前言¶

在 DeepSeek Harness（DSH）裏給智能體加「記憶」，常見做法是把聊天情緒、項目路徑、踩坑記錄都丟進同一個池子，檢索時再一股腦注入上下文。時間一長，無關人設和低頻閒聊會擠佔 token，真正該遵守的規矩和進度反而排不上隊。workmem 是維護者 mengyuruxing 發佈在 DSH 插件目錄、分類爲「記憶」的本地插件：把工作相關的四類記憶與人設分開存放，檢索走本地分詞與權重，不爲此額外調用模型。

這是什麼¶

workmem（GitHub：mengyuruxing/workmem）面向 DSH，用 5 個純文本分類文件 存記憶：工作記憶 4 類（規矩、事實、坑、進度）和 人設 1 份（persona/persona.md）。數據默認在 ~/.workmem，可用環境變量 WORKMEM_ROOT 覆蓋；與插件代碼目錄分離，升級或重裝不會動已有條目。README 標明當前爲可用版本，核心、面板與 DSH 適配層已完成，附帶 98 項 node:test 測試；許可證爲 MIT（Copyright (c) 2026 MOLULISHANGPOLU），package.json 版本爲 0.1.0，要求 Node >=24。

核心功能¶

工作優先與人設分離¶

工作記憶四類會被高頻檢索並按重要性注入；人設文件在「幹活」模式下默認低權重，不與工作記憶混池。三種模式——幹活、混合、陪人——通過按鈕切換，不做比例滑桿。

五個文件與權重¶

一個分類對應一個 Markdown 文件，不是「一條記憶一個文件」，也不是單文件數據庫。面板提供 5×3 權重矩陣（5 個文件 × 3 種模式），每格五檔：忽略、低、正常、高、最高。單條記憶另有 ★1–4 重要度，疊加在分類權重之上。

來源、冷熱與歸檔¶

來源標記爲原話、總結、判斷、工具（是標記而非分類）；原話正文鎖死只讀，更正需作廢後新建。14 天未被訪問的條目進入冷區，不移動、不刪除，命中檢索即回熱。歸檔與作廢均保留原文，可翻回。

檢索與注入（零模型調用）¶

本地分詞、IDF、門檻、分類權重與冷熱狀態由本地代碼處理；搜索不調用模型。DSH 適配層在 pre-step 做注入：規矩保底每輪至少 1 條（pinned 優先），注入總預算 1000 字。整理（合併、歸納類操作）可手動觸發或每 25 輪 自動調用一次當前對話模型，輸出 JSON 後由腳本校驗、合併、落盤；深挖默認關閉。

面板與 DSH 工具¶

自帶本地面板，獨立於 DSH 也可啓動：

node start-panel.mjs        # 默認 http://127.0.0.1:8795，只綁本機
node start-panel.mjs 9000   # 換端口

面板支持模式切換、健康燈、權重矩陣點選、分類篩選、搜索、詳情編輯（原話只讀）、時間軸、自檢表、目錄快照與回滾、整理卡片。Windows 可複製 start-panel.example.vbs 爲 start-panel.vbs 無窗口啓動。掛進 DSH 後提供 pre-step 注入、8 個工具、面板路由與懸浮入口；通過 cordis.patch.yml 掛載，無需改宿主 cordis.yml。

安裝與啓用¶

官方 README 的安裝步驟如下（注意：並非 dsh plugin add 一類命令，而是把包放進 profile 並聲明依賴）。

1、把倉庫放到 DSH profile 的 node_modules 下（軟鏈或複製均可）：

# 例：Linux / macOS
git clone https://github.com/mengyuruxing/workmem.git \
  ~/.dsh/profiles/desktop/node_modules/workmem

Windows 可用 mklink /J 建目錄聯接，或在 profile 的 package.json 裏寫 "workmem": "link:<絕對路徑>"。

2、在 profile 的 package.json 依賴里加上 workmem。

3、重啓 DSH。插件通過自帶的 cordis.patch.yml 掛進宿主。

安裝前請自行閱讀倉庫源碼與 MIT 許可；插件以當前 DSH 進程權限讀寫 WORKMEM_ROOT 目錄，僅在本機使用時注意面板只監聽迴環地址。

典型用法¶

在 DSH 裏日常對話：適配層按當前模式與權重矩陣檢索並注入；健康燈與「30 輪小字」等策略在 README 的「已實現」列表中有說明，無寫入時會黃燈提示。可通過 DSH 暴露的 8 個工具新建、編輯、合併、歸檔、作廢、恢復記憶，並觸發搜索或整理。

單獨開面板維護記憶：在插件目錄執行 node start-panel.mjs，瀏覽器打開 http://127.0.0.1:8795，切換幹活/混合/陪人，點選權重矩陣，按分類篩選或搜索，在詳情裏編輯（原話仍只讀）。需要回滾時可用目錄快照功能，回滾前會自動做安全快照。

跑測試（驗證環境）：

npm test        # node --test，98 項

更細的條目格式、審計與事件結構見倉庫內 docs/DATA-FORMAT.md；需求與檢索算法見 docs/SPEC.md、docs/ARCHITECTURE.md。

適用場景與注意¶

適合希望在 DSH 裏長期積累項目規矩、事實、坑與進度，又希望人設與陪聊內容不要污染工作上下文的開發者。檢索與遺忘、自檢以本地代碼爲主，適合對「記憶檢索也走 API」有顧慮、或需要離線可控的場景。

不適合期待「一個無限大統一記憶庫、全自動語義向量檢索」的用戶：workmem 刻意採用 5 個明文文件與本地 TF-IDF 式檢索，整理才用對話模型。社區目錄頁（https://www.skillhub.cn/plugins/mengyuruxing/workmem）與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係；目錄頁星標爲 0，選用前請以倉庫 README 與文檔爲準。

結尾¶

workmem 把 DSH 記憶拆成「工作四分類 + 人設一份」，檢索零額外模型調用，整理與注入策略在 README 裏寫得很具體。目錄頁：https://www.skillhub.cn/plugins/mengyuruxing/workmem ；源碼與安裝說明：https://github.com/mengyuruxing/workmem 。