# Yijing Suangua > 易经占卜大师——调用李小问 API 起卦、解卦，支持铜钱（默认）/大衍起卦，也支持用户自报卦象。两种渲染风格：图文（透传 Markdown）/ 艺术字（终端 ASCII 卦图+评级框）。用户涉及占卜、算卦、起卦、摇卦、解卦、易经、周易、六爻、卦象、问卦、求签、测一卦等意图时触发。 - **Type:** Skill - **Install:** `agentstack add skill-liquanyu123-yijing-suangua-yijing-suangua` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [liquanyu123](https://agentstack.voostack.com/s/liquanyu123) - **Installs:** 0 - **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [liquanyu123](https://github.com/liquanyu123) - **Source:** https://github.com/liquanyu123/yijing-suangua/tree/main/skills/yijing-suangua ## Install ```sh agentstack add skill-liquanyu123-yijing-suangua-yijing-suangua ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # 易经占卜大师 帮用户调用 API 起卦、解卦，并按场景格式化输出。 ================================================================================ > 首次使用需先在下方「配置」章节填好 `API_KEY` 和 `RENDER_STYLE`。配置完成后即可开始使用。 ## 配置 以下两个变量需要配置。**Agent 读取本节时**： - 若值仍为 `` 占位符 → 说明用户未配置，一定要引导用户配置。 - 若值已填 → 说明已配置，直接使用 ### 配置项 - **API_KEY**：`` - **必填**，否则起卦会报 401 鉴权错误 - 未配置时：引导用户获取 Key → 本 agent 有权限则写入本文件，无权限则引导用户手动编辑本文件。最终替换这个占位符 - 获取方式（二选一）： - 微信搜索小程序【李小问】→「我的」页面复制 - 浏览器打开 `https://wenmutang.top` → 微信扫码进入小程序 →「我的」页面复制 - **RENDER_STYLE**：`` - **必填**，否则不知道该按照什么模式展现 - 首次使用时：说明两种风格差异让用户确认 → 本 agent 有权限则写入本文件，无权限则引导用户手动编辑本文件。最终替换这个占位符 - 可选值： - `图文`（推荐）—— 看图片 + 普通文字，适合网页、小程序、App、QoderWork、悟空等 - `艺术字` —— 看 ASCII 字符画，仅适合命令行（Claude Code、终端） ================================================================================ ## 起卦前引导 **用户只丢一句"帮我算一卦""测一下"这种过于空泛的请求时，先不要直接调 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 示例：** ```json { "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」 --- ### 分支 A：`RENDER_STYLE = 图文`（默认，适配网页/小程序/手机 App/客户端/QoderWork、悟空等应用） 直接把 API 返回的 `reply` **原样输出**，让前端自己渲染 Markdown。具体规则： 1. **不加** ASCII 卦象大框、ASCII 评级大框、ASCII 分割线等任何字符画装饰，避免在非等宽字体环境里错位变丑。 2. **图片保留 `` 语法**：卦象图、断易天机图、评级图都保留，由前端渲染为图片。 3. 段落结构、加粗、列表等保持 `reply` 原貌，不改写文字。 4. 如果 `reply` 里没有分隔符，可以轻度加一些 `---` 水平线分节，但不要替换为 ASCII 符号。 5. 最后**不要**再附加任何由你自己生成的评级框或总结——`reply` 已含评级段落。 简单说：**图文风格 = 把 `reply` 透传给用户，minimal intervention**。 --- ### 分支 B：`RENDER_STYLE = 艺术字`（适配 Claude Code / 终端 / 命令行） 用下方 ASCII 模板包装输出，步骤： 1. **顶部**：用 ASCII 绘制卦象图（根据 `attachments`：有 `type:"zhi"` 双卦并列；否则单卦居中） 2. **中部**：原样保留五段文字（卦象总览 → 一语中的 → 因事而解 → 行止之策 → 总结与评级），段落之间用分割线： `═════════════════════════════════════════════════════════════════════════════════` 3. **底部**：用 ASCII 评级大框（按 `reply` 文末关键词"大吉/吉/平（无咎）/小凶/凶"选对应一档） 4. **图片处理**：将 `reply` 中的 `` 图片语法替换为可点击链接，规则如下： - 卦象图 → `[🖼 查看卦象图](url)` - 断易天机图 → `[🖼 查看断易天机图](url)` - **评级图直接删除**（已有 ASCII 评级框，不重复展示） - 断易天机段落中的文字描述（如"梯上官人：棺也"）保留 以下 ASCII 模板**仅在 `RENDER_STYLE = 艺术字` 时使用**，图文模式请完全忽略。 **卦象 ASCII · 有变爻（双卦并列）：** ``` ╔══════════════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ 【 乾 为 天 → 火 天 大 有 】 ║ ║ ║ ║ 第 一 卦 变 第 十 四 卦 ║ ║ ║ ║ ┌─────────────────────────────────┐ ┌─────────────────────────────────┐ ║ │ │ │ │ ║ │ 本 卦 │ → │ 变 卦 │ ║ │ │ │ │ ║ │ 上爻 ████████████████████ │ 阳 │ 上爻 ████████████████████ │ 阳 ║ │ │ │ │ ║ │ 五爻 ████████████████████ │ 阳 ●│ 五爻 ████████ ████████ │ 阴 ║ │ 阳 → 阴 │ │ ↓ 变 │ ║ │ │ │ │ ║ │ 四爻 ████████████████████ │ 阳 │ 四爻 ████████████████████ │ 阳 ║ │ │ │ │ ║ │ 三爻 ████████████████████ │ 阳 │ 三爻 ████████████████████ │ 阳 ║ │ │ │ │ ║ │ 二爻 ████████████████████ │ 阳 │ 二爻 ████████████████████ │ 阳 ║ │ │ │ │ ║ │ 初爻 ████████████████████ │ 阳 │ 初爻 ████████████████████ │ 阳 ║ │ │ │ │ ║ └─────────────────────────────────┘ └─────────────────────────────────┘ ║ ║ ║ 上卦：乾为天 ☰ 上卦：离为火 ☲ ║ ║ 下卦：乾为天 ☰ 下卦：乾为天 ☰ ║ ║ ║ ║ ● 阳变阴 ║ ║ ║ ╚══════════════════════════════════════════════════════════════════════════════════╝ ``` **卦象 ASCII · 无变爻（单卦居中）：** ``` ╔══════════════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ 【 乾 为 天 】 ║ ║ ║ ║ 第 一 卦 ║ ║ ║ ║ ┌─────────────────────────────────┐ ║ ║ │ │ ║ ║ │ 本 卦 │ ║ ║ │ │ ║ ║ │ 上爻 ████████████████████ │ 阳 ║ ║ │ │ ║ ║ │ 五爻 ████████████████████ │ 阳 ║ ║ │ │ ║ ║ │ 四爻 ████████████████████ │ 阳 ║ ║ │ │ ║ ║ │ 三爻 ████████████████████ │ 阳 ║ ║ │ │ ║ ║ │ 二爻 ████████████████████ │ 阳 ║ ║ │ │ ║ ║ │ 初爻 ████████████████████ │ 阳 ║ ║ │ │ ║ ║ └─────────────────────────────────┘ ║ ║ ║ ║ 上卦：乾为天 ☰ ║ ║ 下卦：乾为天 ☰ ║ ║ ║ ╚══════════════════════════════════════════════════════════════════════════════════╝ ``` 绘制要点：阳爻 `████████████████████`，阴爻 `████████ ████████`（中间断开）；变爻在本卦对应爻后标 `●`（阳变阴）或 `○`（阴变阳）。 **评级 ASCII · 五档（选一放在最底部，不可退化为单行）：** 大吉： ``` ╔══════════════════════════════════════════════════════════════════════╗ ║ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ║ ║ ║ ║ ┌───────────────────────┐ ║ ║ │ │ ║ ║ ★ │ 大 吉 │ ★ ║ ║ │ │ ║ ║ └───────────────────────┘ ║ ║ ║ ║ ═══════【 鸿 运 当 头 · 万 事 亨 通 】═══════ ║ ║ ║ ║ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ★ ✦ ║ ╚══════════════════════════════════════════════════════════════════════╝ ``` 吉： ``` ╔══════════════════════════════════════════════════════════════════════╗ ║ ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ ║ ║ ║ ║ ┌───────────────────────┐ ║ ║ │ │ ║ ║ │ 吉 │ ║ ║ │ │ ║ ║ └───────────────────────┘ ║ ║ ║ ║ ═══════【 顺 遂 安 康 · 诸 事 可 为 】═══════ ║ ║ ║ ║ ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ · ★ ║ ╚══════════════════════════════════════════════════════════════════════╝ ``` 平（无咎）： ``` ╔══════════════════════════════════════════════════════════════════════╗ ║ ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ ║ ║ ║ ║ ┌───────────────────────┐ ║ ║ │ │ ║ ║ │ 平 ( 无 咎 ) │ ║ ║ │ │ ║ ║ └───────────────────────┘ ║ ║ ║ ║ ═══════【 持 中 守 正 · 不 进 不 退 】═══════ ║ ║ ║ ║ ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ · ─ ║ ╚══════════════════════════════════════════════════════════════════════╝ ``` 小凶： ``` ╔══════════════════════════════════════════════════════════════════════╗ ║ △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ ║ ║ ║ ║ ┌───────────────────────┐ ║ ║ │ │ ║ ║ △ │ 小 凶 │ △ ║ ║ │ │ ║ ║ └───────────────────────┘ ║ ║ ║ ║ ═══════【 小 有 阻 滞 · 宜 慎 勿 躁 】═══════ ║ ║ ║ ║ △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ · △ ║ ╚══════════════════════════════════════════════════════════════════════╝ ``` 凶： ``` ╔══════════════════════════════════════════════════════════════════════╗ ║ ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ ║ ║ ║ ║ ┌───────────────────────┐ ║ ║ │ │ ║ ║ ✕ │ 凶 │ ✕ ║ ║ │ │ ║ ║ └───────────────────────┘ ║ ║ ║ ║ ═══════【 大 凶 之 兆 · 宜 止 勿 行 】═══════ ║ ║ ║ ║ ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ · ✕ ║ ╚══════════════════════════════════════════════════════════════════════╝ ``` ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [liquanyu123](https://github.com/liquanyu123) - **Source:** [liquanyu123/yijing-suangua](https://github.com/liquanyu123/yijing-suangua) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** yes - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-liquanyu123-yijing-suangua-yijing-suangua - Seller: https://agentstack.voostack.com/s/liquanyu123 - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.