这是一个面向 AI Agent 的八字与紫微斗数分析 Skill，遵循 SKILL.md 标准，可接入 Claude、Codex、Cursor、Claude Desktop、Hermes、OpenClaw 等工具。项目核心价值在于：八字四柱、紫微十二宫、大运流年等排盘由本地 TypeScript 算法确定性计算，而不是让大模型凭空推算；随后再把排盘结果、格局补层、旺衰、调候、刑冲合害等结构化信息交给 LLM 做解释分析。它支持八字独立分析、紫微独立分析、八字与紫微综合印证三种模式，并可生成 Markdown 长文或水墨风单文件 HTML 命盘海报。
适用领域
AI Agent Skill / 命理工具 / 八字排盘 / 紫微斗数 / 中华传统文化 / AIGC 内容生成 / TypeScript 工具链 / 本地算法计算 / HTML 报告生成
配置难度
中等。普通用户如果只是在 Claude 或 Cursor 中安装使用，需要会克隆仓库、安装 npm 依赖、放置 skills 目录；有一定门槛但不复杂。开发者二次集成时需要理解 TypeScript 脚本、JSON 数据结构、提示词流程和 HTML 模板渲染，难度中等。若要修改排盘算法或适配不同命理流派，则难度较高。
商业价值
具备较明确的细分商业价值。它可以作为命理类 AI 产品的基础组件，用于生成八字分析、紫微斗数分析、综合报告和可分享海报，适合嵌入 AI 咨询助手、小程序、公众号工具、知识付费产品或个人品牌服务。项目的优势是本地算法排盘加 LLM 分析，能比纯聊天式命理机器人更稳定，也比普通排盘工具更容易生成可读报告。不过商业化时必须控制合规风险和预期管理，明确娱乐与文化研究属性，避免将结果包装为确定性预测或专业决策建议。
01
技术亮点
- 排盘不依赖 LLM 猜测，而是由本地确定性算法完成，降低日柱、日主、宫位、大运等基础错误风险
- 同时支持八字和紫微斗数，并提供综合印证模式，这是相比单一排盘工具的主要差异化能力
- 遵循 SKILL.md 标准，具备跨 Agent 复用能力
- 本地运行，无需联网，隐私友好
- 提供 Markdown 长文分析和单文件 HTML 海报两种输出形态
- HTML 海报模板固定，LLM 只填充结构化分析内容，降低大模型直接生成复杂 HTML 的不稳定性
- 目录结构清晰，包含算法层、提示词、模板和示例，方便二次开发
- MIT 许可证，对商业集成和二次开发比较友好
- 已有 400+ stars，说明在细分命理 AI Agent 工具领域有一定关注度
02
目标用户
- 希望在 Claude、Cursor、Codex 等 Agent 中接入命理能力的开发者
- 研究八字、紫微斗数、传统术数文化的技术用户
- 想做命理类 AI 应用、知识助手或内容生成工具的创业者
- 需要稳定排盘算法而不是依赖 LLM 猜测的命理产品开发者
- 对 SKILL.md 标准和跨 Agent 插件生态感兴趣的开发者
- 想生成命盘海报、命理报告、咨询辅助材料的内容创作者
03
配置要求
- 需要 Node.js >= 18
- 需要运行 npm install 安装算法层依赖
- 算法层依赖 lunar-typescript，许可证为 MIT
- 需要一个支持 SKILL.md 或可引用规则文件的 AI Agent 环境，如 Claude Code、Claude Desktop、Codex、Cursor、Hermes、OpenClaw
- 若通过 Agent 使用，需要正确放置 skills 目录或配置对应的规则引用
- 用户需要提供出生年、月、日、时、分钟、性别等基础信息
- 紫微斗数和八字分析对出生时间敏感，实际使用中最好确认出生地、时区、是否使用真太阳时等口径
- 生成 HTML 海报时需要 chart.json、analysis.json 和模板文件 report-zonghe-poster.html
04
适用场景
- 在 Claude Code、Claude Desktop、Cursor、Codex 中作为命理分析 Skill 使用
- 输入出生年月日时和性别后，自动生成八字或紫微斗数分析
- 进行八字与紫微斗数的综合印证，对比两套体系在人生主轴、性格、事业、感情、财运、关键年份上的一致性
- 生成可分享的水墨风 HTML 命盘海报
- 将本项目作为命理类 SaaS、公众号工具、小程序、AI 咨询助手的算法与提示词参考
- 命理研究者用于本地排盘、导出 JSON、文本盘或进一步二次分析
- 开发者学习如何把确定性算法、提示词和 HTML 模板组合成 Agent Skill
05
部署与配置
- 克隆仓库：git clone https://github.com/dzcmemory-web/bazi-ziwei-skill.git
- 进入算法目录：cd bazi-ziwei-skill/calculator
- 安装依赖：npm install
- 确认本机 Node.js 版本 >= 18
- 将整个 bazi-ziwei-skill 文件夹放入目标 Agent 的 skills 目录，例如 Claude 为 ~/.claude/skills/bazi-ziwei/
- 启动或重载 Agent，使其读取 SKILL.md
- 在 Agent 中输入出生信息，例如：我是 2000 年 1 月 1 日中午 12 点出生的男生，帮我看下命盘
- 如需命令行直接排盘，可在 calculator 目录下运行 node dist/run-chart.js 等脚本
06
风险与注意事项
- 命理分析属于传统文化和娱乐参考范畴，不适合作为医疗、投资、婚姻、法律等重大决策依据
- 分析文本仍由 LLM 生成，可能存在过度解读、语言暗示、幻觉或不当建议，需要加免责声明和安全边界
- 项目依赖的排盘核心来自外部开源项目 Yiqi，虽然是 MIT，但二次商用时仍应检查 NOTICE、许可证和代码来源
- 紫微斗数和八字流派众多，算法口径、起盘规则、节气边界、真太阳时处理等可能与部分用户认知不一致
- 如果用户出生时间不准，排盘和分析结果可能显著偏差
- README 中强调经过案例回归验证，但对专业命理准确性仍不能等同于科学验证
- Agent 集成体验依赖不同平台对 SKILL.md 的支持程度，可能需要手动调整路径或规则配置
- 仓库主要面向中文命理场景，国际化和非中文用户体验可能有限
- 如果用于商业命理咨询产品，需要特别注意合规、未成年人保护、心理暗示风险和消费纠纷
2026-06-19
第20名
新收录 · github_search
