前言¶
在 Cursor、Claude Code 等客户端里做设计类任务时，常见做法是单独接一家图像 API，再在 Skill 或脚本里写请求、轮询和错误处理。模型一换，又要改配置。若你希望 Agent 用自然语言完成「画海报」「改风格出图」，并尽量少维护多套密钥，可以把产灵（xdhdancer.top）的能力封装成标准 markdown Skill，一次配置 token，由 Agent 按文档自动选子能力与调接口。
下面介绍 SkillHub 社区技能 @user_91ce4cec/chanling-skill（当前版本 1.0.2）的定位、能力与安装方式。
这是什么¶
@user_91ce4cec/chanling-skill 是面向 产灵 API（https://www.xdhdancer.top） 的 Skill 总入口：一份总 SKILL.md 说明公共鉴权与异步任务约定，子目录 chanling-image 承载图像生成细则。发布来源为 SkillHub community，发布者坐标 user_91ce4cec，分类 design-media；页面标注 requires_api_key=true，使用前需自备平台令牌。
Skill 解决的核心问题是：让兼容 Skill 协议的 Agent 读 markdown 指令即可完成提交任务、轮询状态、取结果 URL，而不必在对话里手写 curl。视频、音乐等子 Skill 在官方说明中标注为陆续上线；截至 1.0.2，已落地的是图像能力。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 chanling-image/SKILL.md，可与 SkillHub 简介交叉核对。
统一鉴权与子 Skill 路由¶
- Base URL：
https://www.xdhdancer.top - 鉴权：Bearer Token，密钥在客户端 secrets 中命名为
xdhdancer_api_key（占位符{{secrets.xdhdancer_api_key}}），所有子 Skill 共用，无需按子能力重复建 token。 - 总入口职责：按用户意图匹配子 Skill（如含「画」「生图」「海报」等触发
chanling-image），再读取对应子目录下的SKILL.md执行。
图像生成（chanling-image）¶
- 协议：异步两步——
POST /v1/videos提交任务，再GET /v1/videos/{task_id}轮询；路径名含videos但平台约定其承载图/视频/音频等异步任务，无同步出图端点（勿用/v1/images/generations调本平台图像模型）。 - 推荐模型（平台内模型 ID，默认第一个）：
1.gpt-image-2（gpt 系，通用首选）
2.gemini-3.1-flash-image-preview（Nano Banana 2，响应快，支持图生图）
3.gemini-3-pro-image-preview（Nano Banana Pro，高清与文字渲染场景） - 文生图 / 图生图：图生图需先将参考图经平台图床
POST https://xdhdancer.top/api/share-data上传，再把返回 URL 填入请求体images数组。 - 连通自检：首次或异常时可
GET https://www.xdhdancer.top/ai-api/pricing，确认清单中含gpt-image-2等模型。
规划中能力¶
总入口说明后续将补充 chanling-video（视频）、chanling-music（音乐）、chanling-text（文本/多模态）等子 Skill；当前包内仅包含 chanling-image。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装说明 检查或安装：
command -v skillhub && skillhub --version
未安装时可执行（完整安装含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端会加载的 skills 目录，否则默认落在 ./skills/ 可能不被识别。官方页面给出的坐标为 @user_91ce4cec/chanling-skill；skillhub search 解析后的安装方式为：
skillhub install chanling-skill --namespace user_91ce4cec --dir <你的 skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装完成后，按各客户端要求重启或刷新 Skill 列表。
3、在产灵平台创建令牌¶
- 打开 https://www.xdhdancer.top ，注册并按需充值（计费见 https://www.xdhdancer.top/pricing ）。
- 后台「我的令牌」创建密钥，复制
sk-xxx形式的 token。
4、写入客户端 secrets¶
将 token 存为 secret 名 xdhdancer_api_key，与各 Skill 文件中的占位符一致。具体 UI 或配置文件以你所用客户端的 secrets 管理文档为准。
典型用法¶
对话式（推荐）¶
Skill 设计目标是自然语言触发。安装并配置 xdhdancer_api_key 后，可直接对 Agent 说例如：
- 「用默认模型画一只赛博朋克风格的猫，2K 正方形。」
- 「把这张本地参考图改成水彩插画风格。」（Agent 应按子 Skill 说明先走图床上传，再图生图。）
Agent 应先读总入口 SKILL.md，匹配 chanling-image，再按子 Skill 默认使用 gpt-image-2（用户未指定模型时），并按 5 秒间隔、最长约 10 分钟超时轮询任务。
命令行验证（与子 Skill 示例一致）¶
可用环境变量承载密钥，复现异步提交流程：
KEY="$XDHDANCER_KEY"
BASE="https://www.xdhdancer.top"
RESP=$(curl -s -X POST "$BASE/v1/videos" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $KEY" \
-d '{
"model": "gpt-image-2",
"prompt": "a cyberpunk cat sitting on a neon-lit rooftop, ultra detailed",
"size": "2048x2048"
}')
TASK_ID=$(echo "$RESP" | jq -r '.task_id // .id')
# 轮询直至 metadata.url 或失败终态
gpt 系 size 放在请求体顶层；Nano Banana（banana 系）则需把画幅相关参数放在 metadata 内，详见 chanling-image/SKILL.md 的 Per-Kind Parameter Rules。
适用场景与注意¶
适合谁
- 已在 xdhdancer.top 有账号与余额，希望在 Cursor / Claude Code / Codex 等 Agent 里用一套 token 做文生图、图生图。
- 愿意让 Agent 按 markdown Skill 自行处理异步轮询与错误码（401 密钥、402 余额、404 模型 ID 等），减少手写集成代码。
限制与注意
- Skill 与 https://www.xdhdancer.top 强绑定：改 base URL 或模型 ID 会导致鉴权或调用失败；勿将 Skill 中的端点改写到其他厂商 API。
- 模型名称是平台内标识，与 OpenAI/Google 官方同名产品并非同一端点。
- 图像任务按次计费，失败退款规则以平台 pricing 为准；Skill 要求 Agent 不向用户报具体单价，需价格时引导用户查看 pricing 页。
- SkillHub 页面统计（截至抓取）：评分 100000，下载 1113 次；安装后仍需自行配置 API Key 与充值，社区来源需自行评估维护节奏。
Skill 包内注明更新源可参考 GitHub：https://github.com/CCCpan/chanling-skill；SkillHub 分发地址见文末。
结尾¶
@user_91ce4cec/chanling-skill 把产灵平台的异步生图协议写进标准 Skill：一次配置 xdhdancer_api_key，Agent 即可按文档调用 gpt-image-2 与 Nano Banana 系列。经过上面的安装与 secrets 配置，即可在对话中完成出图；视频与音乐能力以官方后续子 Skill 为准。
- SkillHub 页面：https://www.skillhub.cn/skills/user_91ce4cec/chanling-skill
- API 坐标页：https://api.skillhub.cn/user_91ce4cec/chanling-skill
- 产灵平台：https://www.xdhdancer.top
