前言¶
DeepSeek Harness (DSH) 的插件生態允許通過模塊化擴展核心能力。dsh-cc-studio 是一個專注於角色卡 (CC) 開發的工具，旨在解決“只有點子，世界觀薄弱”的問題。它將輸入框上方的膠囊轉換爲全屏融合工坊，通過預設讓 LLM 通過 14 個 Tool 進行交互，實現“先問再填”的共創流程。
功能概覽¶
該插件提供以下核心能力：
* 膠囊融合工坊：將輸入框膠囊轉換爲全屏工坊，提供更廣闊的編輯空間。
* CC 模式預設：配合預設，讓 LLM 通過 14 個 Tool 先提問再填入信息，輔助共創角色卡。
* 多格式導出：支持一鍵導出 JSON、PNG 或 CHARX 格式。
安裝與啓用¶
使用官方安裝命令：
dsh plugin --profile web add @xia-sc/dsh-cc-studio
安裝完成後，必須重啓 dsh web 使其生效。
關於包名變更
包名由 @dsh-plugins/dsh-cc-studio 更改爲 @xia-sc/dsh-cc-studio。如果之前安裝過舊包名，請先卸載再安裝新包名，否則無法正常加載。
配置與數據¶
插件的數據目錄默認位於 <DSH_HOME>/cc-library/（角色卡）和 <DSH_HOME>/cc-drafts/（會話草稿）。DSH_HOME 默認爲 ~/.dsh。從 0.3.6 版本起，插件開始識別 DSH_HOME 環境變量，但舊的 ~/.dsh 位置在 0.3.6 之前仍然可讀。
CC 模式預設機制
插件隨包提供了 CC 預設，無需手動拷貝文件。預設的加載方式取決於宿主 DSH 的版本：
* DSH >= 0.1.7-alpha.1：插件通過 presets/cc.patch.yml 的組合聲明行註冊預設，直接在會話模式中選擇。
* DSH <= 0.1.6-alpha.2：插件啓動時將 presets/cc 裝載到 <DSH_HOME>/.agent-presets/cc 目錄。
使用流程¶
- 在會話輸入框上方找到膠囊圖標，點擊進入全屏融合工坊。
- 選擇
CC 模式預設。 - LLM 會通過 14 個 Tool 進行提問，你需根據提示完善角色設定。
- 完成共創後，點擊導出按鈕，選擇 JSON / PNG / CHARX 格式保存。
注意事項¶
- 權限：插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
- 會話保護：RPC 接口與資源地址受會話 cookie 保護。
- 資源鑑權：資源地址本身不走鑑權（如
/plugins/??@xia-sc/dsh-cc-studio/...），但訪問 RPC 需要有效 cookie。 - 版本兼容：若使用舊版 DSH，需確保符合 <= 0.1.6-alpha.2 的目錄安裝要求。
