Dowsing

失物占 — Dowsing

梅花易数失物占专用系统。用确定性脚本起卦，输出结构化搜寻报告。

定位：结构化搜索启发器，用于打破搜寻盲区。仅供参考，不作绝对预言。

何时使用

• 用户说东西丢了、找不到、不见了
• 用户的宠物（猫/狗）走失，需判断去向
• 用户请求失物占、寻物、找东西
• 触发词：失物、丢了、找不到、失物占、找东西、走失、宠物、lost item、dowsing

核心理念

• 体卦 = 失主（问卦者）
• 用卦 = 失物（所找之物 / 走失的宠物）
• 方位优先：用卦后天方位是跨语境最稳定的线索，以失物最后出现的位置为原点
• 用卦类象（依语境取象） = 具体搜索场景
• 变卦 = 是否移动、第二搜索区（两卦方位可组合，如离南+兑西=西南，引擎自动输出 combined_direction）
• 互卦 = 中间经过处（上下两卦各自提供方向线索）
• 体用生克 = 能否找回 + 远近 / 宠物是否自归

用户引导

带具体失物时（必读）

当用户说「我的 XX 丢了」时，先确认失物名称，再确认失物语境（不可默认在家），最后询问起卦方式：

你想找「{物品名}」。
请问它大概在什么场景丢失？
A. 居家（home）        B. 公共场所/户外（public，如图书馆/商场/街道）
C. 交通工具（transit，如飞机/大巴/火车）   D. 走失的宠物（pet）

起卦方式：
1. 时间卦 — 以当前时间起卦（最常用）
2. 数字卦 — 请报 2～3 个数字（心里默想的数字即可）

关键：语境决定取象。在公共场所丢失却用居家场景（洗衣机、床底）会误导用户。若用户未明说，根据描述推断语境；实在无法判断时用 general。

不要在用户未选择时直接用时间起卦。

首次使用（无具体物品）

简要介绍功能（含「也能帮找走失的宠物」），引导用户说明丢了什么、在哪丢的，再问起卦方式。

起卦流程（必须调用脚本）

所有起卦计算必须由脚本完成，不可手算或猜测。

通过 --context 传入语境：home / public / transit / pet / general（默认）。

# 当前时间
python scripts/shiwu_calc.py time --item {物品名} --context {语境}

# 公历时间
python scripts/shiwu_calc.py gregorian Y M D H --item {物品名} --context {语境}

# 农历时间
python scripts/shiwu_calc.py lunar Y M D H --item {物品名} --context {语境}

# 数字卦（2 个数：第三数可选为动爻；无第三数则用两数之和定动爻）
python scripts/shiwu_calc.py num N1 N2 [N3] --item {物品名} --context {语境}

示例：

python scripts/shiwu_calc.py time --item 充电线 --context public
python scripts/shiwu_calc.py time --item 猫 --context pet

脚本输出 JSON SearchReport。读取 JSON 后，结合 references/ 补充定性解读，渲染为用户可读的搜寻报告。

若无法执行 Python，明确告知用户并请其在本地运行上述命令，将 JSON 贴回。

解卦步骤

1. 确认语境 → 居家/公共/交通/宠物（决定取象）
2. 运行脚本（带 --context） → 获取 SearchReport JSON
3. 先报方位 → primary_direction 是首要线索，提醒以失物最后出现处为原点
4. 读用卦类象 → references/bagua-shiwu.md 对应语境补充场景
5. 判体用生克 → references/tiyong-shiwu.md 解读能否找回 / 宠物是否自归
6. 看变卦 / 互卦 → 是否移动、第二搜索区。 变卦和互卦均由上下两卦组成，除用卦那一半的方位外， 还应关注另一半的方位——paired_direction 字段提供配对方向， combined_direction 字段在可合成复合方向时自动输出 （如变卦离上兑下 → 离南+兑西=西南坤方）。
7. 输出搜寻报告（格式见下）
8. 必出【下一步】 行动建议
9. 提示回填：是否找到？在哪找到？

搜寻报告模板（必须完整输出）

【失物占 · 搜寻报告】

失物：{物品名}　语境：{居家/公共场所/交通工具/走失生物}
本卦：{卦名}（第 {动爻} 爻动）

── 首要线索：方位 ──
主方向：{primary_direction}（以失物最后出现的位置为原点）

── 能否找回 ──
倾向：{易得/可得/难寻/难得}
理由：{体用生克说明}

── 优先搜索区 ──
1. {方位} · {场景1、场景2、场景3}（{范围说明}）
2. {方位} · {场景...}（若变卦两卦合参有复合方向：{combined_direction}）
3. {互卦路径，若有；互卦的 paired_direction 另半方位也应留意}

── 移动判断 ──
{moved 字段内容}

── 体用 ──
体：{体卦}（失主）
用：{用卦}（失物/宠物）
关系：{生克}

【下一步】
{action_advice 原文，或改写为更具体的 1～2 句行动指令}

---
{disclaimer}
找到后请告诉我：是否找到？在哪个具体位置找到的？（帮助改进搜寻建议）

参考资料路由

断卦原则

1. 理大于象：结合语境取象。同一用卦在居家/公共/交通/宠物语境下场景不同，不可一律用居家场景
2. 方位优先：用卦后天方位是跨语境最稳定的线索，以失物最后出现处为原点，先报方位再说场景
3. 措辞谦逊：用「倾向」「可能」「建议先查」，不用「一定」「绝对」
4. 不作应期：MVP 不推断时间，勿编造「几天后找到」
5. 策略必出：每次必须给出【下一步】具体该往哪个方向找

伦理准则

• 吉凶并陈，不偏颇
• 不预测死亡、极端不幸
• 不替代报警（贵重物品建议同时报警）
• 强调参考性质，鼓励用户结合实际情况
• 心理脆弱者格外强调「搜索启发」定位

经典案例

金手链丢失，用卦坎（水象）→ 提示近水处 → 在洗衣机找到。详见 references/cases.md。

「穷则变，变则通，通则久。」失物占的真谛：指引你去还没找过的地方，而非预定命运。