返回目錄

dsh-memory

編輯精選維護狀態: 活躍

seriousz158/dsh-memory

DeepSeek Harness 記憶外掛(dsh-memory),為智慧體提供持久化記憶能力。

前往 GitHub
$ dsh plugin --profile web add github:seriousz158/dsh-memory

180

星數

4

Fork

JavaScript

語言

MIT

授權條款

2026-08-19

建立於

2026-10-10

最近推送

MIT 開源的本機 Git 託管長期記憶外掛程式:記憶持久化、事務性同步 / 復原、全文搜尋、啟動注入 summary_snapshot、唯讀工具(memory_search / memory_context)、備份匯出匯入,並內建 DSH 設定頁 UI。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-08-27

授權條款

MIT

01它能幫你完成什麼?

  • 在 DeepSeek Harness 對話之間保留長期記憶

    存到本機 Git 儲存庫的持久記憶(`summary.md`、`handbook/`、`rollouts/`、`archive/`),並提供唯讀的 `memory.search()` / `memory.context()` 檢索

    使用 DeepSeek Harness 的開發者與研究者,希望模型跨工作階段記住偏好與知識,又不想依賴託管記憶服務

  • 安全清除已學到的記憶,並保留可復原的 Git 檢查點

    兩步確認的清除流程:先保留 Git 復原點(乾淨儲存庫沿用既有 HEAD,髒路徑打獨立 checkpoint commit),再記錄清除後的狀態

    需要在 DSH 設定頁做可復原的日常記憶重設的使用者

  • 無人值守地把閒置工作階段同步進記憶

    選用的無頭同步器(`./integrations/dsh/dsh-memory-sync`),只在私密的一次性 workspace 中處理閒置的本機工作階段日誌,由宿主驗證並寫入 live Git 儲存庫

    希望模型只改隔離副本、由宿主驗證後自動累積記憶的使用者

02如何將外掛接入 DeepSeek Harness?

先決條件

  • 官方 dsh CLI(README 相容性表:DSH runtime peer range `@deepseek-ai/dsh@^0.1.0-rc.6`,即 rc.6 與 rc.7)
  • Git 可執行檔需位於 `PATH`(README 相容性表:Git | a local executable available on `PATH`)
  • Node.js 22.x(README 相容性表)
  • Python 3.11.x(README 相容性表)
  • macOS(README:macOS is the supported/tested integration target)

安裝步驟

  1. 01

    執行 `dsh plugin --profile web add github:seriousz158/dsh-memory`(GitHub 原始碼安裝,根 bundle `dsh-git-memory` 一次安裝同時啟用兩半)

    $ dsh plugin --profile web add github:seriousz158/dsh-memory

  2. 02

    安裝後重新啟動所選 DSH profile(README:Restart the selected DSH profile after installing)

  3. 03

    原始碼方式(選用):`git clone https://github.com/seriousz158/dsh-memory.git`,`cd dsh-memory`,再 `npm ci --ignore-scripts`

    $ git clone https://github.com/seriousz158/dsh-memory.git

  4. 04

    原始碼方式(選用):`npm install --global @deepseek-ai/dsh@0.1.0-rc.7` 安裝 v0.8.2 實測用的固定版本執行環境,並用 `dsh --version` 確認

    $ npm install --global @deepseek-ai/dsh@0.1.0-rc.7

  5. 05

    原始碼方式(選用):執行 `./integrations/dsh/install.sh` 把兩個本機包裝入 DSH profile(預設 `~/.dsh`;非預設路徑時保持 `DSH_HOME` / `DSH_MEMORY_ROOT` 環境變數一致)

  6. 06

    重新啟動 DSH host,在 DSH Settings 中找到「長期記憶」並保持開關開啟,讓下一次模型呼叫啟用記憶

驗證整合成功

作者未說明

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

原生 DSH 外掛程式套件:透過官方 `dsh plugin` CLI 安裝,宿主外掛程式與設定頁 UI 外掛程式經由 DSH 的 Cordis loader 介面直接載入(非 MCP、非第三方 agent 轉接)

  • 本機 Git 託管的長期記憶

    需要跨工作階段持久化的知識、偏好與經驗→本機 Git 儲存庫中的持久記憶(`summary.md`、`handbook/`、`rollouts/`、`archive/`),Markdown 記錄支援 front matter、namespaced ids、溯源、過期投影

  • 安全同步與復原

    閒置的本機工作階段日誌(選用)→dry-run / preview / apply 流程、操作鎖、健康檢查、有界批次處理、重試退避、重複 id 診斷與僅元資料的 journal

    模型只能編輯每次執行私密隔離的 workspace 副本,由宿主驗證並寫入 live Git 儲存庫
  • 唯讀記憶檢索

    有界且明確不受信任的 `summary.md` 快照(上限 12 KiB)→`memory.search()` / `memory.context()` 回傳本機有界檢索結果,帶來源引用與依使用情況決定的確定性排序

    讀取用量以私有元資料存入 `.sync/usage.json`;transcripts、prompts、憑證與記憶內容不會寫入 journal
  • DSH 設定頁整合

    DSH 設定頁 UI→記憶開關、儲存庫狀態、近期同步狀態、preview 操作、復原與兩步確認的清除操作

    設定頁不暴露檔案系統根目錄,也不直接執行 Git
  • 帶復原點的記憶清除

    來自 DSH 設定頁的兩步確認清除請求→清除前保留 Git 復原點(乾淨儲存庫沿用清除前的 HEAD,髒路徑打 checkpoint commit),清除提交直接建在該復原點上;`.git`、`README.md`、輔助腳本、目錄結構與 `.last-sync` 保持完整

    面向可復原的日常重設,不保證隱私擦除

04適合誰?何時不該用?

適合

  • 使用 DeepSeek Harness 的開發者與研究者,希望模型跨工作階段記住偏好與知識,又不想依賴託管記憶服務
  • 需要在 DSH 設定頁做可復原的日常記憶重設的使用者
  • 希望模型只改隔離副本、由宿主驗證後自動累積記憶的使用者

不適合

  • 外掛程式保持 DSH `0.1.0-rc.6` peer 相容範圍(rc.6 與 rc.7),並在固定為 `0.1.0-rc.7` 的圖上實測整合;DSH `rc.8` 及之後版本在通過本儲存庫測試套件前均未驗證。
  • 清除記憶面向可復原的日常重設,不保證隱私擦除。對隱私敏感的刪除需求,需移除相關本機備份並遵循組織的保留策略;Git 歷史本身不是安全擦除機制。

05相容性、維護與安全提醒

  • 外掛程式保持 DSH `0.1.0-rc.6` peer 相容範圍(rc.6 與 rc.7),並在固定為 `0.1.0-rc.7` 的圖上實測整合;DSH `rc.8` 及之後版本在通過本儲存庫測試套件前均未驗證。
  • macOS 是官方支援 / 實測的整合目標;相容性表還列出 Node.js 22.x、Python 3.11.x,以及 `PATH` 上可用的本機 Git 可執行檔。
  • 清除記憶面向可復原的日常重設,不保證隱私擦除。對隱私敏感的刪除需求,需移除相關本機備份並遵循組織的保留策略;Git 歷史本身不是安全擦除機制。
  • 選用同步器預設 `workspace-write` 權限,更高的權限絕不是儲存庫預設。它需要使用者自行安裝的 `dsh` 可執行檔(或明確指定的 `DSH_BIN`),不呼叫 `npx --yes`;其工作階段過濾器會在 transcript 進入記憶萃取模型前去敏化常見憑證形態與 home 目錄前綴。
  • 專案僅透過 GitHub 原始碼安裝與 GitHub Releases 發佈,未發佈到 npm;兩個 workspace 實作套件保持私有,只有根 `dsh-git-memory` bundle 可發佈。
2026-08-192026-08-26v0.8.2

MIT · 活躍維護中(最新版本 v0.8.2,2026-08-25)

06常見問題

要怎麼安裝 dsh-memory?

執行 `dsh plugin --profile web add github:seriousz158/dsh-memory` 即可。儲存庫根目錄本身就是公開的 DSH bundle `dsh-git-memory`,包含宿主外掛程式、設定頁用戶端 bundle 與其 `dsh.bundle` 修補程式,一次安裝同時啟用兩半;安裝後重新啟動所選 DSH profile。專案未發佈到 npm。

記憶會上傳到託管服務嗎?

不會。記憶只留在本機 Git 儲存庫,README 明確表示沒有託管記憶服務或雲端向量資料庫(There is no hosted memory service or cloud vector database);bundle 也不包含任何記憶資料、工作階段日誌、憑證或本機 `.dsh` 目錄。

相容哪些 DSH 版本?

v0.8.2 保持 DSH `0.1.0-rc.6` 的 peer 相容範圍,並在固定為 `0.1.0-rc.7` 的圖上實測與本機整合;`rc.8` 及之後版本在通過本儲存庫測試套件之前均未驗證。

清除記憶會發生什麼事?

設定頁強制兩次確認(點按「刪除記憶」→ 輸入 `刪除記憶`)。在改動任何目標記憶路徑前會保留復原點:乾淨儲存庫沿用既有 HEAD,髒路徑打獨立 checkpoint commit,清除提交直接建在該復原點上。它面向可復原的日常重設,不保證隱私擦除。

支援哪些平台與前置條件?

macOS 是官方支援 / 實測的整合目標;相容性表還列出 Node.js 22.x、Python 3.11.x,以及 `PATH` 上可用的本機 Git 可執行檔。

08資料與來源

  • 作者聲明github.com2a994f7279b0…

    The repository root is also a public DSH bundle named `dsh-git-memory`.

  • 作者聲明github.com2a994f7279b0…

    dsh plugin --profile web add github:seriousz158/dsh-memory

  • 作者聲明github.com2a994f7279b0…

    The package uses DSH's Cordis loader interfaces.

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

🏆

最佳 DeepSeek Harness 外掛

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

廣告

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

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