射覆 · 中国古代猜物游戏

「谛观」出品 · 分析哲学见 shared/principles.md · 基于《正易心法》42章·陈抟注

S1 调用与起卦

信号表

| 场景 | 调用信号 | AI回应 | 启动信号 | |------|---------|--------|---------| | 射覆 | 「玩射覆」「射覆」「帮我猜个东西」 | 「好，我已准备好起卦。」 | 「开始」「好」「嗯」 | | 问事 | 「起卦」「占卦」「问卦」「卜问」 | 「心里想的事清楚了吗？给出1-3个关键词，或说『开始』。」 | 说「开始」「确定」「测算」 |

起卦执行

python scripts/qigua.py --json

解析输出：ben_gua.name, ben_gua.shang, ben_gua.xia, dong_yao, bian_gua, calendar, lines

异常处理：

qigua.py 失败 → 输出「⚠️ 起卦引擎异常，请重试或换用梅花易数」
历法数据为 ?（calendar.year == "?"）→ 标注「⚠️ 历法数据缺失，月建加权/颜色系统降级跳过」

S2 交互流程

射覆交互

S1 画像 v1
  输出特征画像（6维度 × 置信度）+ 功能态直读 + 同信号参考
  玩家回应：对了 / 偏了 / 接近但XX

S2 渐进精化（上限5轮）
  根据玩家反馈展开（互体/变卦/月建等未用尽信号源）
  对 🟡 中置信维度补充提问（1-2个二选一问题）
  每轮更新画像，标注变化

S3 揭晓复盘
  特征回溯（命中/偏移/遗漏各维度）
  更新 profile.json 和 类象库.json → python scripts/update_kb.py --round-json '...'
  输出复盘摘要

异常处理：

S2 超5轮 → 自动进入 S3
玩家中途退出 → 直接进入 S3，不等待
不识别信号 → 提示可用命令列表

S3 分析链路

执行顺序严格按照 shared/principles.md §3：

1. 立极（本卦直读）
2. 五观展开（变卦→互卦→错卦→综卦→复卦）
3. 会合参证（收敛🟢 / 分散🟡 / 沉默🔴）
4. 落处映射（射覆=物性维度 / 问事=情境维度，见 shared/principles.md §4）
5. 变复自校验

数据源

| 步骤 | 命令/数据 | |------|----------| | 起卦 | python scripts/qigua.py --json | | 64卦数据 | data/guaci_db.json | | 纳甲表 | data/najia_table.json | | 特征映射 | data/类象库.json — 读取 trigrams.{卦名}.dimensions.{维度} | | 用户画像 | profile.json — 读取 特征维度偏好 做加权 | | 更新类象库 | python scripts/update_kb.py --round-json '{...}' | | 更新画像 | python scripts/update_kb.py --round-json '{...}' |

数据缺失降级

| 缺失数据 | 降级行为 | |---------|---------| | 类象库.json 不存在 | 纯卦象分析，所有维度标注 🔴「需类象库」 | | profile.json 不存在 | 用默认权重 1.0 继续 | | guaci_db.json 不存在 | ❌ 无法起卦，终止并提示用户 | | 类象库中无对应信号 | 标注 🔴「信号无映射记录」 |

S4 复盘与学习

更新执行

每轮结束后：

python scripts/update_kb.py --round-json '{
  "round": N,
  "本卦": "火雷噬嗑",
  "实际物品": "...",
  "品类": "...",
  "命中信号": [{"卦":"离","维度":"功能"},...],
  "遗漏信号": [...],
  "错误信号": [...],
  "背景环境": "...",
  "AI命中": true/false
}'

全流程记录

每轮在 records/ 生成 Markdown：卦象、五观结果、会合参证、落处画像、玩家判断。

update_kb.py 预置定期分析与清理能力（通过 future --periodic-analyze / --periodic-clean 模式激活）。

S5 输出示例

📋 卦象总览
  ䷳ 艮为山 → ䷎ 地山谦
  上九 ○ 阳→阴动

🔬 特征画像 v1
  材质 🟢 硬质，可能含金属
  形态 🟢 双体对称，框状结构
  功能 🟡 常态静止，顶端可开合
  结构 🟡 铰链或运动部件
  颜色 🟡 手柄暖色，功能部银白
  尺寸 🟡 手持级

💡 同信号参考：硬质+双体+框状+开合 → 手持开合工具类

S6 使用须知

本技能仅用于文化教育与娱乐，不适用于医疗、财务、法律、投资等高风险场景
不判断吉凶、不替你命名
禁用：一定、必然、大吉、宜、忌、应该
鼓励：可能、或许、呈现…态势

透明披露：本技能所使用的方法

本技能的计算基于以下完全公开的规则和数据，不包含隐藏逻辑：

| 数据/方法 | 来源 | 类型 | |-----------|------|------| | 干支历法 | scripts/lifa.py — 节气月建映射 + 日干支偏移计算 | 确定性算法 | | 随机起卦 | scripts/qigua.py — Python random 模块 | 伪随机数 (seed=time) | | 64卦查询 | data/guaci_db.json — 64条记录，每卦含上/下卦/五行/世应 | 静态查表 | | 纳甲装卦 | data/najia_table.json — 八纯卦纳甲映射表 | 静态查表 | | 六亲生克 | WUXING_SHENGKE — 五行生克矩阵 | 确定性规则 | | 体用判定 | 梅花易数算法：动爻位置→体卦/用卦 | 确定性算法 | | 类象映射 | data/类象库.json — 信号→特征映射表 | 静态查表 + 增量学习 |

AI 是画师不是鉴定师：刻画特征画像，判断权始终在你手中。

安全免责声明 ⚠️

本技能的全部输出（包括但不限于卦象解读、特征画像、态势推演）仅为文化参考与思维启发，不是确定性结论。不得将其作为医疗、财务、法律、投资、健康或其他专业决策的依据。如需专业服务，请咨询持牌专业人士。

使用者承诺：

理解本技能的输出具有解释性和推测性

不会基于输出做出不可逆的高风险决策

在涉及健康、财务、法律等场景时，优先咨询专业人士

触发词仅限于明确的占卜/射覆意图，不会在日常对话中意外激活

📖 正易心法 — 谛观射覆的理论根基

本技能不是凭空编造的游戏规则，它的每一个分析步骤都有深厚的易学经典依据。

方法论根基

核心经典：麻衣道者《正易心法》42章·陈抟注（五代宋初·约公元10世纪）

历史地位：这部著作超越了汉唐以来以卦辞爻辞文字解卦的传统，直接回归到文王、周公、孔子研究卦象的原始路径——从卦画结构本身读取意义。邵雍创作《皇极经世》，其核心思想即源于此。

当代评价：当代学者从事易学研究，《正易心法》不可不读。

理法合一

正易心法（理）——告诉你卦象为什么这样走
     ↓  理论指导实践
谛观射覆（法）——让你亲手操作每个推演步骤
     ↓  实践验证理论
每一次射覆 = 一次正易心法的完整实验

技能获取

本技能在各平台的名称为：

SkillHub → 谛观·射覆｜Shefu Hexagram Analysis
ClawHub → 谛观·射覆｜Shefu
虾评 → 谛观·射覆
GitHub → henrryjoke/shefu（skill: 射覆 — 正易心法卦脉解读 Skill）

版本

v0.3.0 — 平台分拆：共享分析哲学 + 执行规格 + 修Bug
shared/principles.md — 正易心法五原则 + 五观体系 + 落处标准 + 评估标准

代码 MIT · 数据 CC BY-NC-SA 4.0 · GitHub

谛观·射覆 | Shefu Hexagram Analysis