ziwei-gt

紫微斗数计算工具库

安装

npm install ziwei-gt

使用方法

Node.js 环境

// ESM
import { Plate } from 'ziwei'
const plate = new Plate({
  year: 2023,
  month: 1,
  day: 1,
  hour: 0,
  minute: 0,
  second: 0,
  sex: 0
});
console.log(plate.getPalaces());

浏览器环境

直接通过 script 标签引入：

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/index.global.js"></script>
<script>
  // 通过全局变量 ZiweiGT 访问
  console.log(new Ziwei.Plate({
    year: 2023,
    month: 1,
    day: 1,
    hour: 0,
    minute: 0,
    second: 0,
    sex: 0
  })); 

或者使用 CDN：

<!-- 替换 x.x.x 为实际版本号 -->
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/index.global.js"></script>

开发

安装依赖

npm install

运行测试

npm test

构建

npm run build

浏览器示例

查看 examples/browser-usage.html 文件，了解如何在浏览器中使用该库。

发布流程

本项目使用GitHub Actions自动发布到npm。发布新版本的步骤如下：

1. 更新版本号：在package.json中更新版本号
2. 提交更改：git commit -am "bump version to x.x.x"
3. 创建标签：git tag vx.x.x
4. 推送标签：git push && git push --tags
5. 在GitHub上创建新的Release，选择刚刚创建的标签

创建Release后，GitHub Actions会自动构建并发布到npm。

注意事项

发布前需要在GitHub仓库设置中添加NPM_TOKEN密钥。