前言¶
DeepSeek Harness(DSH)支持通過插件擴展系統提示詞的處理方式。在進行多智能體開發或調試不同對話風格時,頻繁手動複製粘貼提示詞或重啓應用會降低調試效率。dsh-persona-dafeiyu 提供了一個集中式的人設庫管理方案,內置了常用人設,並支持導入自定義人設,通過動態函數實現無重啓切換。
核心功能¶
該插件主要解決人設切換繁瑣的問題,核心能力如下:
- 內置人設:提供大肥魚、阿茶、聽瀾三個固定人設。這些人設寫死在代碼中,不可刪除或覆蓋。
- 自定義導入:支持通過文件(.md/.txt)或直接粘貼文本導入新的人設。導入後可在設置頁進行管理(重命名、刪除、啓用/停用)。
- 生效範圍:支持“全局”和“會話”兩種模式。全局模式下所有會話共用當前人設;會話模式下每個對話可以獨立選擇一個人設。
- 即時切換:人設文本是動態函數,切換人設後,下一個請求立即生效,無需重啓 DeepSeek Harness。
- 按需加載:狀態接口僅返回人設元數據(如簡介)。點擊“查看全文”纔會拉取具體提示詞內容,避免接口數據量過大。
安裝與啓用¶
前置條件:
* Node.js ≥ 20
* DeepSeek Harness (DSH) ≥ 0.2.0-rc.1(兼容 0.2.0-rc.2)
安裝命令(需替換 <profile> 爲你的 profile 名稱):
dsh plugin --profile <profile> add dsh-persona-dafeiyu
安裝完成後,插件會自動註冊爲獨立的 dafeiyu:persona 段落。
使用方法¶
安裝並啓用插件後,在 DSH 的設置頁面中會新增一個名爲“大肥魚”的小節。在這裏可以查看當前人設、切換人設、啓用/停用人設,或導入新的人設。
在輸入框上方的小條上,可以切換“全局”與“會話”模式。切換到“會話”模式後,人設名變爲可點擊的開關,點擊即可爲當前會話挑選一個人設(默認爲“跟隨全局”)。
導入新的人設時,支持上傳 .md、.markdown 或 .txt 文件,也可以直接粘貼文本到設置頁並點擊“導入”。
技術細節¶
- 動態求值:人設的
text字段註冊爲動態函數,每次提示詞組裝時都會重新求值,因此切換人設無需重啓。 - 持久化存儲:人設庫文件保存在
<DSH_HOME>/storages/dsh-persona-dafeiyu/personas.json。 - 接口設計:提供
/api/dsh-persona-dafeiyu/status獲取元數據,提供/api/dsh-persona-dafeiyu/persona?id=<id>按需獲取全文。
結語¶
dsh-persona-dafeiyu 通過人設庫的方式,將系統提示詞的管理從手動粘貼轉變爲可視化的列表管理,並利用動態函數實現了無縫切換,適合需要在多個預設人設之間頻繁切換的開發者。