dsh-mnemon 0.1.4 → 0.1.6

package/docs/zh-CN/README.md

@@ -1,48 +0,0 @@
-# dsh-mnemon 文档中心
-
-**简体中文** | [English](../en/README.md) | [项目首页](../../README.zh-CN.md)
-
-这里按“你现在要完成什么”组织文档。第一次使用从快速开始进入；需要理解页面时看 UI 指南；只有在部署、集成或开发时才需要进入参考文档。
-
-## 新用户路径
-
-1. [快速开始](./getting-started.md)：安装 Mnemon 与插件，选择存储范围，完成第一次验证。
-2. [Sidebar 与对话交互指南](./ui-guide.md)：认识状态、运行时、记忆体、档案和对话内入口。
-3. [项目介绍](./project-overview.md)：理解三层模型、跨 Agent 共享边界、读写边界与完整流转。
-
-## 按任务查找
-
-| 我想要…… | 文档 |
-|---|---|
-| 决定一条信息应放在哪一层 | [存储与三层记忆模型](./storage-model.md) |
-| 让 DSH 与其他 Mnemon-enabled Agent 共享长期记忆 | [项目介绍：跨 Agent 共享边界](./project-overview.md#跨-agent-共享边界) · [配置参考：共享范围](./configuration.md#选择跨-agent-共享范围) |
-| 了解每轮注入、召回、沉淀和归档何时发生 | [生命周期与核心流程](./workflows.md) |
-| 切换 Sidebar / Buildin、全局 / 工作区 / 自定义目录 | [配置参考](./configuration.md) |
-| 理解工作区“查看目录”与 Agent“实际生效目录” | [UI 指南：工作区模式](./ui-guide.md#工作区模式查看与执行分离) |
-| 检查或更新 Mnemon 与 dsh-mnemon | [运维指南：版本检查与更新](./operations.md#版本检查与更新) |
-| 备份、恢复或迁移完整记忆目录 | [运维指南：备份与恢复](./operations.md#备份与恢复) |
-| 排查召回为空、目录未对齐、CLI 或 Provider 问题 | [运维、安全与故障排查](./operations.md#故障排查) |
-| 使用模型工具、`/mnemon` 命令或内部 RPC | [接口参考](./interfaces.md) |
-| 理解 Host、worker、控制面与数据面 | [架构设计](./architecture.md) |
-| 修改代码、截图、测试或发布 | [开发与验证](./development.md) |
-| 查看下一阶段计划 | [Roadmap](./roadmap.md) |
-
-## 核心术语
-
-| 中文 | 英文 / 代码名 | 含义 |
-|---|---|---|
-| 记忆系统 | Memory System | dsh-mnemon 在 DSH 中的完整入口 |
-| 运行时记忆 | Runtime Memory | 每轮注入的 USER / MEMORY 热记忆 |
-| 档案 | Project Documents | 受管、可检索、保留完整 Markdown 叙事的项目知识 |
-| 记忆体 | Memory Space | 独立、可激活、按需召回的长期 Mnemon Store |
-| 跨 Agent 共享 | Cross-agent memory sharing | 多个 Mnemon-enabled Agent 使用同一根和 Store，共享长期记忆而非完整 DSH 上下文 |
-| 沉淀 | Remember / Distill | 把候选交给受监督子 Agent 判断、查重与写入 |
-| 召回 | Recall | 从已激活记忆体按需取回有界证据 |
-| 归档 | Archive | 先建立冷引用，再把不常用档案迁出 active 层 |
-
-## 文档边界
-
-- 用户文档以 v0.1.4 的 Sidebar 默认体验为主，同时说明 Buildin 兼容形态。
-- 架构图表达稳定执行边界，不是实时监控面板；实时数量与版本以“状态”页为准。
-- RPC 是 Host 与插件客户端之间的内部协议，不承诺稳定外部 API。
-- 当前没有正式固定的 DSH / Mnemon 版本矩阵；升级前应备份并在隔离目录验证。

package/docs/zh-CN/architecture.md

@@ -1,133 +0,0 @@
-# 架构设计
-
-**简体中文** | [English](../en/architecture.md) | [文档中心](./README.md)
-
-## 定位
-
-`dsh-mnemon` 是 DSH 与 Mnemon 之间的集成和监督层，不是新的数据库引擎：
-
-- DSH 提供主 Agent、生命周期事件、subagent provider、工具、命令、设置和 Web 扩展点；
-- 插件提供三层知识控制面、路由策略、事务屏障和 UI；
-- 本地 `mnemon` CLI 提供命名 Store、SQLite 持久化、四类图、召回、关系和软删除，并形成与其他 Mnemon-enabled Agent 共享长期记忆的数据边界。
-
-## 组件图
-
-[![dsh-mnemon 运行时架构](../assets/diagrams/zh-CN/project-architecture.svg)](../assets/diagrams/zh-CN/project-architecture.svg)
-
-图中实线表示确定性数据或控制路径，紫色虚线表示 LLM 监督路径。Runtime Memory 和 Documents 直接使用受管文件；只有 Memory Spaces 通过 `MnemonRunner` 调用本地 Mnemon CLI。点击图片可以查看原始 SVG。
-
-因此跨 Agent 互操作只发生在图中的 Memory Spaces：共享的是 Mnemon Store 内的长期记忆与关系，不是 DSH 的会话上下文、Runtime 投影或 Documents 控制面。插件不会把数据主动推送到其他 Agent；参与方通过对齐本地 Mnemon 根和 Store 来共享。
-
-## Host 组合根
-
-`src/index.ts::apply()` 按以下顺序组装插件：
-
-```text
-settings.register("mnemon")
-  -> resolveConfig
-  -> createRunner
-  -> MnemonService
-  -> RuntimeMemoryController
-  -> DocumentManager
-  -> StorageScopeInspector
-  -> MnemonSubagentCoordinator
-  -> MnemonLifecycle
-  -> tools / commands / prompt sections
-  -> register RPC when a Web connection exists
-```
-
-Host 声明依赖 `tools`、`settings`、`commands`、`agents` 和 `subagents`。Web client 另外依赖 slots、connection 和 DSH locale 服务。
-
-## 主 Agent 与 worker 的双路径
-
-同名 `mnemon_*` 工具根据调用者是否为 subagent 分流，防止递归委派：
-
-```text
-root Agent calls mnemon_recall
-  -> coordinator starts a bounded recall worker
-  -> worker calls mnemon_memory_bodies and mnemon_recall
-  -> tool sees origin=subagent
-  -> call reaches MnemonService directly
-  -> structured evidence returns to root Agent
-```
-
-长期语义写入、关系、软删除以及记忆体创建/更新/合并采用相同模式。运行时记忆和 Documents 的普通变更先经过 coordinator，但通常由确定性控制层直接提交；只有容量维护或归档需要额外 worker。
-
-记忆体目录的物理删除是单独的确定性危险操作：WebUI 必须先展示二次确认，随后经 loopback 写 RPC 调用 Mnemon 原生 `store remove`；只有 CLI 删除成功后才移除目录登记。
-
-## 两类子 Agent
-
-### `spawn`
-
-`spawn` 使用新的隔离上下文。插件为每类任务提供：
-
-- 固定 persona；
-- 最小工具白名单；
-- DSH 支持子集内的结构化输出 schema；
-- `maxDepth: 1`；
-- 可取消的 signal 和有界 token 预算。
-
-它用于召回、长期语义写入、证据限定问答、热记忆整理和 Document 归档。
-
-### `fork`
-
-评分后台审查必须使用名为 `fork` 且 `inheritsParentContext=true` 的 provider。它只继承已经完成的父 checkpoint，用于判断是否需要维护热记忆或最多一份项目档案。它不是用户任务的延续，也不会把审查推理注入主对话。
-
-当前审查白名单不包含 `mnemon_remember`、`mnemon_forget` 或记忆体维护工具，因此后台审查不会直接修改长期记忆体。
-
-## 控制面与数据面
-
-```text
-LLM-owned judgment                  Host-owned guarantees
-------------------                  ---------------------
-what is worth keeping               input validation
-which Memory Space fits             path boundary
-whether two items are duplicates    process timeout/cancel
-how to summarize a Document         file lock + atomic rename
-whether a reusable artifact exists  UTF-8 capacity accounting
-                                     revision conflict rejection
-                                     read/write RPC authority
-```
-
-必须区分“persona 约束”和“Host 硬保证”。例如 MEMORY 归档 worker 被要求覆盖每条已提交热记忆，但 Host 只能硬校验结构化 action、revision 和字节预算；USER 压缩的 source coverage 则由 Host 逐项验证。
-
-## Web 边界
-
-WebUI 不启动系统进程，也不直接打开 SQLite：
-
-```text
-browser component
-  -> typed client wrapper
-  -> DSH RPC authority check
-  -> Host validation
-  -> controller / service / bounded worker
-  -> local CLI or managed files
-```
-
-读通道要求 `trusted-host`，记忆写通道和设置通道要求 `loopback`。`writeEnabled=false` 时 Host 不注册记忆写通道。
-
-## 国际化
-
-`src/client/locales.ts` 以中文键集定义 `MnemonKey`，英文词典必须满足同一键集合；`src/client/index.ts` 把两套词典注册到 DSH locale。主要 Web 页面和设置卡随 DSH 全局语言即时切换，并复用全局明暗主题。
-
-当前命令输出、工具卡标题、持久化的兼容默认记忆体名称和部分后端错误仍是单语，这是 Roadmap 中的已知缺口。
-
-## 关键模块
-
-| 模块 | 职责 |
-|---|---|
-| `src/index.ts` | Host 组合与注册 |
-| `src/config.ts` | 配置 schema、默认值和解析 |
-| `src/process.ts` | 无 shell 的有界进程执行 |
-| `src/runner.ts` | CLI 发现、参数、序列化和 JSON 解析 |
-| `src/service.ts` | 长期记忆应用门面 |
-| `src/memory-bodies.ts` | Memory Space 目录元数据 |
-| `src/runtime-memory.ts` | 热记忆事实源与投影 |
-| `src/documents.ts` | Documents 控制面 |
-| `src/subagent.ts` | worker 编排与容量事务 |
-| `src/lifecycle.ts` | per-root-Agent 生命周期 |
-| `src/review-activity.ts` | 确定性审查评分 |
-| `src/tools.ts` | 模型工具及 root/worker 分流 |
-| `src/rpc.ts` | Web 读写通道 |
-| `src/storage-scope.ts` | 三种存储范围的只读盘点 |
-| `src/client/*` | Web 工作台、设置和 locale |

package/docs/zh-CN/configuration.md

@@ -1,223 +0,0 @@
-# 配置参考
-
-**简体中文** | [English](../en/configuration.md) | [文档中心](./README.md)
-
-## 配置位置与生效方式
-
-插件在 DSH settings 服务中注册 `mnemon` 命名空间。用户配置位于：
-
-```text
-$DSH_HOME/settings.yaml
-```
-
-默认通常是 `~/.dsh/settings.yaml`。当前全部配置标记为 `live` 生效；保存后会先初始化候选运行图，再原子切换 Host 服务。
-
-Web 设置页编辑 `displayMode`、`storageScope`、`dataDir`，以及 `mnemon-ui` 下的回合记忆条和存入记忆按钮；同页还提供当前有效目录的 ZIP 导入 / 导出。其他高级项需要直接修改 YAML。
-
-## 完整示例
-
-```yaml
-mnemon:
-  displayMode: sidebar # sidebar | buildin
-  storageScope: global # global | workspace | custom
-  # dataDir: ~/mnemon-data       # custom 时必填
-  # cliPath: /opt/homebrew/bin/mnemon
-  # store: legacy-store          # 兼容发现提示，不是常规路由目标
-  timeoutMs: 10000
-  defaultRecallLimit: 10
-  routingGuidance: true
-  lifecycleEnabled: true
-  recallMode: guided
-  writebackMode: guided
-  idleReviewMs: 30000
-  tabEnabled: true
-  writeEnabled: true
-```
-
-## 选项
-
-| 配置 | 默认值 | 范围 | 实现语义 |
-|---|---:|---|---|
-| `displayMode` | `sidebar` | `sidebar` / `buildin` | `sidebar` 挂载左侧栏独立工作台；`buildin` 恢复 DSH 原生对话区标签页；保存后实时切换且不会同时挂载两个入口 |
-| `storageScope` | `global` | `global` / `workspace` / `custom` | 统一控制 Runtime、Documents、Memory Spaces 和预留 state 根目录 |
-| `dataDir` | 未设置 | 绝对路径、`~` 或 `~/...` | `custom` 时必填；旧配置只设置它时自动解析为 `custom` |
-| `cliPath` | 自动发现 | 可执行路径 | 显式指定 Mnemon CLI |
-| `store` | 未设置 | `[A-Za-z0-9][A-Za-z0-9_-]*` | 用于旧 Store 的兼容发现/首选提示；语义操作由 Memory Space 路由 |
-| `timeoutMs` | `10000` | 100–120000 ms | 单次 CLI 硬超时 |
-| `defaultRecallLimit` | `10` | 1–50 | 服务和 UI 默认召回条数；不同入口可能再收紧 |
-| `routingGuidance` | `true` | boolean | 是否注册额外的分层路由 system section |
-| `lifecycleEnabled` | `true` | boolean | 是否启用 pre-step cue 和评分后台审查 |
-| `recallMode` | `guided` | `guided` / `off` | 是否注入按需 recall cue；不移除显式召回 |
-| `writebackMode` | `guided` | `guided` / `off` | 是否注入热记忆 cue 并启用评分后台审查；不移除显式写入 |
-| `idleReviewMs` | `30000` | 5000–600000 ms | 达标后需要连续空闲的时间 |
-| `tabEnabled` | `true` | boolean | 是否挂载 `displayMode` 指定的 Web 入口；关闭后 Host RPC、命令和 Agent 工具保持注册 |
-| `writeEnabled` | `true` | boolean | 是否暴露语义写工具、写 RPC 和写命令 |
-| `mnemon-ui.turnBar` | `true` | boolean | 回合尾记忆活动条；默认开启，**保存后实时生效** |
-| `mnemon-ui.saveAction` | `true` | boolean | 已定稿助手回复旁的「存入记忆」图标与确认弹窗；默认开启，**保存后实时生效** |
-
-`mnemon` Host/存储命名空间和 `mnemon-ui` 浏览器呈现命名空间都实时生效。存储根只会在新运行图初始化成功后原子切换；旧版 `mnemon.conversationInteraction` 仍会作为迁移默认值读取，但新保存只写入 `mnemon-ui`。
-
-## 存储范围
-
-### `global`
-
-```text
-MNEMON_DATA_DIR when non-empty
-  otherwise ~/.mnemon
-```
-
-适合希望多个工作区共享 Runtime、Documents 和 Memory Spaces 的用户；其他 Mnemon-enabled Agent 使用相同根时，也可以共享其中的 Mnemon Memory Spaces。
-
-### `workspace`
-
-```text
-Agent / 工具 / 生命周期：resolve(currentSession.header.cwd, ".mnemon")
-Web 工作台查看：resolve(workspaceRegistry.get(selectedWorkspaceId).path, ".mnemon")
-```
-
-每个 DSH 工作区拥有独立的三层记忆根。Agent、模型工具、命令和生命周期按当前会话的 cwd 路由，不受 Web 工作台查看目标影响。工作台只能从 Host 已登记的工作区中选择，不能提交任意路径；查看目标与会话实际目录不一致时，顶部会显示两条路径并提供“一键对齐当前会话”。需要 Agent 子任务的操作在未对齐时会被 Host 拒绝，避免写入错误项目。
-
-### `custom`
-
-```yaml
-mnemon:
-  storageScope: custom
-  dataDir: /absolute/path/to/mnemon-data
-```
-
-也允许 `~` 和 `~/...`。相对路径会被拒绝。
-
-### 选择跨 Agent 共享范围
-
-| 目标 | 推荐范围 | 说明 |
-|---|---|---|
-| 本机多个 Agent 共享长期记忆 | `global` | 各方统一使用 `~/.mnemon` 或同一个 `MNEMON_DATA_DIR` |
-| 多个 Agent 共享指定数据根 | `custom` | 各方显式配置同一个绝对目录，便于隔离和备份 |
-| 只在一个项目内共享 | `workspace` | 各方都需要把 Mnemon 根对齐到该项目的 `<workspace>/.mnemon` |
-
-只有 `data/<store>/mnemon.db` 中的 Mnemon 长期层具备原生跨 Agent 互操作性。Runtime、Documents、DSH 的激活状态和 UI 元数据仍属于 dsh-mnemon 管理范围。
-
-## CLI 发现优先级
-
-```text
-config.cliPath
-  -> executable MNEMON_CLI_PATH
-  -> each PATH directory
-  -> ~/.local/bin/mnemon
-  -> /opt/homebrew/bin/mnemon
-  -> /usr/local/bin/mnemon
-  -> /usr/bin/mnemon
-```
-
-显式 `cliPath` 会被采用；若它不可执行，实际调用会返回启动错误。
-
-## 兼容 Store 提示优先级
-
-```text
-config.store
-  -> MNEMON_STORE
-  -> <storageRoot>/active
-  -> default
-```
-
-Memory Space 目录建立后，长期语义操作使用明确的记忆体 ID，不依赖全局 active Store 进行路由。
-
-## Provider 要求
-
-普通 worker 会优先选择 `spawn`；如果没有该名称，可以选择另一个具备全部能力的 provider：
-
-```text
-outputSchema = true
-toolFilter   = true
-persona      = true
-depthLimit   = true
-```
-
-后台审查没有回退：必须存在名为 `fork` 的兼容 provider，并且：
-
-```text
-inheritsParentContext = true
-```
-
-缺少 `fork` 不会阻止确定性状态或普通 UI 读取，但达到审查门槛时会记录 subagent 失败。
-
-## 只读配置
-
-```yaml
-mnemon:
-  writeEnabled: false
-```
-
-效果：
-
-- 不注册模型写工具；
-- 不注册 `/dsh-mnemon-write` RPC；
-- `/mnemon remember` 和 `/mnemon forget` 拒绝；
-- `MnemonService` 的语义 mutation 拒绝。
-
-它是“功能只读”，不是文件系统只读模式：Runtime 控制器仍可能初始化或修复投影，Document 搜索会更新 LRU 访问时间，Mnemon 读命令也可能触发上游数据库迁移。不要把 `writeEnabled=false` 用作只读挂载的安全承诺。
-
-## 开关交互
-
-```text
-writeEnabled=false
-  -> overrides all explicit semantic writes
-
-writebackMode=off
-  -> no write cue, no scored review
-  -> explicit writes remain when writeEnabled=true
-
-recallMode=off
-  -> no recall cue
-  -> explicit recall remains
-
-lifecycleEnabled=false
-  -> no lifecycle cues or review
-  -> UI, commands, and explicit tools remain
-
-routingGuidance=false
-  -> removes only mnemon:routing
-  -> runtime-memory prompt section remains
-```
-
-## 展示形态与 `tabEnabled` 界面开关
-
-`displayMode=sidebar`（默认）会挂载“记忆系统”侧边栏入口和独立主内容区工作台，并使用无 Mnemon Logo 的 DSH 官方风格极简皮肤；`displayMode=buildin` 会改为注册原有的 DSH `conversation.view` 内嵌标签页并保持既有视觉。两者共享功能工作台，但外观定义隔离。设置页保存后会先卸载当前入口再挂载目标入口，因此两种形态不会同时出现。
-
-`tabEnabled=false` 会实时移除当前形态的 Web 入口。为避免运行中的 Agent 或命令因界面设置变化而失效，Host RPC、命令和工具不会随展示形态或总开关卸载。
-
-## Profile patch 覆盖
-
-包内 `cordis.patch.yml` 提供默认 config 行。DSH profile 的同 ID 配置可能整体覆盖这行；自定义 patch 时应保留仍需启用的键，而不是假设深合并。
-
-## 常见配置
-
-工作区隔离：
-
-```yaml
-mnemon:
-  storageScope: workspace
-```
-
-自定义数据盘和较长 CLI 超时：
-
-```yaml
-mnemon:
-  storageScope: custom
-  dataDir: /Volumes/AgentData/mnemon
-  timeoutMs: 30000
-```
-
-保留显式工具、关闭生命周期行为：
-
-```yaml
-mnemon:
-  lifecycleEnabled: false
-```
-
-仅关闭后台写回判断：
-
-```yaml
-mnemon:
-  writebackMode: off
-```

package/docs/zh-CN/development.md

@@ -1,198 +0,0 @@
-# 开发与验证
-
-**简体中文** | [English](../en/development.md) | [文档中心](./README.md)
-
-## 环境
-
-仓库没有在 `package.json` 中声明 Node、pnpm、DSH 或 Mnemon 的最低版本。使用当前 DSH 开发环境，并在升级依赖时通过完整验证链路确认兼容性。
-
-安装依赖：
-
-```sh
-pnpm install
-```
-
-## 标准命令
-
-```sh
-pnpm run typecheck  # tsc --noEmit
-pnpm test           # vitest run
-pnpm run build      # declarations + host/client bundles
-pnpm run verify     # typecheck + test + build
-```
-
-## 目录结构
-
-```text
-src/
-+-- index.ts                  # Host composition root
-+-- config.ts                 # settings schema
-+-- process.ts / runner.ts    # local CLI execution
-+-- service.ts                # durable-memory facade
-+-- memory-bodies.ts          # Memory Space registry
-+-- runtime-memory.ts         # hot-memory authority
-+-- documents.ts              # managed Documents
-+-- subagent.ts               # bounded workers
-+-- lifecycle.ts              # root-Agent hooks
-+-- review-activity.ts        # activity score
-+-- tools.ts / commands.ts    # model and human interfaces
-+-- rpc.ts / settings.ts      # Web bridges
-+-- storage-scope.ts          # storage inventory
-+-- client/                   # React workspace and locales
-tests/                        # Vitest suites
-lib/                          # committed build artifacts
-docs/zh-CN/                   # Chinese documentation
-docs/en/                      # English mirror
-cordis.patch.yml              # DSH profile bundle patch
-```
-
-## 构建产物
-
-```text
-tsc -p tsconfig.build.json
-  -> lib/types/*              declarations, maps, intermediate ESM
-
-tsdown host bundle
-  -> lib/index.js             Node ES2024 ESM
-
-tsdown client bundle
-  -> lib/client.js            DSH browser module wrapper
-  -> lib/client.js.map
-
-lightningcss plugin
-  -> CSS Modules compiled and injected as scoped <style>
-```
-
-Host 保持 `cordis` 和 `schemastery` external。Client 保持 React、ReactDOM、JSX runtime 和 Cordis external，其余依赖打入 bundle。
-
-`lib/` 是发布输入的一部分。修改 `src/` 后必须重新构建并检查生成 diff；不要手工编辑 `lib/`。
-
-## 测试层次
-
-现有 Vitest 套件覆盖：
-
-- 配置解析、CLI 查找、进程串行；
-- Memory Space 发现、激活、路由与合并；
-- recall payload 兼容和图谱解析；
-- Runtime JSON/Markdown 一致性、锁、容量、UTF-8 和 revision；
-- Documents 路径、frontmatter、搜索、LRU、归档与冲突；
-- worker 工具隔离、schema 子集、结构化回执；
-- 生命周期 cue、评分、idle debounce、取消和水位保留；
-- RPC authority、只读行为和设置 revision；
-- Web 工作台、双语文案和关键交互。
-
-这些主要是临时目录、fake runner 和 mock Host 集成测试，不等同于自动化的真实 DSH + Mnemon WebUI E2E。
-
-## 真实 WebUI 验证
-
-发布前使用隔离环境，避免污染个人记忆：
-
-```text
-temporary DSH_HOME
-temporary MNEMON_DATA_DIR or custom storageScope
-temporary workspace
-independent Web port
-local link installation
-```
-
-建议场景：
-
-1. 空根：UI 不报错，能够创建第一个 Memory Space。
-2. 普通对话：只出现短 cue，不强制 recall 或写入。
-3. 历史问题：Agent 自主 recall，并返回正确 space provenance。
-4. 显式沉淀：worker 查重、选择范围并可被再次召回。
-5. 多空间：读取只覆盖 active，写入 inactive 后自动激活。
-6. Runtime：USER / MEMORY add、replace、remove 和投影一致。
-7. Documents：创建、检索、更新、人工归档和原项目文件不变。
-8. 评分审查：轻任务不触发；达标后等待 idle；新 turn 能取消并保留水位。
-9. 只读：写工具、写命令和写 RPC 被拒绝，读取仍可用。
-10. Sidebar：四个一级标签、记忆体四个二级标签、固定页头、筛选与加载更多均正常。
-11. 对话内交互：本回合记忆只在已完成且有活动的回合出现；跳转目标正确；存入记忆取消不写入。
-12. 设置：Sidebar / Buildin、存储范围与两个对话开关保存后实时生效，不需要刷新。
-13. ZIP：导出后可预检，并能在隔离 custom 根完成合并恢复；损坏 checksum 必须拒绝。
-14. 版本：检查不会安装；link / 手工来源不显示不安全更新；更新完成后自动重新检查状态。
-15. 状态和浏览器控制台：无未处理错误或警告。
-
-容量极限、CLI 超时、revision 冲突和 Host 重启应在专用故障注入环境验证。
-
-## 维护文档视觉素材
-
-公开 UI 截图统一位于 `docs/assets/screenshots/`，中英文文档复用同一组实机画面；语言相关架构图分别保存在 `docs/assets/diagrams/zh-CN/` 与 `docs/assets/diagrams/en/`。界面结构、主要文案或默认行为变化时：
-
-1. 使用真实 DSH Web profile，但先检查画面中没有 token、凭据或不应公开的个人数据；
-2. 只做查看、筛选、展开与打开弹窗等可逆交互；需要展示写入前流程时停在最终确认之前；
-3. 覆盖同职责截图，避免按版本不断累积文件名；只有新增用户任务时才增加素材；
-4. 同步 README 海报、GIF / MP4 演示和 `ui-guide.md`；
-5. 检查 PNG / JPEG 扩展名与真实编码一致，并在原始分辨率下确认文字可读；
-6. 删除已无引用、展示旧 Buildin 布局或术语过时的截图；
-7. 运行链接与图片检查，再人工打开中英文 README 和 UI 指南。
-
-README 演示资源位于 `docs/assets/media/dsh-mnemon-memory-system-demo.*`。演示应覆盖状态、运行时、记忆体、档案和对话内确认，但不要用自动化真正提交记忆、更新组件或更改设置。
-
-## 修改 subagent schema
-
-DSH structured output 只支持一个紧凑 JSON Schema 子集：
-
-```text
-type, oneOf, properties, required, additionalProperties,
-items, enum, const, and annotation keywords
-```
-
-不要加入 `maxItems` 等不受支持关键字。`assertDshOutputSchema()` 会在启动 worker 前递归拒绝未知 schema 键；结果数量等限制由 persona 和 Host parser 双重实现。
-
-## 修改存储格式
-
-Runtime、Documents 和 Memory Space registry 都带版本字段或固定结构。修改时需要：
-
-1. 明确旧格式解析策略；
-2. 增加迁移或拒绝路径；
-3. 保证临时文件与原子 rename；
-4. 补充并发和损坏输入测试；
-5. 更新中英文存储、运维和 Roadmap 文档；
-6. 在复制的数据根上完成升级/回退验证。
-
-当前没有正式 schema migration 框架，不应静默改变持久格式。
-
-## 文档国际化维护
-
-`docs/zh-CN` 与 `docs/en` 应保持同名文件和相同章节职责。修改默认值、流程或限制时：
-
-- 同步两种语言；
-- 保持命令、配置键、路径和代码符号完全一致；
-- 使用相对路径互链对应语言页面；
-- 架构总览优先使用可访问、无脚本和无外部资源的 SVG；目录树、命令、公式与短协议仍使用可复制的 `text` / ASCII；
-- 根 README 只保留摘要，把细节放到单一权威 docs 页面；
-- 所有用户可感知界面变化同步检查 `ui-guide.md`、`getting-started.md`、`configuration.md` 与 `operations.md`。
-
-Web locale 变更时，中文键集合仍是类型事实源；英文词典必须满足 `Record<MnemonKey, string>`，并保持占位符一致。
-
-## 发布检查
-
-```text
-[ ] pnpm run verify
-[ ] review source and generated lib diffs
-[ ] validate package file list includes README.md, README.zh-CN.md, docs/assets and bilingual docs
-[ ] install the built/local bundle into an isolated Web profile
-[ ] run real Mnemon CLI and WebUI smoke tests
-[ ] verify Chinese and English workspaces
-[ ] verify global/workspace/custom paths as applicable
-[ ] record tested DSH and Mnemon versions
-[ ] back up any data root used for upgrade testing
-```
-
-`package.json.files` 当前发布 `lib`、patch、两份根 README、统一管理的文档视觉素材、双语公开 docs 和 License。
-
-## 发布到 npm
-
-发布后 `dsh plugin --profile web add dsh-mnemon` 即按 registry 名称解析（与 dsh-better-sidebar 同路径）。发布步骤：
-
-```sh
-npm pack --dry-run                 # 检查 tarball 文件清单（含 cordis.patch.yml、lib、docs）
-pnpm publish --access public       # prepublishOnly 会先跑 pnpm run verify
-```
-
-凭据约定：NPM_TOKEN 只写入用户级 `~/.npmrc`（`npm config set "//registry.npmjs.org/:_authToken" "${NPM_TOKEN}" --userconfig ~/.npmrc`），发布后删除。**不要**把凭据行提交进仓库 `.npmrc`：pnpm 11 出于安全会忽略项目级 `.npmrc` 中未展开的环境变量凭据并告警，且该文件会随仓库传播。
-
-2FA 注意：若 npm 账号开启发布级两步验证，交互发布直接执行 `pnpm publish --access public`，按提示输入 OTP；脚本/CI 发布需改用 Classic **Automation** 令牌或允许 bypass 2FA 的 Granular 令牌（`npm login` 生成的普通令牌无法发布，会报 403 Two-factor authentication required）。
-
-发布前核对 `package.json` 的 `repository`/`homepage`/`bugs` 指向 `omdsh-dev/dsh-mnemon`（npm 页面与 GitHub 保持一致），并确认版本号已递增。