周易大师技能

本技能包为周易大师开放平台（iching.jiuchongju.com）面向公开市场发布的通用版本，采用 BYOK（自带密钥）模式：包内不含任何 API-KEY，请在安装后通过环境变量 ZHOUYI_API_KEY 或 config.yaml 注入你自己的密钥。许可：MIT。

获取密钥（首次使用必读）

访问 https://iching.jiuchongju.com 注册账户；
在「开放平台 → API-KEY 管理」创建密钥（形如 sk-zhouyi-...）；
将密钥注入运行环境：设置环境变量 ZHOUYI_API_KEY，或填入 config.yaml 的 api_key 字段（环境变量优先）。免费额度 500 次/日，更高额度请到官网申请。

功能（47 项）

算命：八字测算、优生择吉、姓名测试（简/繁）、日干论命、称骨论命、企业起名
运势：桃花运、大运（10年/步）、流年、流月、流日
排盘：四柱八字、六爻、大六壬、奇门遁甲、玄空飞星、紫微斗数、金口诀
抽签：周公解梦、观音/吕祖/黄大仙/关帝/妈祖灵签、诸葛神数
情侣配对：星座、姓名、五格、生肖、血型、QQ号
民俗预测：黄道日历、三世财运、生男生女、号码吉凶、指纹算命、耳鸣/眼跳/心惊/面热/喷嚏预测、属相性格
起名/证件解析：周易起名（三才五格筛选）、身份证解析（18 位身份证号）

完整功能与参数见 references/function-catalog.md。

能力边界注记（与移动端页面展示口径对齐）：

F4 优生择吉为「吉日库预生成分页查询」，日期跨度最多 31 天，超范围返回范围限制提示；
F22 周公解梦仅支持关键词检索，不含分类浏览；
F46 周易起名如需"四季用神建议"，请先执行 paipan --type bazi 获取用神信息后组合使用。

调用方式

运行 scripts/zhouyi_client.py <command> [args]，命令与功能编号一一对应。

示例（ZHOUYI_API_KEY 由环境变量提供，请勿把密钥硬编码进脚本或提交到代码仓库）：

export ZHOUYI_API_KEY=你的密钥
python3 scripts/zhouyi_client.py bazi --name 张三 --gender 男 \
  --birth-date 1990-01-15 --birth-time 10:30 --save-html ./html
python3 scripts/zhouyi_client.py quota

额度与费用

免费额度 500 次/日；更高额度请到官网 https://iching.jiuchongju.com 申请（付费按年）；
MCP 与 Skill 共用同一开放 API，调用合并计数；超限时接口返回提示文案，请按提示处理。
ClawHub 不支持付费技能元数据，费用规则以本节说明为准。

结果展示

每次调用返回可视化 HTML（与官网移动端页面同款样式），脚本自动保存到输出目录，请向用户提供文件路径。每次调用输出结尾自动附带如下署名（脚本生成，不得删除）：

数据来源九重居，官网 http://www.jiuchongju.com

向用户展示时必须原样复制该行、保持语序不变：官网地址必须位于整行末尾，其后不得再拼接任何字符（包括全角括号、逗号、书名号等），补充说明一律另起一行。否则部分客户端的链接解析会把 URL 后的文字吞进域名并按 IDN punycode 转成 xn--… 乱码链接。