前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，對話一切換或窗口滾走，模型往往拿不到上一輪已經確認過的做法與教訓。雲側記憶方案又要綁廠商、綁格式，也不適合只想在本機留一份可審計 JSON 庫的場景。下面介紹社區插件 dsh-memory（維護者 hong1413）：它在 Harness 內掛五類工具與一個設置頁裏的 3D 星圖，用本地存儲做跨會話檢索、經人確認後寫入，並用反饋推進成熟度；不依賴 npm 構建，引擎爲 Python 3.8+ 單文件腳本。
這是什麼¶
dsh-memory 是 DSH 生態裏分類爲「記憶」的插件包（package.json 版本 1.2.1，MIT 許可，要求 DSH >=0.2.1-rc.5）。定位是：爲運行在 Harness 內的任意 LLM 提供與模型廠商無關的長期「經驗記憶」——任務開始前可檢索歷史，用戶確認後可保存教訓，可彙報使用效果，並在 Web UI 中以交互式 3D 星圖瀏覽整庫。數據默認落在本機目錄，無雲同步表述。
社區目錄頁：skillhub.cn/plugins/hong1413/dsh-memory。源碼與說明：github.com/hong1413/dsh-memory（截至資料抓取時 GitHub 顯示 1 star）。目錄站點爲社區收錄，與 DeepSeek / 幻方無官方從屬關係；安裝與運行仍以你本機 DSH 與插件源碼爲準。
核心功能¶
插件向模型暴露五個工具，設計原則在 README 中寫死：寫入經 Harness 審批服務、審批不可用則 fail closed；衝突教訓保留爲成對條目而非靜默覆蓋；每條有版本、來源與僅由顯式反饋驅動的成熟度。
| 工具 | 作用（據 README） |
|---|---|
memory_search |
跨會話檢索，返回相關性、置信度、成熟度、前提/反例、衝突、來源、陳舊度等 |
memory_get |
單條全文與元數據 |
memory_status |
數量、歸檔、待批准提案、成熟度分佈、數據路徑 |
memory_save |
保存教訓（摘要、詳情、標籤、前提、反例、分數、案例類型、置頂、來源引用等） |
memory_feedback |
結果 good / bad / neutral，推進成熟度（如 draft → active → trusted，bad 可 flipped） |
客戶端半部提供 3D star map（設置 → Memory star map）：區域爲星雲、子區爲星團、單元爲星體；可軌道視角、點擊聚焦；待批准提案以可點擊「流星」形式落下。Host 提供只讀 GET /dsh-memory/starmap.json；批准/駁回走 POST /dsh-memory/proposals，可由 allowUiWrites: false 關閉界面寫入。
平臺：Windows / macOS / Linux；需已啓用 plugin_manager 的 DSH（桌面或 CLI 配置均可）。
安裝與啓用¶
安裝分兩步：拿到插件目錄，再讓 DSH 按目錄裝入 bundle。README 說明可用倉庫 ZIP 解壓，解壓後的文件夾即插件包（與 git clone 等價，任選其一即可）。
1. 將 bundle 裝入當前 DSH profile
在智能體對話或 Plugins 頁面中，使用 plugin_manager 按絕對路徑安裝：
plugin_manager: install_bundle target = <absolute path to the dsh-memory folder>
管理器會鏈接包、應用 cordis.patch.yml，五個工具會出現在模型工具列表中。
2. 首次安裝後重啓客戶端
3D 星圖掛在 Web UI；首次安裝後需退出並重新打開 DeepSeek Harness 一次。之後若只改 client.js，刷新頁面即可。
3. 可選配置
在插件行的 config 中可覆蓋默認值；空配置即可工作。示例（字段含義見 README 表格）：
- insert:
- id: dsh-memory
name: 'dsh-memory'
config:
dataDir: 'C:\Users\you\AppData\Local\doubao-memory\data'
# pythonExe: 'python'
# timeoutMs: 30000
# maxResults: 6
# allowWrites: true
# requireApproval: true
# allowUiWrites: true
# promptHint: true
常用默認：dataDir 在 Windows 爲 %LOCALAPPDATA%\doubao-memory\data，其他系統爲 ~/.local/share 下對應路徑；pythonExe 爲 python（Windows）或 python3（macOS/Linux）；maxResults 默認 6；requireApproval 默認 true。
安裝前建議自行閱讀倉庫源碼與 MIT 許可證：插件以當前 DSH 進程權限運行，會調用本機 Python 執行捆綁的 memory_onefile.py，並在 dataDir 讀寫 JSON；HTTP 路由僅綁定 Harness Web 服務 127.0.0.1，星圖寫入需本機人工點擊或模型側審批流。
典型用法¶
在對話裏用自然語言驅動
模型會根據意圖調用對應工具，例如 README 中的示意：
Did I write down anything about pricing used cameras? → memory_search
Remember this: always check the shutter count before buying a used camera.
How did that advice work out? It saved me. → memory_feedback good
不啓動 Harness 時直連引擎（CLI）
在插件目錄下對 memory_onefile.py 操作，例如：
python memory_onefile.py remember "Used cameras: check shutter count first" \
--premise "in-person inspection" --counter "online listings without a hands-on test" \
--score 0.85 --case-type success --tags camera,used
python memory_onefile.py search "used camera inspection" --json
python memory_onefile.py status
python memory_onefile.py selftest
完整子命令見 python memory_onefile.py --help。
查看存儲位置與共享
運行 memory_status，或讀 status 輸出中的 dataDir。多個 DSH 安裝指向同一 dataDir 可共用一份庫。
數據與安全注意¶
數據模型：每個單元一個 JSON，位於 main_library/units/；版本快照、冷歸檔、提案等分目錄存放，README 稱佈局穩定且可直接備份、diff。
安全相關（摘自 README）：模型寫入走審批；無審批或無會話上下文時不靜默寫入；插件不改會話日誌、不註冊自定義會話事件、不把數據寫到 dataDir 外。星圖僅本機迴環訪問；若擔心界面誤點批准，可設 allowUiWrites: false。只讀部署可設 allowWrites: false。
適用誰、不適合誰¶
適合：在 DSH 裏做長期任務、希望模型「先搜經驗再動手」、且願意對寫入與 memory_feedback 做人工把關的開發者。也適合需要本地可讀 JSON、可追溯成熟度與衝突對的場景。
不適合：需要多用戶鑑權、遠程共享記憶服務，或不願在本機常駐 Python 與本地數據目錄的環境。FAQ 提到星圖頁缺失時，多數情況是安裝後未重啓 Harness 一次。
結尾¶
dsh-memory 用五工具加星圖，把「檢索—確認寫入—反饋成熟—可視化瀏覽」收在本機 DSH 插件裏，與具體 LLM 提供商解耦。進一步瞭解可打開社區目錄 skillhub.cn/plugins/hong1413/dsh-memory，安裝與細節以 github.com/hong1413/dsh-memory 的 README 爲準。
