dsh-mnemon 0.1.3 → 0.1.5

package/docs/en/development.md

@@ -171,7 +171,7 @@ When the Web locale changes, the Chinese key set remains the type source of trut
 ```text
 [ ] pnpm run verify
 [ ] review source and generated lib diffs
-[ ] validate package file list includes README.en.md, docs/assets, and bilingual docs
+[ ] 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

package/docs/en/getting-started.md

@@ -14,7 +14,7 @@ You need:
 
 Regular semantic work prefers a provider named `spawn` with `outputSchema`, `toolFilter`, `persona`, and `depthLimit`. Optional score-based background review additionally requires a provider named `fork` with `inheritsParentContext=true`. Missing `fork` does not block deterministic pages or regular manual actions.
 
-The project does not declare a fixed minimum DSH / Mnemon matrix. This guide and its screenshots target dsh-mnemon v0.1.3. Back up and repeat this verification against an isolated root before upgrading.
+The project does not declare a fixed minimum DSH / Mnemon matrix. This guide and its screenshots target dsh-mnemon v0.1.5. Back up and repeat this verification against an isolated root before upgrading.
 
 ## 2. Install Mnemon
 
@@ -24,7 +24,7 @@ Homebrew Cask is recommended on macOS:
 brew install --cask mnemon-dev/tap/mnemon
 ```
 
-On macOS or Linux, Go is another option:
+Go works on macOS and Linux:
 
 ```sh
 go install github.com/mnemon-dev/mnemon@latest
@@ -36,7 +36,51 @@ Verify the binary:
 mnemon --version
 ```
 
-If DSH cannot find it on `PATH`, set `MNEMON_CLI_PATH` or configure an absolute `mnemon.cliPath`. `mnemon status` opens the effective Store and may initialize data or run upstream migrations, so it is not a side-effect-free installation probe.
+On Windows, the official release provides ZIP archives for AMD64 and ARM64. The following PowerShell installs v0.2.3 under the auto-discovered per-user Programs directory and verifies it against the published 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 remains an alternative when a Go toolchain is already available:
+
+```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
+```
+
+On Windows, dsh-mnemon discovers native `mnemon.exe` from `PATH`, an exported `GOBIN` or `GOPATH`, the default `%USERPROFILE%\go\bin`, `%LOCALAPPDATA%\Programs\mnemon`, and Program Files. `.cmd` and `.bat` wrappers are not accepted because CLI calls deliberately run without a shell.
+
+If DSH still cannot find the binary, set `MNEMON_CLI_PATH` or add an absolute path to the user settings file instead of replacing the plugin's profile patch:
+
+```yaml
+mnemon:
+  cliPath: 'C:\Users\alice\AppData\Local\Programs\mnemon\mnemon.exe'
+```
+
+`mnemon status` opens the effective Store and may initialize data or run upstream migrations, so it is not a side-effect-free installation probe.
 
 ## 3. Install dsh-mnemon
 
@@ -103,7 +147,7 @@ Confirm that:
 - the storage root matches your chosen scope;
 - Runtime, Memory Spaces, and Documents report no errors.
 
-If Mnemon is unavailable, run `command -v mnemon` and `mnemon --version`. See [Troubleshooting](./operations.md#troubleshooting) for other symptoms.
+If Mnemon is unavailable, run `command -v mnemon` and `mnemon --version` on macOS/Linux, or `Get-Command mnemon` and `Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"` on Windows PowerShell. See [Troubleshooting](./operations.md#troubleshooting) for other symptoms.
 
 ## 6. Complete first verification
 

package/docs/en/operations.md

@@ -11,6 +11,13 @@ command -v mnemon
 mnemon --version
 ```
 
+Windows PowerShell:
+
+```powershell
+Get-Command mnemon -ErrorAction SilentlyContinue
+Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"
+```
+
 ```text
 /mnemon status
 ```
@@ -125,7 +132,7 @@ Report vulnerabilities privately through [SECURITY.md](../../SECURITY.md), not a
 
 | Symptom | Check and resolution |
 |---|---|
-| Mnemon unavailable | Run `command -v mnemon`, `mnemon --version`; set `MNEMON_CLI_PATH` or `cliPath`, then restart |
+| Mnemon unavailable | macOS/Linux: run `command -v mnemon`, `mnemon --version`. Windows PowerShell: run `Get-Command mnemon`, `Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"`. Set `MNEMON_CLI_PATH` or `mnemon.cliPath`, then restart |
 | Memory System missing from sidebar | Check `tabEnabled=true`, `displayMode=sidebar`; Buildin is in the conversation area; for a local link run `pnpm run build`, then restart |
 | Status healthy but recall empty | Check active spaces, storage scope, inspected root, effective session root, and query focus |
 | Header reports misalignment | The workbench is inspecting another workspace; align or keep deliberate read-only inspection; Agent-backed actions are rejected |

package/docs/en/project-overview.md

@@ -1,8 +1,8 @@
-# Project Overview: Local Three-Tier Memory for DSH
+# Project Overview: Local Three-Tier and Cross-Agent Memory for DSH
 
 [简体中文](../zh-CN/project-overview.md) | **English** | [Documentation hub](./README.md)
 
-`dsh-mnemon` integrates [Mnemon](https://github.com/mnemon-dev/mnemon) Memory Spaces with DeepSeek Harness, then adds Runtime hot memory, Project Documents, lifecycle routing, bounded subagents, a deterministic control layer, and native DSH interfaces.
+`dsh-mnemon` integrates [Mnemon](https://github.com/mnemon-dev/mnemon) Memory Spaces with DeepSeek Harness, then adds Runtime hot memory, Project Documents, lifecycle routing, bounded subagents, a deterministic control layer, and native DSH interfaces. Because the durable tier uses native Mnemon Stores, DSH can reuse the same local long-term memory with other Mnemon-enabled agents.
 
 Its goal is not to store more text. It balances long-term continuity, current-fact priority, context cost, and recoverable writes.
 
@@ -50,6 +50,18 @@ Each Memory Space maps to an independent Mnemon Store and `mnemon.db`, with a st
 
 See [Storage and the three-tier model](./storage-model.md) for authoritative files, capacities, and directories.
 
+## Cross-agent sharing boundary
+
+“Sharing” does not mean that dsh-mnemon broadcasts conversations or files to arbitrary agents. It means that multiple Mnemon-enabled agents use the same local Mnemon data:
+
+1. every participant installs and integrates Mnemon;
+2. every participant can access the same `storageRoot`;
+3. durable memories intended for sharing live in Mnemon Stores recognized by those participants.
+
+Under those conditions, another Mnemon-enabled agent can recall durable facts, entities, and relations written through DSH, and DSH can discover compatible memories written in the other direction. This boundary covers Mnemon Memory Spaces only. `runtime/` and `documents/` are DSH layers managed by dsh-mnemon and do not automatically become another agent's context merely because the root is shared.
+
+The default `global` root, `~/.mnemon`, is the simplest choice for several local agents. Use `custom` for an explicitly agreed shared root, or `workspace` to constrain sharing to one project. Concurrent processes rely on Mnemon and SQLite concurrency semantics; stop every user before offline copying, migration, or direct database changes.
+
 ## Architecture
 
 [![dsh-mnemon runtime architecture with DSH Web, Root Agent, supervised control, and three local tiers](../assets/diagrams/en/project-architecture.svg)](../assets/diagrams/en/project-architecture.svg)

package/docs/en/storage-model.md

@@ -164,6 +164,12 @@ mnemon.db     independent data plane
 - Merge imports source content into the target through Mnemon; the source database remains in place, and by default only the source is marked inactive.
 - `forget` is a soft delete by exact ID, not deletion of a database file.
 
+### Cross-Agent Visibility
+
+`mnemon.db` is Mnemon's native data plane, not a private dsh-mnemon format. Another Mnemon-enabled agent can access the same durable memory when it uses the same `storageRoot` and Store. dsh-mnemon also discovers compatible Stores already present on disk; DSH-specific names, descriptions, and activation state remain managed by `.dsh-memory-bodies.json`.
+
+This sharing does not extend to `runtime/` or `documents/`. Even when those directories sit under the same root, another agent must implement their DSH-specific protocols to understand them. “Shared Mnemon memory” must not be presented as automatic sharing of the complete DSH context.
+
 ## Four Relationship Types
 
 The Mnemon long-term layer preserves `temporal`, `semantic`, `causal`, and `entity` relationships. The plugin does not require relationships to be created manually for every memory; they should be created only when they genuinely improve future recall. Overview can aggregate memories, entities, relationships, and space membership across multiple active Memory Spaces.

package/docs/en/ui-guide.md

@@ -2,7 +2,7 @@
 
 [简体中文](../zh-CN/ui-guide.md) | **English** | [Documentation hub](./README.md)
 
-This guide follows the default `sidebar` presentation and a real user path through Memory System. Screenshots come from the v0.1.3 interface and use the Chinese locale; names, counts, and content vary with your data.
+This guide follows the default `sidebar` presentation and a real user path through Memory System. Screenshots come from the v0.1.5 interface and use the Chinese locale; names, counts, and content vary with your data.
 
 ## Start with the two display modes
 

package/docs/zh-CN/README.md

@@ -1,6 +1,6 @@
 # dsh-mnemon 文档中心
 
-**简体中文** | [English](../en/README.md) | [项目首页](../../README.md)
+**简体中文** | [English](../en/README.md) | [项目首页](../../README.zh-CN.md)
 
 这里按“你现在要完成什么”组织文档。第一次使用从快速开始进入；需要理解页面时看 UI 指南；只有在部署、集成或开发时才需要进入参考文档。
 
@@ -8,13 +8,14 @@
 
 1. [快速开始](./getting-started.md)：安装 Mnemon 与插件，选择存储范围，完成第一次验证。
 2. [Sidebar 与对话交互指南](./ui-guide.md)：认识状态、运行时、记忆体、档案和对话内入口。
-3. [项目介绍](./project-overview.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#工作区模式查看与执行分离) |
@@ -34,13 +35,14 @@
 | 运行时记忆 | 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.3 的 Sidebar 默认体验为主，同时说明 Buildin 兼容形态。
+- 用户文档以 v0.1.5 的 Sidebar 默认体验为主，同时说明 Buildin 兼容形态。
 - 架构图表达稳定执行边界，不是实时监控面板；实时数量与版本以“状态”页为准。
 - RPC 是 Host 与插件客户端之间的内部协议，不承诺稳定外部 API。
 - 当前没有正式固定的 DSH / Mnemon 版本矩阵；升级前应备份并在隔离目录验证。

package/docs/zh-CN/architecture.md

@@ -8,7 +8,7 @@
 
 - DSH 提供主 Agent、生命周期事件、subagent provider、工具、命令、设置和 Web 扩展点；
 - 插件提供三层知识控制面、路由策略、事务屏障和 UI；
-- 本地 `mnemon` CLI 提供命名 Store、SQLite 持久化、四类图、召回、关系和软删除。
+- 本地 `mnemon` CLI 提供命名 Store、SQLite 持久化、四类图、召回、关系和软删除，并形成与其他 Mnemon-enabled Agent 共享长期记忆的数据边界。
 
 ## 组件图
 
@@ -16,6 +16,8 @@
 
 图中实线表示确定性数据或控制路径，紫色虚线表示 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()` 按以下顺序组装插件：

package/docs/zh-CN/configuration.md

@@ -66,7 +66,7 @@ MNEMON_DATA_DIR when non-empty
   otherwise ~/.mnemon
 ```
 
-适合希望多个工作区共享 Runtime、Documents 和 Memory Spaces 的用户。
+适合希望多个工作区共享 Runtime、Documents 和 Memory Spaces 的用户；其他 Mnemon-enabled Agent 使用相同根时，也可以共享其中的 Mnemon Memory Spaces。
 
 ### `workspace`
 
@@ -87,19 +87,33 @@ mnemon:
 
 也允许 `~` 和 `~/...`。相对路径会被拒绝。
 
+### 选择跨 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
+  -> 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` 会被采用；若它不可执行，实际调用会返回启动错误。
+显式 `cliPath` 会被采用；若它不可执行，实际调用会返回启动错误。Windows 自动发现只接受普通 `.exe` 文件；进程执行不使用 shell，因此有意排除 `.cmd` 与 `.bat` wrapper。
 
 ## 兼容 Store 提示优先级
 
@@ -178,7 +192,7 @@ routingGuidance=false
 
 ## Profile patch 覆盖
 
-包内 `cordis.patch.yml` 提供默认 config 行。DSH profile 的同 ID 配置可能整体覆盖这行；自定义 patch 时应保留仍需启用的键，而不是假设深合并。
+包内 `cordis.patch.yml` 提供默认 config 行。DSH profile 的同 ID 配置可能整体覆盖这行。不要在 profile 的最终 patch 中只增加 `cliPath`；请改用 `MNEMON_CLI_PATH` 或用户设置 `mnemon.cliPath`。确因其他原因需要自定义 profile patch 时，应保留仍需启用的全部键，而不是假设深合并。
 
 ## 常见配置
 
@@ -189,6 +203,13 @@ mnemon:
   storageScope: workspace
 ```
 
+显式指定 Windows CLI 路径：
+
+```yaml
+mnemon:
+  cliPath: 'C:\Users\alice\AppData\Local\Programs\mnemon\mnemon.exe'
+```
+
 自定义数据盘和较长 CLI 超时：
 
 ```yaml

package/docs/zh-CN/development.md

@@ -171,7 +171,7 @@ Web locale 变更时，中文键集合仍是类型事实源；英文词典必须
 ```text
 [ ] pnpm run verify
 [ ] review source and generated lib diffs
-[ ] validate package file list includes README.en.md, docs/assets and bilingual docs
+[ ] 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

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

@@ -14,7 +14,7 @@
 
 普通语义任务优先使用名为 `spawn` 的 Provider，并要求 `outputSchema`、`toolFilter`、`persona` 与 `depthLimit`。可选的评分后台审查还要求名为 `fork`、且 `inheritsParentContext=true` 的 Provider。缺少 `fork` 不影响确定性页面读取和普通手动操作。
 
-项目当前不声明固定的 DSH / Mnemon 最低版本矩阵。本文与截图以 dsh-mnemon v0.1.3 为基线；升级前先备份，并在隔离目录重复本页验证。
+项目当前不声明固定的 DSH / Mnemon 最低版本矩阵。本文与截图以 dsh-mnemon v0.1.5 为基线；升级前先备份，并在隔离目录重复本页验证。
 
 ## 2. 安装 Mnemon
 
@@ -24,7 +24,7 @@ macOS 推荐 Homebrew Cask：
 brew install --cask mnemon-dev/tap/mnemon
 ```
 
-macOS 或 Linux 也可通过 Go 安装：
+macOS 和 Linux 可通过 Go 安装：
 
 ```sh
 go install github.com/mnemon-dev/mnemon@latest
@@ -36,7 +36,51 @@ go install github.com/mnemon-dev/mnemon@latest
 mnemon --version
 ```
 
-如果 DSH 无法从 `PATH` 找到它，可设置 `MNEMON_CLI_PATH`，或把绝对路径写入 `mnemon.cliPath`。`mnemon status` 会打开有效 Store，可能初始化数据或执行上游迁移，不要把它当作完全无副作用的安装探测。
+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
 
@@ -103,7 +147,7 @@ dsh plugin --profile web remove dsh-mnemon
 - 存储根与刚才选择的范围一致；
 - Runtime、Memory Spaces 和 Documents 没有错误提示。
 
-如果 Mnemon 不可用，先运行 `command -v mnemon` 与 `mnemon --version`。更多症状见[故障排查](./operations.md#故障排查)。
+如果 Mnemon 不可用，macOS/Linux 先运行 `command -v mnemon` 与 `mnemon --version`；Windows PowerShell 运行 `Get-Command mnemon` 与 `Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"`。更多症状见[故障排查](./operations.md#故障排查)。
 
 ## 6. 完成第一次验证
 

package/docs/zh-CN/operations.md

@@ -11,6 +11,13 @@ command -v mnemon
 mnemon --version
 ```
 
+Windows PowerShell：
+
+```powershell
+Get-Command mnemon -ErrorAction SilentlyContinue
+Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"
+```
+
 ```text
 /mnemon status
 ```
@@ -125,7 +132,7 @@ mnemon --version
 
 | 现象 | 检查与处理 |
 |---|---|
-| Mnemon 不可用 | 运行 `command -v mnemon`、`mnemon --version`；设置 `MNEMON_CLI_PATH` 或 `cliPath` 后重启 |
+| Mnemon 不可用 | macOS/Linux 运行 `command -v mnemon`、`mnemon --version`；Windows PowerShell 运行 `Get-Command mnemon`、`Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"`。设置 `MNEMON_CLI_PATH` 或 `mnemon.cliPath` 后重启 |
 | 左侧栏没有“记忆系统” | 检查 `tabEnabled=true`、`displayMode=sidebar`；Buildin 位于对话区；本地 link 先 `pnpm run build` 再重启 profile |
 | 状态正常但召回为空 | 检查 active 记忆体、存储范围、查看目录、会话实际目录和查询是否足够聚焦 |
 | 顶部提示目录未对齐 | 工作台正在查看另一个工作区；点击一键对齐，或有意保留只读查看；Agent-backed 操作在未对齐时拒绝 |

package/docs/zh-CN/project-overview.md

@@ -1,8 +1,8 @@
-# 项目介绍：面向 DSH 的本地三层记忆系统
+# 项目介绍：面向 DSH 的本地三层与跨 Agent 共享记忆系统
 
 **简体中文** | [English](../en/project-overview.md) | [文档中心](./README.md)
 
-`dsh-mnemon` 将 [Mnemon](https://github.com/mnemon-dev/mnemon) 的长期记忆体接入 DeepSeek Harness，并补充运行时热记忆、项目档案、生命周期路由、受限子 Agent、确定性控制层与 DSH 原生界面。
+`dsh-mnemon` 将 [Mnemon](https://github.com/mnemon-dev/mnemon) 的长期记忆体接入 DeepSeek Harness，并补充运行时热记忆、项目档案、生命周期路由、受限子 Agent、确定性控制层与 DSH 原生界面。因为长期层使用 Mnemon 原生 Store，DSH 也获得了与其他 Mnemon-enabled Agent 复用同一套本地长期记忆的能力。
 
 它要解决的不是“保存更多文字”，而是让 Agent 在长期连续性、当前事实优先、上下文成本和可恢复写入之间取得平衡。
 
@@ -50,6 +50,18 @@
 
 三层的权威文件、容量与目录结构见[存储与三层记忆模型](./storage-model.md)。
 
+## 跨 Agent 共享边界
+
+这里的“共享”不是 dsh-mnemon 把对话或文件主动广播给任意 Agent，而是多个已接入 Mnemon 的 Agent 使用同一套本地 Mnemon 数据：
+
+1. 每个参与方都安装并接入 Mnemon；
+2. 每个参与方都能访问同一个 `storageRoot`；
+3. 需要共享的长期记忆位于各方共同识别的 Mnemon Store 中。
+
+满足这些条件后，在 DSH 中写入的长期事实、实体与关系可以由其他 Mnemon-enabled Agent 召回，反向写入也能被 DSH 发现。共享范围只覆盖 Mnemon Memory Spaces；`runtime/` 和 `documents/` 是 dsh-mnemon 管理的 DSH 层，不会仅因共用目录就自动成为其他 Agent 的上下文。
+
+`global` 默认根 `~/.mnemon` 最适合本机多个 Agent 共享；`custom` 适合显式约定的公共根；`workspace` 则把共享限制在对应项目目录。多个进程同时访问时依赖 Mnemon / SQLite 的并发语义，离线复制、迁移或直接修改数据库前应先停止所有使用者。
+
 ## 总体架构
 
 [![dsh-mnemon 运行时架构：DSH Web、Root Agent、监督控制层与三层本地存储](../assets/diagrams/zh-CN/project-architecture.svg)](../assets/diagrams/zh-CN/project-architecture.svg)

package/docs/zh-CN/storage-model.md

@@ -164,6 +164,12 @@ mnemon.db     独立数据面
 - 合并通过 Mnemon import 把来源内容导入目标；来源数据库保留，默认只将来源设为未激活。
 - `forget` 是按精确 ID 的软删除，不等于删除数据库文件。
 
+### 跨 Agent 可见性
+
+`mnemon.db` 是 Mnemon 原生数据面，不是 dsh-mnemon 私有格式。其他 Mnemon-enabled Agent 在使用同一个 `storageRoot` 和 Store 时，可以访问同一份长期记忆。dsh-mnemon 也会发现磁盘上兼容的 Store；其 DSH 专有名称、说明和激活状态仍由 `.dsh-memory-bodies.json` 管理。
+
+共享不延伸到 `runtime/` 或 `documents/`。即使它们位于同一个根，其他 Agent 也必须自行实现相应协议才能理解这些 DSH 管理层；不能把“共享 Mnemon 长期记忆”表述为自动共享完整 DSH 上下文。
+
 ## 四类关系
 
 Mnemon 长期层保留 `temporal`、`semantic`、`causal` 和 `entity` 关系。插件不会要求每条记忆都手工创建关系；关系应在确实能改善未来召回时建立。记忆体页可以聚合多个已激活记忆体的记忆、实体、关系和空间归属。

package/docs/zh-CN/ui-guide.md

@@ -2,7 +2,7 @@
 
 **简体中文** | [English](../en/ui-guide.md) | [文档中心](./README.md)
 
-本指南以默认的 `sidebar` 形态为主，按真实使用路径介绍记忆系统。截图来自 v0.1.3 实机界面；数量、名称和内容会随你的数据变化。
+本指南以默认的 `sidebar` 形态为主，按真实使用路径介绍记忆系统。截图来自 v0.1.5 实机界面；数量、名称和内容会随你的数据变化。
 
 ## 先认识两种展示形态