DeepSeek Harness 工作區記憶插件：審批式指令與項目記憶維護

前言¶

在 DeepSeek Harness (DSH) 的插件化生態中，讓多個會話在同一工作區保持一致的上下文是常見需求。現有的方式通常難以兼顧可複用的行爲規則與穩定的項目事實。下面介紹 dsh-workspace-memory 插件，它提供了一種基於審批的工作區指令與項目記憶維護方案。

該插件由 luyy9apples 維護，採用 MIT 許可證。它允許用戶在工作區內維護兩類共享上下文：AGENTS.md（可複用的行爲規則）和 .dsh-memory.md（穩定的項目事實與決策）。通過這種分離，行爲指令保持聚焦，而事實上下文則被保留供後續會話使用。

核心功能¶

該插件提供以下能力：
1. 文件維護：維護 AGENTS.md（可複用規則）和 .dsh-memory.md（穩定事實/決策）。
2. 交互式審批：模型識別到長期指令或記憶時，會通過 Diff 預覽請求用戶確認，防止靜默推斷寫入。
3. 併發會話共享：同一工作區打開的新對話會自動讀取最新的上下文文件。
4. 本地存儲：僅使用標準 Markdown 文件存儲，無網絡請求、遙測、數據庫或隱藏內存存儲。
5. 聚焦的 Diff：僅顯示變更內容，便於審查。
6. 防衝突機制：防止舊更新覆蓋新工作，基於文件版本進行校驗。
7. 沙箱感知：寫入操作使用調用會話的會話策略和當前工作目錄（cwd），而非插件啓動目錄。

安裝與啓用¶

安裝前請確保環境滿足要求：
* DeepSeek Harness 0.1.1-rc.2
* Node.js ^22.19.0 或 >=24.0.0

使用官方插件安裝命令：

dsh plugin --profile web add dsh-workspace-memory

該包聲明瞭 dsh.bundle，安裝後 DSH 會自動將配置層添加到 web profile 中。無需手動編輯配置文件。安裝或更新後，需重啓已運行的 profile。

如需更新或移除：

# 更新
dsh plugin --profile web update dsh-workspace-memory@latest

# 移除
dsh plugin --profile web remove dsh-workspace-memory

典型用法¶

插件在工作區目錄下維護兩個標準 Markdown 文件。

定義規則：將可複用的規則保存到 AGENTS.md。
- 示例：Whenever you change files here, finish by summarizing what changed and what you verified.
定義事實：將穩定的項目決策保存到 .dsh-memory.md。
- 示例：This project prioritizes backward compatibility over adopting new APIs.
驗證上下文：在同一工作區打開新對話，詢問當前應遵循的指令和項目決策。
提議更新：在對話中，模型可以使用 workspace_memory 工具提議更新上述文件。
- 用戶在 DSH Web 中查看聚焦的 Diff（顯示行號、顏色標記的增刪）。
- 確認後，變更纔會被寫入。

配置說明¶

Bundle 安裝時包含默認配置：

memoryFile: .dsh-memory.md
instructionFile: AGENTS.md
suggestUpdates: true
maxBytes: 32768

若需覆蓋，可在 $DSH_HOME/profiles/web/cordis.patch.yml 中添加：

- id: workspace-memory
  config:
    memoryFile: .dsh-memory.md
    instructionFile: AGENTS.md
    suggestUpdates: false
    maxBytes: 65536

注意：DSH 會替換整個 config 值，因此需重寫所有字段。文件名必須在同一目錄且不含路徑分隔符。

注意事項與限制¶

兼容性：已驗證 DeepSeek Harness 0.1.1-rc.2、Windows x64 和 Ubuntu（Node.js 22/24）。macOS 兼容性未驗證。
Headless 模式：在無交互界面的 Headless profile 中，建議設置 suggestUpdates: false。
存儲範圍：僅限會話當前工作目錄（cwd）中的兩個配置文件。
符號鏈接：最終路徑組件的符號鏈接會被拒絕。
生態背景：DSH 理念是“一切皆插件”，社區目錄（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係。

生態背景¶

該插件遵循 DSH 插件化設計，旨在解決本地化、可控的工作區上下文管理問題。