MIT 授權的 TypeScript DSH 外掛:記憶以本機 JSONL 存放,雙通道檢索(詞法 + 本機 llama-server 向量)自動降級,每輪召回、硬性規則、規則程式碼腳本與五個分頁的面板齊備,不設向量服務也能用、不送網路請求。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-18
授權條款
MIT
01它能幫你完成什麼?
讓新的 DSH 工作階段接得上先前的結論
記憶以 JSONL 存放在本機;新工作階段第一步注入專案 / global 摘要,之後每輪依問題召回,只給印象,需要細節時用 `memory_get` 取全文
在 DeepSeek Harness 裡長期做同一個專案、不斷重推同一批結論的開發者
把團隊共識與流程變成每輪都在的硬性規則
`kind: rule` 進入系統提示常駐段落(行首帶 8 位 id,注入摘要);`kind: procedure` 進入流程目錄(依工作區與觸發詞命中);規則還能附掛腳本,在儲存前拒絕、儲存後觀察、注入前改寫或丟棄
希望硬性規則與 SOP 真的被執行、不必每個工作階段重新交代一次的團隊
人工核對、檢索、備份與稽核記憶系統的行為
「服務 / 記錄 / 記憶樹 / 設定 / 稽核」五個分頁,記錄頁帶語意檢索開關與作用域用途 / 別名編輯,匯出為純文字 JSON(不含向量)
想自己確認存了什麼、召回了什麼,並把資料帶走的使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- Node.js 22.13 以上 —— README 的 Node.js 徽章標示 ≥22.13
- 要安裝外掛的 DSH profile:桌面端是 `~/.dsh/profiles/desktop`,Web 端是 `~/.dsh/profiles/web`
安裝步驟
- 01
$ dsh plugin --profile web add @restregular/dsh-memory
- 02
在 profile 目錄裡手動執行:`pnpm add @restregular/dsh-memory`(外掛自帶的 `cordis.patch.yml` 會註冊那唯一一條 entry)。
- 03
開啟 設定頁 →「記憶系統」,也可以在「設定 → 側欄入口」開啟左側欄入口。
- 04
需要語意檢索時,在面板「服務 → 向量服務」一鍵安裝本機 llama.cpp 後端;不裝則檢索維持詞法。
驗證整合成功
作者未說明
復原
- pnpm remove @restregular/dsh-memory
- 再從 profile 的 patch 裡刪掉那條 `dsh-memory` entry。
- 解除安裝不會移除已設定的向量服務與記憶檔案(它們在 `<storeDir>` / `<installRoot>` 裡),要清掉得在解除安裝前用面板「服務 → 維護」操作。
03DSH 整合程度與能力邊界
原生 DSH 外掛(Host + Client 兩半):profile 的 `cordis.patch.yml` 只註冊一條 entry,提供 `memory` 服務、八個 `memory_*` 工具、`agent/pre-step` 注入鏈與 `/memory/api` 面板;Client 半邊在設定頁掛出「記憶系統」。
八個模型工具
要儲存的內容、查詢語句、作用域名稱、記錄 id→`memory_search` 只回印象(8 位 id / 作用域 / 類型 / 標籤 / 摘要),`memory_get` 依 `fields` 取正文與中繼資料;另有作用域目錄、封鎖與規則程式碼管理
在 `storeDir` 下的 JSONL 寫入記錄把回傳過的項目記進工作階段去重狀態雙通道檢索(詞法 + 本機向量)
一句查詢→依相關度排序的記憶;向量通道可用時附排序分,不可用時自動退化為詞法結果
設定了端點時呼叫本機 llama-server 的 `/v1/embeddings`為每個作用域檔案寫一份 `.vec` 向量附檔自動召回與注入
本輪使用者問題、工作階段第一步、工具失敗與帶標籤的行為→注入的摘要、每條記憶的印象、常駐規則段落與流程目錄
在系統提示與對話上下文中插入記憶摘要在 `<cwd>/.dsh/dsh-memory/sessions/` 寫入工作階段去重狀態工作階段層級記憶權限與範圍外審批
作用域勾選、可讀 / 可寫標記、限制等級(絕對 / 普通 / 無限制)→工具只能讀寫被授權的範圍;範圍外命中預設只回作用域清單,確認後彈出審批卡,可逐條勾選放行
把本工作階段的可見範圍與授權寫進 `<storeDir>/visibility/<session>.json` 和 `<storeDir>/grants/<session>.json`審批等待期間在該工作階段側欄列顯示待審批標記規則程式碼(hook 腳本)
一段 JS 腳本,並且帶上一個 `hookPhase` 欄位,取值可以是 `before-save`、`after-save` 或 `before-inject`→儲存前直接拒絕並把理由回給模型、儲存後只觀察,或注入前改寫正文 / 丟棄整條
程式碼存在 `<storeDir>/hooks.json`,不進檢索在 node:vm 沙箱中同步執行,無 require / process / 網路,120ms 逾時
04適合誰?何時不該用?
適合
- 在 DeepSeek Harness 裡長期做同一個專案、不斷重推同一批結論的開發者
- 希望硬性規則與 SOP 真的被執行、不必每個工作階段重新交代一次的團隊
- 想自己確認存了什麼、召回了什麼,並把資料帶走的使用者
不適合
- 記憶資料只在本機,JSONL 未加密,匯出檔案也是明文,store 目錄需要你自己保護;向量端點預設走 loopback。
05相容性、維護與安全提醒
- 記憶資料只在本機,JSONL 未加密,匯出檔案也是明文,store 目錄需要你自己保護;向量端點預設走 loopback。
- 稽核資料預設只存在記憶體:總量 2000 筆、每個工作階段 200 筆,超出時優先保留 digest / rules / delivery / error 等關鍵通道,重新啟動後記錄就消失。
- 同內容去重仍只在行程內判斷,兩個行程同時寫完全相同的內容理論上會留下兩筆;跨行程安全靠的是每個作用域一把寫入鎖。
- 只有設定了 `endpoint`、配置了 `spawn`、或在面板安裝了本機後端,外掛才會連網;否則一個請求都不送,檢索只用詞法。
MIT · README 分支 main · 無 tagged release,最後推送 2026-11-12
06常見問題
沒有向量模型,dsh-memory 還能用嗎?
可以。README 說明沒有向量服務時檢索自動退化為詞法(IDF + 中文 bigram),不產生任何網路請求。要語意檢索時在面板「服務 → 向量服務」一鍵安裝本機 llama-server 後端,內建清單已為每個模型配好 `dims` 與 `pooling`。
記憶資料存在哪裡?
存在 `storeDir` 底下,預設是相對於啟動目錄的 `.dsh-memory`,README 建議明確設定一個絕對路徑。記錄是明文 JSONL 加 `.vec` 向量附檔,作用域用途等中繼資料在 `scope-meta/`,面板設定寫入 `settings.json`。
怎麼裝進 DSH 的 profile?
執行 `dsh plugin --profile web add @restregular/dsh-memory`,或手動把套件加進 profile 相依;兩種方式都靠外掛自帶的 `cordis.patch.yml` 註冊那唯一一條 entry。README 說明宿主只允許一個套件名稱、一個解析來源,所以面板與服務端在同一個套件裡。
新工作階段沒召回我的記憶,先檢查什麼?
先確認 `inject.recall` / 自動召回是開著的,目前作用域在召回範圍內(標籤觸發的自動召回只含 global + 目前工作階段 + 目前工作區),再確認標籤真的命中。面板頂部的「稽核」分頁能看到每次注入的候選、過濾、預算與投遞狀態。
怎麼解除安裝?會連記憶一起刪掉嗎?
執行 `pnpm remove @restregular/dsh-memory`,再從 profile 的 patch 裡刪掉那條 entry。解除安裝不會移除已設定的向量服務與記憶檔案——它們在 `storeDir` 與 `installRoot` 裡,所以要在解除安裝之前用面板「服務 → 維護」清掉,外掛移除後面板就打不開了。
07相關的 DSH 工作流程
dsh-univer-office
作者 dream-num
在 DSH 內預覽、建立與編輯表格、文件和幻燈片,由 Univer 驅動
clearai-dsh
作者 clearailhc
ClearAI:以本體為綱的原生 DSH 外掛 —— 經證據核驗的研究長成可瀏覽的領域本體。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 魚的記憶:給會話一份會淡忘的長期記憶,每條都帶時間。名字裡的「魚」來自 DeepSeek 的鯨魚。
dsh-trading
作者 zhu1090093659
基於 DeepSeek Harness 的智慧體原生交易終端,三欄介面聚合幣圈、美股、A股與港股,內建 19+ 可熱插拔聯結器,預設模擬交易並需人工確認。
08資料與來源
包自带 `cordis.patch.yml`,注册**唯一一条** entry:
面板分五个标签:**服务 / 记录 / 记忆树 / 设置 / 审计**。
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
