DeepSeek Harness(DSH)採用插件化架構,具備高度的可擴展性。在處理 SillyTavern 的角色卡、世界書和預設文件時,開發者通常需要在本地文件系統、JSON 編輯器和 DSH 之間頻繁切換。dsh-stcardwriter 插件在 DSH 中集成了 SillyTavern 的創作環境,提供本地化、可視化的資源管理方案。
該插件由 bychv 維護,遵循 MIT 許可證,旨在解決多格式資源的管理、預覽與遷移問題。
核心功能¶
- 酒館創作模式與工作臺:插件支持 DeepSeek Harness
0.1.2-rc.1。它提供了“酒館創作模式”Agent 預設和三欄工作臺。左側用於連接 Harness 並管理項目,中間用於編輯資源,右側用於編輯世界書注入內容並支持實時預覽。 - 模式切換:在酒館工作臺頂部可通過“工具模式”下拉框切換“標準模式”或“極簡模式”。極簡模式僅保留
tavern_*酒館資源工具及少量交互工具,隱藏 Shell、文件操作等,以減少工具定義佔用的上下文。 - 本地連接器:內置本地 SillyTavern 連接器,通過本地文件直連,不依賴 HTTP 接口,也不受 CSRF 或鑑權限制。酒館無需處於運行狀態即可進行同步。
- 格式支持與修復:支持 Character Card V1/V2/V3 的識別與編輯。支持世界書格式檢查與修復,支持 Preset Plus 0.1.5。
- 資源管理:支持批量導入角色卡文件(.json, .png, .charx, .zip)。支持 CHARX 中除
card.json以外的任意文件及 PNG 二進制資源的保留。
安裝與啓用¶
通過官方 CLI 安裝:
dsh plugin --profile web add github:bychv/dsh-stcardwriter
安裝或升級後重啓 DSH Host。首次啓動會自動創建 tavern-authoring 和 preset-plus 兩個 Agent 模式。
典型用法¶
- 激活 Preset Plus:在 DSH 設置的“預設增強”中創建、導入或激活 Preset Plus 預設。
- 選擇模式:新建會話並選擇“酒館創作模式”。此時 Preset Plus 預設會與完整的
tavern_*工具同時生效。 - 導入資源:打開“酒館創作”面板,可新建空項目,也可批量導入
.json、.png、.charx或.zip文件。 - 連接本地酒館:在連接器面板填寫 SillyTavern 目錄(安裝根目錄或
data/<用戶>目錄)進行連接,用於瀏覽和同步本地酒館資源。 - 切換工具模式:在酒館工作臺頂部的“工具模式”下拉框中,根據需要切換“標準模式”或“極簡模式”。
注意事項¶
- 依賴關係:插件目前尚未發佈到 npm,需直接從 GitHub 安裝。
- Agent 數據讀取:Agent 項目讀取默認只返回摘要,需顯式傳入
detail=full參數才能獲取完整 JSON。 - 數據安全:導出規範化操作不會改寫工作區源資源,需持久化時需使用修復工具或直接導出。
- 腳本執行:格式檢查不執行卡內腳本,且不測試第三方擴展的可用性。
- 權限與隔離:連接器通過本地文件直連,不涉及 HTTP 權限問題。工具目錄精簡功能僅改變工具可見性,不影響權限隔離或沙箱邊界。