dsh-memory-evolve

一句话定位

为 DeepSeek Harness 注入一套「越用越懂你」的 AI 长期记忆与协作扩展：让 AI 跨会话、跨项目、跨设备记住你是谁和项目里定下的事，附带待办/技能/提示词/画板管理、外部 AI 代理调度、会话广播与房间协作等十几个可选子模块，覆盖 WebUI 管理面板。

核心能力

• 五轨分层记忆自动注入（用户档案 / 全局事实 / 项目关键记忆+git 分支过滤 / 项目日志 / 每日日志），写入与读取均通过 memory 工具
• AI 提议-用户确认双轨写入：key/user/memory 自动进待确认队列，由记忆 Tab「待确认」中采纳或拒绝
• 四轨待办管理（生活 / 工作 / 项目 / 每日），支持到期提醒、状态筛选与四象限，按当前工作目录自动隔离项目待办
• 技能自我进化：后台审查可自动把反复踩坑的方法论固化为技能，由 skill_manage 工具创建/编辑/禁用
• 外部 AI 代理调度（COI）：把重活派给 kimi/codex/grok/hermes 等 CLI 代理，后台异步执行、结果自动沉淀回记忆
• 多会话广播房间 + 工作区冲突协调：让一组并行会话拥有房间消息、文件占用锁与冲突告警
• 提示词库、无限画板（素材收集）、会话书签与任意轮分支、记忆跨设备同步（git 仓库级别）、会话评审员（独立模型 per-session 持续评审）

技术实现

• 语言: JavaScript（Node.js ESM；src/client/ 为 TypeScript/TSX，src/ 通过 scripts/build.mjs 编译到 lib/）
• 关键依赖: 零运行时依赖（仅使用 Node 内置 node:fs / node:path / node:child_process / node:crypto / node:os / node:url）；客户端通过 dsh.client.inject 注入 @deepseek-ai/dsh-client-runtime
• 架构模式: 标准 Cordis 插件（export function apply(ctx, rawConfig) + inject 列表），宿主端通过 cordis.patch.yml 的 bundle patch 自动注册 dsh-memory-evolve 一行；每个可选子模块都遵循「独立开关 + 独立存储 + 运行时同步装配/卸载」纪律
• 入口文件: lib/index.js（host 端插件入口，541 行配置 + 678 行 apply 装配）；lib/client.js（浏览器端，含 41 个 React 组件）

适用场景

日常和 DSH 协作但希望 AI 跨会话记住项目约定的开发者：今天定下的架构决策、踩过的坑、用户偏好，下次开新会话直接问 AI 就能衔接；同时希望把多会话协作、外部 AI 派单、跨设备项目记忆这类「操作复杂但常规」的扩展能力收在一个插件里用 WebUI 集中管理，而不用单独装十几个小插件。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:csyangwen/dsh-memory-evolve

配置项

上表为常用项的子集，完整配置见 lib/index.js:69-245 的 DEFAULTS 对象；所有运行时可改项（RUNTIME_KEYS）既可在 cordis.patch.yml 静态配置，也可在 Web 设置面板即时切换。

常见问题

Q: 装上后什么都没发生是正常的吗？

A: 正常。本插件核心能力（五轨记忆 / 待办 / 技能管理 / 记忆同步补丁）默认就生效；其他十几个子模块（外部 AI 调度、会话广播、画板、评审员等）默认关闭，需要到「Memory Evolve 设置 → 配置」打开对应开关才会出现 Tab 和工具。

Q: 提示「duplicate loader entry id」启动失败怎么办？

A: 你的 profile patch 里还残留旧版本的手动 insert 行。包内 cordis.patch.yml 已经把 dsh-memory-evolve 写入 bundle patch 自动注册，重复 insert 同 id 会让加载器报错。删除 ~/.dsh/profiles/<name>/cordis.patch.yml 里这一行即可。

Q: 五轨记忆会塞爆上下文吗？

A: 不会。注入策略是「只注入低频稳定轨」——用户档案 / 全局事实 / 项目关键记忆（按 git 分支过滤）实时读取并以 user-role 尾部消息注入；项目日志与每日日志不注入（每回合增长会破坏前缀缓存），改为按需读取 + 快照中固定提示要求模型每轮收尾调用 memory 工具写入。keyProgressiveDisclosure 开启摘要模式后，关键记忆也按需 expand 加载全文。

Q: 记忆同步会不会把代码也同步过去？

A: 不会。同步只覆盖 memoryDir 下的项目记忆与全局记忆（按轨分别开关），代码文件不会被读取或写入；项目轨默认把同步数据放到项目代码仓库的专属分支（不污染任何代码分支），全局轨需要单独配置一个共享记忆仓库。

Q: 用了一段时间后发现记忆变得很乱，怎么整理？

A: 记忆 Tab 提供「归档」入口——把暂时不用的全局记忆 / 用户档案 / 项目关键记忆条目移到 *-archive.md（不注入、可一键转回主轨）。删除失败时会先归档再删除，宁可重复不可丢失；批量归档/采纳/拒绝都有按钮，不需要逐条手动操作。

Q: 跟官方插件冲突怎么办？

A: 本插件已合并原独立插件 dsh-skills-manager / dsh-skill-browser 的功能。从旧版本升级前必须先卸载旧插件（删除 profile patch 里的 insert 行 + 删除 ~/node_modules/@dsh-local/skills-manager 软链），否则旧插件客户端调用 DSH 已移除的 ui-slots.deferRegistration 会让 Web 整页不可用。

Q: 会话评审员（advisor）会干扰主 AI 吗？

A: 默认完全沉默（advisorEnabled=false）。开启后评审员只观察你界面上看到的对话文本（不含思考/工具调用），记入面板日志；仅当严重度达到 nit / concern / blocker 阈值、且配置允许时，才会以用户指令形式注入主会话触发即时纠偏——你可以在评审面板里即时打断或调整它。

上手难度

进阶 — 核心五轨记忆零配置即可生效，但插件聚合了十几个独立子模块并提供数十项配置项，想把「外部 AI 调度 / 跨设备同步 / 评审员 / 广播房间」这些高阶能力串成完整流水线需要读懂模块边界与开关依赖（参见 README 场景章节）。

已知问题与限制

• spawn 出来的子会话在新会话无历史 header 时仅继承发起会话的 provider/model 配置；GUI 改模型等主动切换机制在 lib/session-orch.js:549 标注为后续再完善
• 会话评审（advisor）通过 sessionTitle.get(session) 读取会话名称；离线/已归档会话 session.events 不存在时必须先做 agent?.session 存在性检查（lib/index.js:2104-2106），否则会因传 undefined 抛出 TypeError 导致评审流静默失败
• 画板（canvas）遍历节点时同样依赖 sessionTitle.get；曾因缺失判空导致整个 GET 500、前端刷新后空板，已在 lib/index.js:2027-2042 加固
• 会话搜索（sessionSearchEnabled）当前只支持 Codex 源（~/.codex/sessions + archived_sessions 明文 JSONL）；DSH 会话（zstd 拼接帧）暂不实现
• 仅同进程内的会话可被 de_session 程序化唤醒；跨实例 / 跨机器无法程序化唤醒（README-详细说明.md:52）
• dat 同步走的 git 仓库地址若使用公开项目仓库，记忆默认存到代码仓库的专属分支；需要把记忆与代码彻底隔离时，必须显式配置一个独立的共享记忆仓库

一句话：让 DSH 里的 AI 拥有跨会话的长期记忆、帮你管理待办与技能、还能拉起一群 AI 会话和外部 AI 代理协同干活——越用越懂你，换会话不丢上下文。

本指南按真实工作流组织，每个场景讲「适合谁、能做什么、怎么用、会得到什么」。

相关文档：详细功能说明 · 记忆同步 · 更新日志 · English

---

快速开始（安装）

插件包内自带 cordis.patch.yml（dsh.bundle.patch 声明），dsh plugin add 安装后 host 端自动注册，无需任何手动配置。以 web profile 为例，两步装好：

# 1. 安装到 profile（本地目录用 link:，也可用 git/registry 包地址）
dsh plugin --profile web add github:csyangwen/dsh-memory-evolve

# 2. 重启 dsh web 即生效

⚠️ 不要再往 ~/.dsh/profiles/web/cordis.patch.yml 手动 insert 本插件：bundle patch 已自动注册，重复 insert 同 id 会让加载器报 duplicate loader entry id 无法启动。完整说明见 详细功能说明「标准安装」章节。

修改默认配置（如开启回合内记忆审查）：在 profile 的 cordis.patch.yml 用 id 覆盖（顶层写法，非 insert）：

- id: dsh-memory-evolve
  config:
    reviewEnabled: true      # 开启回合内记忆审查（默认关）
    reviewInterval: 10       # 每 10 个用户回合审查一次

插件异常导致 DSH 无法启动时，临时禁用（等修复后取消）：同样在 profile 的 cordis.patch.yml 加一行即可，无需卸载：

- id: dsh-memory-evolve
  disabled: true

从旧版本升级：若你此前按旧文档手动 insert 过本插件，请删除 profile patch 里的 insert 行（否则与 bundle 自动注册重复）。

卸载：dsh plugin --profile web remove dsh-memory-evolve，一切效果随插件卸载自动清理。

---

认识它（30 秒）

装上插件后，打开任意会话，你会多出一排能力标签：记忆 · 技能 · 待办 · 无限画板 · COI 调度 · 会话广播 · 提示词 · 记忆同步 · 模型设置 · 书签 · 会话评审 · Web UI 设置 · Memory Evolve 设置。AI 侧则多了一批工具：记忆读写、待办、技能管理、本地文件搜索、会话编排、会话广播、外部 AI 派单、提示词注入、模型查询……

一句话概括这些能力：让 AI 记住你、替你管、替你做、互相配合做。

小提示：插件里很多能力默认关闭（不占 AI 的工具清单），需要时在「Memory Evolve 设置」里打开即可。下面的场景大多是组合玩法——把相关功能都打开，才能串成完整的流水线。

---

场景一：让 AI 真正记住你（长期记忆）

适合谁：所有人。这是插件的核心，也是其他一切功能的地基。

AI 的对话是「一次性」的：换项目、隔几天、开新会话，它就忘了你是谁。插件的五轨记忆让 AI 拥有跨会话的长期工作记忆：

• 用户档案：你的偏好、公司、沟通习惯——AI 每回合都能看到；
• 全局事实：环境、工具、惯例等长期知识；
• 项目关键记忆：当前项目的约定、决策、架构、踩坑，自动注入上下文，重要结论可标记只在某个 git 分支生效；
• 项目日志 / 每日日志：每回合自动记录进展，按需读取，历史可追溯。

怎么用：

1. 正常和 AI 对话即可——每回合结束时它会自动把进展写进项目日志和今日日志；
2. 发现重要事实时对它说「记一下：这个项目的部署端口是 8080」，它会写入项目关键记忆，你确认后才生效——AI 不会擅自往记忆里写东西；
3. 过几天、换了个会话，直接问「查一下记忆，上次我们定下的架构决策是什么」——它能无缝衔接；
4. 记忆多了之后，让 AI「把 XX 那条记忆归档」——归档条目不再注入上下文，随时可转回；
5. 情绪反馈记录：你对工作结果的评价（如「太好了」「怎么还没改对」）会被 AI 记入当日与项目日志（【反馈】 行，含情绪、任务分类、你的原话）——积累后随时可以让 AI「分析一下最近我对哪些方面不满意」，判断它在哪类任务上做得好/不好。

会得到什么：AI 从一个「每次会话都失忆」的对话机器，变成了解你全盘工作的长期伙伴——隔天继续开发，它直接引用昨天的结论，不用你复述。

---

场景：多台电脑共享项目记忆（记忆同步）

适合谁：办公室和家里两台电脑干活、或有同事协作同一个项目的人——不想在每台电脑上把重要结论重新讲一遍。

怎么用（详见 记忆同步）：

1. 「Memory Evolve 设置 → 配置」打开「记忆同步」模块开关（这只是让功能可见）；
2. 在项目会话的「记忆同步」Tab 打开「本项目同步」——点「开始同步」即可（记忆远端默认用你的代码仓库，自动存进专属分支，不污染代码），再点「同步并推送」完成首次推送；代码公开（如 GitHub 开源）但记忆想私藏？填一个共享记忆仓库地址——一个仓库装所有项目的记忆（每项目一条专属分支），记忆与代码彻底隔离；
3. 另一台电脑 clone 项目后打开——自动认亲（同一仓库地址 = 同一项目），拉下来即可继续用；
4. 平时照常写记忆（实时落盘、零延迟），攒一批点一次「同步」；两台电脑都改了同一条记忆才会出现冲突，Tab 里选「采用本机 / 采用远端 / 两者都要」即可。

会得到什么：项目关键记忆、项目日志、归档、项目待办跨设备一致；填了共享记忆仓库后，全局记忆（用户档案/每日日志/待办）也能跨设备（四个独立轨开关，开哪个同步哪个）——换电脑不换记忆。没开同步的项目完全不受影响（保持纯本地状态）。

---

场景二：多项目并行开发，每件事都不丢（待办 + 项目日志 + 本地搜索）

适合谁：同时维护多个项目、经常被「之前那个方案是怎么定的」卡住的开发者。

• 四轨待办：生活 / 工作 / 项目 / 每日。「项目」轨按工作目录隔离，换目录互不干扰。说「记住，周五前把二级面板部署到手机访问实例」，自动落成项目待办（带重要/紧急、截止日期）；每天收尾 AI 会提醒你到期的待办；
• 项目日志：每个项目的进展按目录隔离沉淀，日志自动带 [git main] 分支标记，可溯源；
• 本地文件搜索：对 AI 说「搜一下本机有没有写过类似的东西」——按文件名找文档（可扩展到全类型）；也能内容检索：「哪个文档里提过 XX」直接返回命中文件和片段。

怎么用：

1. 新项目开工直接开聊，项目日志自动建档；
2. 冒出的想法对 AI 说「记住」，它会进待确认队列——到「待办」里采纳或拒绝，你说了算；
3. 想不起来就问「之前有个文档提到过 XX」。

会得到什么：同时开 3 个项目也不乱——每个项目的记忆、待办、文档线索各归各的目录，问一句就能捡起来。

---

场景三：一个人指挥一群 AI 干活（内部团队）

适合谁：想把 AI 用成「团队」的人——一个主会话指挥美工、前端、后端、测试多个子会话。

怎么用：

1. 拉起团队：对主会话的 AI 说「创建 4 个会话：美工负责网站视觉、前端负责页面、后端负责接口、测试负责验收，把它们拉进同一个协作房间」——它立刻创建 4 个标准会话（出现在左侧列表、随时可接管），自动继承你的模型与工作目录；创建时可指定 Agent 预设（如「用代码模式创建前端会话」），决定该会话的工具面与人格；
2. 协作沟通：房间建好后，谁改了什么、谁干完了，全员可见；成员状态（正在生成 / 空闲）变化会自动收到「房间动态」通知；房间消息可以带图片——截图直接发群里，接收方 AI 通过 read 拿到图片文件路径，可读图、可转发到 IM 渠道；
3. 派活与催活：问 AI「现在谁在干活、谁空闲了」，它会查看各会话状态；对空闲的会话说「叫前端把结果发过来」，AI 自动唤醒它并派活——不会批量自动唤醒，一切由你（或你的主会话）有意识地指挥；
4. 防冲突：同一项目多个会话并行改代码时，开工前对 AI 说「声明一下你要改哪些文件」——其他人（及其 AI）能看到「谁在改什么」；真撞车了，写入方会收到冲突警告，还有「工作区活动」通知（并行开始/结束、成员变化时单独推送）随时告知谁在跑、在干什么；
5. 结果回传：各成员干完把结果发回房间，你汇总确认。

持续运转（关键）：主会话自己一直在运行，所以它能随时唤醒已经休息（空闲）的会话继续干活——催活、收结果、派下一轮，哪怕你不在电脑前，队伍也能一路推进到出结果。唯一的前提是主会话所在的 DSH 进程保持运行；如果主会话空闲了或 DSH 被关掉，唤醒链就停了——需要你回来发一条消息，队伍重新开动。

会得到什么：一个人的开发产出，变成一个小团队的吞吐。任务交接、唤醒、冲突预警全链路自动化，房间消息留痕可查。

---

场景四：重活派给外部 AI 代理（外部外援）

适合谁：需要把大任务（视觉重设计、代码审查、完整功能开发）交给专用 AI 代理（Kimi / Codex / Grok / Hermes）的用户——不想被阻塞，又不想错过结果。

怎么用：

1. 对 AI 说「把这个任务派给 grok：移动端适配改造」——后台异步执行，立即返回任务号，不卡当前会话，你可以继续聊别的；
2. 期间随时问「任务进度如何」，或在「COI 调度」里看实时日志流；
3. 派单时 AI 可自主选择带上你的项目记忆——外部代理也「懂项目约定」；
4. 派单可以带图：对 AI 说「把这张截图发给 grok 分析」——附件支持本地路径/远程 URL/本会话图片（你在输入框贴的图），codex/kimi/hermes 都能真看图（grok 走 prompt 读图，zcode 纯文本会明确拒绝）；
5. 完成后结果摘要自动写入项目日志与今日日志——派出去的活自动变成你的记忆资产。

会得到什么：AI 派活给 AI，你只负责确认验收。视觉改版、深度代码审查、批量重构这类「重活」都能甩出去，主会话保持轻快。

---

场景五：内外协同——一支队伍，两种兵种

适合谁：任务大到单靠一边搞不定的人。这是插件协作能力的完全体：内部会话负责「需要上下文和来回打磨的活」，外部代理负责「一次性重活」，两者通过记忆、房间、提示词串成一条流水线。

一个完整的真实流程（产品视觉改版）：

1. 分工：主会话 spawn 前端、测试两个内部会话并拉进房间；同时把「全站视觉重设计」派给外部代理 Kimi；
2. 外部主刀：Kimi 后台跑重设计（不占任何会话）；期间内部前端会话先做数据层和页面结构，不干等；
3. 接力：Kimi 完成，摘要自动沉淀进项目记忆——主会话把设计结论发到房间，前端会话读记忆拿到设计规范，开始集成；
4. 问题升级：集成中发现一个诡异样式问题，前端会话卡住——主会话把这个 bug 派给 Grok 深挖，结论回房间，前端会话照结论修复；
5. 验收：测试会话跑完验收流程，结果发回房间，你最后确认。

协作的四个结合点，可以自由组合：

• 任务接力：外部代理的产出（摘要/结论）自动进记忆 → 内部会话接力执行——外部做重活，内部做集成与打磨；
• 问题升级：内部会话遇到难啃的问题 → 主会话派给外部代理深挖 → 结论回房间——内部快节奏迭代，外部慢工出细活；
• 标准统一：给外部代理派活时，注入你沉淀的提示词（如「代码审查清单」「PRD 规范」）——外部代理按你的流程干活，不靠运气；
• 状态同步：谁在跑、谁干完了，房间 + 工作区活动 + 通知随时可见——你不用当人肉调度员。

会得到什么：一条「外部主刀 → 内部集成 → 测试验收 → 你确认」的完整流水线。大任务不再是一个人（或一个 AI）硬扛，而是内外两支队伍分工协作。

---

场景六：AI 的自我纪律——提示词注入

适合谁：想把「好用的工作方法」沉淀下来、让每个 AI（包括外部代理）都按同一套流程干活的人。

提示词库是指令范式资产库：代码审查、调试、PRD、测试策略……把常用的工作方法固化成提示词（可分类、可搜索、可启用/禁用）。

怎么用：

1. AI 自己选、自己注入：AI 觉得当前任务适用某套流程时，它会自己查看提示词库、选中合适的提示词注入自己——「接下来按代码审查清单执行」；下一轮它自动遵循，不打断当前回复；也能「立即注入」，当前回合马上生效；
2. 你一键注入：在「提示词注入」里选中一条，点「注入一次 / 持续注入 / 立即注入」——持续注入就是「每回合提醒 AI 按此纪律干活」；
3. 临时注入：不建提示词，直接输入一段要求注入，自动存入库中，下次复用；
4. 派活带纪律：给子会话、外部代理派活时，让 AI 把对应提示词一起带上——整个团队用同一套标准。

会得到什么：好方法不再只存在你脑子里或一次对话里——它变成可复用的「团队操作手册」，AI 会主动遵守，你只管维护手册质量。

---

场景七：会话太长、太贵、容易糊——书签与分支

适合谁：对上下文开销敏感、一个会话动辄上百轮的深度用户。

• 会话书签：每一轮都可以点星（☆）标记，「书签」列出全部书签（名称/轮次/时间/摘要，可搜索），点击一键跳回任意一轮——探索到「这个结论很重要」就打个星；
• 任意轮分支：官方只支持从最后一轮创建分支；本插件把中间任意轮的分支入口接管——书签列表点「分支」（或直接点官方分支按钮，中间轮会弹出确认），走官方分支通道创建新会话，进入官方分支谱系；
• 上下文占用提醒：输入框圆环实时显示上下文占用——≥30% 变黄、≥40% 变红，提醒你该打书签、该开分支、该开新会话了。

怎么用：

1. 探索性会话在关键轮次点 ☆，给书签起个名字（如「方案 A 评审结论」）；
2. 想从中间某个决策点另开一条线，书签列表点「分支」；
3. 看到圆环变红，把当前会话打个书签，开新会话继续。

会得到什么：上下文不再是一根只能从头滚到尾的绳子，而是带锚点、可分支、可跳转的时间线——每一轮的探索成果都能被精准复用，不会再因为「会话太长了」被迫放弃中间的好结论。

---

场景八：离开电脑也能用（手机访问 + 会话筛选 + 通知）

适合谁：离开电脑也想继续和 AI 协作、或者同时开很多会话看不过来的人。

• 手机浏览器访问：DSH 界面适配了手机——对话区/消息气泡满宽、输入栏「⋯」上拉收纳工具栏与模型选择，手机上操作和电脑端一致；
• 会话列表筛选：左侧列表可只显示「进行中的会话」，一屏看清谁在干活——桌面端同样适用；
• 渠道通知（de_notify）：对 AI 说「任务完成用飞书通知我」，重要结果推到飞书/QQ/微信/企业微信，电脑前/手机上立刻知道（通知内容带「这是通知」标注，可附图片/文件）；
• web 站内通知（de_notify channels=web）：对 AI 说「发个站内通知给我」，通知直接落到网页右上角的铃铛——未读数字徽标 + 弹窗列表，能看到「哪个会话发来什么」，点主题跳转到那个会话、长内容点「查看详情」打开大弹窗看全文；铃铛可随意拖动、松手吸附到屏幕左/右边缘（位置记忆）。发到 web 和发到飞书等 IM 是同一句话，只是换个送达目的地（channels 传 web，或 all 一起发）；
• 渠道直发（de_channel_send）：AI 随时主动把文本/图片/文件发到你的 IM 渠道（不带通知标注）——「把生成的图片/文档发给我」类场景；四个渠道（飞书/QQ/微信/企微）全部支持，附件来源可选本地路径/远程 URL/内联 base64/本会话图片（sessionImage=true 直接转发你在 DSH 输入框粘贴/拖入发送的图；attachmentId 显式引用，配合 de_session_images 先查本会话有哪些图，需 DSH 260810+ 快照）。

会得到什么：重活照派、进度照盯，人不用守在电脑前——回电脑后从左侧列表接管会话继续。

---

场景九：给每个会话配一个隐形评审员（会话评审）

适合谁：想让 AI 干活时有一双"第二眼睛"把关、又不想自己逐句盯的人——尤其是项目里定了纪律（如"回复前先说明自己在哪个目录"）却总发现 AI 聊着聊着就忘了的情况。

能做什么：

• 独立评审员：给每个会话挂一个独立的评审会话，它只观察你在界面上看到的对话（用户说的话 + Agent 的回复正文），看不到思考过程、工具调用参数等内部细节——像旁边坐了一位只旁听对话、不碰键盘的同事；
• 每轮实时评审：对话每推进一轮，评审员就基于完整上下文评审一次——它是持续会话，像普通 LLM 长对话一样记住全部历史、永不截断，不会"忘了前面说过什么"；
• 需要时实时提醒（steer）：评审员发现值得说的点，会以用户指令的形式注入当前会话——Agent 会把它当成你说的话直接执行（2026-08-13 拍板：实测带"非用户指令"标记会让 Agent 质疑来源、执行力下降，所以伪装成用户指令效果最好）；GUI 对话流中这类消息显示为折叠行 [severity] 前缀，方便你一眼认出哪些话其实是评审员说的；
• 四级严重度：info（仅记录、默认不注入主会话，可配置注入）/ nit（小建议）/ concern（值得处理）/ blocker（必须立即处理）——不是所有话都打断，只有该说的才说；
• 新建评审会话：面板里一键清空评审员的上下文与记忆重来——新会话第一条指令由你告诉它背景，上下文长度由你掌控；
• 直接向评审员提问：面板里随时提问，它立即回答（回答只在评审面板展示，不注入主会话流）——像随时可以问的旁听同事；
• 四层级约束：系统提示词（全局默认，可查看全文/修改/一键恢复）/ 项目约束（本工作区共享）/ 会话约束（本会话保留）/ 本次评审会话约束（随"新建评审会话"清空）——四层拼接注入，冲突时越局部越优先；
• 记录可查：评审记录 JSONL 持久化，面板「记录」可追溯。

怎么用：

1. 「Memory Evolve 设置 → 配置」打开「会话评审」（advisorEnabled，默认关闭）；评审模型缺省继承当前会话模型，也可单独配置 advisorProvider/advisorModel；
2. 会话页出现「会话评审」悬浮窗，点开面板即可看到评审员的实时评审流与上下文占用；
3. 在「约束」Tab 给评审员立规矩（如项目约束："每次回复前先说明自己在哪个目录"），保存立即生效；
4. 想让评审员重头开始就点「新建评审会话」；想直接问它就点「提问」；
5. Agent 侧：评审提醒以折叠行 [severity] 出现在对话流里——你能看到评审员说了什么、Agent 是否照做。

会得到什么：每个 AI 会话都多了一位持续在岗的"旁听同事"——它不打断你的节奏，只在关键时刻以你的口吻提醒 Agent 纠偏；项目纪律、会话约束有人替你盯着，不会聊着聊着就忘了规矩。

---

场景十：散落的素材，一块画板装下（无限画板）

适合谁：设计稿在下载目录、合同在文档库、参考图在桌面、录音在个人文件夹——每次要用都得开 Finder 一层层翻的人；以及想让 AI"看得见"你手头素材、又不想把素材一股脑塞进对话上下文的人。

能做什么：

• 素材集中上板：三种入口——路径上板（粘贴本地路径）、便签（画板内直接写，内容不落盘）、搜索上板（真实搜本机文件，搜到一键上板）；文本类文件上板后自动读取内容；
• 一眼看见：无限平移/缩放画布，卡片自由摆放、右下角拖拽调大小；图片/音视频/文本在画板内直接预览，Word/PDF 等走系统默认应用打开；
• 单板 + 视角筛选：物理上一块画板，节点带归属徽标（🌐 全局 / 📁 项目 / 💬 会话）；默认会话视角看"自己会话 + 当前项目 + 全局"，切「项目」看该项目全部会话，切「全局」看所有；
• 快速调用：复制节点 ID / 标题 / 路径 / 引用串（[canvas:id] 标题），把引用串丢给 AI，它就能凭 id 找到素材；
• AI 双向（拉取式）：AI 用 de_canvas 工具按 id 查画板、读素材内容、往画板中央区放便签（带「AI 放置」标记）——画板内容不注入上下文，需要时主动查，省 token 不打扰；
• 本地路径引用：文件留在原地，画板只记"指向哪里"——源文件改动实时可见，删除源文件后卡片显示失效提示；
• 安全边界：AI 只能读已上板的节点（没有任意路径读取 API）；敏感目录（.ssh/.config 等）即使上板也拒绝代理。

怎么用：

1. 「Memory Evolve 设置 → 配置」打开「无限画板」（canvasEnabled，默认关闭）；
2. 会话页出现「画板」Tab：路径上板 / 便签 / 搜索上板，卡片自由摆；
3. 点卡片「引用」复制引用串，对 AI 说"去画板拿 XX"——AI 用 de_canvas 查/读/放便签；
4. AI 放的便签落在画板中央虚线区，拖到想要的位置即可。

会得到什么：告别"文件在哪来着"的反复翻找——素材集中一块画板，人和 AI 在同一张桌子上干活：你摆、AI 拿；AI 放、你看。

---

还有这些能力（一句话索引）

• 技能自我进化：反复踩坑的方法论自动固化成技能，同类任务下次直接按流程执行；
• 技能管理：记忆 Tab 里浏览/搜索/禁用/编辑全部技能、添加自定义技能目录（原独立插件 dsh-skills-manager 已合并进本插件，旧插件用户升级前先按安装文档卸载旧插件）；
• 无限画板：把散落各处的文件/文本/图片/音视频集中到一块无限画布上陈列——本地路径引用、单板+视角筛选（会话/项目/全局）、画板内直接预览/复制/引用；AI 也能按 id 读画板素材、往画板中央区放便签（de_canvas）；
• 会话搜索：让 AI 搜索本机其他 AI 工具（如 Codex）的历史会话——「之前 Codex 里做过 XX」直接问；
• 模型配置：插件侧维护各模型的启用状态、思考等级、备注，并标注是否支持图片输入（🖼 标记，AI 选模型时一目了然）；
• 回合内记忆审查：每隔 N 轮，AI 主动提炼值得记住的信息交给你确认——记忆库自己会生长；
• 版本检测与更新：多设备/多用户部署时，「Memory Evolve 设置」Tab 的「版本」页自动检测远端发布版本（git tag v0.x.y），检测到新版本时设置 Tab 出现 🔴 红点，由你决定是否更新（详见下方「发布版本」）；
• 会话评审（Advisor）：给每个会话挂一个独立评审员——只观察界面可见对话（不含思考/工具调用），每轮实时评审、需要时以用户指令形式实时提醒（info/nit/concern/blocker 四级；info 默认仅记录），持续会话永不截断，支持新建评审会话/直接提问/四层级约束/记录可查。默认关闭，详见场景九。
• web 站内通知：渠道通知（de_notify）新增 web 渠道——AI 发通知直接落到网页右上角铃铛（未读徽标 + 弹窗列表 + 点主题跳会话 + 长文大弹窗 + 拖拽吸附左右），与飞书等 IM 渠道同一套通知语义。默认关闭，随「通知模块」（notifyEnabled）开关启用，详见场景八。

每个功能的完整说明，在对应标签页的「指南」里。

---

发布版本

插件使用 git tag 作为发布版本标识（两种格式都支持：日期戳 v<纯数字> 如 v26081302（日常发版推荐）、语义化 v1.2.3）：日常开发推送 main 分支不会触发任何更新提示，只有打了发布 tag 才会被各设备检测到。

发版流程（开发者）：

# 1. 提交并推送 main（tag 必须打在已推送的 main 提交上）
git push origin main

# 2. 用发版脚本一键完成：工作树/远端同步检查 → 构建 → 全量测试 → 打 annotated tag → 推送 tag
bash ~/shell/dsh-memory-evolve-release.sh v26081302 -m "发布说明：……"

各设备更新（使用者）：

• 进入 Web UI 后自动检测（24 小时内最多自动检测一次，也可点「检查更新」强制检测；插件启动时也会后台检测一次）；
• 检测到新版本时，设置 Tab 出现 🔴 红点；进入「版本」页点击「更新到 v26081302」；
• 更新完成后必须重启 dsh web 再刷新浏览器（仅刷新页面不会加载新代码）；
• 更新后插件处于 detached HEAD（跟随发布 tag）：继续用「版本」页的更新按钮升级即可，不要直接 git pull；
• 想回到开发轨：git checkout main && git pull --ff-only。

更新安全机制：只接受严格格式（v<纯数字> 或 v1.2.3）且位于 origin/main 历史的 tag；更新前校验本地工作树干净；更新过程有跨进程锁与失败回滚，不会把半更新状态留给你。

---

三条原则

1. AI 只提议，你确认：AI 自建的记忆、待办、技能都先进待确认队列——所有会真实改变 AI 行为的写入，决定权都在你；
2. 不重复造轮子：官方已有的能力不碰，只做官方没做、且真实解决痛点的；
3. 内外有别、协作互补：内部会话负责需要上下文的活，外部代理负责一次性重活，记忆、房间、提示词把它们串成一条流水线。

---