前言¶
在 DeepSeek Harness（DSH）裏做智能體擴展時，常見需求不止是接入一個模型或工具，而是把角色設定、角色卡管理、圖片生成等能力放進同一個 web profile 中使用。DSH 的理念是「一切皆插件」，社區目錄作爲獨立站點收錄部分插件，與 DeepSeek / 幻方沒有官方從屬關係。
dsh-roleplay 是 chinosk6 維護的 DSH 插件，面向 DeepSeek Harness，提供角色扮演、角色卡創作/導入和圖片生成能力。
這是什麼¶
dsh-roleplay 是一個 DSH 插件，主要用於：
- 角色扮演對話
- 角色卡創作與導入
- 調用圖片生成接口
許可證爲 MIT。
環境要求¶
使用前需要滿足以下條件：
dsh0.1.0-rc.6+- Node
22.19+ pnpm9+
核心功能¶
下面介紹已覈實的能力。
角色扮演¶
插件支持 Role-play conversations，也就是在 DSH 中進行角色扮演式對話。
角色卡創作與導入¶
插件支持角色卡創作，並支持酒館兼容角色卡的生成 / 導入。
具體包括：
- 支持交互式創建角色卡
- 支持酒館兼容角色卡生成 / 導入
- 支持導入 RP-Hub 角色卡
README 中提到，部分提示詞參考了 RP-Hub 項目。
圖片生成¶
插件支持圖片生成，並可接入以下接口：
- NAI 官方接口
ai.erp.sex三方接口- Stable Diffusion WebUI 本地接口
安裝與啓用¶
先確認環境滿足上面的版本要求，再選擇安裝來源。
從 npm 安裝¶
如果插件已經發布到 npm，可以使用下面的命令安裝到 web profile：
dsh plugin --profile web add -w dsh-roleplay
這條命令會把 dsh-roleplay 添加到當前 web profile 的插件列表中。
從 GitHub 安裝¶
也可以直接從 GitHub 倉庫安裝：
dsh plugin --profile web add -w github:chinosk6/dsh-roleplay
如果安裝時需要指定分支或 tag，可以使用 # 後面的版本引用：
dsh plugin --profile web add -w github:chinosk6/dsh-roleplay#v0.1.0
Git 安裝的構建腳本配置¶
從 GitHub 安裝時，插件會運行 prepare 來構建 lib/。
如果 pnpm 提示忽略了 build script，可以在下面的文件中配置允許構建：
~/.dsh/profiles/web/pnpm-workspace.yaml
配置內容如下：
allowBuilds:
dsh-roleplay: true
配置完成後，再重新執行安裝或啓動流程。
更新插件¶
更新插件使用下面的命令：
dsh plugin --profile web update dsh-roleplay
更新完成後，需要重啓 dsh。
卸載插件¶
卸載插件使用下面的命令：
dsh plugin --profile web remove dsh-roleplay
注意：卸載後，角色卡和生成圖片的緩存仍可能留在：
$DSH_HOME/roleplay/
如果需要徹底清理，需要手動刪除該目錄中的相關文件。
本地構建與添加¶
如果要從本地倉庫使用，可以先構建，再添加本地目錄。
構建插件¶
在項目目錄中執行：
pnpm install
pnpm run build
這一步會安裝依賴並執行構建腳本。
添加本地倉庫到 dsh¶
構建完成後，將當前本地倉庫目錄添加到 DSH：
dsh plugin --profile web add -w .
之後需要重啓 dsh web。
適用場景與注意¶
這個插件適合以下幾類使用場景：
- 在 DSH 的 web profile 中使用角色扮演對話
- 需要導入或創建角色卡
- 需要調用 NAI、
ai.erp.sex或 Stable Diffusion WebUI 等圖片生成接口 - 希望統一管理 DSH 插件、更新和卸載
使用前需要注意：
- 插件會以當前
dsh進程權限運行，安裝前應檢查源碼和許可證 - 本項目許可證爲 MIT
- 從 GitHub 安裝時可能觸發
prepare構建流程 - 卸載插件不會自動清理
$DSH_HOME/roleplay/下的緩存文件
相關鏈接¶
dsh-roleplay 的價值在於把角色扮演、角色卡管理和圖片生成能力納入 DSH 插件體系中，減少單獨搭建流程的成本。
目錄頁：
- https://www.skillhub.cn/plugins/chinosk6/dsh-roleplay
GitHub：
- https://github.com/chinosk6/dsh-roleplay
