dsh-memory 状态

September 5, 2026 · View on GitHub

当前状态（2026-09-05）

  • 最新版本：0.2.11（main），65/65 自动化测试全绿（默认跑，harness 依赖存在时含 apply() 冒烟；零依赖 CI 中该冒烟跳过）。npm run check 通过。
  • 0.2.11 修复：consolidateMaxTokens 默认 3000 → 8192（合并输出需容纳 ~8KB 有界摘要 ≈ 4-6K token，3000 触发 LLM output reached max tokens，摘要停在 v12 无法推进；已在线实测：蒸馏写入 rollout 后合并报此错）。
  • 0.2.10 修复：llm 服务改为经 ctx.inject(['llm'],…) 等待，而非启动时 ctx.get('llm')（DSH 0.1.2-rc.1 下后者返回 undefined，自动摘要静默跳过：llm calls: 0、skips {"disabled":1}、摘要永不更新）；新增 host-wiring llm 守卫。已在线实测：蒸馏端到端恢复（rollout 14:39 写入）。
  • 0.2.9 修复：适配 DSH 0.1.2-rc.1 的 Surface 层 —— Session.events 被 snapshotEvents/deriveMessages 替换，extractTurnText 改为 agent.session.snapshotEvents(fromSeq)（此前每次轮次摘要都抛 Cannot read properties of undefined (reading entries)）；新增 host-wiring Surface 守卫。
  • 0.2.8 修复：适配 DSH 0.1.2-rc.1 —— 该版 dsh-settings 移除了 settingsNamespace 辅助导出，settings.register 改为接受裸字符串命名空间；插件改用 settings.register('memory', …)，并将 peerDependencies 收紧到 dsh-* ^0.1.2-rc.1 / cordis ^4.0.1。
  • 0.2.7 修复：auto-memory 运行时技能补 source: 'runtime'（此前技能出现在目录但加载报错）。
  • 另：新增 .github/workflows/ci.yml（node 20/22，零依赖直跑）、scripts/check-release.mjs（npm run check 防版本/测试数漂移）、test/host-wiring.test.js；标签 v0.2.5–v0.2.11。
  • 以下为 2026-08-15 的部署历史快照；此后的进展见 CHANGELOG.md，当前发布形态以 README 安装章节为准。

历史快照（2026-08-15）

结论

路线图 P0 / P1 / P2.1-P2.6 已全部实现，49 项自动化测试全绿。仓库 master 为 0.2.1 已发布部署版本：运行副本已同步、DSH 已重启、插件加载与 Web 设置页卡片均已端到端验证。

已验证矩阵

层结果
npm test（store 单测 + browser 单测 + web-settings 单测 + fake embedding server + MCP 子进程）49/49；核心依赖无关代码行覆盖 93.0%（store 93.07%、browser 92.31%）
DSH 工具注册14 个（read/add/update/delete/search/review/merge/export/import/stats/browse/history/rollback/sync）
独立 MCP9 个工具，stdio JSON-RPC 子进程集成通过
作用域global / workspace(cwd) / project(最近 git 根) 工具与自动管线隔离验证通过
自动管线summarize→rollout→consolidate、journal 游标、畸形输出拒绝、回滚/历史均端到端通过
安全凭据拒绝、注入脱敏、readOnlyScopes 端到端通过
部署脚本临时目标 DryRun/sync/篡改修复/Backup 全部通过

本轮复验（2026-08-15 19:10）

本节为 2026-08-15 19:10 的复验快照（当时测试套件 41 项、DSH 尚未重启）；后续进展见下方「部署状态」——测试已扩展为 49 项，部署重启与 Web 设置页卡片均已验证。

  • npm test：41/41 通过（388ms），与已验证矩阵一致。
  • DSH 插件链路（fake ctx + 真实 @deepseek-ai 依赖）：settings 注册（namespace=memory, applies=live）；14 个 memory_* 工具全部注册；read/add/update/delete/search/review/merge/export/import/stats/browse/history 全链路通过。
  • 作用域：global / workspace(cwd) / project(git root) 端到端读写与隔离通过。
  • 自动管线：fake LLM 下 summarize→rollout→consolidate 通过；畸形合并输出被拒绝且旧摘要保持 v1，后续有效合并写入 v2。
  • 回滚与同步：memory_history/memory_rollback（v1→v2→回滚 v1，历史双向归档）通过；memory_sync 的 up-to-date/imported/conflict 三分支通过。
  • 安全：凭据写入默认拒绝、allowSecret 显式放行、注入摘要脱敏、readOnlyScopes 阻断写操作均通过。
  • 安装副本：verify-after-restart.ps1 10/10 SHA-256 match；MCP smoke server=dsh-memory version=0.2.0 tools=9，add/search 通过。
  • 同步脚本 -DryRun：14/14 match，无需复制。
  • 结论：功能完成性复验通过（41 单测 + 14 工具全链路 + 自动管线 + 安全 + 部署副本），本测试目标完成。
  • DSH 重启：本轮未执行（仍按约定待用户确认，不阻塞测试目标）。

部署状态

  • 文件同步：已完成（2026-08-15 18:17，-Backup 已创建）；10/10 文件 SHA-256 与仓库一致。
  • 重启前校验：已直接用安装副本启动 MCP server（version 0.2.0，9 tools，add/search 全链路通过）。
  • DSH 重启：已完成（2026-08-15 19:15，用户确认后执行；新 DSH 进程已拉起）。
  • 重启后验证：verify-after-restart.ps1 10/10 SHA-256 match；MCP smoke v0.2.0/9 tools 通过；pluginInventory/list 显示 include:dsh-memory enabled=true、fiberPhase=active；记忆目录 .memory.lock/state.json 于 19:15:59 刷新。
  • settings 说明：memory 命名空间已随插件注册；Web settings.describe 仅返回 host-apiproxy 白名单命名空间。两条路径均已落地：
    1. scripts/patch-web-settings.ps1 把 memory 加入 WEB_SETTINGS_NAMESPACES 白名单（已应用于本部署，备份 index.js.bak-20260815，node --check 通过），使 describe/update API 也覆盖 memory；
    2. Web 设置页卡片（主路径）：插件新增客户端 bundle（lib/client.js，dsh.client 声明 + exports["./client"]），在 settings.plugin.item Slot 注册 "Memory" 卡片（order 30），通过同源端点 /_dsh/memory/settings（host lib/web.js 注册）读写配置——不依赖 apiproxy 白名单。
  • 本部署同步状态（2026-08-15 20:45）：18/18 文件 SHA-256 一致（含 lib/client.js、lib/web.js、lib/types/client.d.ts）；verify-after-restart.ps1 全绿；npm test 49/49（test/web-settings.test.js 覆盖 GET 快照、POST 保存、403/409、非法 action、client bundle 静态断言、VM 沙箱加载与卡片注册、webServer 等待注册）。
  • GUI 验证完成（2026-08-15 20:48，DSH 重启后）：
    1. 设置 → 插件 → 插件配置 出现 "Memory (dsh-memory)" 卡片（与终端/Agent 循环/网页搜索并列）；
    2. 展开卡片，表单正确加载当前值（maxBytes=8000 等）；
    3. 编辑 maxBytes → Save → 页面显示 "Settings saved and applied."，Save/Discard 复位为禁用；
    4. 宿主落盘确认：settings.yaml 出现 memory: 段（maxBytes 往返测试后恢复 8000，autoSummarize=true 等）——Web 卡片 → 同源端点 /_dsh/memory/settings → settings.replace → 落盘 → applies: live 即时生效，全链路闭环。
  • 目标「让 DSH Web 设置页面出现 memory」已达成。

部署命令记录

# 1. 预览差异（不改文件）
powershell -ExecutionPolicy Bypass -File E:\git\github\dsh-Plugin\scripts\sync-install.ps1 -DryRun

# 2. 同步（自动备份当前安装副本，不碰记忆数据，不自动重启）
powershell -ExecutionPolicy Bypass -File E:\git\github\dsh-Plugin\scripts\sync-install.ps1 -Backup

# 3. 重启 DeepSeek Harness（已于 2026-08-15 19:15 执行；脚本会自动停掉 @deepseek-ai/dsh 相关 node 进程并重新拉起）：
powershell -ExecutionPolicy Bypass -File E:\git\github\dsh-Plugin\scripts\restart-dsh.ps1 -WhatIf
powershell -ExecutionPolicy Bypass -File E:\git\github\dsh-Plugin\scripts\restart-dsh.ps1

# 4. 让 Web 设置页显示 memory（两条互补路径）：
#    a) 白名单补丁（可选，让 settings.describe/update API 覆盖 memory；幂等、自动备份）：
powershell -ExecutionPolicy Bypass -File E:\git\github\dsh-Plugin\scripts\patch-web-settings.ps1 -WhatIf
powershell -ExecutionPolicy Bypass -File E:\git\github\dsh-Plugin\scripts\patch-web-settings.ps1
#    b) 设置页卡片（主路径，随插件 client bundle 自动注册 settings.plugin.item）
#       重启一次 DSH 后，设置 → 插件 → 插件配置 应出现 "Memory (dsh-memory)" 卡片

#   或手动重启后仅验证（自动校验文件 + 白名单 + 安装副本 MCP 冒烟）：
powershell -ExecutionPolicy Bypass -File E:\git\github\dsh-Plugin\scripts\verify-after-restart.ps1
#    - 手动确认 settings 命名空间出现 memory
#    - 新工具（memory_browse/memory_history/memory_merge 等）可用
#    - memory_stats.scopes / lastError 正常输出

可选后续

  • 用户自选神经网络 embedding 端点（embeddingBaseURL/apiKey/model；未配置时本地哈希向量）。
  • Web 设置页验证：白名单补丁已应用，DSH 重启后用 GUI 确认 memory 表单渲染（设置 → 插件 → 插件配置）。