DeepSeek Harness (DSH) 的智能體在會話之間是無狀態的。對話中產生的上下文(項目決策、約定、調試技巧)僅存在於該對話中,會話結束後即消失。內置的 AGENTS.md 雖然是持久化文件,但它是靜態的、項目級的指令文件:智能體無法自行更新,且將服務器地址、拓撲結構等敏感信息寫入項目目錄存在誤提交的風險。
dsh-workspace-memories 是一個爲 DSH 提供工作區級持久化記憶的插件。它爲每個工作區創建獨立的記憶文件,默認存儲在 DSH 數據目錄外,並在每個會話中自動注入系統提示,同時提供側邊欄面板和智能體工具來管理記憶。
核心功能¶
- 側邊欄管理:通過 Workspace Memory 側邊欄面板,瀏覽、創建、編輯或刪除記憶文件。
- 智能體工具:註冊
save_workspace_memory工具,允許智能體在對話中主動保存新的記憶。 - 自動注入:每個工作區的會話系統提示中都會自動包含該工作區的記憶文件內容。
- 存儲模式配置:支持
home(默認,DSH 數據目錄外)和workspace(項目目錄內)兩種存儲模式。
安裝與啓用¶
使用 DSH 的插件安裝命令添加該插件:
dsh plugin --profile desktop add github:lengfengng-tech/dsh-workspace-memories
安裝完成後,可在側邊欄的插件頁面找到並啓用該插件。
典型用法¶
- 創建記憶:打開側邊欄中的“Workspace Memory”面板,選擇“New file”創建 Markdown 格式的記憶文件。
- 智能體保存:在對話中輸入指令,例如“remember: this project uses pnpm, not npm”。智能體會調用
save_workspace_memory工具將此信息持久化。 - 配置存儲:通過配置項設置
storage: home(默認,存儲在 DSH 數據目錄)或storage: workspace(存儲在工作區目錄下)。
注意事項¶
- 會話刷新:工具註冊後立即生效,但模型可見的工具列表是在每次會話開始時構建的。如果安裝或升級後未開啓新會話,模型可能無法看到
save_workspace_memory工具(PTC 模式下尤爲明顯)。建議開啓新會話或發送新消息以更新工具列表。 - 權限與範圍:瀏覽器面板的操作僅限於已註冊的
workspaceId,無法訪問任意路徑。 - 文件限制:
- 文件名必須嚴格驗證,不允許包含路徑分隔符(如
/)、..、空白字符或控制字符。 - 單個文件大小上限爲 1 MiB。
- 注入系統提示時,每個文件會被截斷至 32K 字符,且記憶文件總數上限爲 20 個。
- 文件名必須嚴格驗證,不允許包含路徑分隔符(如
- 許可與性質:該插件採用 MIT 許可證,爲社區維護插件,非 DeepSeek 官方產品。
總結¶
dsh-workspace-memories 通過外部存儲和自動注入機制,彌補了 DSH 原生無狀態和 AGENTS.md 靜態不可更新的缺陷。它讓智能體能夠在會話間保持一致性,同時也讓開發者能更好地控制記憶的生命週期。
- 插件目錄:SkillHub
- GitHub 倉庫:lengfengng-tech/dsh-workspace-memories