dsh-mnemon 0.1.3 → 0.1.4

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.4 的 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,6 +87,16 @@ 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

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.4 为基线；升级前先备份，并在隔离目录重复本页验证。
 
 ## 2. 安装 Mnemon
 

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.4 实机界面；数量、名称和内容会随你的数据变化。
 
 ## 先认识两种展示形态