射覆 · 中国古代猜物游戏
> 「谛观」出品 · 分析哲学见 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 是画师不是鉴定师：刻画特征画像，判断权始终在你手中。
安全免责声明 ⚠️
> 本技能的全部输出（包括但不限于卦象解读、特征画像、态势推演）仅为文化参考与思维启发，不是确定性结论。不得将其作为医疗、财务、法律、投资、健康或其他专业决策的依据。如需专业服务，请咨询持牌专业人士。
>
> 使用者承诺：
> 1. 理解本技能的输出具有解释性和推测性
> 2. 不会基于输出做出不可逆的高风险决策
> 3. 在涉及健康、财务、法律等场景时，优先咨询专业人士
> 4. 触发词仅限于明确的占卜/射覆意图，不会在日常对话中意外激活
📖 正易心法 — 谛观射覆的理论根基
本技能不是凭空编造的游戏规则，它的每一个分析步骤都有
深厚的易学经典依据。
方法论根基
核心经典：麻衣道者《正易心法》42章·陈抟注（五代宋初·约公元10世纪）
历史地位：这部著作超越了汉唐以来以卦辞爻辞文字解卦的
传统，直接回归到文王、周公、孔子研究卦象的
原始路径——从卦画结构本身读取意义。
邵雍创作《皇极经世》，其核心思想即源于此。
当代评价：当代学者从事易学研究，《正易心法》不可不读。
理法合一
正易心法（理）——告诉你卦象为什么这样走
↓ 理论指导实践
谛观射覆（法）——让你亲手操作每个推演步骤
↓ 实践验证理论
每一次射覆 = 一次正易心法的完整实验
延伸阅读
「谛观」公众号持续发布《正易心法》系列解读文章，
逐章阐释卦脉分析原理：
- 中文：微信公众号「谛观」/ 知乎专栏
- English：Medium @ 谛观
推荐从「导读」篇开始阅读。
技能获取
本技能在各平台的名称为：
- 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
