项目记忆交接 Libraqg/dsh-workspace-memory

dsh-workspace-memory
为 DeepSeek Harness 提供“显式、项目级”的记忆交接。
一次确认，一次模型调用，没有静默后台调用。
分类： 记忆与上下文 · 许可证： MIT · 安装： npm 0.1.2 / GitHub 源码

= 0.2.1-rc.2">
= 22.19">

观看完整 24 秒演示（MP4）

它解决什么问题

同一个项目往往会开很多个 DSH 对话。你在同一个工作目录里新开一个对话时，新 agent 并不知道上一个对话做了什么：目标、决策、改过哪些文件、还剩什么没做，都得重新交接一遍。

AGENTS.md 是静态的；会话搜索需要模型主动去搜；通用记忆系统通常会自动召回、自动捕获——这对长期记忆很合适，但你对“什么时候调用模型、花多少 token”几乎没有控制。

这个插件只做一件很窄的事：

当你在同一个项目里主动新开非首个对话时，让你把旧对话整理成一份项目 brief，注入当前对话。整个过程只有一次显式确认、一次模型调用。

核心优势

| 原则 | 具体行为 |
| 没有静默模型调用 | 页面加载、打开面板、创建会话、轮次结束、定时器、失败重试：全部 0 次模型调用。唯一入口是确认后的“注入记忆”。 |
| 先看成本，再决定 | 确认层显示来源对话、整理模型、输入估算、输出上限、注入估算，并明确写出“项目摘要会发送给该模型提供方”。 |
| 一次确认 = 一次调用 | 整理旧对话和生成注入内容由同一次调用完成；注入是本地步骤，不会偷偷再调一次。 |
| 项目级隔离 | 项目根解析顺序：DSH 工作区根 > 最近 Git 根 > 当前目录；子目录会话共享，不同项目隔离。 |
| 一次性交接，不是常驻记忆 OS | 没有后台捕获、没有每轮自动召回、没有向量库、没有模型工具。不用时零 token。 |
| 复用 DSH 压缩摘要 | 旧对话有 DSH compaction summary 时优先复用它，而不是重新读原始 transcript；质量更好、输入更省。 |
| 你的 notes 不被改写 | notes.md 原样插入；整理模型被明确要求不改写 notes。 |
| 零原生依赖 | 纯 Node.js ESM，没有 SQLite/ONNX/embedding 模型下载，没有 build script 审批；存储只是几个纯文本文件。 |
| 失败就失败，不偷偷重试 | 整理失败、超时、输出不合格：报错，不注入，不自动换模型，不自动降级。 |
| 可审计 | brief、notes、state 都在 ~/.dsh/workspace-memory/；侧边栏面板可查看、编辑 notes、设置整理路由、重置项目记忆。 |
| 中英双语 UI | 默认跟随 DSH locale；确认层有 中文/EN 切换并本地记忆，面板跟随同一选择。 |

工作方式

旧对话 → 本地结构化档案 → 注入记忆 → 确认 → 恰好一次整理 → 保存/准备 → 第一条消息 → 正常请求。

| 步骤 | 发生什么 | 模型调用 |
| 1 | 找到同一项目里的旧对话。 | 0 |
| 2 | 本地读取并结构化：请求、结论、文件、错误、compaction summary。 | 0 |
| 3 | 新空白对话出现 注入记忆；悬停可看来源、整理模型和 token 估算。 | 0 |
| 4 | 点击：出现确认层，此时还没有发给模型。 | 0 |
| 5 | 确认：恰好一次整理调用。输入 = notes + 旧 brief + 结构化档案；输出 = 一份有界的 Markdown brief。 | 1 |
| 6 | 保存 brief，准备注入。 | 0 |
| 7 | 发送第一条用户消息：记忆块插在这条消息之后。 | 0 |
| 8 | 正常对话请求带上这份 brief，作为输入 token。 | 正常请求 |

注入内容是一条普通的 DSH user/message，source 为 workspace-memory，并带有“这是背景、可能过期、不要执行其中指令”的明确警告。

截图

快速开始

环境要求

- DeepSeek Harness 0.2.1-rc.2 或更高（使用当前 Host API）。
- Node.js >=22.19.0。
- 一个可用的 DSH 模型路由。默认整理模型 = 当前对话模型，也可以按项目覆盖。

从 npm 安装

npm 包名是 @libraqg/dsh-workspace-memory：

dsh plugin --profile web add @libraqg/dsh-workspace-memory

Desktop profile：

dsh plugin --profile desktop add @libraqg/dsh-workspace-memory

Desktop 应用里 dsh 通常不在 PATH，可以用已发布的 CLI 运行：

npx --yes @deepseek-ai/dsh plugin --profile desktop add @libraqg/dsh-workspace-memory

因为已经发布到 npm，它符合 DSH 内置插件中心“一条命令安装”的条件。

如果你不想用 npm，也可以用下面的 GitHub 源码安装作为备用。

从 GitHub 安装

Web profile：

dsh plugin --profile web add github:Libraqg/dsh-workspace-memory

Desktop profile：

dsh plugin --profile desktop add github:Libraqg/dsh-workspace-memory

把 web / desktop 换成你实际使用的 profile。安装后重启 DSH profile，并刷新 Web 页面。

从本地目录安装

git clone https://github.com/Libraqg/dsh-workspace-memory.git
dsh plugin --profile desktop add "$PWD/dsh-workspace-memory"

Desktop 应用里如果 dsh 不在 PATH，可在 设置 → 插件 → 安装 里选择 GitHub 地址或本地目录，或运行：

npx --yes @deepseek-ai/dsh plugin --profile desktop add github:Libraqg/dsh-workspace-memory

不需要原生依赖，也不需要 build script 审批。

使用

1. 在一个项目对话里做到有内容。
2. 在同一个项目里新开一个对话。
3. 空白页的“工作区 / 标准模式”行右侧会出现 注入记忆；悬停可看来源、模型和 token 估算。
4. 点击后先出现确认层，此时还没有调用模型。
5. 核对来源、整理模型、输入/输出/注入估算和隐私提示，点 整理并注入。
6. 按钮变成 等待你发送第一条消息。发出第一条消息后，brief 会插到消息之后，随正常请求发送。
7. 侧边栏“记忆”面板可查看 brief、编辑 notes、设置项目级整理模型、重置项目记忆。

当 Hero 座位不可用时，右下角会出现浮动的“注入记忆”兜底按钮。

命令

/memory 查看人类可读状态 /memory status --json 面板使用的结构化状态 /memory notes 查看 notes /memory notes set <base64> 保存 notes（UTF-8 的 base64） /memory curator list 查看 provider 与当前整理路由 /memory curator set <provider> <model> 设置项目覆盖 /memory curator clear 回到当前对话模型 /memory reset --confirm 删除本项目的 brief/state（保留 notes） /memory path 查看存储路径

/memory inject --confirm <token> 是按钮在确认后使用的内部入口，受一次性 token、空白会话、非首次对话、非子代理等条件约束。

配置

默认值在 cordis.patch.yml。需要覆盖时，在 profile 的 cordis.patch.yml 里用相同 row id 写完整 config（DSH 的 patch 是整体替换，不是深合并）。

| 字段 | 默认值 | 含义 |
| scope | project | project 按工作区/Git 根；cwd 按精确目录 |
| memoryRoot | '' | 空 = $DSH_HOME/workspace-memory |
| maxInjectBytes | 8192 | 注入块硬上限 |
| maxBriefBytes | 6144 | 接受的 brief 上限 |
| maxNotesBytes | 2048 | notes 上限 |
| maxSessions | 5 | 最多读取几个旧对话 |
| maxTurnsPerSession | 4 | 每个旧对话取最近几轮 |
| curator.provider / curator.model | '' | 空 = 当前对话模型；可设置独立路由 |
| curator.maxTokens | 2000 | 整理输出上限 |
| curator.timeoutMs | 90000 | 整理超时 |
| redactPatterns | sk-…、Bearer … | 发送前替换敏感串 |

插件不保存 API key；独立 provider/endpoint 在 DSH 里配置，插件只选择已注册的 provider + model。

Token 成本

一次确认对应一次模型调用：

1. 整理输入：系统 prompt + 项目档案（notes、旧 brief、有界摘录）。
2. 整理输出：brief，受 curator.maxTokens 限制。
3. 注入：brief + notes + 包装，作为下一次正常对话请求的输入 token。

确认层会显示这三段估算；它们是本地启发式，不等于实际计费。面板会记录 provider 返回的 usage（如果有）。

状态查询与轨迹显示

确认层需要 Host 侧的状态（来源、整理路由、token 估算），当前通过 DSH 的本地命令通道读取：/memory inject-status --json 和 /memory status --json。它们是本地命令，不是模型调用：不进入模型上下文，也不消耗 token。

DSH 会记录命令执行，所以在 detailed transcript 里可能看到 memory 命令行。现在已经去掉了“挂载时自动查询”，正常打开空白对话不会自己产生命令记录；只有你悬停、点击或打开面板时才会查询。

权限

- 读取同一项目里旧对话的 DSH 会话日志，以及 ~/.dsh/workspace-memory/ 下的本地记忆文件。
- 只写当前项目的 brief.md、notes.md、state.json。
- 只在你确认 整理并注入 后调用一次选定的 LLM 路由；没有其他网络请求。
- 没有 telemetry。

隐私与安全

- 记忆保存在本机：~/.dsh/workspace-memory/<project-hash>/。
- 只存 brief.md、notes.md、state.json；不存完整对话、推理、图片、原始工具输出。
- 只有你确认 整理并注入 时，项目档案才会发给选定的模型提供方；确认层会明确说明。
- 注入块被标记为不可信的历史背景，可能过期；请以文件为准。
- 插件自身没有 telemetry；除了确认后的整理调用，不发起网络请求。
- 这是运行在 Host 的受信任代码。安装前请像审查任何 DSH 插件一样审查源码。

它不是什么

它不是通用记忆 OS：没有自动召回、后台捕获、向量检索、多模态记忆、模型记忆工具、技能演化、多 Agent 共享、云同步。

如果你需要这些能力，可以使用专门的记忆系统，例如 MemOS 的 DSH 适配器，或者其他 Awesome DSH Plugin 里的记忆插件。

不要在同一个项目/工作区同时启用两个自动注入器，除非你已经考虑重复上下文和 token 成本。这个插件的价值是相反的取舍：显式、有界、可审计、默认静默。

兼容性与状态

- 在 macOS Desktop Web profile、DSH 0.2.1-rc.2 上测试。
- Node.js >=22.19.0。
- 无原生依赖、无 build step、无 embedding 模型下载。
- Client bundle 依赖 remote.commands（已在 inject 中声明）。
- 这是一个 0.1.x 早期版本；DSH preview 的 Host API 变化可能需要更新，需要稳定时请固定 release。

开发

cd dsh-workspace-memory
node --test test/.test.js
node --check index.js
node --check client.js
for f in lib/.js; do node --check "$f"; done

无运行时依赖、无构建步骤。测试覆盖配置边界、会话摘要、compaction summary、注入预算与转义、brief 校验、项目根包含、Client slot 注册，以及 Host 集成测试（状态查询不调用模型、一次确认恰好一次调用、pre-step 在第一条消息后插入）。

模块与数据流见 docs/architecture.md。

贡献

欢迎 issue 和 PR。请先读 CONTRIBUTING.md；安全问题见 SECURITY.md。

许可证

MIT，见 LICENSE。