前言¶

在 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 。