| name | fortune-teller |
| description | 算命综合推算系统，融合紫微斗数、生辰八字、盲派、南北派四大派系，进行交叉验证的综合命理推算。触发条件：算命、八字算命、紫微斗数、命理分析、算一卦、看命 |
FortuneTeller 多代理版 v2.6.0
融合紫微斗数、生辰八字、盲派、南北派四大派系的综合命理推算系统
版本说明
v2.6.0（2026-08-03）- 梁湘润流年论版
- ✅ 新增梁湘润流年六字真言（冲=动、合=缠、刑=烦、会=成）作为流年分析第一层体感判断
- ✅ 新增财官判吉凶规则（财官被冲=破财丢官，被合=得财升职）作为流年第二层事件判断
- ✅ 新增天干地支分工规则（天干=表象，地支=实质）
- ✅ 新增冲合大运vs冲合原局的新事旧事区分
- ✅ 流年分析重构为三层递进框架（六字真言→财官判吉凶→做功通堵）
- ✅ 验证专家新增第五层"流年解读合规性验证"
- ✅ 盲派专家流年应期章节补充六字真言解读语言
v2.5.0（2026-07-29）- 方法论驱动版
- ✅ 新增
prompts/methodology.md 七步推演法操作手册（盲派实战主线）
- ✅ 新增
prompts/enhanced/zuogong-analysis.md 做功链路专项模板
- ✅ 重构盲派专家三维定位顺序：宾主定位→做功路径→调候判定
- ✅ 八字/盲派分析前置"七步推演法速推"，做功主线优先于用神喜忌
- ✅ 流年模板强制三层叠加（大运背景→做功通道变化→通/堵判定→应期落点）
- ✅ 验证专家新增第四层"做功链路一致性验证"
v2.4.0（2026-03-19）- 多代理协作版
- ✅ 重构为多代理协作架构（7个专业子代理）
- ✅ 三层验证机制（计算验证→LLM验证→交叉验证）
- ✅ 三层Review流程（准确性→一致性→可读性）
- ✅ 充分利用LLM推理能力，减少JavaScript计算负担
- ✅ 输出更专业更深入的命理分析报告
v2.3.0（2026-03-17）- 一键生成版
- ✅ 自动生成PNG信息图（横版1920x1080 + 竖版1080x1920）
- ✅ 支持中文数字日期解析（农历十月初六、正月初一等）
- ✅ 完全自动化流程，无需用户中途干预
- ✅ 文字报告 + 图片可视化，双输出模式
核心架构
从单脚本到多代理协作
v2.3.0 架构:
JavaScript计算引擎 → AI主对话分析 → 输出报告
v2.4.0 多代理架构:
Phase 1: 输入解析专家 → Review 1（数据完整性）
Phase 2: 三大派系推算（并行）→ Review 2（推算准确性）
├─ 八字专家 → 四柱推算
├─ 紫微专家 → 斗数分析
└─ 盲派专家 → 口诀推演
Phase 3: 三层验证专家 → Review 3（验证完整性）
Phase 4: 报告撰写专家 → Review 4（报告质量）
Phase 5: 最终Review（整体一致性）
Phase 6: 生成PNG → 输出完整报告
核心优化：每个子代理完成后立即Review，确保质量关卡前置，问题早发现早解决。
注：南北派专家暂时屏蔽，待后续优化后再启用。
子代理配置
系统包含6个专业子代理，配置文件位于 agents/ 目录：
-
输入解析专家 (input-parser-specialist.md)
- 从自然语言中提取姓名、性别、日期、时辰、地点
- 支持多种日期格式（公历、农历、干支）
- 支持12时辰表达方式
- 支持40+主要城市坐标匹配
-
八字专家 (bazi-specialist.md)
- 四柱排盘（年柱、月柱、日柱、时柱）
- 五行分析（强弱、缺失、流通）
- 十神配置（性格、关系、事业）
- 格局判断（正格、从格、化格）
- 大运计算（起运年龄、大运排列）
-
紫微专家 (ziwei-specialist.md)
- 十二宫位配置
- 十四主星分析
- 四化飞星推演
- 大限流年预测
-
盲派专家 (mengpai-specialist.md)
- 三维定位法（格局-流通-调候）
- 墓库能量开关理论
- 十神精析系统
- 传统口诀应用
- 神煞计算
- 流年应期
- 趋吉避凶建议
-
验证专家 (validation-specialist.md)
- 第一层：计算验证（排盘准确性）
- 第二层：LLM逻辑验证（因果一致性）
- 第三层：派系交叉验证（结论一致性）
-
报告撰写专家 (report-writer-specialist.md)
- 整合所有推演结果
- 生成结构化Markdown报告
- 专业术语通俗化
- 包含置信度评估
注：南北派专家暂时屏蔽，待后续优化。
Review流程（关键优化）
核心理念：每个子代理完成后立即Review，质量关卡前置，问题早发现早解决。
Review 1（Phase 1完成后）：输入数据完整性检查
- 检查姓名、性别、日期、时辰、地点是否完整提取
- 验证日期格式转换是否正确（农历→公历）
- 验证时辰解析是否准确（12时辰→24小时制）
- 验证地点坐标匹配是否正确
- 不通过：返回重新提取，不允许进入Phase 2
Review 2（Phase 2完成后）：推算准确性检查
- 检查八字四柱排盘是否正确
- 检查五行统计是否准确
- 检查紫微宫位配置是否合理
- 检查各派系理论应用是否得当
- 验证计算结果与理论是否一致
- 不通过：指出错误，要求重新推算
Review 3（Phase 3完成后）：验证完整性检查
- 检查三层验证是否全部完成
- 检查验证逻辑是否清晰
- 检查问题发现是否充分
- 检查置信度评估是否合理
- 不通过：要求补充验证内容
Review 4（Phase 4完成后）：报告质量检查
- 检查报告结构是否完整
- 检查内容是否全面覆盖所有派系
- 检查专业术语是否准确
- 检查逻辑是否连贯
- 检查是否有遗漏或错误
- 不通过：要求修改报告内容
Review 5（最终Review）：整体一致性与可读性
- 检查整个报告的一致性
- 检查派系结论是否矛盾
- 检查语言表达是否自然流畅
- 检查是否有AI痕迹
- 检查置信度标注是否准确
- 不通过：要求优化表达
Review专家配置：
- 可由主代理兼任，或调用独立的Review子代理
- 每次Review输出结构化结果：
{"status": "pass/fail", "issues": [], "suggestions": []}
使用说明
用户输入
用户用自然语言输入基本信息，例如：
帮我算命，张三 男 2025年3月15日 下午2点 北京
必需信息（全部必填，不得省略）：
- 姓名
- 性别（男/女）
- 出生日期（2025年3月15日 或 农历十月初六）
- 出生时辰（X点 或 上午X点、下午X点、晚上X点）
- 出生地点（北京、上海、广州等）
⚠️ 重要：所有信息必须由用户提供，不允许使用默认值！
如果用户没有提供任何一项，应反复询问，直到获取所有信息。
AI工具执行流程
digraph fortune_teller_flow {
rankdir=TB
node [shape=box, style=filled]
start [label="用户输入自然语言", fillcolor="#c8e6c9"]
phase1 [label="Phase 1: 输入解析专家", fillcolor="#bbdefb"]
review1 [label="Review 1: 数据完整性", fillcolor="#fff9c4"]
decision1 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]
phase2 [label="Phase 2: 四大派系并行推算", fillcolor="#bbdefb"]
review2 [label="Review 2: 推算准确性", fillcolor="#fff9c4"]
decision2 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]
phase3 [label="Phase 3: 三层验证专家", fillcolor="#bbdefb"]
review3 [label="Review 3: 验证完整性", fillcolor="#fff9c4"]
decision3 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]
phase4 [label="Phase 4: 报告撰写专家", fillcolor="#bbdefb"]
review4 [label="Review 4: 报告质量", fillcolor="#fff9c4"]
decision4 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]
final_review [label="Review 5: 整体一致性", fillcolor="#fff9c4"]
decision5 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]
phase6 [label="Phase 6: 生成PNG", fillcolor="#bbdefb"]
output [label="输出完整报告", fillcolor="#f8bbd0"]
start -> phase1
phase1 -> review1
review1 -> decision1
decision1 -> phase2 [label="是"]
decision1 -> phase1 [label="否，重新提取"]
phase2 -> review2
review2 -> decision2
decision2 -> phase3 [label="是"]
decision2 -> phase2 [label="否，重新推算"]
phase3 -> review3
review3 -> decision3
decision3 -> phase4 [label="是"]
decision3 -> phase3 [label="否，补充验证"]
phase4 -> review4
review4 -> decision4
decision4 -> final_review [label="是"]
decision4 -> phase4 [label="否，修改报告"]
final_review -> decision5
decision5 -> phase6 [label="是"]
decision5 -> phase4 [label="否，优化表达"]
phase6 -> output
}
详细步骤：
步骤1: AI工具识别意图
- 用户: "帮我算命，张三 男 2025年3月15日 下午2点 北京"
- AI识别: 这是算命请求，触发 fortune-teller skill
步骤2: Phase 1 - 输入解析 + Review 1
- 调用输入解析专家子代理
- 提取结构化数据（姓名、性别、日期、时辰、地点）
- 立即Review 1：检查数据完整性
- 姓名是否提取？性别是否识别？
- 日期格式转换是否正确？
- 时辰解析是否准确？
- 地点坐标是否匹配？
- 如果Review不通过：返回重新提取，不允许进入Phase 2
步骤3: Phase 2 - 四大派系推算 + Review 2
- 并行调用4个子代理：
- 八字专家 → 生成八字分析
- 紫微专家 → 生成紫微分析
- 盲派专家 → 生成盲派分析
- 南北派专家 → 生成南北派对比
- 立即Review 2：检查推算准确性
- 八字四柱是否正确？
- 五行统计是否准确？
- 理论应用是否得当？
- 计算结果是否一致？
- 如果Review不通过：指出错误，要求重新推算
步骤4: Phase 3 - 三层验证 + Review 3
- 调用验证专家子代理
- 第一层：计算验证
- 第二层：LLM逻辑验证
- 第三层：派系交叉验证
- 生成置信度评分
- 立即Review 3：检查验证完整性
- 三层验证是否全部完成？
- 验证逻辑是否清晰？
- 问题发现是否充分？
- 置信度评估是否合理？
- 如果Review不通过：要求补充验证内容
步骤5: Phase 4 - 报告撰写 + Review 4
- 调用报告撰写专家子代理
- 整合所有推演结果
- 生成结构化Markdown报告
- 立即Review 4：检查报告质量
- 报告结构是否完整？
- 内容是否全面覆盖？
- 术语是否准确？
- 逻辑是否连贯？
- 如果Review不通过：要求修改报告内容
步骤6: Review 5 - 整体一致性与可读性
- 检查整个报告的一致性
- 检查派系结论是否矛盾
- 检查语言表达是否自然流畅
- 检查是否有AI痕迹
- 检查置信度标注是否准确
- 如果Review不通过：要求优化表达
步骤7: Phase 6 - 生成PNG
- 自动调用
/infographic-generator
- 生成横版（1920x1080）和竖版（1080x1920）信息图
步骤8: 输出最终报告
- Markdown报告（8000-12000字）
- PNG信息图（横版+竖版）
输出内容
完整命理分析报告（Markdown格式）：
- 基本信息 - 姓名、性别、出生日期、真太阳时
- 八字排盘 - 四柱、五行、十神、神煞
- 紫微斗数 - 十二宫、主星、四化、大限
- 综合分析 - 性格、事业、财运、感情、健康
- 大运流年 - 大运走势、流年提醒
- 趋吉避凶 - 有利因素、注意事项
- 验证与置信度 - 三层验证结果、置信度评分
- 免责声明 - 仅供参考，娱乐而已
PNG信息图：
- 横版（1920x1080）：适合博客、报告
- 竖版（1080x1920）：适合手机分享、小红书
文件输出规范
⚠️ 重要规则：所有文件输出必须严格遵守以下目录规范
目录结构
fortune-teller/
├── agents/ # 子代理配置目录（新增）
│ ├── input-parser-specialist.md
│ ├── bazi-specialist.md
│ ├── ziwei-specialist.md
│ ├── mengpai-specialist.md
│ ├── nanbeipai-specialist.md
│ ├── validation-specialist.md
│ └── report-writer-specialist.md
│
├── lib/ # 计算引擎库（保留）
│ ├── bazi-calculator.js
│ ├── ziwei-calculator.js
│ └── ...
│
├── prompts/ # 提示词模板（保留）
│ ├── ziwei-analysis.md
│ ├── bazi-analysis.md
│ └── ...
│
├── output/ # 正式输出目录
│ ├── [姓名]_命盘数据.json
│ ├── [姓名]_完整命理报告.md
│ ├── [姓名]_命盘信息图_横版.png
│ └── [姓名]_命盘信息图_竖版.png
│
├── test/ # 测试输出目录
└── backup/ # 备份目录
三层验证机制
第一层：计算验证
目标: 确保排盘计算的准确性
验证内容：
- 八字四柱准确性（年柱、月柱、日柱、时柱）
- 五行统计准确性（数量、缺失）
- 神煞计算准确性（天乙贵人、桃花、驿马等）
- 紫微宫位配置准确性（十二宫、主星）
方法：调用计算引擎验证
第二层：LLM逻辑验证
目标: 确保分析推理的合理性
验证内容：
- 因果关系验证（五行生克逻辑链）
- 结论依据验证（判断是否有理论支撑）
- 矛盾检测（不同分析之间是否矛盾）
- 过度推断检测（是否有超出依据的结论）
方法：LLM分析推理
第三层：派系交叉验证
目标: 确保多派系结论的一致性
验证内容：
- 八字 vs 紫微（结论是否一致）
- 八字 vs 盲派（口诀是否支持）
- 南派 vs 北派（差异是否可解释）
- 置信度评估（综合评分）
方法：派系对比分析
技术架构
计算引擎（lib/）
保留现有的JavaScript计算引擎，用于：
-
精确计算
- 真太阳时计算
- 八字排盘计算
- 紫微斗数排盘
- 大运流年计算
-
被Agent调用
- 子代理可以通过Bash工具调用计算引擎
- 例如：
node lib/bazi-calculator.js --date "2025-03-15" --time 14
-
验证基准
提示词库（prompts/）
保留现有的提示词模板，用于：
-
操作手册（最高优先）
prompts/methodology.md —— 所有子代理必须优先读取，七步推演法完整操作规程prompts/enhanced/zuogong-analysis.md —— 做功链路专项模板（功神识别/五档效率/反做功）
-
子代理参考
- 提供专业知识库
- 提供分析方法论（bazi/mengpai/ziwei 等）
-
动态加载
- 子代理可以读取prompts/*.md
- 作为背景知识参考
⚠️ 关键约束：任何派系分析（八字/盲派/紫微）都必须先走 methodology.md 的七步推演法
步骤1-3 锁定"核心做功路径"，再进入各自补充分析。做功主线优先级高于传统用神喜忌。
子代理系统（agents/）
新增的子代理配置文件，定义：
- 角色定位 - 每个子代理的专业领域
- 核心能力 - 擅长的分析维度
- 输入输出 - 结构化的JSON格式
- 工作流程 - 分析步骤
- 质量标准 - 输出要求
Token消耗与时间预估
总Token消耗: ~28,000 tokens（含5次Review）
各阶段消耗：
- Phase 1（输入解析）: ~2,000 tokens
- Review 1: ~500 tokens
- Phase 2（四大派系）: ~10,000 tokens（并行）
- Review 2: ~1,500 tokens
- Phase 3（验证）: ~3,000 tokens
- Review 3: ~800 tokens
- Phase 4（报告撰写）: ~4,000 tokens
- Review 4: ~1,000 tokens
- Review 5（最终）: ~1,200 tokens
- Phase 6（生成PNG）: ~500 tokens
- 其他开销: ~3,500 tokens
总时间预估: 3-5分钟
Review时间占比：约20-25%的时间用于Review，但可以避免后期返工，整体效率更高。
核心优势
1. 专业化分工
- 每个派系有专门的Agent
- 充分利用LLM推理能力
- 输出更专业更深入
2. 质量保证
- 三层验证机制
- 三层Review流程
- 置信度评分
- 八字验证
3. 可扩展性
- 新增派系只需添加配置文件
- 无需修改JavaScript代码
- 易于维护和优化
4. 参考wechat-article-writer成功模式
- 相同的多代理架构
- 相同的自然语言指导
- 相同的Review机制
注意事项
- 日期格式：支持农历和阳历，系统会自动转换并验证
- 真太阳时：提供出生地可以获得更准确的时辰
- 验证机制：系统会进行三层验证确保准确
- 大运流年：分析会考虑对应的时代背景
- 置信度：报告会明确标注置信度评分
更新日志
- v2.4.0: 多代理协作版，7个子代理，三层验证，三层Review
- v2.3.0: 一键生成版，自动生成PNG信息图
- v2.2.0: 重大改进版，文件输出规范，优化提示词
- v2.1.0: 完整增强版，三层验证，增强报告生成器
- v1.0.0: 初始版本，包含四大派系排盘和基本分析
