帮用户调用 API 起卦、解卦,并按场景格式化输出。
================================================================================
> 首次使用需先在下方「配置」章节填好 API_KEY 和 RENDER_STYLE。配置完成后即可开始使用。
以下两个变量需要配置。Agent 读取本节时:
占位符 → 说明用户未配置,一定要引导用户配置。https://wenmutang.top → 微信扫码进入小程序 →「我的」页面复制图文(推荐)—— 看图片 + 普通文字,适合网页、小程序、App、QoderWork、悟空等艺术字 —— 看 ASCII 字符画,仅适合命令行(Claude Code、终端)================================================================================
用户只丢一句"帮我算一卦""测一下"这种过于空泛的请求时,先不要直接调 API——易经断事讲究"因事而占",上下文越具体卦象解读越准。先用一两句友好的话引导用户补点信息再起卦,例如:
> "好的,为了让卦象更有针对性,能简单说下想问的是什么事吗?比如——
> • 事项(感情 / 工作 / 财运 / 健康 / 出行 / 考试……)
> • 当下状况(正在发生什么、卡在哪、纠结什么选项)
> • 想问的具体问题(能不能成 / 该不该去 / 何时见分晓)
> 有其中一两点就够了,越具体越好。"
如果用户已经自己讲清楚了背景(即使只有一两句),就别再追问,直接把用户原话作为 message 发过去即可。避免问得过细让用户觉得繁琐,也避免在完全没上下文时硬起卦导致解读空泛。
POST https://wenmutang.top/api/skill/chatX-API-Key: {API_KEY}(取自上方「配置」章节){"message": "用户的消息", "conversationId": "会话ID(可选)"}--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 值,判断渲染风格:
图文 或 (未配置,视为默认)→ 执行「分支 A」艺术字 → 执行「分支 B」RENDER_STYLE = 图文(默认,适配网页/小程序/手机 App/客户端/QoderWork、悟空等应用)直接把 API 返回的 reply 原样输出,让前端自己渲染 Markdown。具体规则:
!... 语法:卦象图、断易天机图、评级图都保留,由前端渲染为图片。reply 原貌,不改写文字。reply 里没有分隔符,可以轻度加一些 --- 水平线分节,但不要替换为 ASCII 符号。reply 已含评级段落。简单说:图文风格 = 把 reply 透传给用户,minimal intervention。
RENDER_STYLE = 艺术字(适配 Claude Code / 终端 / 命令行)用下方 ASCII 模板包装输出,步骤:
attachments:有 type:"zhi" 双卦并列;否则单卦居中) ═════════════════════════════════════════════════════════════════════════════════
reply 文末关键词"大吉/吉/平(无咎)/小凶/凶"选对应一档)reply 中的 !... 图片语法替换为可点击链接,规则如下:以下 ASCII 模板仅在 RENDER_STYLE = 艺术字 时使用,图文模式请完全忽略。
卦象 ASCII · 有变爻(双卦并列):
╔══════════════════════════════════════════════════════════════════════════════════╗
║ ║
║ 【 乾 为 天 → 火 天 大 有 】 ║
║ ║
║ 第 一 卦 变 第 十 四 卦 ║
║ ║
║ ┌─────────────────────────────────┐ ┌─────────────────────────────────┐
║ │ │ │ │
║ │ 本 卦 │ → │ 变 卦 │
║ │ │ │ │
║ │ 上爻 ████████████████████ │ 阳 │ 上爻 ████████████████████ │ 阳
║ │ │ │ │
║ │ 五爻 ████████████████████ │ 阳 ●│ 五爻 ████████ ████████ │ 阴
║ │ 阳 → 阴 │ │ ↓ 变 │
║ │ │ │ │
║ │ 四爻 ████████████████████ │ 阳 │ 四爻 ████████████████████ │ 阳
║ │ │ │ │
║ │ 三爻 ████████████████████ │ 阳 │ 三爻 ████████████████████ │ 阳
║ │ │ │ │
║ │ 二爻 ████████████████████ │ 阳 │ 二爻 ████████████████████ │ 阳
║ │ │ │ │
║ │ 初爻 ████████████████████ │ 阳 │ 初爻 ████████████████████ │ 阳
║ │ │ │ │
║ └─────────────────────────────────┘ └─────────────────────────────────┘
║ ║
║ 上卦:乾为天 ☰ 上卦:离为火 ☲ ║
║ 下卦:乾为天 ☰ 下卦:乾为天 ☰ ║
║ ║
║ ● 阳变阴 ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════════╝
卦象 ASCII · 无变爻(单卦居中):
╔══════════════════════════════════════════════════════════════════════════════════╗
║ ║
║ 【 乾 为 天 】 ║
║ ║
║ 第 一 卦 ║
║ ║
║ ┌─────────────────────────────────┐ ║
║ │ │ ║
║ │ 本 卦 │ ║
║ │ │ ║
║ │ 上爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 五爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 四爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 三爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 二爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ │ 初爻 ████████████████████ │ 阳 ║
║ │ │ ║
║ └─────────────────────────────────┘ ║
║ ║
║ 上卦:乾为天 ☰ ║
║ 下卦:乾为天 ☰ ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════════╝
绘制要点:阳爻 ████████████████████,阴爻 ████████ ████████(中间断开);变爻在本卦对应爻后标 ●(阳变阴)或 ○(阴变阳)。
评级 ASCII · 五档(选一放在最底部,不可退化为单行):
大吉:
╔══════════════════════════════════════════════════════════════════════╗
║ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ ★ │ 大 吉 │ ★ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 鸿 运 当 头 · 万 事 亨 通 】═══════ ║
║ ║
║ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ║
╚══════════════════════════════════════════════════════════════════════╝
吉:
╔══════════════════════════════════════════════════════════════════════╗
║ ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ │ 吉 │ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 顺 遂 安 康 · 诸 事 可 为 】═══════ ║
║ ║
║ ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ ║
╚══════════════════════════════════════════════════════════════════════╝
平(无咎):
╔══════════════════════════════════════════════════════════════════════╗
║ ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ │ 平 ( 无 咎 ) │ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 持 中 守 正 · 不 进 不 退 】═══════ ║
║ ║
║ ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ ║
╚══════════════════════════════════════════════════════════════════════╝
小凶:
╔══════════════════════════════════════════════════════════════════════╗
║ △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ △ │ 小 凶 │ △ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 小 有 阻 滞 · 宜 慎 勿 躁 】═══════ ║
║ ║
║ △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ ║
╚══════════════════════════════════════════════════════════════════════╝
凶:
╔══════════════════════════════════════════════════════════════════════╗
║ ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ ║
║ ║
║ ┌───────────────────────┐ ║
║ │ │ ║
║ ✕ │ 凶 │ ✕ ║
║ │ │ ║
║ └───────────────────────┘ ║
║ ║
║ ═══════【 大 凶 之 兆 · 宜 止 勿 行 】═══════ ║
║ ║
║ ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ ║
╚══════════════════════════════════════════════════════════════════════╝
共 1 个版本