易经占卜大师
帮用户调用 API 起卦、解卦,并按场景格式化输出。
================================================================================
首次使用需先在下方「配置」章节填好 API_KEY 和 RENDER_STYLE。配置完成后即可开始使用。
配置
以下两个变量需要配置。Agent 读取本节时:
- 若值仍为
<YOUR_...> 占位符 → 说明用户未配置,一定要引导用户配置。
- 若值已填 → 说明已配置,直接使用
配置项
起卦前引导
用户只丢一句"帮我算一卦""测一下"这种过于空泛的请求时,先不要直接调 API——易经断事讲究"因事而占",上下文越具体卦象解读越准。先用一两句友好的话引导用户补点信息再起卦,例如:
"好的,为了让卦象更有针对性,能简单说下想问的是什么事吗?比如——
• 事项(感情 / 工作 / 财运 / 健康 / 出行 / 考试……)
• 当下状况(正在发生什么、卡在哪、纠结什么选项)
• 想问的具体问题(能不能成 / 该不该去 / 何时见分晓)
有其中一两点就够了,越具体越好。"
如果用户已经自己讲清楚了背景(即使只有一两句),就别再追问,直接把用户原话作为 message 发过去即可。避免问得过细让用户觉得繁琐,也避免在完全没上下文时硬起卦导致解读空泛。
API
- 接口:
POST https://wenmutang.top/api/skill/chat
- Header:
X-API-Key: {API_KEY}(取自上方「配置」章节)
- Body:
{"message": "用户的消息", "conversationId": "会话ID(可选)"}
- 超时:后端是 agent 查询,响应时间通常 60-120 秒。调用时 不要设置 curl
--max-time,Bash tool 的 timeout 设为 180000(3 分钟留余量)。若使用其他 HTTP 工具,同样确保超时 ≥ 180 秒。
- 不要改写用户的消息
会话规则
默认不传 conversationId,开启新会话(避免多轮上下文占用 Token、积分)。
仅当用户明确说"继续"、"再算一卦"、"接着上次"等延续语时,才传入上一轮返回的 conversationId。
响应结构
API 返回 reply(Markdown 正文)+ attachments(卦象元数据)。
attachments 示例:
{
"attachments": [
{ "type": "ben", "guaName": "火天大有", "guaId": "111101", "guaOrder": 14, "bianyaoOrder": [1, 5], "yaoList": [true, true, true, true, false, true] },
{ "type": "zhi", "guaName": "天风姤", "guaId": "011110", "guaOrder": 44, "yaoList": [false, true, true, true, true, false] }
]
}
| 字段 | 说明 |
|---|
| type | ben=本卦,zhi=变卦 |
| guaName | 卦名 |
| guaId | 6 位二进制,从左→右 = 从下→上,1=阳 0=阴 |
| guaOrder | 卦序 |
| bianyaoOrder | 变爻位置(1-6,仅本卦有) |
| yaoList | 从下到上爻列表,true=阳 false=阴 |
输出规则
API 返回的 reply 是 agent 输出的标准 Markdown,含五个段落:卦象总览、一语中的、因事而解、行止之策、总结与评级,以及 卦图 / 断易天机图 / 评级图 三类图片 URL。
第一步:读取「配置」章节的 RENDER_STYLE 值,判断渲染风格:
图文 或 <YOUR_RENDER_STYLE>(未配置,视为默认)→ 执行「分支 A」
艺术字 → 执行「分支 B」
分支 A:RENDER_STYLE = 图文(默认,适配网页/小程序/手机 App/客户端/QoderWork、悟空等应用)
直接把 API 返回的 reply 原样输出,让前端自己渲染 Markdown。具体规则:
- 不加 ASCII 卦象大框、ASCII 评级大框、ASCII 分割线等任何字符画装饰,避免在非等宽字体环境里错位变丑。
- 图片保留
 语法:卦象图、断易天机图、评级图都保留,由前端渲染为图片。
- 段落结构、加粗、列表等保持
reply 原貌,不改写文字。
- 如果
reply 里没有分隔符,可以轻度加一些 --- 水平线分节,但不要替换为 ASCII 符号。
- 最后不要再附加任何由你自己生成的评级框或总结——
reply 已含评级段落。
简单说:图文风格 = 把 reply 透传给用户,minimal intervention。
分支 B:RENDER_STYLE = 艺术字(适配 Claude Code / 终端 / 命令行)
用下方 ASCII 模板包装输出,步骤:
- 顶部:用 ASCII 绘制卦象图(根据
attachments:有 type:"zhi" 双卦并列;否则单卦居中)
- 中部:原样保留五段文字(卦象总览 → 一语中的 → 因事而解 → 行止之策 → 总结与评级),段落之间用分割线:
═════════════════════════════════════════════════════════════════════════════════
- 底部:用 ASCII 评级大框(按
reply 文末关键词"大吉/吉/平(无咎)/小凶/凶"选对应一档)
- 图片处理:将
reply 中的  图片语法替换为可点击链接,规则如下:
- 卦象图 →
[🖼 查看卦象图](url)
- 断易天机图 →
[🖼 查看断易天机图](url)
- 评级图直接删除(已有 ASCII 评级框,不重复展示)
- 断易天机段落中的文字描述(如"梯上官人:棺也")保留
以下 ASCII 模板仅在 RENDER_STYLE = 艺术字 时使用,图文模式请完全忽略。
卦象 ASCII · 有变爻(双卦并列):
╔══════════════════════════════════════════════════════════════════════════════════╗
║ ║
║ 【 乾 为 天 → 火 天 大 有 】 ║
║ ║
║ 第 一 卦 变 第 十 四 卦 ║
║ ║
║ ┌─────────────────────────────────┐ ┌─────────────────────────────────┐
║ │ │ │ │
║ │ 本 卦 │ → │ 变 卦 │
║ │ │ │ │
║ │ 上爻 ████████████████████ │ 阳 │ 上爻 ████████████████████ │ 阳
║ │ │ │ │
║ │ 五爻 ████████████████████ │ 阳 ●│ 五爻 ████████ ████████ │ 阴
║ │ 阳 → 阴 │ │ ↓ 变 │
║ │ │ │ │
║ │ 四爻 ████████████████████ │ 阳 │ 四爻 ████████████████████ │ 阳
║ │ │ │ │
║ │ 三爻 ████████████████████ │ 阳 │ 三爻 ████████████████████ │ 阳
║ │ │ │ │
║ │ 二爻 ████████████████████ │ 阳 │ 二爻 ████████████████████ │ 阳
║ │ │ │ │
║ │ 初爻 ████████████████████ │ 阳 │ 初爻 ████████████████████ │ 阳
║ │ │ │ │
║ └─────────────────────────────────┘ └─────────────────────────────────┘
║ ║
║ 上卦:乾为天 ☰ 上卦:离为火 ☲ ║
║ 下卦:乾为天 ☰ 下卦:乾为天 ☰ ║
║ ║
║ ● 阳变阴 ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════════╝
卦象 ASCII · 无变爻(单卦居中):
╔══════════════════════════════════════════════════════════════════════════════════╗
║ ║
║ 【 乾 为 天 】 ║
║ ║
║ 第 一 卦 ║
║ ║
║ ┌─────────────────────────────────┐ ║
║ │ │ ║
║ │ 本 卦 │ ║
║ │ │ ║
║ │ 上爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 五爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 四爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 三爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 二爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 初爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ └─────────────────────────────────┘ ║
║ ║
║ 上卦:乾为天 ☰ ║
║ 下卦:乾为天 ☰ ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════════╝
绘制要点:阳爻 ████████████████████,阴爻 ████████ ████████(中间断开);变爻在本卦对应爻后标 ●(阳变阴)或 ○(阴变阳)。
评级 ASCII · 五档(选一放在最底部,不可退化为单行):
大吉:
╔══════════════════════════════════════════════════════════════════════╗
║ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ ★ │ 大 吉 │ ★ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 鸿 运 当 头 · 万 事 亨 通 】═══════ ║
║ ║
║ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ║
╚══════════════════════════════════════════════════════════════════════╝
吉:
╔══════════════════════════════════════════════════════════════════════╗
║ ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ │ 吉 │ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 顺 遂 安 康 · 诸 事 可 为 】═══════ ║
║ ║
║ ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ ║
╚══════════════════════════════════════════════════════════════════════╝
平(无咎):
╔══════════════════════════════════════════════════════════════════════╗
║ ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ │ 平 ( 无 咎 ) │ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 持 中 守 正 · 不 进 不 退 】═══════ ║
║ ║
║ ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ ║
╚══════════════════════════════════════════════════════════════════════╝
小凶:
╔══════════════════════════════════════════════════════════════════════╗
║ △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ △ │ 小 凶 │ △ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 小 有 阻 滞 · 宜 慎 勿 躁 】═══════ ║
║ ║
║ △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ ║
╚══════════════════════════════════════════════════════════════════════╝
凶:
╔══════════════════════════════════════════════════════════════════════╗
║ ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ ✕ │ 凶 │ ✕ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 大 凶 之 兆 · 宜 止 勿 行 】═══════ ║
║ ║
║ ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ ║
╚══════════════════════════════════════════════════════════════════════╝