在 DeepSeek Harness (DSH) 的生態中，爲智能體 (Agent) 配置固定的暱稱、回覆風格和語調是常見需求。手動拼接 System Prompt 既繁瑣，又容易出錯。dsh-soul 插件提供了一個可視化的配置入口，用於管理 Agent 的人格設定，並支持通過命令行進行快速修改。
插件簡介¶
dsh-soul 是一個由 Aliuyanfeng 維護的 DSH 插件，分類爲“趣味換裝”。它通過 Web UI 和命令行工具，幫助用戶統一配置 Agent 的暱稱、語調、回覆風格及自定義指令。
核心功能¶
Web UI 配置¶
插件內置 Web UI，提供中英雙語文案。
* 設置頁體驗：包含 dirty 檢測（無改動時禁用保存）、保存結果提示、提示詞預覽只讀面板。
* 「關於你」：設置用戶暱稱、職業和介紹。
* 風格與語調：支持專業嚴謹、輕鬆自然、幽默風趣、吐槽達人、高效幹練。
* 特質微調：在風格基礎上疊加標題和列表（default/more/less）、表情符號、表格的呈現方式。
* 回覆長度偏好：concise（簡潔）、normal（適中）、detailed（詳盡）。
* 語言與指令：選擇輸出語言（中文/English），提示詞會隨語言本地化。支持輸入自定義指令。
人設預設與工具¶
- 人設預設：提供 7 個內置人設（蘇格拉底式提問者、極簡主義者、資深架構師、教學型講解者、嚴格代碼審閱者、頭腦風暴夥伴、自驅型協作者），支持用戶保存、切換和刪除自建人設。預設僅包含人格維度（風格、特質等），不影響“關於你”。
- 工具調用：Agent 可調用工具
set_persona在對話中直接調整人設。開啓確認模式後，需通過/soul confirm確認變更。 - 輸入框光軌：提供純外觀的輸入框光軌效果（顏色、流動速度、光帶粗細、漸隱拖尾）。
健壯性與可觀測性¶
- 配置持久化：支持字段白名單、類型、長度上限（暱稱/職業 50、介紹 500、自定義指令 2000）及十六進制顏色校驗。寫入採用原子替換，配置損壞時支持備份與重置。
安裝¶
使用以下命令安裝插件：
dsh plugin --profile <profile> add dsh-soul
典型用法¶
Web 界面操作¶
啓動 DSH 後，進入設置頁面的「個性化設置」欄目，修改配置並點擊「保存設置」。
命令行操作¶
插件提供了一套斜槓命令用於管理配置：
/soul show 查看當前配置（含確認模式、預設數量與送達狀態）
/soul set k=v 修改配置項（如 /soul set style=humorous language=en）
/soul save <名> 保存當前人設爲預設
/soul use <名> 應用人設預設
/soul list 查看人設預設
/soul del <名> 刪除人設預設
/soul confirm 應用待確認的人設變更
/soul reject 拒絕待確認的人設變更
/soul reset 重置配置（配置損壞時這是逃生口）
/soul enable 啓用個性化設置
/soul disable 禁用個性化設置
/soul <暱稱> 設置暱稱
配置保存後會同步到所有活動 Agent，變更檢測機制確保僅在影響 Agent 行爲的配置實際變化時刷新提示詞。
注意事項¶
- 依賴與兼容性：插件不打包 DSH 運行時包，全部由宿主提供。peerDependencies 檢查針對 DSH 運行時版本（
@deepseek-ai/dsh-app-boot），支持 DSH 0.1.x 與 0.2.x（含 prerelease 版本）。 - 提示詞插值：提示詞插值已關閉，自定義指令裏的
{{…}}按字面保留，不會觸發裝配失敗。 - 光軌配置：輸入框光軌字段屬純外觀配置，只落盤、不進入 system prompt、不觸發會話注入。
- 配置損壞：配置損壞時，插件會拒絕覆寫，用戶可使用
/soul reset功能（保留人設預設庫）進行修復。
dsh-soul 通過結構化的配置管理和健壯的存儲機制，解決了 DSH 中 Agent 人設定製繁瑣的問題。對於需要批量管理 Agent 風格或快速切換人設的場景，該插件提供了可靠的解決方案。
