源码系统概览
文章正文
Yuan（元）不是一个把多套术数机械堆在一起的“玄学路由器”，而是一个“命理成品渲染器”：它把出生时间、地点、历法、性别与关注主题收敛为统一输入包，再基于当前环境真正能运行的方法产出可辩护的结果。本文基于其公开源码梳理技能包结构，仅用于 Agent Skills 工程实现与文化研究的参考。
源码简介
项目以 MIT 风格的开放协议发布，主体由一份总 skill 与六套参考体系组成，目录集中在 references/ 下，每个体系包含 SKILL.md、机器可读的 json/yaml 规范、参考实现与示例。六个体系分别是八字（四柱）、称骨、数字命理、西方占星、吠陀占星与紫微斗数。
它的设计原则强调“统一输入、成品交付、统一边界”：能算的就算，不能可靠排盘的部分直接标注限制，不编造事实；确定性计算与经验性解读严格分层，传统经验可用但不包装成科学证明。这种边界意识对构建任何涉及不确定知识的 AI 技能都有参考价值。
适用场景
适合想为 Claude Code、Codex 等运行时编写结构化技能包的开发者，参考其多体系组织方式。
适合研究“如何把含歧义的领域知识做成可校验、可标注边界的 AI 工作流”的工程师。
可作为传统文化知识工程的教学样本，观察术语、规则与输出 schema 如何被结构化。
功能亮点
六体系统一：八字、称骨、数字命理、西方占星、吠陀、紫微共用一套输入与交付约定。
参考实现齐备：八字体系内置节气换算、四柱排盘、十神、旺衰、格局、神煞、大运流年的 Python CLI（bazi_skill_engine.py）。
精确排盘可选依赖：西方占星与部分体系使用 pyswisseph 做确定性星历计算，安装后才启用高精度排盘。
边界标注：对 partial 或 blocked 的体系明确限制，不假装完成排盘，体现负责任的输出设计。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：无（技能包形态，无图形界面） 后端：无（供 Agent 运行时加载的 Skill 文件） 数据库：无（规则以 |
依具体方案选型，需自行搭建与维护 |
| 部署方式 | 技能包以文件夹形式复制到 Agent 运行时的 skills 目录（如 .claude/skills/ 或 .agent | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 六体系统一：八字、称骨、数字命理、西方占星、吠陀、紫微共用一套输入与交付约定。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：无（技能包形态，无图形界面）
后端：无（供 Agent 运行时加载的 Skill 文件）
数据库：无（规则以 markdown / json / yaml 表达）
运行环境：Python 3.x（仅精确排盘参考实现需要）；技能包本身可纯文本加载
其他依赖：pyswisseph（可选，用于八字/西方占星的精确星历计算）
安装与部署提示
技能包以文件夹形式复制到 Agent 运行时的 skills 目录（如 .claude/skills/ 或 .agents/skills/）即可被识别加载。
若需运行八字参考实现，进入 references/bazi/ 执行 pip install pyswisseph，再运行 bazi_skill_engine.py 并传入出生时间、性别与大运/流年参数。
各体系 README 给出了输入示例（sample_request.json）与输出示例（sample_output.json），便于理解 schema 约定后再自行调用。
截图与演示说明
项目为技能包形态，没有图形界面，所谓“页面”即各体系的 SKILL.md 文档与 json/yaml 配置。
references/bazi/ 包含规则文档、机器可读规范、Python CLI 与示例，是代码量最集中、最值得阅读的部分。
references/ziwei/ 与 references/western-astrology/ 下设 scripts 目录（如 compute_chart.py、request_guard.py、validate_output.py），演示排盘计算与输出校验的参考实现。
常见问题
问：它能在不装依赖的情况下运行吗？
答：可以。输入判断、结果渲染与结构约束默认零依赖；只有精确排盘才使用 pyswisseph 等可选工具链，缺失时对应体系会明确标注限制。
问：支持哪些 Agent 运行时？
答：面向 Codex、Claude Code 以及兼容 Agent Skills 标准的运行时，技能包以标准 SKILL.md 结构组织，可被相应运行时加载。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本项目涉及多种传统命理体系的结构化表达，请遵守所在地法律法规，仅用于 Agent Skills 工程研究、文化研究与娱乐用途，不得用于欺诈性算命收费或误导性宣传。
GitHub项目开源地址：https://github.com/shizhilya/yuan