DeepSeek Harness 插件介紹：dsh-agent-identity

前言¶

DeepSeek Harness (DSH) 採用“一切皆插件”的架構。在構建智能體時，如何將 ~/.dsh/DSclaw/ 目錄下的人設文件準確地注入到系統提示中，是一個常見需求。dsh-agent-identity 插件提供了治理套件 Phase 1 的解決方案，它不攔截工具，而是專注於將核心文件注入提示詞。

這是什麼¶

該插件由開發者 xingyingyuzhui 維護，屬於模型推理分類。它主要解決的問題是：將 ~/.dsh/DSclaw/<agent>/ 目錄下的核心文件讀取並塞入當前會話的系統提示中，從而讓 Agent 擁有特定的人設或能力配置。

核心功能¶

插件通過文件機制管理 Agent 的身份與行爲，具體規則如下：

注入文件：以下文件會被注入到系統提示中：
- SOUL.md
- IDENTITY.md
- AGENTS.md
- TOOLS.md
- BOOTSTRAP.md
BOOTSTRAP.md 的特殊處理：
- 新建 Session 時自動注入。
- 在初次問答（如“你叫什麼”、“怎麼稱呼用戶”）完成前即生效。
- 初次問答完成後，由 Agent 刪除該文件。
僅存盤文件：以下文件僅存儲在磁盤上，不會注入提示詞：
- USER.md
- MEMORY.md
- HEARTBEAT.md
運行條件：
- 僅當 session 的當前工作目錄（cwd）在 DSclaw 下時，纔會觸發人設注入。
依賴關係：
- 依賴 dsh-agent-registry 創建的 DSclaw 目錄結構。

安裝與啓用¶

安裝該插件需要通過 Web Profile 進行：

dsh plugin --profile web add github:xingyingyuzhui/dsh-agent-identity

安裝完成後，請重啓 dsh web 服務。

如果進行本地開發調試，可以使用本地路徑鏈接：

dsh plugin --profile web add link:/abs/path/to/dsh-agent-identity

典型用法¶

安裝並重啓後，插件的默認行爲如下：

文件編輯：在設置菜單中找到 “Claw Agent” → “核心” Tab，可以查看和編輯上述七個核心文件。
自動注入：新建 Session 時，系統會自動讀取並注入 BOOTSTRAP.md 等文件。

注意事項與適用場景¶

依賴檢查：使用前請確保已安裝並正確配置了 dsh-agent-registry，否則 DSclaw 目錄可能不存在。
文件持久化：卸載本插件後，磁盤上的人設文件（如 SOUL.md）依然保留，只是不再被注入到提示詞中。
巡檢機制：HEARTBEAT.md 的巡檢功能默認關閉（every: 0），不會在空閒時觸發。
權限：該插件作爲 DSH 的插件運行，需遵守當前 DSH 進程的權限範圍。

結尾¶

dsh-agent-identity 是一個輕量級的治理插件，它通過文件系統映射的方式，解決了人設文件與提示詞注入的自動化問題。對於需要在 DSH 中管理多 Agent 場景下的身份一致性，該插件提供了基礎的 Phase 1 支持。