dsh-nexus：DeepSeek Harness 的零配置記憶層

前言¶

DeepSeek Harness（DSH）採用插件化架構，開發者通常需要自行處理智能體的記憶持久化與成本控制問題。dsh-nexus 插件旨在提供一個零配置、成本自保的記憶層。它默認零 token、零外部服務，通過“原子 + 門控 + 可審計”的三層結構管理記憶，而非簡單的文本追加。

核心功能¶

該插件通過單一的面板實現所有交互，核心能力集中在成本控制、審計與數據清理上。

面板與注入真相¶

面板打包在 lib/nexus.html，通過設置頁的「記憶」入口或獨立頁 /nexus 訪問。
頂部會顯示當前注入的上下文條數、總字節數及預算剩餘。展開詳情後，可以查看每條記憶未進入上下文的具體原因，包括：
* 單條超預算
* 被擠掉
* 歸屬未知
* 屬於其他項目
* 本會話
* 非活躍

成本控制與審計¶

• 預算高亮：單條記憶佔用的預算超過總預算的 30% 時，會以橙色高亮顯示。
• 運行狀態：設置頁的“運行狀態”模塊會實時統計今日寫入、待確認、已拒收及注入次數。
• 成本明細：在同一處提供注入、提煉、編碼三項的 token 與字節數統計。

數據管理¶

• 一鍵清理：插件能自動識別子代理回執、提示詞等誤寫內容（例如某次測試中 29/33 條爲誤寫），支持一鍵歸檔並拉黑，且 5 秒內可撤銷。
• 三態刪除：支持歸檔（可回溯）→ 回收站（可恢復）→ 徹底清除（真刪並清邊）。注意 /memory purge 命令僅做歸檔，真刪需在面板回收站操作。
• 自繪交互：面板中的狀態、作用域、提煉模型下拉框均爲自繪彈層，避免原生 <select> 在 macOS 亮色模式下的樣式問題。

安裝與啓用¶

由於尚未發佈到 npm，目前只能通過 GitHub 源或本地 tarball 安裝。

1. 通過 GitHub 安裝（推薦）：

    dsh plugin --profile web add github:chenqiuyushuang/dsh-nexus

安裝後運行 `dsh web` 啓動服務。

2. 本地 tarball 安裝：
   若需離線安裝，需先在本地構建並打包：

    npm run build && npm pack

安裝時使用 `file:` 協議指向生成的 tarball 文件，並確保修改版本號以觸發更新。

3. 校驗安裝：
   安裝完成後，建議運行校驗腳本以確保代碼與面板一致性：

    npm run verify:install

典型用法¶

在會話中，可以通過命令行與面板配合使用：

• 基礎操作：

    /memory list|search <q>      # 列表或搜索
    /memory show <id>            # 查看詳情
    /memory edit <id> <新陳述>   # 編輯
    /memory delete <id...>       # 刪除（進入回收站）

• 審覈與衝突處理：

    /memory confirm <id...>      # 確認記憶
    /memory reject <id...> [原因] # 拒收記憶
    /memory conflict [keep-new|keep-old|keep-both <id...>|--all] # 處理衝突

• 會話與維護：

    /memory session [read-write|write-only|pause] # 修改會話模式
    /memory cost                     # 查看成本
    /memory doctor                   # 自檢（檢查庫計數、待裁決衝突、注入佔用等）
    /memory import <file>            # 導入記憶
    /memory integrate [run]          # 整合記憶

安全與存儲¶

安全配置¶

• 寫入限制：寫操作要求 Origin == Host（含端口）精確匹配。
• 讀取限制：讀操作要求 Host 爲 loopback，防止 DNS rebinding 攻擊。
• 遠程訪問：如需遠程訪問，必須在宿主配置中顯式開啓 webuiAllowRemote: true。
• 安全掃描：支持對密鑰、身份證、私鑰的出廠掃描。

存儲結構¶

插件使用兩類存儲，需注意區分：
* 投影目錄（默認 ~/.dsh/nexus）：存放人類可讀的 MEMORY.md / USER.md，權限爲目錄 0700、文件 0600。
* 原子庫：通過宿主的 storage-domain 後端存儲，由宿主決定權限。

注意事項¶

• npm 未發佈：目前無法通過 npm install 直接安裝，必須使用 GitHub 源或本地 tarball。
• 價值密度門（影子期）：目前的記憶打分機制（價值密度門）處於影子期，只記錄不攔截。需要積累真實使用樣本並驗證誤攔率爲 0 後，纔會切換爲攔截模式。
• 版本更新：使用 file: 安裝時，若包體未變，pnpm 不會更新，必須升級版本號。
• 插件重啓：安裝新版本後，必須重啓 dsh web 進程才能生效。

結語¶

dsh-nexus 提供了一套結構化的記憶管理方案，通過預算控制、審計面板和三態刪除機制，解決了智能體記憶管理的成本與可追溯性問題。對於需要精細控制上下文成本的 DSH 用戶，這是一個值得部署的插件。

• 項目地址：https://github.com/chenqiuyushuang/dsh-nexus
• 許可協議：MIT