前言¶
在 DeepSeek Harness (DSH) 的插件生態中，構建角色扮演或伴侶功能往往面臨架構臃腫或侵入性強的問題。現有的解決方案常依賴獨立前端應用或脆弱的靜態提示注入。dsh-character-studio 提供了一種原生、輕量的替代方案。作爲 DeepSeek Harness 的客戶端插件，它利用 Cordis 框架構建非侵入式架構，並統一了角色卡管理與 Hindsight 圖記憶引擎，使 DSH 成爲一個輕量且持久化的角色扮演運行時。
核心功能¶
該插件主要包含以下能力：
- 原生輕量級架構：基於 Cordis 的原生插件，非侵入式集成，不破壞現有 DSH 進程結構。
- 多格式角色卡支持：兼容原生 Markdown 格式（含三段式結構）與 SillyTavern V2 JSON 格式。
- Hindsight 圖記憶引擎：利用 Hindsight 的圖記憶能力，結合時間推理，提升長期記憶的深度。
- 角色專用內存隔離：爲每個角色自動創建獨立的記憶庫（如
rp_<character>），防止不同角色間的記憶泄漏。 - DeepSeek Persona 沉浸式獨白：支持 DeepSeek 官方的
persona沉浸式獨白模式，增強角色的第一人稱心理分析與對話表現。 - 指令控制：提供斜槓命令與 OOC（Out-Of-Character）指令，用於快速切換角色和發佈非角色內的控制指令。
安裝與啓用¶
在安裝前，請確保你的 DeepSeek Harness 版本滿足要求，並確保 Hindsight REST API 服務已運行。
- 檢查環境依賴：
- DeepSeek Harness >= 0.1.1-rc.2
- Hindsight REST API 服務已啓動
- 執行安裝命令：
dsh plugin --profile web add dsh-character-studio
如需在無頭模式下運行，可使用 --profile headless 參數。
典型用法¶
安裝完成後，可通過以下指令進行操作：
- 列出角色：查看當前已加載的角色卡列表。
/rp list
- 切換角色：立即激活指定的角色人格。
/rp use <name>
- 查看狀態：檢查當前記憶庫狀態及 Hindsight 連接健康度。
/rp status
- OOC 指令：發送非角色內的控制指令或旁白。
/ooc <directive>
配置項¶
插件支持以下配置項（通常在 DSH 配置文件中設置）：
cardsPath: 角色卡根目錄，默認爲~/.dsh/cards。defaultCard: 默認激活的角色卡名稱，留空表示不激活。hindsightEndpoint: Hindsight REST API 地址，默認爲http://localhost:8888。hindsightToken: Hindsight 的 Bearer Token（可選）。bankPrefix: 記憶庫前綴，默認爲rp_。recallCacheTtlMs: 內存召回緩存有效期（毫秒），默認爲 60000ms。enableDeepSeekImmersivePrompt: 是否啓用 DeepSeek 沉浸式獨白規則，默認爲true。enableTavernFormatting: 是否啓用角色扮演格式規則，默認爲true。
適用場景與注意¶
該插件適合需要構建長期、穩定且記憶隔離度高的角色扮演場景的開發者與用戶。由於插件以當前 DSH 進程權限運行，建議在安裝前仔細檢查源碼與許可證（MIT）。
結語¶
dsh-character-studio 通過原生插件化與 Hindsight 的結合，解決了傳統方案中內存隔離差、格式複雜等問題。它爲 DSH 用戶提供了一個輕量、優雅且可持久化的角色扮演解決方案。
