把你的 AI 助手（Claude、Qoder、Cursor 等）接上周易测算能力。全文以演示账号 jiuchongju001 为例，走完「注册 → 创建 API-KEY → 导出 Skill 包 → 在 Agent 中使用」的完整链路。
一周易大师 Skill 是什么
周易大师开放平台把 47 项周易数术能力（八字测算、七种排盘、运势流年、抽签解梦、配对合婚、民俗预测等，编号 F1–F47）对外开放，提供三种接入方式：
| 接入方式 | 适合谁 | 产物 |
|---|---|---|
| Skill 包 | 想让 AI 助手”会说周易”的用户 | zhouyi-master-skill.zip，解压即用 |
| MCP 服务 | 使用支持 MCP 协议客户端的开发者 | zhouyi-mcp-config.json 配置 |
| 开放 API | 自建系统的开发者 | HTTPS 接口（/api/open/**） |
三种方式共用同一个 API-KEY 与每日额度（默认 500 次/日，Skill 与 MCP 合并计数），计量口径完全一致。本指南聚焦最常用的 Skill 包 路线。
二第一步：注册账号（以 jiuchongju001 为例）
- 用电脑浏览器打开官网 https://iching.jiuchongju.com；
- 点击右上角 「注册」，进入注册页（
/#/user/register）； - 按下表填写并提交；
- 提交成功后自动跳转到个人中心（
/#/user/center），注册完成。
| 字段 | 示例值 | 说明 |
|---|---|---|
| 用户名 | jiuchongju001 |
3–50 个字符，登录与展示用 |
| 密码 | （自设强密码） | 建议字母+数字+符号组合 |
| 确认密码 | 与密码一致 | 二次校验 |
| 生日 | 如 1990-01-01 | 命理计算的默认个人信息 |
| 出生时间 | 如 08:30 | 时辰影响排盘结果 |
| 性别 | 男 / 女 | 部分测算区分性别 |
三第二步：创建 API-KEY
API-KEY 是你调用所有开放能力的”钥匙”，以 sk-zhouyi- 开头。
- 登录后，在侧边栏或顶部菜单的 「开放平台」 分组中点击 「API-KEY 管理」；也可直接访问 iching.jiuchongju.com/#/user/openapi/keys；
- 点击蓝色按钮 「+ 创建 API-KEY」；
- 弹窗显示 「API-KEY 创建成功」，其中密钥为完整明文（如
sk-zhouyi-V8LsizYyqUmB82rQTUcXNPXjFUHWat7Y），掩码为列表长期展示形式（如sk-zho****at7Y）； - 立即点击「复制密钥」并妥善保存，然后点「我已保存」关闭弹窗。
创建成功后，列表会出现一行记录，包含：API-KEY（掩码）、创建时间、当前每日限额（默认 500 次）、额度有效期、状态（正常）。
四（可选）申请提升每日额度
默认每个 KEY 每日 500 次调用。若不够用：
- 在 API-KEY 管理页，对应行点击 「申请提升每日额度」；
- 在弹窗中填写期望额度与理由，提交；
- 系统返回申请编号（如「申请编号为「QD…」，联系管理员付费后开通」）；
- 凭申请编号联系管理员完成付费开通，额度实时生效。
五第三步：导出 Skill 包
- 在 API-KEY 管理页，对应 KEY 行点击 「导出 Skill」；
- 浏览器自动下载
zhouyi-master-skill.zip； - 该包与你的 API-KEY 一一绑定：包内配置已注入你的密钥，无需手动填写；
- 每次导出都会在后台生成一条导出记录（可在管理端按用户 / KEY / 日期查询），便于追溯。
六第四步：安装并使用 Skill 包
解压 zhouyi-master-skill.zip，得到顶层目录 zhouyi-master-skill/，结构大致为：
zhouyi-master-skill/
├── SKILL.md # 技能说明（含 YAML frontmatter，已注入你的账号与 KEY）
├── config.yaml # 账户与密钥配置（已填好，无需改）
├── scripts/ # 调用脚本（CLI 子命令覆盖 47 项能力）
└── ... # 渲染模板、说明文档等放入你的 Agent 平台技能目录：
- Claude Desktop / Claude Code：放入其 skills / plugins 目录；
- Qoder：放入工作区
.qoder/skills/； - Cursor、ClawHub 等：按各自技能加载规范放置。
在对话中直接下达命理任务，Agent 会自动调用 Skill：
你：帮我用八字看看 1990 年 1 月 1 日 8 点半、男、出生地杭州的运势。
Agent：（调用 zhouyi_bazi_fortune）……返回排盘与解读，并附可视化结果页。
每次调用消耗每日额度；成功响应会附「今日额度：已用 X/500」。
七（可选）改用 MCP 接入
若你的客户端支持 MCP 协议（Claude Desktop、Qoder、Cursor、阿里云百炼等），可免本地部署、直连云端：
- 在 API-KEY 管理页，对应行点击 「导出 MCP 配置」，下载
zhouyi-mcp-config.json； - 将该文件导入客户端的 MCP 配置；或手动配置云端端点（见下）；
- 配置完成后，客户端即获得 34 个
zhouyi_*工具，能力与 Skill 包等价。
{
"mcpServers": {
"zhouyi-master": {
"type": "streamableHttp",
"url": "https://api.iching.jiuchongju.com/mcp",
"headers": { "X-API-Key": "sk-zhouyi-你的KEY" }
}
}
}八查看用量、调用记录与 API 文档
- 用量与状态：API-KEY 管理页列表直接展示「当前每日限额 / 额度有效期 / 状态」；
- 调用分析：用户中心「开放平台」分组内的调用分析页，可查看近期调用明细；
- API 文档：访问 iching.jiuchongju.com/#/user/openapi/docs，覆盖 47 项能力的逐接口参数表；
- 调用记录工具：在 Agent 中调用
zhouyi_my_calls可查询最近调用与剩余额度（不消耗额度）。
九常见问题（FAQ）
密钥明文忘了保存怎么办？
在 API-KEY 管理页对应行点「重新生成」，弹窗会再次展示新明文（旧密钥立即失效），请当场复制。
调用返回”每日调用限额 500 次”（QUOTA_EXCEEDED）怎么办？
当日额度用尽。次日 0 点自动重置，或按第四节申请提升额度。
Skill 和 MCP 的额度是分开的吗？
不分开。同一 KEY 下 Skill 与 MCP 合并计数，共用每日 500 次（或你申请的额度）。
导出的 Skill 包能给别人用吗？
包内已绑定你的 API-KEY，他人使用将消耗你的额度。请勿外传；如需为他人开通，请让其自行注册并导出。
能在手机 / APP 上导出 Skill 吗？
不能。开放平台（含 Skill 导出）仅在 PC 端 iching.jiuchongju.com 提供，请用电脑浏览器操作。
支持哪些测算能力？
共 47 项（F1–F47）：七种排盘、大运流年流月流日、姓名测试与起名、抽签解梦、配对合婚、黄历、民俗预测等，详见 API 文档页。