在 DeepSeek Harness (DSH) 的開發與調試過程中,調整智能體(Agent)的 Persona 往往需要重啓進程或重載配置。這不僅中斷了當前會話,還可能打亂模型端的 KV-cache,導致推理效率下降。dsh-openclaw-persona 插件借鑑了 OpenClaw 的成熟範式,將這套五文件 Persona 定義系統引入 DSH,並提供了一個 Web GUI 編輯器,支持即改即生效。
插件定位¶
該插件由用戶 lynsucceed 維護,屬於「趣味換裝」類別。它允許用戶複用 SOUL/IDENTITY/USER/MEMORY/TOOLS.md 這五個文件作爲 DSH 的 Agent 定義,通過側邊欄或磁盤文件直接修改,並在下一條消息中立即生效。
核心功能¶
- 即改即生效:修改配置後,無需重啓 DSH,發送下一條消息即可應用新設定。
- 五文件分層定義:使用 OpenClaw 的標準結構,包括行爲準則(SOUL)、身份設定(IDENTITY)、用戶畫像(USER)、長期記憶(MEMORY)和工具備忘(TOOLS)。
- Web GUI 編輯器:在側邊欄提供標籤頁界面,直接編輯 Markdown 文件,保存後寫入磁盤。
- mtime 緩存:利用文件修改時間(mtime)檢測變更,僅在文件變動時重新發送,保持 KV-cache 穩定。
- 兩級回退機制:優先讀取項目級配置(
<項目目錄>/.dsh/persona/*.md),找不到時回退到全局配置(~/.dsh/persona/*.md)。 - 即插即用:安裝後側邊欄自動出現「Custom Persona」入口。
安裝¶
該插件僅支持 Web Profile。
dsh plugin --profile web add @lynsucceed/dsh-openclaw-persona
安裝完成後,重啓 DSH Web 服務。
典型用法¶
- Web 界面編輯:重啓後,點擊側邊欄的「Custom Persona」入口。在標籤頁中切換編輯五個 Markdown 文件(如 SOUL.md 或 IDENTITY.md)。點擊「保存」後,發送下一條消息,Agent 將按照新設定的 Persona 應答。
- 文件編輯:也可以直接編輯磁盤上的配置文件。全局配置位於
~/.dsh/persona/*.md,項目級配置位於<項目目錄>/.dsh/persona/*.md。
注意事項¶
- 容錯性:任何文件都可以留空或刪除,缺失的部分會被安靜跳過,不會報錯。
- 緩存策略:文件未修改時複用緩存文本,文件修改後立即生效。
- 覆蓋規則:項目目錄下的
.dsh/persona/會覆蓋全局~/.dsh/persona/的同名文件。 - 首次啓動:首次運行時會寫入示例模板,不會覆蓋用戶已有的編輯。
總結¶
dsh-openclaw-persona 提供了一種低侵入、高效率的方式來管理 DSH 的智能體設定。它結合了文件系統的靈活性和 Web 界面的便捷性,特別適合需要頻繁調整角色風格或進行實驗性開發的場景。
- GitHub 倉庫:lynsucceed/dsh-openclaw-persona
- 社區目錄:dsh-openclaw-persona