星盘大师 Skill 使用指南：从注册到导出全流程

一星盘大师 Skill 是什么

星盘大师（AstroMaster，亚洲占星学院出品）开放平台把 14 项占星算力（本命排盘、个人运势、星座运势、过运盘、PDF 报告、调用记录等）对外开放，提供三种接入方式：

接入方式	适合谁	产物
Skill 包	想让 AI 助手”会看星盘”的用户	astro-skill.zip，解压即用
MCP 服务	使用支持 MCP 协议客户端的开发者	astro-mcp.zip 配置包
开放 API	自建系统的开发者	HTTPS 接口 api.astro.jiuchongju.com

三种方式共用同一个 API-KEY 与每日额度（默认 500 次/日，Skill 与 MCP 合并计数），计量口径完全一致，数据与官方客户端（PC 端 / 移动端 / APP）完全一致。本指南聚焦最常用的 Skill 包 路线。

二第一步：注册账号（以 jiuchongju001 为例）

1. 用电脑浏览器打开官网 https://astro.jiuchongju.com，点击右上角 「注册」（/register）；
2. 按下表填写并提交；
3. 提交成功后自动登录并进入首页，注册完成。

字段	示例值	说明
用户名	jiuchongju001	登录与展示用
密码	（自设强密码）	建议字母+数字+符号组合
昵称	如「星友」	展示用，可留空默认
性别	男 / 女	部分解读区分性别
出生日期	如 1995-08-20	星盘计算的默认个人信息
出生时间	如 08:30	影响上升星座与宫位
出生城市	如「杭州」	输入城市名自动匹配经纬度与时区

三第二步：创建 API-KEY

API-KEY 是你调用所有开放能力的”钥匙”，以 zs_ 开头（共 35 位）。

1. 登录后点击顶部导航的 「智能体」 进入「智能体配置」页，或直达 astro.jiuchongju.com/agent/api-keys；
2. 点击 「+ 创建密钥」，在弹窗填写密钥名称（可选）与有效期（30/90/180 天、1 年、2 年）；
3. 点 「确认创建」，弹出 「密钥已生成」 窗口，展示完整明文密钥（如 zs_9fK2...）；
4. 立即点击「复制」并妥善保存，再点「我已保存」关闭弹窗。

创建成功后列表出现一行记录：名称、密钥前缀、状态（有效）、有效期、每日限额 / 今日已用（默认 500）、已用额度与操作按钮。每个账号最多创建 5 个 API-KEY。

四（可选）申请提升每日额度

默认每个 KEY 每日 500 次调用，若不够用：

1. 在密钥列表对应行点击 「📈 申请提升每日额度」；
2. 在弹窗的「每日额度报价表」中选择期望档位（含免费档与付费档）；
3. 点 「提交申请」，系统返回申请编号（形如「申请编号为 APP…，联系管理员付费后开通」）；
4. 凭申请编号联系管理员付费开通；审批通过后新额度立即生效，列表状态显示「审核中」直至处理完成。

五第三步：导出 Skill 包

1. 在密钥列表对应行点击 「📦 导出 Skill」（导出 ClawHub 规范 Skill 包）；
2. 浏览器自动下载 astro-skill.zip；
3. 该包与你的 API-KEY 一一绑定：包内 config.json 已注入你的密钥，无需手动填写；
4. 每次导出都会在后台生成一条导出记录（skill_name = astro-skill），便于追溯。

六第四步：安装并使用 Skill 包

解压 astro-skill.zip，得到顶层目录 astro-skill/：

astro-skill/
├── SKILL.md          # ClawHub 技能说明（含 YAML frontmatter，声明 ASTRO_API_KEY 依赖）
├── config.json       # 账户与密钥配置（已填好：api_key / username / base_url / 有效期）
├── astro_client.py   # 独立可运行的 Python 客户端（含 401/429/503 错误处理）
├── requirements.txt  # Python 依赖（仅 requests）
└── README.md         # 使用说明

放入你的 Agent 平台技能目录：Claude Desktop / Claude Code 放入其 skills / plugins 目录；Qoder 放入工作区 .qoder/skills/；Cursor、ClawHub 等按各自技能加载规范放置。随后在对话中直接下达占星任务，Agent 会自动调用 Skill：

你：帮我排一下 1995 年 8 月 20 日 8 点半、出生地杭州、女的星盘。

Agent：（先用城市搜索取经纬度，再调用本命排盘）……返回行星落座、宫位、相位与完整解读。

Skill 覆盖的 14 项能力

1. 城市搜索（获取经纬度坐标与时区）
2. 个人信息补全（交互式收集出生信息）
3. 本命排盘计算
4. 个人每日运势
5. 个人本周运势
6. 个人本月运势
7. 个人本年运势
8. 十二星座每日运势
9. 指定星座每日运势
10. 指定星座本周运势
11. 指定星座本月运势
12. 指定星座本年运势
13. 查询最近调用记录
14. 官网注册引导

七（可选）改用 MCP 接入

若你的客户端支持 MCP 协议（Claude Desktop、Qoder、Cursor、阿里云百炼等），可免本地部署、直连云端：在密钥列表对应行点击 「🔌 导出 MCP」 下载 astro-mcp.zip，或手动配置云端端点：

{
  "mcpServers": {
    "星盘大师": {
      "type": "streamableHttp",
      "url": "https://api.astro.jiuchongju.com/mcp/astro/mcp",
      "headers": { "x-api-key": "zs_你的KEY" }
    }
  }
}

八查看用量、调用记录与 API 文档

• 用量与状态：「智能体配置 → API密钥」列表直接展示「每日限额 / 今日已用 / 有效期 / 状态」，页顶有总调用量、今日调用、本月调用、成功次数四张统计卡；
• 调用分析：「智能体配置 → 调用分析」页查看近期调用明细（仅保留最近 1 个月）；
• API 文档：「智能体配置 → API文档」（astro.jiuchongju.com/agent/api-docs），逐接口列出参数、鉴权方式与错误码；
• 鉴权方式：所有开放 API 请求需在 HTTP 请求头携带 X-API-Key。

九常见问题（FAQ）

密钥明文忘了保存怎么办？

在密钥列表对应行点「🔄 重新生成」，弹窗会再次展示新明文（旧密钥立即失效）。请当场复制。

调用返回 429 / 额度用尽怎么办？

说明当日 500 次额度用尽。可次日 0 点自动重置，或按第四节申请提升额度。

Skill 和 MCP 的额度是分开的吗？

不分开。同一 KEY 下 Skill 与 MCP 合并计数，共用每日 500 次（或你申请通过的额度）。

导出的 Skill 包能给别人用吗？

包内已绑定你的 API-KEY，他人使用将消耗你的额度。请勿外传；如需为他人开通，请让其自行注册并导出。

返回 401 是什么意思？

API 密钥无效或已过期。检查 config.json 里的 KEY 是否以 zs_ 开头、是否被重新生成过、是否已过有效期。

只能在电脑上用吗？

是。开放平台（API-KEY / Skill / MCP）目前仅在 PC 端 astro.jiuchongju.com 提供，移动端与 APP 暂不含该模块。