Renhuai123/ziwei-doushu

解决什么问题

紫微斗数的排盘规则、星曜亮度和断语文本，长期被锁在各种闭源软件里：你没法和古籍逐条对照，也没法把解读文本搬进自己的产品。想做一个命理应用的人，往往要自己重写农历转换、真太阳时、四化逻辑，还要从头写解读文案。这个项目把两件事一起公开：用 TypeScript 写的排盘引擎，以及由它确定性生成的大规模解读数据集。

有什么不同

同类东西多数是桌面或网页应用，你只能看结果；或者是散落的资料，没有可执行的代码。这里引擎是能读、能跑测试的普通 TypeScript，而仓库真正的大件是数据：约 67.5 万张命盘、13 个分析维度，覆盖 1950–2026 的真实日期，用 zstd 按年份分文件压缩成 JSON Lines，可以只下需要的那几年。生成方式是规则加断语库，不走 AI，同一输入永远同一输出——在满街 LLM 生成解读的当下，这一点反而少见。README 还主动写明自身短板，比如六亲判断偏弱、只能作参考。

适合谁

适合做命理产品的开发者、想对命盘结构做量化分析的研究者，以及需要中文领域语料做微调或 RAG 的人。不适合只想装个应用看解读的普通用户——仓库里的界面自称 Demo，不是线上那套。如果你需要别的流派，也不合适：内容绑定一家教学体系，换流派的解读风格对不上。

上手成本

代码 MIT，数据 CC BY 4.0、保留署名即可商用。真正的门槛是数据本身：全量解压约 56 GB，要用 zstd -d --long=27，不是装个包的事。解读里引用的老师原话不在数据授权范围内，适用非商用条款，单独批量使用这些引文要另做处理。引擎需要 Node 环境，Demo 用 Next.js。成熟度信号有好有坏：仓库才几个月大，测试和 CI 是最近才补上的，数据也有已知坑——旧版本包含不存在的日期，v4.0 之后星曜亮度默认值又改过，部分解读句会和当前引擎对不上。

点评

这不是一个有长期积累的老牌库。它很年轻，靠一次体量很大的数据发布和一波快速涨星进入视野：176 天的仓库拿到 7,226 star，一个月 +2,556。开源代码本身规模不大，数据集才是主角。把它当作语料和参考实现来用，上线前拿几张已知命盘核对排盘结果，并厘清引文部分的授权边界。作者肯把局限写清楚是加分项，但维护历史太短，别默认它稳定。