前言¶

在 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 安裝文檔）：

安裝完成後，按各客戶端要求重啓或刷新 Skill 列表。

3、在產靈平臺創建令牌¶

1. 打開 https://www.xdhdancer.top ，註冊並按需充值（計費見 https://www.xdhdancer.top/pricing ）。
2. 後臺「我的令牌」創建密鑰，複製 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