← 返回列表
需源码安装
dsh 记忆体Memory Body插件
暂不能直接安装（需源码编译或环境不满足）：仓库缺少 package.json，无法用 dsh 插件安装命令安装。 · 最近上游提交 2026/9/12 · 已提供中文文档
LMA (Layered Memory Architecture) 是一个为 DeepSeek Harness 设计的地基插件（Foundation Plugin）。它定义了 “记忆体（Memory Body）” 这一抽象概念及其挂载/卸载协议。 它与其他记忆插件的本质区别在于：LMA 是一个容器和载体，让 dsh-memory-evolve、EchoCore 等“能力性插件”可以挂载其上，它本身也内置了一套可开关的基础记忆流程，作为可选能力。LMA结束记忆功能的“一锅乱炖”，实现跨会话的结构化记忆机制。(目前功能还在持续完善以及测试，对于其他插件的接口在构想完整后逐步推动)
综合分
30.6
GitHub 分
30.6
用户评分
—
★ Stars
2
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add szx-a/ds仓库缺少 package.json，无法用 dsh 插件安装命令安装，改用 GitHub 源安装
信任档位：需留意实装验证未通过
- 是什么
- dsh 原生插件 · chat
- 装得上吗
- 实装验证未通过（unknown），装前请到仓库确认最近更新与 issue
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 13 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
⚠︎ 实装验证未通过（unknown · 2026/9/24） ——可能是验证环境差异，装前建议到 GitHub 仓库确认最近更新与 issue。
数据截至 2026/9/20（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包ds（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
仓库缺少 package.json，无法用 dsh 插件安装命令安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/21 01:59:29
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh 记忆体（Memory Body）插件
社区体验版 · 跨会话记忆：多体 + 挂载 + 自动总结 + FTS5 检索
这是 GitHub Discussions #1822（记忆体 Memory Body） 提案的一个可运行实现。
这是什么
一个 DeepSeek Harness 的记忆插件，实现「命名、跨会话、隔离、可挂载」的记忆单元（Memory Body）：
- 多个记忆体（body）：每个体是一组相关记忆，物理上是一个目录 + JSONL 文件
- 挂载（mount）：控制当前会话能检索哪些体（数据永久、挂载按会话）
- 双权威：user（用户钦定的文档）vs model（模型自动总结的经验）
- 自动总结：把会话提炼成经验写入记忆体
- GUI + 后台 JSONL 双编辑：既能在设置页管体，也能直接改文件
- FTS5 全文检索：中英文 3 字以上任意子串命中
核心闭环：/remember → 存储 → memory_search → 检索。
特性
- 多体 + 挂载：/mount /unmount 按会话挂载
- 降权不删除：/forget 只标记失效（superseded），历史可追溯、可恢复
- 事件溯源：JSONL 权威层 + SQLite FTS5 可重建读模型（索引可丢弃、可重建）
- 中文检索：FTS5 trigram 分词器，3 字以上任意子串命中
- 三平面架构：host（存储 + 命令 + Remote）+ preset（工具）+ client（GUI）
安装
前置：版本对齐（重要）
源码已适配 dsh 0.1.5-rc.2（9 处改动，含挂载标签实时刷新）。npm 发布版目前仍是 0.1.1-rc.2，0.1.5 版待发布。
方式一：手动接入（当前可用的方式）
需要改动 5 个官方文件 + 放入 2 个插件目录：
1. packages/bundle/web-app/package.json —— dependencies 加 2 行：
"@szx-a/dsh-layered-memory-architecture": "workspace:^",
"@szx-a/dsh-layered-memory-architecture-preset": "workspace:^"
2. packages/bundle/web-app/cordis.patch.yml —— 加 2 个 row（host 平面）：
- id: memory-store
name: '@szx-a/dsh-layered-memory-architecture/memory-store'
config:
root: 'F:/dp/memory-body-data' # ⚠️ 改成你自己的数据目录路径！
defaultBodies: [code] # 默认挂载的体，可改成自己的（如 [physics]），该体需先创建
- id: memory-body
name: '@szx-a/dsh-layered-memory-architecture'
⚠️ root 是数据存放目录，请改成你自己的绝对路径（如 'D:/ds/memory-data'），首次启动会自动建目录。
⚠️ defaultBodies 是默认挂载清单，不是创建命令：code 只是示例名，可改成任意体 id（如 [physics]），但该体必须先在磁盘上创建（设置页建，或手动建 body.json），否则 /remember 会报 does not exist。
3. packages/preset/agent-presets/presets/standard/agent.cordis.yml（⚠️ 0.1.2 新路径，旧版在 apps/cli/config/agent-presets/standard/）—— 末尾加 1 个 row（preset 平面）：
- id: memory-body-preset
name: '@szx-a/dsh-layered-memory-architecture-preset'
config:
autoSummarize: false
4. tsconfig.host.json —— references 加 2 行：
{ "path": "./packages/memory/memory-body/tsconfig.host.json" },
{ "path": "./packages/memory/memory-body-preset" }
5. tsconfig.client.json —— references 加 1 行：
{ "path": "./packages/memory/memory-body/tsconfig.client.json" }
6~7. 放入插件目录：
packages/memory/memory-body/ # host 包：存储 + 命令 + Remote + GUI
packages/memory/memory-body-preset/ # preset 包：工具 + 自动总结
8. 构建（在 harness 根目录，必须跑 host + client 两个 face）：
pnpm run clean # 更新版本后先清旧 lib 产物
pnpm install
pnpm run build:lib:host # tsc -b tsconfig.host.json && tsdown --env.DSH_BUILD_FACE host
pnpm run build:lib:client # tsc -b tsconfig.client.json && tsdown --env.DSH_BUILD_FACE client
只跑 host face 会让 dsh web 报 MissingClientBundleError（缺全图 lib/client.js）。
9. 重启：Ctrl+C 停掉 pnpm dsh web 再重启（命令在 node 进程启动时注册，只刷新浏览器不会加载）。
10. 初始化一个体：默认挂载 [code]，但本仓库不含记忆数据（数据是私有的，不随源码分发）。重启后先建体：
- 方式 A：设置页 → 「记忆体」tab → 新建体，id 填 code（或改成你自己的 id）
- 方式 B：手动在 root 目录建 code/body.json（内容见下方「后台编辑」）
建完体才能 /remember / memory_search，否则会报「body does not exist」。
⚠️ 本仓库是源码存档，不含 lib/ 构建产物，且依赖 harness monorepo 的 @deepseek-ai/* 包 —— 必须放进 harness 源码树内构建，不能独立编译运行。
方式二：npm 安装（推荐）
已发布到 npm（@szx-a/dsh-layered-memory-architecture@0.1.1-rc.2 + -preset，基于 dsh 0.1.1-rc.2），适合不想放源码、不想自己构建的情况（npm 包已含编译好的 lib/ 产物和类型声明）。
⚠️ 当前 npm 版是 0.1.1-rc.2（dsh rc.2），尚未发布 0.1.5 版。若你的 dsh 是 0.1.5-rc.2（或 0.1.2 系列），请用方式一（手动接入），npm 版暂时不兼容新版 dsh。
1. 安装两个包（装到 web-app bundle）：
pnpm --filter @deepseek-ai/dsh-web-app add @szx-a/dsh-layered-memory-architecture @szx-a/dsh-layered-memory-architecture-preset
2. 改 packages/bundle/web-app/cordis.patch.yml（同方式一第 2 步）：加 memory-store + memory-body 两个 row。
3. 改 packages/preset/agent-presets/presets/standard/agent.cordis.yml（⚠️ 0.1.2 新路径，同方式一第 3 步）：加 memory-body-preset row。
4. 重启：Ctrl+C 停掉 pnpm dsh web 再重启。
5. 初始化体（同方式一第 10 步）。
npm 安装省掉了方式一的第 1、4、5、6~7、8 步：不用手动加 web-app 依赖（pnpm add 自动写）、不用改 tsconfig、不用放源码、不用构建。
用法
命令
| 命令 | 作用 | 示例 |
|---|---|---|
| /remember | 存一条你钦定的记忆 | /remember 用 pnpm 构建，别用 npm |
| /remember | 存到指定体 | /remember physics 牛顿三定律 |
| /summarize | 把当前对话总结成经验存下 | /summarize |
| /forget | 降权（不删除，检索跳过） | /forget 测试 |
| /mount | 把体挂到当前会话 | /mount physics |
| /unmount | 从当前会话卸下（数据保留） | /unmount code |
记忆写到哪里？（默认写入目标）
最容易踩坑的地方，单独说明。
先分清三个动作：
- 建体（设置页建，或手动建 body.json）= 创建，只在磁盘生成一个体，不等于授权
- 挂载（/mount）= 授权，「这个会话能读写这个体」
- 写入（/remember /summarize）= 实际存内容
只有挂载的体才能被写。刚建好的体不会自动挂载，要先 /mount 。所以「在 GUI 里建了体」之后直接 /remember 会报 No memory body mounted —— 那不是体不存在，是还没挂载。
挂载是累加，可挂多个（/unmount 只删那一个，不影响其他）：
/mount wd-231567 → [wd-231567]
/mount code → [code, wd-231567] # 后挂的插到最前
/mount physics → [physics, code, wd-231567]
默认写入「最近挂载的体」（挂载集第一个）：
- 刚启动、没挂过任何体 → 挂载集 = defaultBodies（默认 [code]），默认写 code
- /mount physics → 把 physics 插到最前，默认写 physics
体必须先存在：默认目标体（或任何你指定的体）若没创建，/remember /summarize 会报 Memory body "xxx" does not exist，不会自动创建。
显式指定体（绕过默认，挂多个时才有意义）：
- /remember → 存到指定体
- /summarize → 总结到指定体
⚠️ 显式指定的体也必须已挂载：/remember x 内容 里若 x 长得像体 id（全小写字母数字/连字符）却未挂载，会报错 Memory body "x" is not mounted，不会静默当文本。所以先 /mount x 再点名。
所有操作的默认目标一览（命令 + 模型工具都遵循同一规则）：
| 操作 | 权威 | 不指定体时的目标 |
|---|---|---|
| /remember | user | 最近挂载的体（挂载集第一个） |
| memory_remember（模型自动） | user | 最近挂载的体 |
| /summarize | model | 最近挂载的体 |
| 自动总结 | model | 最近挂载的体 |
| memory_search（模型自动） | — | 搜所有挂载的体 |
核心规则一句话：所有写入（命令和模型工具）默认写到「最近挂载的体」——因为 /mount 会把体插到挂载集最前。想写别的体就显式指定体 id。
举例（挂 physics 和 code 两个）：
| 操作 | 挂载集 | /remember 内容 存到 | /remember code 内容 存到 |
|---|---|---|---|
| （无操作） | [code] | code | code |
| /mount physics | [physics, code] | physics | code |
| /mount physics 后 /unmount code | [physics] | physics | ❌ 报错 code 未挂载 |
模型工具（自动调用，无需手动）
- memory_search —— 跨会话回忆，检索挂载的体
- memory_remember —— 你明确说「记住 xxx」时自动写入
- memory_forget —— 模型发现记忆过时/错误时主动降权（标记失效、不删除、可追溯）
- memory_correct —— 模型主动纠正：降权旧条目 + 写入纠正后的内容
GUI
- 设置页 → 「记忆体」tab：查看体列表、新建体、删除体、查看条目
- 输入框 dock 挂载标签：聊天输入框附近实时显示当前会话挂载的记忆体（如「记忆体：code, physics」），/mount /unmount 后自动刷新
后台编辑
数据是纯文本，可直接改，改完下次检索自动重建索引：
/
/ # 一个体 = 一个目录
body.json # 体元数据（name/description/kind/trust）
entries.jsonl # 记忆条目，一行一条，append-only
架构（LMA — Layered Memory Architecture）
2 个包（host + preset）+ 3 个加载平面：
┌─ host 平面（cordis.patch.yml）─────────────────────────────┐
│ memory-store 共享存储服务（JSONL + FTS5） │
│ memory-body Remote（体管理 GUI）+ /remember 等命令 │
└────────────────────────────────────────────────────────────┘
┌─ agent preset（agent.cordis.yml）──────────────────────────┐
│ memory-body-preset 工具（search/remember/forget/correct）│
│ + 自动总结 │
└────────────────────────────────────────────────────────────┘
┌─ client（dsh.client + exports["./client"]）────────────────┐
│ 设置页「记忆体」tab + 自 mount Remote │
└────────────────────────────────────────────────────────────┘
服务组件
| 组件 | 形态 | 职责 |
|---|---|---|
| MemoryStore | Service 类 | 共享存储：JSONL + FTS + 挂载集 |
| MemoryBodyService | TypertRemoteService | 体管理 Remote + 命令注册 |
| preset 插件 | namespace plugin | 工具 + 自动总结 |
| client 插件 | 双面 React 插件 | GUI + 自 mount Remote |
存储：事件溯源
- 权威层：JSONL（append-only、可手改、可审计）
- 读模型：SQLite FTS5（可丢弃、每次 search 前从 JSONL 重建）
- 降权不删除：supersede 追加标记行，同 id 折叠取最新
- 双权威：user（用户钦定，只读）/ model（模型总结，可编辑）
作用域与挂载机制
作用域（LMA 的设计哲学）：
| 维度 | 作用域 | 说明 |
|---|---|---|
| 体（body） | 全局共享 | 一个 root，所有工作区/会话可见同一套体 |
| 挂载（mount） | 按会话 | 每个会话挂载自己的子集，互不影响 |
| 默认挂载集 | 全局 | defaultBodies 对所有新会话生效 |
隔离靠「体本身」（独立目录 + 独立 JSONL），不靠工作区限制 —— 用户通过「建体 + 挂载」自由管理，而非系统预设边界。
挂载机制：
- 建体 ≠ 挂载：建体只是磁盘生成 body.json，挂载才是「授权会话读写」
- 挂载累加：/mount 插到最前（最近挂载 = 默认写入目标），/unmount 只删单个
- 挂载持久化：会话挂载集存 root/mounts.json，/mount /unmount 立即落盘；会话重启自动恢复，新会话回退默认
设计取舍
1. 隔离在存储层，而非检索层 —— 记忆按体分开存放，挂载圈定范围，从源头不乱炖
2. 双权威 vs 混在一起 —— user/model 严格分层
3. 降权不删除 vs 覆盖 —— 可审计可回滚
4. GUI + JSONL 双编辑 vs 黑盒 —— 透明可手改
5. 事件溯源 vs 单一数据库 —— 索引可重建
开发历程与踩坑
迭代主线
1. 三大基石提案投递 GitHub Discussions（#1822 记忆体 / #1825 插件市场）
2. 拆分 host 包（存储 + Remote + 命令）与 preset 包（工具 + 自动总结）
3. 修 client 插件自 mount Remote（第三方包不在 api-remotes 白名单）
4. 加会话级挂载（/mount /unmount）
5. FTS5 分词器 unicode61 → trigram（修中文检索）
6. 在 worktree 副本完成 v0.1.2-alpha.1 适配并验证完整跑通（9 处改动，构建 0 错误，挂载标签实时刷新已恢复）
7. 官方发布 v0.1.2-rc.1 后，主体已更新到 rc.1 并跑通（9 处适配跨 alpha.1→alpha.4→rc.1 全程零改动）
8. 官方版本号跳到 v0.1.5-rc.2（跳过 0.1.3/0.1.4），主体已更新到 0.1.5-rc.2 并跑通（9 处适配全程零改动）；0.1.5 npm 版待发布
关键踩坑（已固化到 RECOVERY.md）
| 坑 | 现象 | 根因 | 解法 |
|---|---|---|---|
| 循环等待 | pending (waiting for service: remote.memoryBody) | 把「自己 $mount 出来的服务」写进 inject，apply 前死等 | inject 只写外部依赖，$mount 后用 ctx.get() 读 |
| 假阳性 | 删 row 后「启动成功」但功能全没 | 删 row = 弃用服务，服务不加载自然无 pending | 用 SQLite warning 判断服务是否真加载 |
| waiting for memoryStore | preset 工具不激活 | 前置 MODULE_NOT_FOUND 把 memory-store row 带崩 | 修模块解析（leaf 包进 fallback 闭包） |
| 中文搜不到 | 搜「用中文」搜不到「用中文交流」 | unicode61 把连续中文粘成一个 token | 换 trigram 分词器 |
测试与后续开发
已知限制
1. 检索最短 3 字符：trigram 天生不支持 2 字及以下的搜索（中文 返回空）
2. 自动总结默认关：autoSummarize: false，需手动开启
3. 安装门槛：npm 安装仍需手动改 2 个接入文件（cordis.patch.yml / agent.cordis.yml），未接入一键安装通道
测试
- 单元测试未补：store.ts / fts.ts / parse.ts 是纯函数，尚未补测试
后续开发（按优先级）
1. 记忆提供者接口：让第三方记忆插件（dsh-memory-evolve / EchoCore 等）挂 LMA 之上，PLM「地基插件」定位验证点
2. 挂载体元信息注入：模型只加载已挂载体的 id + 描述
3. 量化对比数据：benchmark（token 节省量、检索命中率）
4. 向量检索：BodyKind 已预留 vector 扩展位，混合检索
5. 权重自然衰减：weight 字段支持记忆自然衰减
版本提示
| 项 | 值 |
|---|---|
| dsh 版本 | 0.1.5-rc.2（源码已适配并跑通） |
| 插件 version | 0.1.1-rc.2（npm 发布版，dsh rc.2）；源码已适配 0.1.5-rc.2 |
| npm 包 | @szx-a/dsh-layered-memory-architecture + -preset |
| peerDependencies | 发布时由 pnpm publish 自动替换 workspace:^ → 对应官方版本 |
兼容性说明
| 版本 | 支持状态 |
|---|---|
| dsh v0.1.1-rc.2 | ✅ npm 发布版（@szx-a/dsh-layered-memory-architecture@0.1.1-rc.2 + -preset） |
| dsh v0.1.5-rc.2 | ✅ 源码已适配并跑通（主体已更新验证），0.1.5 npm 版待发布 |
v0.1.5 适配结论：官方从 rc.2 到 0.1.5 经历重大重构（版本号跳过 0.1.3/0.1.4）。作者已在 worktree 副本（隔离环境）完成适配，并已将主体更新到 0.1.5-rc.2 验证跑通、功能不降级——9 处改动、host/preset/client 三侧构建 0 错误、dsh web 干净启动、挂载标签实时刷新已恢复。适配跨 alpha.1→alpha.4→rc.1→0.1.5-rc.2 全程零改动。破坏点与实测结论：
| 破坏点 | 影响 LMA 的 | 实测结论 |
|---|---|---|
| agent-presets 目录迁移（apps/cli/config → packages/preset） | preset 接入点 | memory-body-preset row 需搬到新位置 |
| @deepseek-ai/dsh-client-runtime 被拆散 | client 插件依赖 | ClientContext → cordis Context；ConversationSnapshot.chat.legacy.nodes → chat 包的 ChatSnapshot.legacy.nodes；store 引擎 → dsh-client-store。共 9 处改动，详见下方适配步骤 |
| ApiProxy 移除 | Remote 层 | ✅ ctx.remote.$mount / TypertRemoteNamespaceMap 未变，零改动 |
作者立场：LMA 已适配 0.1.5-rc.2 并在主体跑通。官方版本号迭代很快（跳过 0.1.3/0.1.4 直接 0.1.5）。0.1.5 的 npm 发布版待定。
LMA 适配新版本的步骤（供先行者自担风险参考）
教程级清单，具体到文件 + 行 + 前后代码。实测 alpha.1→alpha.4 这 9 处改动原样成立、零改动。
A. 接入点（4 处，路径变化）
1. host 接入 — packages/bundle/web-app/cordis.patch.yml，在 plugin-inventory row 后加：
LMA 记忆体：共享存储服务 + Remote（体管理 GUI）+ 命令
- id: memory-store
name: '@szx-a/dsh-layered-memory-architecture/memory-store'
config:
root: 'F:/dp/memory-body-data' # ⚠️ 改成你自己的数据目录
defaultBodies: [code]
- id: memory-body
name: '@szx-a/dsh-layered-memory-architecture'
2. preset 接入 — packages/preset/agent-presets/presets/standard/agent.cordis.yml（⚠️ 0.1.2 新路径，旧版在 apps/cli/config/agent-presets/standard/），末尾加：
LMA 记忆体：模型面向的工具 + 自动总结
- id: memory-body-preset
name: '@szx-a/dsh-layered-memory-architecture-preset'
config:
autoSummarize: false
3. 依赖 — packages/bundle/web-app/package.json 的 dependencies 加 2 行：
"@szx-a/dsh-layered-memory-architecture": "workspace:^",
"@szx-a/dsh-layered-memory-architecture-preset": "workspace:^"
4. references — tsconfig.host.json 的 references 加：
{ "path": "./packages/memory/memory-body/tsconfig.host.json" },
{ "path": "./packages/memory/memory-body-preset" }
tsconfig.client.json 的 references 加：
{ "path": "./packages/memory/memory-body/tsconfig.client.json" }
B. client 源码改动（@deepseek-ai/dsh-client-runtime 被拆散导致，5 处）
5. src/client/index.tsx 第 8 行 — ClientContext 换包：
// 旧
import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
// 新
import type { Context as ClientContext } from '@deepseek-ai/cordis'
6. src/client/MountedBodiesLine.tsx 第 2-3 行 — import 换成 ChatSnapshot：
// 旧
import type { ConversationSnapshot } from '@deepseek-ai/dsh-client-runtime/client'
import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots'
// 新
import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots' // SnapshotSelectorHook 仍在 ui-slots
import type { ChatSnapshot } from '@deepseek-ai/dsh-client-ui-chat/client' // 消息节点在 ChatSnapshot.legacy.nodes
7. package.json — 删 3 处 dsh-client-runtime，新增 ui-chat：
// dsh.client.inject 数组：删 "@deepseek-ai/dsh-client-runtime"，加
"@deepseek-ai/dsh-client-ui-chat"
// peerDependencies / devDependencies：删 "@deepseek-ai/dsh-client-runtime": "workspace:^"，加
"@deepseek-ai/dsh-client-ui-chat": "workspace:^"
我们 LMA 没直接用 store 引擎，删掉 runtime 即可，无需加 @deepseek-ai/dsh-client-store。
8. tsconfig.client.json — 删 client/runtime reference，加：
{ "path": "../../client/ui-chat" }
9. src/client/index.tsx — 补 2 个空 import + slot 参数类型：
// 顶部补（提供 client 服务类型声明）
import type {} from '@deepseek-ai/dsh-api-remotes/client' // ctx.remote 类型
import type {} from '@deepseek-ai/dsh-client-ui-renderer/client' // ctx.slots 类型
// conversation.composer.dock slot 的 inject factory（第 63、65 行）
// 旧
inject: (sessionId: string) => ({
listMounted: async (): Promise => {
const r = await remote.listMounted(sessionId)
return r.ok ? r.value : []
},
}),
// 新（去掉 : string 注解，用 String() 转换 branded 类型 SessionIdOf）
inject: (sessionId) => ({
listMounted: async (): Promise => {
const r = await remote.listMounted(String(sessionId))
return r.ok ? r.value : []
},
}),
实时刷新信号也已恢复：MountedBodiesLine 里 useSession(s => s.chat.legacy.nodes.length) → useChat(s => s.legacy.nodes.length)（照官方 StatsLine 先例，useChat 由 ui-chat merge 进 SessionStandardProps，session 作用域 slot 组件自动获得）。
C. 构建 + 验证（⚠️ 关键教训）
pnpm run clean # 更新版本后必先清旧 lib 产物，否则假 MISSING_EXPORT
pnpm install # 链接新依赖
pnpm run build:lib:host # = tsc -b tsconfig.host.json && tsdown --env.DSH_BUILD_FACE host
pnpm run build:lib:client # = tsc -b tsconfig.client.json && tsdown --env.DSH_BUILD_FACE client
pnpm dsh web --no-open --port 0
- 必须跑 host + client 两个 face：只跑 host face 会让 dsh web 报 MissingClientBundleError（缺全图 lib/client.js）。
- 通过标准：打印 URL + ExperimentalWarning: SQLite，无 pending、无 typert manifest、无 MissingClientBundleError；HTTP 探测返回 401 即确认监听。
- 编译错误先分真假：Cannot find module .../remote、MISSING_EXPORT 类报错，多数是「依赖产物没构建 / 旧 lib 残留」，先 clean + 全量构建，剩下的才是真 API 变化，别急着改好代码。
目录结构
LMA 源码（两个版本相同，官方从未改动）
packages/memory/
├── memory-body/ # host 包 @szx-a/dsh-layered-memory-architecture
│ └── src/
│ ├── index.ts # MemoryBodyService（Remote + 命令注册）
│ ├── memory-store.ts # MemoryStore（共享存储服务）
│ ├── store.ts # JSONL 权威存储（纯函数）
│ ├── fts.ts # FTS5 检索（trigram）
│ ├── command.ts # /remember /summarize /forget /mount /unmount
│ ├── summarize.ts # 总结逻辑
│ ├── parse.ts # 输入解析
│ └── client/ # GUI（记忆体 tab）
└── memory-body-preset/ # preset 包（-preset 后缀）
└── src/
├── index.ts # 工具 + 自动总结装配
├── tool.ts # memory_search / remember / forget / correct
└── auto-summarize.ts # 自动总结触发
LMA 自己的源码目录在 0.1.1-rc.2 和 0.1.5 里完全一致——官方重构从没碰过 packages/memory/（实测从 alpha.1 到 0.1.5-rc.2 全程对 packages/memory/ 零改动）。变的是下面的接入点。
接入点目录（dsh 版本不同，路径不同）
| 接入点 | 0.1.1-rc.2（旧） | 0.1.5（新） |
|---|---|---|
| host 行（memory-store / memory-body） | packages/bundle/web-app/cordis.patch.yml | packages/bundle/web-app/cordis.patch.yml（不变） |
| preset 行（memory-body-preset） | apps/cli/config/agent-presets/standard/agent.cordis.yml | packages/preset/agent-presets/presets/standard/agent.cordis.yml（⚠️ 迁移） |
| web-app 依赖 | packages/bundle/web-app/package.json | packages/bundle/web-app/package.json（不变） |
| tsconfig references | tsconfig.host.json / tsconfig.client.json | tsconfig.host.json / tsconfig.client.json（不变） |
0.1.2 里 agent-presets 目录从 apps/cli/config/ 整体迁移到了 packages/preset/，所以 preset 接入点路径变了；其余三个接入点路径不变。完整 9 处适配见上方「LMA 适配新版本的步骤」。
许可证
见 LICENSE。