前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。對於角色扮演開發者而言，在 DSH 中複用現有的 SillyTavern (Tavern) 角色卡資源是一個實際需求。DSH RolePlay 旨在解決這一痛點，它不僅兼容 Tavern 角色卡，還提供了原生的 Agent RolePlay 能力。

插件概覽¶

DSH RolePlay 是 DeepSeek Harness 的 Tavern 角色卡兼容與原生 Agent RolePlay 插件。插件由 RiemannRe3 維護，採用 MIT 許可證。它將角色卡庫、對話界面和右側功能頁整合在同一個視圖中，選卡和配置無需離開當前對話。

系統要求與安裝¶

使用前需滿足以下條件：

• Node.js 版本：22.19.0 至 22.x，或 24.13.1 至 24.x。
• 環境依賴：需先安裝 DeepSeek Harness。

安裝步驟如下：

1. 在終端執行安裝命令，將插件安裝至 DSH 的 web profile：

    dsh plugin --profile web add @riemannre3/dsh-roleplay

2. 啓動 DSH Web 服務：

    dsh web

核心功能¶

插件提供以下核心能力：

• 角色卡兼容：支持 Character Card V2/V3 的 PNG 與 JSON 導入。
• 多模態配置：支持多開場、世界書、預設、Persona 與 Regex。
• 生態接口：兼容 EJS、iframe、MVU 與 TavernHelper 常用接口。
• 卡內交互：支持卡內 HTML、交互按鈕和獨立前端運行狀態。
• 會話管理：支持會話保存、刷新恢復與重啓恢復。
• 界面整合：卡庫、對話和右側功能頁在同一個界面裏。

使用流程¶

安裝完成後，通過以下步驟開始使用：

1. 打開設置，選擇模型提供商，填寫 API Key 和模型名稱。
2. 進入對話界面，點擊左側的「酒館」入口。
3. 點擊「導入」，選擇 Character Card V2/V3 的 PNG 或 JSON 文件。
4. 展開角色卡，選擇開場並創建新遊戲。
5. 進入對話後，頁面右側可以打開世界書、預設、Regex、前端、卡片和 Persona 等功能頁。

插件管理¶

在 DSH 設置中找到「插件 -> DSH RolePlay」可以啓用或停用插件。停用後，酒館入口和相關運行能力不會加載，但已導入的角色卡和會話數據仍會保留，重新啓用即可繼續使用。

若需更新或卸載，可執行以下命令：

• 更新：

    dsh plugin --profile web add @riemannre3/dsh-roleplay

• 卸載：

    dsh plugin --profile web remove @riemannre3/dsh-roleplay

注意事項¶

• 插件以 DSH 進程權限運行，使用時需注意安全與權限範圍。
• 請在使用前查看源碼與許可證，確保符合使用規範。

參考資料¶

• DSH RolePlay GitHub 倉庫
• DSH RolePlay 社區目錄