返回目錄

dsh-memory

精選清單收錄維護狀態: 活躍

restregular/dsh-memory

DSH 記憶系統 (Memory System): local-first memory — JSONL + local embeddings, five tools, auto recall, hard rules, visual panel.

前往 GitHub專案首頁
$ dsh plugin --profile web add @restregular/dsh-memory

21

星數

2

Fork

JavaScript

語言

MIT

授權條款

2026-10-10

建立於

2026-11-20

最近推送

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`

安裝步驟

  1. 01

    $ dsh plugin --profile web add @restregular/dsh-memory

  2. 02

    在 profile 目錄裡手動執行:`pnpm add @restregular/dsh-memory`(外掛自帶的 `cordis.patch.yml` 會註冊那唯一一條 entry)。

  3. 03

    開啟 設定頁 →「記憶系統」,也可以在「設定 → 側欄入口」開啟左側欄入口。

  4. 04

    需要語意檢索時,在面板「服務 → 向量服務」一鍵安裝本機 llama.cpp 後端;不裝則檢索維持詞法。

驗證整合成功

作者未說明

復原

  • pnpm remove @restregular/dsh-memory
  • 再從 profile 的 patch 裡刪掉那條 `dsh-memory` entry。
  • 解除安裝不會移除已設定的向量服務與記憶檔案(它們在 `<storeDir>` / `<installRoot>` 裡),要清掉得在解除安裝前用面板「服務 → 維護」操作。

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

原生 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`、或在面板安裝了本機後端,外掛才會連網;否則一個請求都不送,檢索只用詞法。
2026-10-102026-11-12作者未說明

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` 裡,所以要在解除安裝之前用面板「服務 → 維護」清掉,外掛移除後面板就打不開了。

08資料與來源

  • 作者聲明github.comabda402c0b9a…

    包自带 `cordis.patch.yml`,注册**唯一一条** entry:

  • 作者聲明github.comabda402c0b9a…

    面板分五个标签:**服务 / 记录 / 记忆树 / 设置 / 审计**。

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-18。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。