dsh-mnemon 0.1.5 → 0.2.0

package/docs/zh-CN/configuration.md

@@ -1,234 +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
-  -> Windows: GOBIN/mnemon.exe
-              first GOPATH/bin/mnemon.exe, or ~/go/bin/mnemon.exe
-              %LOCALAPPDATA%/Programs/mnemon/mnemon.exe
-              %ProgramFiles%/mnemon/mnemon.exe
-  -> Unix: ~/.local/bin/mnemon
-           /opt/homebrew/bin/mnemon
-           /usr/local/bin/mnemon
-           /usr/bin/mnemon
-```
-
-显式 `cliPath` 会被采用；若它不可执行，实际调用会返回启动错误。Windows 自动发现只接受普通 `.exe` 文件；进程执行不使用 shell，因此有意排除 `.cmd` 与 `.bat` wrapper。
-
-## 兼容 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 配置可能整体覆盖这行。不要在 profile 的最终 patch 中只增加 `cliPath`；请改用 `MNEMON_CLI_PATH` 或用户设置 `mnemon.cliPath`。确因其他原因需要自定义 profile patch 时，应保留仍需启用的全部键，而不是假设深合并。
-
-## 常见配置
-
-工作区隔离：
-
-```yaml
-mnemon:
-  storageScope: workspace
-```
-
-显式指定 Windows CLI 路径：
-
-```yaml
-mnemon:
-  cliPath: 'C:\Users\alice\AppData\Local\Programs\mnemon\mnemon.exe'
-```
-
-自定义数据盘和较长 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 保持一致），并确认版本号已递增。

package/docs/zh-CN/getting-started.md

@@ -1,199 +0,0 @@
-# 快速开始
-
-**简体中文** | [English](../en/getting-started.md) | [文档中心](./README.md)
-
-本页从空白环境走到第一次可验证召回。默认采用 Sidebar 和全局存储；如果你已经安装完成，可直接跳到[首次验证](#6-完成第一次验证)。
-
-## 1. 前置条件
-
-你需要：
-
-- 一个可以启动的 DSH Web profile；
-- 本地可执行的 `mnemon` CLI；
-- 一个可用于隔离记忆任务的 DSH subagent Provider。
-
-普通语义任务优先使用名为 `spawn` 的 Provider，并要求 `outputSchema`、`toolFilter`、`persona` 与 `depthLimit`。可选的评分后台审查还要求名为 `fork`、且 `inheritsParentContext=true` 的 Provider。缺少 `fork` 不影响确定性页面读取和普通手动操作。
-
-项目当前不声明固定的 DSH / Mnemon 最低版本矩阵。本文与截图以 dsh-mnemon v0.1.5 为基线；升级前先备份，并在隔离目录重复本页验证。
-
-## 2. 安装 Mnemon
-
-macOS 推荐 Homebrew Cask：
-
-```sh
-brew install --cask mnemon-dev/tap/mnemon
-```
-
-macOS 和 Linux 可通过 Go 安装：
-
-```sh
-go install github.com/mnemon-dev/mnemon@latest
-```
-
-验证二进制：
-
-```sh
-mnemon --version
-```
-
-Windows 官方发行包同时提供 AMD64 与 ARM64 ZIP。下面的 PowerShell 会把 v0.2.3 安装到可自动发现的用户 Programs 目录，并使用官方 checksum 校验下载内容：
-
-```powershell
-$version = '0.2.3'
-$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture -eq 'Arm64') { 'arm64' } else { 'amd64' }
-$archiveName = "mnemon_${version}_windows_${arch}.zip"
-$releaseBase = "https://github.com/mnemon-dev/mnemon/releases/download/v${version}"
-$archive = Join-Path $env:TEMP $archiveName
-$checksumFile = Join-Path $env:TEMP "mnemon_${version}_checksums.txt"
-Invoke-WebRequest "${releaseBase}/${archiveName}" -OutFile $archive
-Invoke-WebRequest "${releaseBase}/checksums.txt" -OutFile $checksumFile
-$line = Get-Content $checksumFile | Where-Object { $_.EndsWith("  $archiveName") } | Select-Object -First 1
-if (-not $line) { throw "Checksum entry not found for $archiveName" }
-$expected = (($line -split '\s+')[0]).ToLowerInvariant()
-$actual = (Get-FileHash -Path $archive -Algorithm SHA256).Hash.ToLowerInvariant()
-if ($actual -ne $expected) { throw "Checksum mismatch for $archiveName" }
-$installDir = Join-Path $env:LOCALAPPDATA 'Programs\mnemon'
-New-Item -ItemType Directory -Force -Path $installDir | Out-Null
-Expand-Archive -Path $archive -DestinationPath $installDir -Force
-$mnemon = Join-Path $installDir 'mnemon.exe'
-& $mnemon --version
-```
-
-如果已经安装 Go 工具链，也可以继续使用 Go：
-
-```powershell
-go install github.com/mnemon-dev/mnemon@latest
-$mnemonBin = go env GOBIN
-if (-not $mnemonBin) {
-  $mnemonBin = Join-Path (((go env GOPATH) -split ';')[0]) 'bin'
-}
-$mnemon = Join-Path $mnemonBin 'mnemon.exe'
-& $mnemon --version
-```
-
-Windows 上，dsh-mnemon 会从 `PATH`、导出的 `GOBIN` 或 `GOPATH`、默认 `%USERPROFILE%\go\bin`、`%LOCALAPPDATA%\Programs\mnemon` 和 Program Files 中发现原生 `mnemon.exe`。CLI 调用刻意禁用 shell，因此不接受 `.cmd` 与 `.bat` wrapper。
-
-如果 DSH 仍无法找到二进制，请设置 `MNEMON_CLI_PATH`，或在用户 settings 中写入绝对路径；不要为此整体替换插件的 profile patch：
-
-```yaml
-mnemon:
-  cliPath: 'C:\Users\alice\AppData\Local\Programs\mnemon\mnemon.exe'
-```
-
-`mnemon status` 会打开有效 Store，可能初始化数据或执行上游迁移，不要把它当作完全无副作用的安装探测。
-
-## 3. 安装 dsh-mnemon
-
-安装到 Web profile：
-
-```sh
-dsh plugin --profile web add dsh-mnemon
-```
-
-开发检出使用绝对路径：
-
-```sh
-dsh plugin --profile web add "link:/absolute/path/to/dsh-mnemon"
-```
-
-然后启动或重启 profile：
-
-```sh
-dsh --profile web
-```
-
-升级与卸载：
-
-```sh
-dsh plugin --profile web update dsh-mnemon
-dsh plugin --profile web remove dsh-mnemon
-```
-
-卸载只移除插件注册，不删除全局、工作区或自定义目录中的记忆数据。
-
-## 4. 选择入口与存储位置
-
-打开“设置 → 记忆系统”：
-
-[![记忆系统设置：展示形态、存储位置、对话界面与备份](../assets/screenshots/settings-memory-system.png)](../assets/screenshots/settings-memory-system.png)
-
-### 展示形态
-
-- **Sidebar**（默认）：从 DSH 左侧栏进入独立工作台；适合绝大多数用户。
-- **Buildin**：使用原有对话区标签页，并保留既有视觉。
-
-### 存储位置
-
-| 范围 | 根目录 | 适合场景 |
-|---|---|---|
-| **全局**（默认） | `MNEMON_DATA_DIR` 或 `~/.mnemon` | 多个工作区共享同一套记忆 |
-| **工作区** | `<workspace>/.mnemon` | 项目隔离，并允许在工作台切换查看其他工作区 |
-| **自定义** | `dataDir` | 专用磁盘、挂载卷或明确的数据目录 |
-
-点击保存后会先初始化新运行图，再原子切换 Host；页面自动清理旧状态并重新读取，无需刷新浏览器。切换范围不会自动迁移、合并或删除旧数据。
-
-在工作区模式下，工作台选择器只决定“正在查看哪套数据”；Agent、工具与生命周期实际使用的目录始终跟随当前会话。两者不一致时顶部会提示并提供一键对齐。
-
-## 5. 打开 Sidebar 工作台
-
-点击左侧栏“记忆系统”，先查看“状态”：
-
-[![状态页：CLI、版本、运行时、记忆体、档案与存储根](../assets/screenshots/status-overview.png)](../assets/screenshots/status-overview.png)
-
-确认：
-
-- 右上角显示“已连接”；
-- Mnemon 与 dsh-mnemon 能显示当前版本；
-- 存储根与刚才选择的范围一致；
-- Runtime、Memory Spaces 和 Documents 没有错误提示。
-
-如果 Mnemon 不可用，macOS/Linux 先运行 `command -v mnemon` 与 `mnemon --version`；Windows PowerShell 运行 `Get-Command mnemon` 与 `Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"`。更多症状见[故障排查](./operations.md#故障排查)。
-
-## 6. 完成第一次验证
-
-### 创建记忆体
-
-1. 打开“记忆体 → 概览”。
-2. 点击“创建记忆体”。
-3. 使用主题明确的名称，例如“项目决策”。
-4. 在说明中写清“哪些内容属于这里，以及什么任务应召回它”。
-5. 开启读取激活开关。
-
-### 沉淀一条测试信息
-
-点击右上角“沉淀记忆”，填写一条稳定、自包含、未来仍有用且不含秘密的信息。默认不要展开高级选项，让记忆子 Agent 自己选择目标、查重与提炼。
-
-只有点击“调度子 Agent 判断并沉淀”才会启动写入；取消弹窗不会改变状态。
-
-### 验证召回
-
-1. 打开“记忆体 → 检索”。
-2. 输入一个能命中刚才内容的具体问题。
-3. 先用“直接检索”检查原始证据。
-4. 确认结果包含记忆体来源、分类、重要性、分数和 ID。
-
-也可以在对话中运行：
-
-```text
-/mnemon status
-/mnemon recall <聚焦查询>
-```
-
-## 7. 验证对话内记忆
-
-在一个确实依赖历史信息的问题中，让 Agent 自主判断是否需要召回。完成后：
-
-- 若本轮调用了记忆工具，回复下方会出现“本回合记忆”；
-- 展开后可以看到具体工具名，并点击跳到对应页面；
-- “存入记忆”会先打开可编辑确认弹窗，取消不会写入。
-
-[![本回合记忆与工具跳转](../assets/screenshots/conversation-turn-memory.png)](../assets/screenshots/conversation-turn-memory.png)
-
-普通聊天不应强制召回。当前请求、现有源文件和实时工具结果应优先于历史内容。
-
-## 8. 下一步
-
-- 用 [Sidebar 与对话交互指南](./ui-guide.md) 认识全部页面。
-- 用[存储模型](./storage-model.md)决定信息应进入运行时、档案还是记忆体。
-- 用[配置参考](./configuration.md)设置工作区范围、只读模式或生命周期开关。
-- 用[运维指南](./operations.md)导出第一份 ZIP 备份并建立升级前检查流程。