bazi-ziwei

# 八字 + 紫微斗数综合分析 Skill ## 何时触发 用户场景： - 提供出生时间（"我是 2000-01-01 中午 12:00 男"）并希望分析 - 询问"帮我看八字 / 看紫微 / 算命 / 看命盘 / 看流年大运" - 提供命盘文本（文墨天机、紫微斗数排盘软件导出格式）希望深度解读 - 询问特定大运/流年的吉凶 **不触发**：单纯的星座 / 塔罗 / 周公解梦 / 风水 / 姓名学。 ## 必需输入 ``` 公历或农历日期 (YYYY-MM-DD) 出生时刻 (HH:MM, 24 小时制) 性别 (男/女) ``` 若用户没给时辰，**必须主动询问**，不要默认子时。时辰对四柱日柱和紫微命宫影响极大。 > 不需要出生地。排盘直接使用钟表时间，不做真太阳时经度校正。 --- ## 执行流程 ### Step 0 — 决策门（开场必做） ⭐ **问题 1：要看哪种命理？** > "我可以做三种分析： > 1. **八字独立分析**（事业 / 财运 / 婚恋 / 子女 / 六亲 / 健康，按八字格局推演 — 长文输出） > 2. **紫微独立分析**（十二宫 + 大限 + 生年四化 + 流年 — 长文输出） > 3. **八字 + 紫微综合印证**（两盘交叉对账 — 提供长文 / 可视化海报 / 两种都要）" **如果用户选 3，再追问问题 2：呈现形态** > "综合印证可以这样输出： > A. **📜 长文深度版**（Markdown 散文，沉浸阅读） > B. **🎴 结构化海报版**（单文件 HTML，可截图分享） > C. **两种都要**" **根据选择加载相应提示词和模板**： | 用户选 | 加载提示词 | 模板 | 输出 | |---|---|---|---| | 1 | `prompts/bazi-prompt.md` | — | Markdown 对话回复 | | 2 | `prompts/ziwei-prompt.md` | — | Markdown 对话回复 | | 3 + A | `prompts/zonghe-yinzheng-prompt.md` | — | Markdown 对话回复 | | 3 + B | `prompts/zonghe-poster.md` | `templates/report-zonghe-poster.html` | `<name>-zonghe.html` | | 3 + C | 上述两份都跑 | 同上 | Markdown + HTML 两份 | > **海报模板仅综合印证一种**。八字独立 / 紫微独立只有长文输出（用户深度阅读用）。这是经过设计的——海报是综合印证独占的杀手锏，承担社交分享 + 用户惊艳的角色。 --- ### Step 1 — 排盘（算法层，产出 JSON） **绝对不要让 AI 自己排八字或紫微**。必须调用算法层脚本： ```bash cd calculator node dist/run-chart.js --year=YYYY --month=MM --day=DD --hour=HH --minute=MM --gender=male > chart.json ``` **注意**：`run-chart.ts` 的 stdout 是纯 JSON，stderr 是 debug 信息。**重定向时只取 stdout**（`> chart.json`），不要 `2>&1`。 脚本输出 JSON： - `bazi`：四柱 / 十神 / 星运 / 自坐 / 纳音 / 藏干 / 大运（含 startAge/endAge/startYear/endYear） - `bazi.enrichment`：格局 / 旺衰 / 调候 / 五行旺相 / 五行统计 / 天干关系 / 地支关系 / 整柱判定 - `ziwei`：十二宫 / 生年四化 / 大限 / 阴阳 / 五行局 / 命主身主 > **关键约束**：纯 LLM 排盘会错排日柱 → 日主 → 格局 → 用神，全链失真。Case B 测试证明 DeepSeek/Gemini 自行排盘均出错。算法层不可绕过。 --- ### Step 2 — 文本盘转换（算法层，产出可读文本） LLM 读 JSON 不如读结构化文本。把 Step 1 的 JSON 转成文墨天机风格的树状文本： ```bash node dist/dump-text.js --input=chart.json --output=chart.txt ``` 文本盘包含： - 紫微部分：基本信息 + 生年四化 + 十二宫（含主星 / 辅星 / 大限 / 流年） - 八字部分：四柱（含藏干十神 / 星运 / 自坐 / 纳音）+ 大运 + 算法补层（格局 / 旺衰 / 调候 / 关系 / 整柱） 将 `chart.txt` 内容连同对应提示词一起送给 LLM 做分析。 --- ### Step 3 — 分析（按 Step 0 用户选择执行对应分支） #### Step 3 — 长文版（用户选 1 / 2 / 3+A / 3+C） 读取对应长文提示词（`bazi-prompt.md` / `ziwei-prompt.md` / `zonghe-yinzheng-prompt.md`），喂入 `chart.txt`，输出 Markdown 长文。 > 综合印证（3+A）的前置条件：先跑八字 + 紫微独立分析拿到中间报告，再喂给 `zonghe-yinzheng-prompt.md`。 > 如输出被截断，分段输出。 #### Step 3 — 海报版（仅用户选 3+B 或 3+C） 1. 读取 `prompts/zonghe-poster.md`，喂入 `chart.txt` 2. LLM **必须输出严格 JSON**（不是 Markdown）——提示词末尾会要求"直接以 `{` 开头"，照办即可 3. 把 LLM 输出的 JSON 保存为 `analysis.json` 4. 调用渲染脚本： ```bash cd calculator node dist/render.js \ --chart=chart.json \ --analysis=analysis.json \ --template=../templates/report-zonghe-poster.html \ --output=<user-name>-<date>.html \ --currentYear=<YYYY> ``` 5. 把生成的 HTML 文件路径告诉用户，让其用浏览器打开 > **重要**：海报版的视觉由 HTML 模板决定，**LLM 只产数据不产 HTML**。如果 LLM 输出含 markdown 包装（如 \`\`\`json … \`\`\`），渲染前需剥掉。 --- ## 安装后行为（重要） **装好 Skill 后不要主动跑任何验证 / 自检命令。** 不要试 Smoke Test、不要排示例盘、不要分析示例命主。装好就是装好，等用户来给生辰再开始工作。 > 自检命令在 `TEST-GUIDE.md` 中由人工按需运行，不在 Agent 的职责范围内。Agent 主动跑会浪费 token + 触发上下文压缩。 依赖检查（仅在用户首次提供生辰、Agent 准备跑 run-chart.ts 报错时）： ```bash cd <skill-root>/calculator ls node_modules >/dev/null 2>&1 || npm install ``` 也就是说，依赖问题**报错时再修**，不要装好就主动检查。 --- ## 关键约束 1. **装好不自检**：见上节"安装后行为"。不要主动跑示例排盘 / 自检 / smoke test 2. **决策门必做**：永远先问用户要哪种分析，避免无意义的 token 消耗 + 输出截断 3. **排盘必须走算法层**：不要徒手算四柱、紫微宫位、大限。错一步全盘垮 4. **不引入命盘外变量**：风水、姓名、阳宅、紫白飞星不在本 Skill 范围 5. **冲突要说出来**：八字与紫微出现矛盾信号时按综合印证提示词的 4 条规则判定，不和稀泥 6. **置信度自评**：边界情况（旺衰临界、格局模糊、两盘对立）必须标"置信度：低" 7. **不替用户做决策**：投资、择偶、医疗、堕胎等决策类问题，给信号不给指令 8. **敏感问题拒答**：下蛊、断人财路、害人命运等违禁内容直接拒绝 9. **免责声明**：分析末尾必带"仅供文化研究与娱乐参考" --- ## 文件清单 ``` ├── SKILL.md ← 本文件 ├── calculator/ │ ├── run-chart.ts ← 入口：生辰 → JSON（stdout 纯 JSON / stderr debug） │ ├── dump-text.ts ← JSON → 文墨天机风文本 │ ├── render.ts ← 渲染脚本：chart.json + analysis.json + 模板 → HTML │ ├── package.json ← 算法层依赖声明 │ ├── yiqi-core/ ← Yiqi 算法（已 vendored 入库，无外部依赖） │ └── bazi-enrich/ ← enrichBazi 补层（格局/旺衰/调候/关系/整柱） ├── prompts/ │ ├── bazi-prompt.md ← 八字独立分析（长文） │ ├── ziwei-prompt.md ← 紫微独立分析（长文） │ ├── zonghe-yinzheng-prompt.md ← ⭐ 综合印证（长文） │ └── zonghe-poster.md ← ⭐ 综合印证（海报版 JSON 输出） ├── templates/ │ └── report-zonghe-poster.html ← 综合印证海报模板（占位符） └── fixtures/ ← 7 个验证案例（Case A-G） ``` **注**：HTML 渲染目前**仅支持综合印证模式**。如用户选了八字独立 / 紫微独立又问"能不能出 HTML 报告"，告知"目前 HTML 海报仅对综合印证开放，建议选综合印证（含八字+紫微）以拿到海报"。 --- ## 工作示例 **用户**：我是 2000 年 1 月 1 日 12:00 出生的男生，帮我看下命盘。 **Skill 应该走**： 1. 信息确认（日期/时辰/性别 ✅） 2. **决策门**："想要八字分析 / 紫微分析 / 综合印证？" 3. 用户回 "八字"： - Step 1：跑 `run-chart.ts` 产出 `chart.json` - Step 2：跑 `dump-text.ts` 产出 `chart.txt` - Step 3a：加载 `prompts/bazi-prompt.md` + 喂入 `chart.txt` → 输出八字分析 4. 提醒"若要紫微 / 综合印证可随时追问" --- ## 失败模式与处理 | 现象 | 原因 | 处理 | |---|---|---| | 排盘脚本报错 | 日期超 1900-2100 / 时辰格式错 | 询问用户校正 | | AI 想"凭记忆排盘" | 偷懒走捷径 | **拒绝**。算法层是不可绕过的硬约束 | | 输出被截断 | 三段一锅出超 token 上限 | 回到决策门，拆分输出 | | 算法层和用户其他软件结果不一致 | 命名流派差异（建禄格 vs 比肩格） | 按算法层 `notes` 解释，不偷换说法 | | Windows + 中文路径 + PowerShell 编码错乱 | 平台特性 | 在 cmd / git bash / WSL 下运行，避免 PowerShell | --- ## 免责声明（每次输出末必带） > 本分析基于传统八字与紫微斗数理论框架，仅供文化研究与娱乐参考，不构成医疗、投资、婚姻、法律等任何决策依据。命运由个人选择与客观环境共同塑造。