diff --git a/AGENTS.md b/AGENTS.md
index e185ab7..d616d0f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -5,7 +5,7 @@
 ## 进入仓库
 
 1. 遵守本文件的全局约束，按 [Agent Wiki 索引](docs/agent-wiki/wiki/index.md) 定位本次任务相关的来源或代码；已知入口时可直接进入。
-2. 需要跨主题理解时选读对应概念页，再按问题追溯来源；不要求每次依次读完 README、概念页和来源。
+2. 需要理解概念及其关系时选读对应概念页，再按问题追溯来源；不要求每次依次读完 README、概念页和来源。
 3. 不熟悉产品、启动方式或支持范围时读 [README.md](README.md)。产品范围以用户已确认的方案为准，代码和测试说明实际能力。
 
 ## 产品与工程边界
@@ -33,8 +33,8 @@
 
 ## 文档维护
 
-- [Agent Wiki 说明](docs/agent-wiki/README.md) 定义维护流程。`sources/` 根目录维护项目级规范与操作说明，`decisions/` 维护当前领域契约与设计取舍，`validation/` 维护验证方法与证据范围；`wiki/index.md` 直接指向来源或代码，`wiki/concepts/` 只按需解释跨主题关系并导航，不重复维护完整规范或验收状态。
-- 影响长期判断时，在同一提交中更新该事实的主要维护位置；只有摘要内容或阅读入口也发生变化时，才同步概念页、索引、本文件或 README。未改变长期知识的小改动不新增文档。
+- [Agent Wiki 说明](docs/agent-wiki/README.md) 定义维护流程。`sources/` 根目录维护项目级规范与操作说明，`decisions/` 维护当前领域契约与设计取舍，`validation/` 维护验证方法与证据范围；`wiki/index.md` 直接指向来源或代码。`wiki/concepts/` 解释概念、关系与职责边界，必要时用简单结构图，并提供带用途的来源链接；具体行为、验证方法和证据由对应来源维护。
+- 影响长期判断时，在同一提交中更新该事实的主要维护位置。概念含义、关系、职责边界或入口变化时才更新概念页；索引、本文件与 README 按各自内容变化更新。精简概念页前先安置独有且有效的规则与证据指针；未改变长期知识的小改动不新增文档。
 - 验收范围扩展、出现阻塞或相关改动影响旧证据时，同步更新证据入口与领域契约中的当前限制；归档前保留从当前来源到相关报告的直接入口。
 - [核心词汇](docs/agent-wiki/sources/product-core-and-glossary.md) 负责产品语义，[协议](docs/agent-wiki/sources/protocol.md) 负责字段与路由；短页面不重复维护完整规范。
 - 旧现场与 main 迁移见 [IMPLEMENTATION.md](IMPLEMENTATION.md)。归档材料只供考据，不能把旧产品边界重新当作当前要求。
diff --git a/docs/agent-wiki/README.md b/docs/agent-wiki/README.md
index 677edfb..cd7626b 100644
--- a/docs/agent-wiki/README.md
+++ b/docs/agent-wiki/README.md
@@ -1,6 +1,6 @@
 # Team Cross Agent Wiki
 
-这里组织当前工程知识和按需的任务记录，帮助后续工作找到产品约束、相关代码、验证方法及必要的接续信息。`sources/` 与 `wiki/` 描述当前项目，`tasks/` 保存具体工作的过程与证据；任务记录中的临时判断不作为当前项目约束。
+Agent Wiki 为人和 Agent 提供概念关系、当前工程契约与证据入口，帮助后续工作找到产品约束、相关代码、验证方法及必要的接续信息。`sources/` 与 `wiki/` 描述当前项目，`tasks/` 保存具体工作的过程与证据；任务记录中的临时判断不作为当前项目约束。
 
 从 [任务索引](wiki/index.md) 按修改范围选读。产品概览与公共阅读入口见根目录 [README](../../README.md)，用户操作见 [使用指南](../user-guide.md)，本地开发见 [开发与构建](sources/development.md)。
 
@@ -19,7 +19,7 @@ docs/agent-wiki/
 │       └── evidence-map.md          已知验证范围及证据入口
 ├── wiki/
 │   ├── index.md                    工程任务导航
-│   └── concepts/                   按需的跨主题上下文与来源入口
+│   └── concepts/                   概念、关系、职责边界与来源入口
 └── tasks/
     ├── <task-id>.md                 按需创建的活跃任务记录
     └── finished_archived/           已结束记录，默认检索排除
@@ -30,12 +30,20 @@ docs/agent-wiki/
 - `sources/` 根目录维护项目级规范与操作说明，包括词汇、流程、架构、协议、开发、安装与发布；它们不必归入概念或决策目录。每类事实有一个主要维护位置，重要页面开头说明本页职责及相关来源。
 - `sources/decisions/` 维护当前领域契约与设计取舍：规则、适用范围、限制、选择理由和重新评估条件，随所在分支的实现维护。它不是仅保存历史选择的记录库；历史过程留在任务记录。不要求每个领域再拆一份规范或摘要。
 - `sources/validation/` 维护验证方法、通过标准与证据范围。`test-gates.md` 回答如何验证；[evidence-map.md](sources/validation/evidence-map.md) 维护具体路径的已知结果、被测版本/环境、证据指针与适用边界，完整执行结果按 [任务记录](#任务记录) 留存。
-- `wiki/concepts/` 按需解释跨主题的对象关系、容易混淆的边界和阅读顺序，并链接到主要来源与实现。保留理解所需的简短说明，不重复维护完整字段、操作步骤、领域契约或验收状态表。来源已经清楚时，由索引直接链接，不要求来源与概念页一一对应。
+- `wiki/concepts/` 是理解系统的领域地图，按概念关系组织，并用带用途的链接指向主要来源。具体行为、字段、接口、操作步骤和异常处理由来源维护，验证方法与实际结果分别进入验证契约和证据入口。一个概念页可连接多个来源；来源已清楚、无需额外解释时，由索引直接链接。
 - `wiki/index.md` 负责工程任务导航；根目录 [AGENTS.md](../../AGENTS.md) 负责首次进入仓库的阅读顺序和必要行为规则。
 - `tasks/` 保存本次目标、临时判断、执行观察和未完成事项；归档记录只说明当时版本与环境下的判断。
 
 当前采用手工维护，没有启用自动 wiki compiler；未来 compiler 的本地状态使用已被 Git 忽略的 `.llmwiki/`。
 
+## 概念页的抽象边界
+
+概念页保留理解系统所需的对象含义、关系与职责边界。例如“已发布材料固定共享依据，个人会话保留各自上下文，共同执行另有输入归属”说明三者的关系；具体发布条件、投递规则和权限检查回到来源查询。
+
+必要时用简单结构图表达包含、依赖、职责或作用域；连线说明含义，文字应能独立解释同一关系。调用顺序、条件分支和恢复步骤留在对应来源，图与文字采用相同的抽象尺度，无须每页套用固定格式。
+
+仅字段、匹配算法或调用实现变化，而概念关系与来源入口未变时，概念页应仍然成立。改写后用一个关系问题检查解释是否清楚，再用一个具体行为问题检查能否沿链接找到规则；同时核对移出的有效约束与证据指针各有去处。
+
 ## 事实来源
 
 用户已确认的产品决策确定目标；代码和测试说明当前实际能力。二者不一致时，应明确记录差异并修正相关实现或说明，不能把计划写成已经验收。
@@ -49,9 +57,9 @@ docs/agent-wiki/
 ## 更新流程
 
 1. 判断变化是否影响未来任务的产品或工程判断；有影响时更新对应来源，涉及新的取舍时记录原因和重新评估条件。
-2. 只有摘要内容或阅读入口也变化时，才同步相关概念页、任务索引、AGENTS 或 README；不要求每次改动更新所有层级。
+2. 概念含义、关系、职责边界或来源入口变化时才更新概念页；任务索引、AGENTS 与 README 按各自内容变化更新，不机械刷新所有层级。
 3. 按 [验证门槛](sources/validation/test-gates.md) 执行适用检查，将实际结果与未覆盖范围分开记录。新结果扩展范围、暴露阻塞或后续改动影响旧证据时，同步更新证据入口与领域契约中的当前限制；无需给每次普通测试新增条目。
-4. 在同一提交中检查相对链接、代码路径和旧引用。精简概念页前确认规范已由主要来源维护；仅存在于概念页的有效规则先移入对应来源，再改为导航。
+4. 在同一提交中检查相对链接、代码路径、旧引用和索引可达性。精简概念页前核对与来源的差异，将独有且有效的规则、验证要求与证据指针移入对应来源，再移除重复细节。
 
 确定下来的长期知识随开发分支中的代码推进，不集中拖到合入时。恢复既有行为、样式微调等未改变长期知识的工作，不必新增决策或概念页。
 
diff --git a/docs/agent-wiki/sources/architecture.md b/docs/agent-wiki/sources/architecture.md
index f39a6dc..bdcec2f 100644
--- a/docs/agent-wiki/sources/architecture.md
+++ b/docs/agent-wiki/sources/architecture.md
@@ -32,13 +32,13 @@ flowchart LR
 
 ## 模块
 
-- `internal/workspace`：Git 预览、干净 worktree、子目录映射、文件读取。
-- `internal/nativecodex`：启动和初始化独立 app-server，通过一个长期 WebSocket 进行 RPC、事件及 server request 分发。
-- `internal/collab`：协作记录、原生协议网关、输入协调、邀请与加入、TUI/Desktop 启动、HTTP 管理接口。
-- `internal/materialstore`：确定性清单、SHA-256 blob、不可变原子写入及内容校验；授权仍由 `internal/collab` 的空间或私有草稿引用决定。
-- `internal/sharing`：`tcx3` 邀请、临时 TLS listener、指纹绑定，以及 LAN / Tailcat 服务端与客户端连接适配。Tailcat 只把虚拟 TCP 443 交给同一 TLS/HTTP 网关。
-- `internal/mcp`：个人辅助 STDIO 与共享运行时批注 STDIO。后者提供当前协作的读取/回复、配对回执、通用空间请求工具及独立凭据，每次调用重新读取 Core 地址，不启动 Core 或复用管理凭据。
-- `packages/web`：新 React/Vite 界面，生产资源编译到 `internal/webassets/dist` 后嵌入 Go 二进制。
+- [internal/workspace](../../../internal/workspace/)：Git 预览、干净 worktree、子目录映射、文件读取。
+- [internal/nativecodex](../../../internal/nativecodex/)：启动和初始化独立 app-server，通过一个长期 WebSocket 进行 RPC、事件及 server request 分发，入口见 [process.go](../../../internal/nativecodex/process.go)。
+- [internal/collab](../../../internal/collab/)：协作记录、原生协议网关、输入协调、邀请与加入、TUI/Desktop 启动、HTTP 管理接口。创建与恢复见 [app.go](../../../internal/collab/app.go)，独立空间、冻结来源与材料版本见 [spaces.go](../../../internal/collab/spaces.go)、[publication.go](../../../internal/collab/publication.go)、[materials.go](../../../internal/collab/materials.go)。
+- [internal/materialstore](../../../internal/materialstore/)：确定性清单、SHA-256 blob、不可变原子写入及内容校验；授权仍由 `internal/collab` 的空间或私有草稿引用决定。
+- [internal/sharing](../../../internal/sharing/)：`tcx3` 邀请、临时 TLS listener、指纹绑定，以及 LAN / Tailcat 服务端与客户端连接适配。Tailcat 只把虚拟 TCP 443 交给同一 TLS/HTTP 网关。
+- [internal/mcp](../../../internal/mcp/)：个人辅助 STDIO 与共享运行时批注 STDIO。后者提供当前协作的读取/回复、配对回执、通用空间请求工具及独立凭据，每次调用重新读取 Core 地址，不启动 Core 或复用管理凭据。
+- [packages/web](../../../packages/web/)：新 React/Vite 界面，生产资源编译到 `internal/webassets/dist` 后嵌入 Go 二进制。
 
 ## 空间工作台
 
@@ -52,7 +52,7 @@ flowchart LR
 
 仅复制 rollout 文件无法替代原生历史数据库。协作记录保存 `sourceId`、已确认的 `sourceTurnId` 和新 `sessionId`。创建调用 `thread/fork`，使用 `lastTurnId` 保留确认过的已完成起点。恢复调用 `thread/resume`，继续同一 ID。
 
-个人 Agent 的当前 Session 分享通过本机持久化请求等待来源本轮完成，不阻塞该 MCP 调用。Codex 原生调用元数据、Claude 的 Session 环境与工具调用历史分别验证来源；独立 Codex 读取进程会重建未结束轮次状态，因此创建前还读取原始 rollout 边界确认完成。工作线程只观察固定轮次；起点漂移、取消或 Core 停止后不自动选新来源或重放。完成后调用既有 Preview/Create/Share；保存部分创建结果，邀请失败可单独恢复。实现见 [current_share.go](../../../internal/collab/current_share.go) 与 [当前 Session 协议](protocol.md#当前-session-与延后分享)。
+个人 Agent 的当前 Session 分享通过本机持久化请求等待来源本轮完成，不阻塞该 MCP 调用。Codex 原生调用元数据、Claude 的 Session 环境与工具调用历史分别验证来源；独立 Codex 读取进程会重建未结束轮次状态，因此创建前还读取原始 rollout 边界确认完成。工作线程只观察固定轮次；起点漂移、取消或 Core 停止后不自动选新来源或重放。完成后调用既有 Preview/Create/Share；保存部分创建结果，邀请失败可单独恢复。实现见 [MCP 当前身份](../../../internal/mcp/current.go)、[延后分享](../../../internal/collab/current_share.go) 与 [来源轮次](../../../internal/nativecodex/source_turn.go)，字段见 [当前 Session 协议](protocol.md#当前-session-与延后分享)。
 
 直接客户端的 `initialize`、会话枚举和请求都经过协作网关。网关只暴露指定协作；固定 `threadId` 与 `cwd`；受限模式固定权限 profile，信任模式沿用原生权限，并允许当前输入者通过原生会话设置选择权限。模型及推理强度继承原生来源和当前输入者的选择。网关与 MCP 共享同一个上游控制连接，避免审批只被某个连接收到而另一入口无法回应。共享仍开放时，直接客户端断开不会终止 app-server。结束共享后，执行、审批、已接收请求和直接连接全部结束才关闭该 Session 的 app-server，释放原生 writer lock；仅 `thread/unsubscribe` 不作为释放依据。关闭过程在会话锁外等待进程退出，恢复等待退出完成，旧进程通知按代次丢弃。
 
diff --git a/docs/agent-wiki/sources/product-core-and-glossary.md b/docs/agent-wiki/sources/product-core-and-glossary.md
index 9494027..62e86fd 100644
--- a/docs/agent-wiki/sources/product-core-and-glossary.md
+++ b/docs/agent-wiki/sources/product-core-and-glossary.md
@@ -76,4 +76,4 @@ Codex 的直接操作与本地辅助可使用 TUI 或 Desktop；Claude 实验性
 
 ## 维护入口
 
-字段以 [协作类型](../../../internal/collab/types.go) 和 [接口说明](protocol.md) 为准。修改用词时同步 [用户流程](product-flows.md)、[产品模型任务页](../wiki/concepts/product-model-and-glossary.md) 与面向用户的文案。
+字段以 [协作类型](../../../internal/collab/types.go) 和 [接口说明](protocol.md) 为准。修改用词时核对 [用户流程](product-flows.md) 与面向用户的文案；只有概念含义、关系、职责边界或入口变化时，才更新 [产品模型概念页](../wiki/concepts/product-model-and-glossary.md)。
diff --git a/docs/agent-wiki/sources/product-flows.md b/docs/agent-wiki/sources/product-flows.md
index 28fbe1a..0714b44 100644
--- a/docs/agent-wiki/sources/product-flows.md
+++ b/docs/agent-wiki/sources/product-flows.md
@@ -59,7 +59,7 @@
 
 发起、结束协作均不要求提出问题、生成摘要、收集独立 Evidence 或验证成果。是否提交代码、导出 patch、创建 PR，由用户在自己的开发工具中决定。
 
-用户动作变化时更新本页；只有相关摘要或阅读入口也变化时，才更新概念页或索引，按 [Wiki 更新流程](../README.md#更新流程) 维护。原生客户端的具体版本与已知覆盖范围见 [证据入口](validation/evidence-map.md#原生执行与协作模式)，不能将流程描述本身当作实测结果。
+用户动作变化时更新本页；只有概念关系、职责边界或阅读入口也变化时，才更新概念页或索引，按 [Wiki 更新流程](../README.md#更新流程) 维护。原生客户端的具体版本与已知覆盖范围见 [证据入口](validation/evidence-map.md#原生执行与协作模式)，不能将流程描述本身当作实测结果。
 
 ## 首页与创建入口
 
@@ -122,3 +122,9 @@
 ## 首次体验入口
 
 创建并邀请、邀请确认、上下文优先、输入申请和分发流程见 [分发与首次体验](distribution-and-onboarding.md)。启动不要求 repo；App 与 CLI 复用同一数据目录的 Core。
+
+## 实现入口
+
+- 分享范围、预览与确认：[Publisher](../../../packages/web/src/components/Publisher.tsx)、[PublicationReader](../../../packages/web/src/components/PublicationReader.tsx)。
+- 正文阅读、批注与原文位置：[Reading](../../../packages/web/src/components/Reading.tsx)、[Context](../../../packages/web/src/components/Context.tsx)、[位置映射](../../../packages/web/src/reading.ts)。
+- 首页、语言与主题：[App](../../../packages/web/src/App.tsx)、[i18n](../../../packages/web/src/i18n.ts)、[样式](../../../packages/web/src/styles.css)；主要流程回归见 [flows.test.tsx](../../../packages/web/src/test/flows.test.tsx)。
diff --git a/docs/agent-wiki/sources/protocol.md b/docs/agent-wiki/sources/protocol.md
index aeb52e2..6fe3758 100644
--- a/docs/agent-wiki/sources/protocol.md
+++ b/docs/agent-wiki/sources/protocol.md
@@ -425,6 +425,8 @@ Codex 信任模式支持原生 hook 确认：只含 `hooks.state` 或其子项
 
 批注实现见 [annotation.go](../../../internal/collab/annotation.go)、[上下文组件](../../../packages/web/src/components/Context.tsx) 和 [批注组件](../../../packages/web/src/components/Annotations.tsx)。
 
+Agent 按需读取见 [历史与材料投影](../../../internal/collab/agent_read.go)、[批注读取](../../../internal/collab/agent_annotations.go)；个人管理工具见 [management.go](../../../internal/mcp/management.go)。
+
 路由与转发以 [本机 HTTP](../../../internal/collab/http.go)、[共享连接](../../../internal/collab/network.go)、[原生 RPC](../../../internal/collab/rpc.go)、[邀请与 TLS](../../../internal/sharing/sharing.go) 和 [STDIO MCP](../../../internal/mcp/server.go) 为准。协议变化在同一提交中更新本页及对应测试；Wiki 页面引用本页，不另存一份路由表。
 
 ## 后台控制与错误分类
diff --git a/docs/agent-wiki/sources/validation/test-gates.md b/docs/agent-wiki/sources/validation/test-gates.md
index d878cb5..e708ba6 100644
--- a/docs/agent-wiki/sources/validation/test-gates.md
+++ b/docs/agent-wiki/sources/validation/test-gates.md
@@ -6,7 +6,7 @@
 
 | 变更范围 | 应完成的检查 |
 | --- | --- |
-| 仅 Markdown、导航或文档迁移 | 相对链接、代码路径、旧引用、索引可达性与 `git diff --check`；不需要启动模型或测试客户端 |
+| 仅 Markdown、导航或文档迁移 | 相对链接、代码路径、旧引用、索引可达性与 `git diff --check`；精简概念页另核对规则与证据指针的去处、关系解释或结构图的含义，以及到具体规则的阅读路径；不需要启动模型或测试客户端 |
 | 产品代码 | 下列 Go 与 Web 工程门槛，按修改范围补相关回归 |
 | Git 预览、目录创建或恢复 | 原目录分支/HEAD/暂存区/文件不变；worktree 不复制四类未提交内容；子目录映射、新会话 ID 与来源关联 |
 | 输入协调、共享或进程生命周期 | 相关 race test，以及直接连接/MCP 共用输入者、重复请求、审批、断线、结束访问和恢复 |
diff --git a/docs/agent-wiki/wiki/concepts/collaboration-spaces.md b/docs/agent-wiki/wiki/concepts/collaboration-spaces.md
index f4ed0d1..c235917 100644
--- a/docs/agent-wiki/wiki/concepts/collaboration-spaces.md
+++ b/docs/agent-wiki/wiki/concepts/collaboration-spaces.md
@@ -1,24 +1,20 @@
 # 只读分享与多人协作空间
 
-本页解释空间、材料、成员和执行之间的关系，帮助跨主题定位。当前规则与设计取舍由 [协作空间契约](../../sources/decisions/collaboration-spaces.md) 维护，对象语义见 [核心词汇](../../sources/product-core-and-glossary.md#协作空间的对象边界)，实际验证范围见 [证据入口](../../sources/validation/evidence-map.md#空间材料与读取)。
-
-空间先提供成员、材料和讨论。成员可以发布自己选定范围的会话材料，各自的个人会话继续保持独立；分享一段历史不会自动公开后续内容。材料的固定版本让不同成员和 Agent 能围绕同一份原文讨论。
-
-加入空间、获得执行访问和取得当前输入权是不同关系。同一链接可以供多人加入，每位成员拥有独立凭据；需要一起操作项目时，才明确启用共同执行并开放新增访问。只读空间本身不需要共享 fork，空间的公开材料与执行目录也有各自的授权范围。
-
-参与会话还可以通过明确关联的目标接收空间请求。空间简报保存成员确认的共同依据，可选专用会话帮助接手这些请求；它们与共同执行独立。因此，“有人阅读材料”“Agent 参与讨论”和“共同操作项目”不应视为同一种接入状态。
-
-## 按问题查来源
-
-| 问题 | 主要来源 | 实现入口 |
-| --- | --- | --- |
-| 空间成员、邀请与执行授权 | [空间契约](../../sources/decisions/collaboration-spaces.md)、[输入与共享](../../sources/decisions/input-and-sharing.md) | [空间](../../../../internal/collab/spaces.go)、[网络](../../../../internal/collab/network.go) |
-| 发布范围、更新版本与撤回 | [分享流程](../../sources/product-flows.md#分享范围与确认)、[材料协议](../../sources/protocol.md#已发布会话材料) | [发布](../../../../internal/collab/publication.go)、[材料](../../../../internal/collab/materials.go) |
-| 内容存储、授权和按需读取 | [架构](../../sources/architecture.md#空间材料与执行)、[Agent 读取协议](../../sources/protocol.md#agent-按需读取视图) | [材料存储](../../../../internal/materialstore/)、[材料 MCP](../../../../internal/mcp/materials.go) |
-| 空间请求、简报与专用角色 | [空间工作台](../../sources/decisions/space-workbench.md)、[接收配对](../../sources/decisions/agent-pairing.md) | [工作台 Core](../../../../internal/collab/workbench.go)、[独立接收会话](../../../../internal/collab/space_receivers.go) |
-
-## 验证时区分
-
-按 [验证门槛](../../sources/validation/test-gates.md) 选择范围隔离、多成员撤销和输入交接检查。实际结果通过 [证据入口](../../sources/validation/evidence-map.md) 定向读取；同机三个 Core、真实模型参与和三台 Mac 的网络各自需要相应证据，较早的双人或旧材料格式报告只适用于当时范围。
-
-相关导航：[产品模型](product-model-and-glossary.md) · [WebGUI 与 MCP](webgui-and-mcp.md) · [验证层次](validation-gates.md)
+空间把成员、已发布材料和讨论组织在一起，可以独立于共同执行存在。材料的固定版本
+提供可引用的共同原文；个人会话的后续内容和执行现场各有自己的公开边界。
+
+| 关系 | 所解释的边界 |
+| --- | --- |
+| 成员与空间 | 谁参与这次协作 |
+| 材料与来源会话 | 哪一份已公开内容成为共同依据 |
+| 成员与共同执行 | 谁可以访问原生历史和执行现场 |
+| 当前输入者与共享会话 | 谁此刻负责模型输入与操作 |
+
+空间请求连接明确关联的接收目标，简报保存成员确认的议题与决定，可选专用会话承担协调
+角色。这些协作关系与共同执行独立；公开材料、关联会话和授予执行权限分别判断。
+
+- 查询邀请、成员、发布版本、撤回与执行授权 → [空间契约](../../sources/decisions/collaboration-spaces.md)。
+- 查询发布确认与材料读取 → [分享流程](../../sources/product-flows.md#分享范围与确认) / [材料协议](../../sources/protocol.md#已发布会话材料)。
+- 查询输入交接与断线处理 → [输入与共享](../../sources/decisions/input-and-sharing.md)。
+- 查询目标关联、请求、简报与协调角色 → [空间工作台](../../sources/decisions/space-workbench.md) / [接收配对](../../sources/decisions/agent-pairing.md)。
+- 判断某种成员与网络组合是否已有实测依据 → [证据入口](../../sources/validation/evidence-map.md)。
diff --git a/docs/agent-wiki/wiki/concepts/product-model-and-glossary.md b/docs/agent-wiki/wiki/concepts/product-model-and-glossary.md
index 04498d7..f32b3fc 100644
--- a/docs/agent-wiki/wiki/concepts/product-model-and-glossary.md
+++ b/docs/agent-wiki/wiki/concepts/product-model-and-glossary.md
@@ -1,24 +1,21 @@
 # 产品模型与词汇
 
-本页解释产品对象之间的关系，完整定义由 [核心词汇](../../sources/product-core-and-glossary.md) 维护。Team Cross 从已有 Session 和会话记录入手，让人和各自的 Agent 按需分享经验、讨论材料，必要时共同执行；设计原因和总体范围见 [项目简报](../../sources/project-brief.md)。
-
-空间托管成员、已发布材料和讨论。个人会话是材料的来源，也可以在明确授权下参与空间请求；它不会因为被引用或关联就全部公开。[接收会话](../../sources/product-core-and-glossary.md#会话与接收能力)描述会话用途，已有、新建和 fork 不据此分成不同的投递能力类别。共同执行使用新的原生 fork，目录与输入归属另行确定。空间工作台中的专用会话是可选协调角色，与共同执行分别管理。
-
-## 容易混淆的对象
-
-| 对象关系 | 理解时的区别 | 主要来源 |
-| --- | --- | --- |
-| 空间、个人会话、已发布材料 | 空间组织协作，个人会话保留原生所有权，材料固定已公开的范围与版本 | [空间对象语义](../../sources/product-core-and-glossary.md#协作空间的对象边界)、[空间契约](../../sources/decisions/collaboration-spaces.md) |
-| 来源会话、新 fork、执行目录 | 新建会话与选择工作目录是两个步骤；原目录模式也使用新会话 | [目录与生命周期](../../sources/decisions/workspace-and-lifecycle.md) |
-| 成员资格、在线状态、输入归属 | 能访问空间、当前已连接、现在可写入分别判断 | [输入与共享](../../sources/decisions/input-and-sharing.md) |
-| 配对目标、空间请求、专用角色 | 配对确定接收路径，请求保存明确要求与回执，角色决定是否承担空间接手职责 | [接收配对](../../sources/decisions/agent-pairing.md)、[空间工作台](../../sources/decisions/space-workbench.md) |
-| 批注、发送、读取、完成 | 保存讨论不自动触发输入；发送成功和 Agent 读取、报告完成各有自己的回执 | [产品流程](../../sources/product-flows.md#上下文阅读)、[请求契约](../../sources/decisions/agent-pairing.md#投递与回执) |
-| 产品对象与原生协议术语 | Codex Thread/Turn 是 Provider 会话与轮次，不是旧产品的 Thread/Round 模型 | [词汇映射](../../sources/product-core-and-glossary.md#当前实现的词汇映射)、[协议](../../sources/protocol.md) |
-
-## 按问题查来源
-
-定位、目标范围和 [GPL-3.0-only](../../../../LICENSE) 许可看 [项目简报](../../sources/project-brief.md)；用户怎么完成某个动作看 [产品流程](../../sources/product-flows.md)；Provider 和客户端差异看 [原生客户端](../../sources/decisions/native-clients-and-models.md) 与 [Claude 接入](../../sources/decisions/claude-native-tui.md)。产品不固定模型或推理强度，显示语义见 [模型设置](../../sources/product-core-and-glossary.md)。
-
-命名变更从 [协作类型](../../../../internal/collab/types.go)、[页面组件](../../../../packages/web/src/components/) 和 [产品路径测试](../../../../packages/web/src/test/flows.test.tsx) 追踪；主要来源更新后，只有本页解释发生变化时才同步本页。判断能力是否已经验收，另从 [证据入口](../../sources/validation/evidence-map.md) 读取对应路径与版本。
-
-相关导航：[协作空间](collaboration-spaces.md) · [WebGUI 与 MCP](webgui-and-mcp.md) · [运行时架构](runtime-architecture.md)
+Team Cross 让人和各自的 Agent 围绕协作空间分享材料、讨论，并按需共同执行。
+个人原生会话保留各自的上下文；已发布材料固定共享的范围与版本，为讨论提供共同依据。
+
+```mermaid
+flowchart LR
+    P["个人原生会话"] ---|选定历史的来源| M["已发布材料"]
+    S["协作空间"] ---|组织| M
+    S ---|承载| D["成员与讨论"]
+    S ---|可选关联| E["共同执行"]
+```
+
+会话起点、接收用途与执行权限是不同维度。已有、新建和 fork 描述上下文来源；接收会话
+描述请求目标，专用会话描述可选协调角色。参与讨论与共同操作执行现场分别管理。
+
+- 查询定位、设计原因与总体范围 → [项目简报](../../sources/project-brief.md)。
+- 查询对象定义、会话用途及原生术语 → [核心词汇](../../sources/product-core-and-glossary.md)。
+- 查询用户如何分享、讨论与操作 → [产品流程](../../sources/product-flows.md)。
+- 查询空间组织与专用角色 → [空间契约](../../sources/decisions/collaboration-spaces.md) / [空间工作台](../../sources/decisions/space-workbench.md)。
+- 查询 fork、执行目录与保留规则 → [目录与生命周期](../../sources/decisions/workspace-and-lifecycle.md)。
diff --git a/docs/agent-wiki/wiki/concepts/runtime-architecture.md b/docs/agent-wiki/wiki/concepts/runtime-architecture.md
index e66b4bf..6471fee 100644
--- a/docs/agent-wiki/wiki/concepts/runtime-architecture.md
+++ b/docs/agent-wiki/wiki/concepts/runtime-architecture.md
@@ -1,31 +1,21 @@
 # 运行时架构
 
-本页解释托管位置、进程与调用入口之间的关系，详细模块和数据流由 [架构](../../sources/architecture.md) 维护，字段和方法由 [协议](../../sources/protocol.md) 维护。
-
-Go Core 保存空间、已发布材料和本机管理状态。共享执行由 A 的专属原生运行时持有 fork，其他成员的本机 Core 连接 A；各自的个人 Agent 仍在自己的环境中运行。独立只读空间不要求共享执行运行时。工作台按需新建会话时，由创建者的 Core 维护运行时连接，不进入空间的共同执行对象；接收能力与当前连接范围由 [配对契约](../../sources/decisions/agent-pairing.md#身份接收能力与范围)维护。
-
-CLI、App 和 MCP 按数据目录发现同一后台 Core；菜单栏外壳另有自己的实例协调。服务可用、外壳已打开、客户端已接通和模型已完成分别代表不同层次。App/Core 的发现与退出规则见 [分发与首次体验](../../sources/distribution-and-onboarding.md)，接收进程和空间角色的关系见 [工作台契约](../../sources/decisions/space-workbench.md)。
-
-## 从哪里进入代码
-
-| 职责 | 入口 |
-| --- | --- |
-| 命令、监听、Web 嵌入与关闭 | [cmd/teamcross/main.go](../../../../cmd/teamcross/main.go) |
-| 创建、记录持久化、恢复与进程管理 | [collab/app.go](../../../../internal/collab/app.go) |
-| 独立空间、冻结来源与材料版本 | [spaces.go](../../../../internal/collab/spaces.go)、[publication.go](../../../../internal/collab/publication.go)、[materials.go](../../../../internal/collab/materials.go) |
-| 当前会话身份与本轮结束后分享 | [mcp/current.go](../../../../internal/mcp/current.go)、[collab/current_share.go](../../../../internal/collab/current_share.go)、[nativecodex/source_turn.go](../../../../internal/nativecodex/source_turn.go) |
-| 原生 WebSocket RPC 和请求分发 | [nativecodex/process.go](../../../../internal/nativecodex/process.go) |
-| 本机管理、共享与接收端代理 | [http.go](../../../../internal/collab/http.go)、[network.go](../../../../internal/collab/network.go) |
-| 接收配对、空间请求与独立会话 | [agents.go](../../../../internal/collab/agents.go)、[workbench.go](../../../../internal/collab/workbench.go)、[space_receivers.go](../../../../internal/collab/space_receivers.go) |
-| 工具、工作目录与 TLS/传输 | [mcp](../../../../internal/mcp/)、[workspace](../../../../internal/workspace/)、[sharing](../../../../internal/sharing/) |
-| Core 生命周期与 App 实例协调 | [service.go](../../../../internal/service/service.go)、[AppInstance.swift](../../../../apps/macos/AppInstance.swift) |
-
-## 按边界追溯来源
-
-创建与恢复、原目录与 worktree、释放后的保留规则看 [目录与生命周期](../../sources/decisions/workspace-and-lifecycle.md)。原生客户端、账户路由和模型设置看 [原生客户端](../../sources/decisions/native-clients-and-models.md)，受限/信任配置继承看 [协作模式](../../sources/decisions/runtime-modes.md)。
-
-共享前的 LAN/Tailcat 选择、成员凭据和输入协调看 [输入与共享](../../sources/decisions/input-and-sharing.md)。它们共用授权层，但网络环境须单独验证。Claude 的单 worker、个人历史和控制路径看 [Claude 接入](../../sources/decisions/claude-native-tui.md)，不能直接套用 Codex app-server 的全部语义。
-
-修改对应路径时按 [验证门槛](../../sources/validation/test-gates.md) 选择检查；已有证据从 [证据入口](../../sources/validation/evidence-map.md) 定向读取。协议替身、真实客户端、App 外壳与跨机传输的结果分别判断。
-
-相关导航：[产品模型](product-model-and-glossary.md) · [WebGUI 与 MCP](webgui-and-mcp.md) · [验证层次](validation-gates.md)
+Core 管理空间、材料与访问关系，原生运行时持有模型会话并执行工具。空间托管在发起者
+A 的 Core；共同执行也留在 A，各成员的个人会话与接收连接保留各自的本机归属。
+
+```mermaid
+flowchart LR
+    A["A 的 Core"] ---|托管| S["空间与材料"]
+    A ---|共同执行连接| R["A 的共享原生运行时"]
+    B["成员的 Core"] ---|获准访问| A
+    B ---|接收连接| P["本机原生会话"]
+```
+
+图中表示托管与连接关系。只读空间可以没有共享运行时，接收请求也不要求启用共同执行。
+App、后台 Core、客户端连接与原生会话各有生命周期，打开一个入口不代表其他层已经就绪。
+
+- 查询模块、存储与实际数据流 → [架构](../../sources/architecture.md)；字段与路由 → [协议](../../sources/protocol.md)。
+- 查询 App/Core 发现、实例协调与退出 → [分发与首次体验](../../sources/distribution-and-onboarding.md)。
+- 查询 fork、目录与恢复 → [目录与生命周期](../../sources/decisions/workspace-and-lifecycle.md)；配置继承 → [协作模式](../../sources/decisions/runtime-modes.md)。
+- 查询客户端、账户与模型设置 → [原生客户端](../../sources/decisions/native-clients-and-models.md) / [Claude 接入](../../sources/decisions/claude-native-tui.md)。
+- 查询成员连接与共享传输 → [输入与共享](../../sources/decisions/input-and-sharing.md)；接收连接与进程 → [配对契约](../../sources/decisions/agent-pairing.md) / [空间工作台](../../sources/decisions/space-workbench.md)。
diff --git a/docs/agent-wiki/wiki/concepts/validation-gates.md b/docs/agent-wiki/wiki/concepts/validation-gates.md
index c37e804..d8fdaa2 100644
--- a/docs/agent-wiki/wiki/concepts/validation-gates.md
+++ b/docs/agent-wiki/wiki/concepts/validation-gates.md
@@ -1,32 +1,16 @@
-# 验证与验收导航
+# 验证与证据
 
-本页帮助选择证据层次。要确定当前应执行哪些检查，读 [验证门槛](../../sources/validation/test-gates.md)；要回答某条路径是否验收过，从 [验证范围与证据入口](../../sources/validation/evidence-map.md) 定位具体报告。方法、已知结果和本次执行记录分别维护。
+验证契约回答怎样检查、什么算通过；执行记录回答哪个版本在什么环境实际发生了什么；
+证据入口把这些记录与当前路径关联，帮助判断结果仍能适用到哪里。
 
-| 证据 | 能支持的判断 |
-| --- | --- |
-| 构建、类型检查与静态检查 | 当前代码与资源可编译，未代替运行时验证 |
-| 单元、集成与 race test | 覆盖对应自动化用例中的逻辑和并发路径，模拟运行时不代表真实模型 |
-| 真实浏览器与截图 | 页面流程、状态和视觉表现，未代替原生客户端执行 |
-| 原生工具加载与协议调用 | 对应宿主版本能加载或调用工具，未代替成品桌面交互或模型处理 |
-| 专用 TUI/Desktop 与原生运行时 | 对应版本、入口和测试目录中的真实行为 |
-| 同机多个 Core 或客户端 | 本机多成员流程，未证明跨设备网络 |
-| 两台 Mac 的 LAN 或跨网络 | 实际执行过的设备、传输与网络条件，不能互相替代 |
-| 公开 Release 与 Homebrew 安装 | 对应版本的发布与安装结果，未证明 Apple 公证或新功能的真实模型行为 |
+构建和自动化用例、浏览器界面、原生客户端与模型处理、跨机网络各自提供不同层面的
+证据。原生平台能力、Team Cross 的接入范围和被测环境分别判断；同机多个 Core 的结果
+不能扩展为多台 Mac 的网络结论，工具调用成功也不等于目标会话已处理。
 
-发布步骤与各阶段的成功条件见 [构建与发布](../../sources/releasing.md)。CI、发布流水线、真实模型、宿主桌面和跨机联网检查分别选择与报告，不能从一个阶段成功补出其他阶段的结论。
+最近已知结果与当前 checkout 是否复验是两个问题。证据需要绑定版本、路径和环境；
+未收录或未检索到报告，也不直接构成不支持的结论。
 
-## 本次结果与历史记录
-
-小改动在提交或 PR 中说明实际检查即可；跨会话调查、多环境验证或需要交接时，再按 [任务记录规则](../../README.md#任务记录) 保存报告。记录日期、被测版本、环境、结果、证据位置及未覆盖项。
-
-回答验收问题时，先明确 Provider、目标会话、客户端、接收方式和网络环境，再由证据入口读取相应报告。最近已知通过不等于当前版本已复验；后续改动影响该路径时，补充适用边界。没有收录或未检索到结果，也不能直接判断不支持或没有测试。
-
-已结束记录默认不搜索或批量读取，确有问题时定向追溯。可复用方法或通过标准变化时更新验证门槛；已知覆盖范围、阻塞或旧证据适用性变化时更新证据入口。概念页只在证据层次或阅读方式变化时更新。
-
-## 交付时记录
-
-分别报告工程检查、浏览器检查和真实客户端检查，标明实际版本、环境及未覆盖范围。真实模型只使用专用 Luna 会话和仓库；验证后精确关闭本次测试客户端、Core、app-server、浏览器和残留辅助进程。具体执行要求由 [验证门槛](../../sources/validation/test-gates.md) 维护。
-
-仅整理文档时检查链接、旧引用、代码路径和索引可达性，不重复启动运行时，也不因此把旧报告标记为本次通过。
-
-相关导航：[运行时架构](runtime-architecture.md) · [协作空间](collaboration-spaces.md) · [WebGUI/MCP](webgui-and-mcp.md)
+- 选择命令、通过标准、客户端与网络检查 → [验证门槛](../../sources/validation/test-gates.md)。
+- 判断已有结果及其当前适用性 → [证据入口](../../sources/validation/evidence-map.md)。
+- 查询发布与安装各阶段的成功条件 → [构建与发布](../../sources/releasing.md)。
+- 保存本次结果或定向追溯历史 → [任务记录与检索规则](../../README.md#任务记录)。
diff --git a/docs/agent-wiki/wiki/concepts/webgui-and-mcp.md b/docs/agent-wiki/wiki/concepts/webgui-and-mcp.md
index 9ff9f15..ac31cb3 100644
--- a/docs/agent-wiki/wiki/concepts/webgui-and-mcp.md
+++ b/docs/agent-wiki/wiki/concepts/webgui-and-mcp.md
@@ -1,33 +1,24 @@
 # WebGUI 与本地 MCP
 
-本页解释人和 Agent 如何使用同一份空间内容，并按问题定位来源和代码。界面行为由 [产品流程](../../sources/product-flows.md) 维护，工具与数据字段由 [协议](../../sources/protocol.md) 维护；这里不另存完整交互规范或验收状态。
-
-WebGUI 负责协作管理、材料阅读和原文讨论；菜单栏速览提供较轻的查找入口。个人 MCP 让自己的 Agent 访问已发起或加入的空间，共享运行时的工具则绑定当前空间。它们通过 Core 使用同一套权限和原文引用，默认阅读视图可以不同。完整 Agent 对话与执行交互仍在对应原生客户端。
-
-ChatGPT 本机插件复用 WebGUI，通过 UI MCP 桥调用 Core；插件界面能打开、模型能读到引用、会话能主动接收请求是三个需要分别判断的环节。输入框 mention 用于选择引用，发送给明确配对目标则沿 [接收会话契约](../../sources/decisions/agent-pairing.md) 处理。不要从页面、资源或工具已经加载推导后续环节已通过。
-
-## 按问题查来源
-
-| 问题 | 主要维护位置 | 实现入口 |
-| --- | --- | --- |
-| 来源选择、发布范围与确认 | [分享范围与确认](../../sources/product-flows.md#分享范围与确认)、[空间契约](../../sources/decisions/collaboration-spaces.md) | [Publisher](../../../../packages/web/src/components/Publisher.tsx)、[PublicationReader](../../../../packages/web/src/components/PublicationReader.tsx) |
-| 正文、目录、阅读位置与批注编辑 | [上下文阅读](../../sources/product-flows.md#上下文阅读)、[批注引用](../../sources/protocol.md#批注引用) | [Reading](../../../../packages/web/src/components/Reading.tsx)、[Context](../../../../packages/web/src/components/Context.tsx)、[原文位置映射](../../../../packages/web/src/reading.ts) |
-| Agent 默认读取、工具输出和分页 | [按需读取协议](../../sources/protocol.md#agent-按需读取视图) | [读取投影](../../../../internal/collab/agent_read.go)、[批注读取](../../../../internal/collab/agent_annotations.go) |
-| 资源选择、固定引用编号与菜单栏速览 | [资源库契约](../../sources/decisions/resource-library.md)、[资源库协议](../../sources/protocol.md#个人资源库) | [Library](../../../../packages/web/src/components/Library.tsx)、[Core](../../../../internal/collab/library.go)、[App](../../../../apps/macos/TeamCross.swift) |
-| 配对、明确发送和请求回执 | [配对契约](../../sources/decisions/agent-pairing.md)、[空间工作台](../../sources/decisions/space-workbench.md) | [配对 Core](../../../../internal/collab/agents.go)、[工作台](../../../../packages/web/src/components/SpaceWorkbench.tsx) |
-| ChatGPT 面板、带回对话与 mention | [本机插件契约](../../sources/decisions/chatgpt-local-plugin.md) | [UI MCP](../../../../internal/mcp/ui.go)、[mentions](../../../../internal/mcp/mentions.go)、[宿主桥](../../../../packages/web/src/plugin/bridge.ts) |
-| 个人 MCP 管理与当前 Session 分享 | [管理协议](../../sources/protocol.md#个人-mcp-管理入口)、[当前 Session](../../sources/protocol.md#当前-session-与延后分享) | [管理工具](../../../../internal/mcp/management.go)、[来源工具](../../../../internal/mcp/current.go) |
-| 首页快照、界面语言与主题 | [首页与创建](../../sources/product-flows.md#首页与创建入口)、[界面语言](../../sources/product-flows.md#界面语言)、[开发约束](../../sources/development.md#前端与本机界面) | [App.tsx](../../../../packages/web/src/App.tsx)、[i18n.ts](../../../../packages/web/src/i18n.ts)、[样式](../../../../packages/web/src/styles.css) |
-| 安装、邀请打开与个人客户端配置 | [分发与首次体验](../../sources/distribution-and-onboarding.md)、[Claude 辅助模式](../../sources/decisions/claude-native-tui.md#个人-claude-code-辅助模式) | [公共启动器](../../../../internal/service/service.go)、[客户端启动](../../../../internal/collab/launch.go) |
-
-## 阅读与发送的关系
-
-材料是已发布的固定范围，执行上下文是经授权读取的活历史；共用阅读组件不使两者具有相同的存储或版本语义。批注保留原文引用，资源选择把明确引用交给后续读取。读取和保存讨论都不会自动开始模型轮次；需要处理时，再明确选择目标、要求与发送动作。
-
-工具写入、直接客户端输入和工作台请求分别沿对应授权路径进入 Core。辅助客户端的 Provider 不决定目标运行时支持什么，也不使普通 MCP 自动获得 Channel 或原生接收连接。判断接收边界时，继续读取目标的领域契约。
-
-## 检查入口
-
-改动时从 [验证门槛](../../sources/validation/test-gates.md) 选择工程、浏览器和原生客户端检查；判断已有验收时从 [证据入口](../../sources/validation/evidence-map.md) 读取具体版本报告。浏览器宿主替身、原生工具加载和用户桌面操作分别报告。
-
-相关导航：[产品模型](product-model-and-glossary.md) · [协作空间](collaboration-spaces.md) · [运行时架构](runtime-architecture.md)
+WebGUI 与菜单栏面向人的管理和阅读，MCP 面向 Agent 的工具访问，ChatGPT 本机插件
+复用 WebGUI。它们通过 Core 使用相同的权限与原文引用，阅读投影可以不同。
+
+```mermaid
+flowchart LR
+    U["WebGUI / 菜单栏"] ---|管理与阅读| C["本机 Core"]
+    M["个人 / 绑定空间 MCP"] ---|工具访问| C
+    P["ChatGPT 本机插件"] ---|宿主桥访问| C
+    C ---|按授权提供| S["材料与协作上下文"]
+```
+
+已发布材料是固定版本，执行上下文是经授权读取的活历史。个人 MCP 按本机成员范围访问，
+绑定空间的工具限于对应空间；完整 Agent 对话与执行交互仍属于原生客户端。
+
+选择引用、保存讨论、向目标发送请求与目标实际处理是不同动作。界面可用、工具能读取、
+会话能接收分别依赖对应接入；辅助客户端的 Provider 与目标执行 Provider 也分别判断。
+
+- 查询页面、发布、阅读、批注与界面语言 → [产品流程](../../sources/product-flows.md)；工具字段与分页 → [协议](../../sources/protocol.md)。
+- 查询固定引用、选择清单与菜单栏速览 → [资源库契约](../../sources/decisions/resource-library.md)。
+- 查询插件面板、带回对话与 mention → [本机插件契约](../../sources/decisions/chatgpt-local-plugin.md)。
+- 查询接收目标、发送与回执 → [配对契约](../../sources/decisions/agent-pairing.md) / [空间工作台](../../sources/decisions/space-workbench.md)。
+- 判断宿主、工具调用与真实处理的已知范围 → [证据入口](../../sources/validation/evidence-map.md)。
diff --git a/docs/agent-wiki/wiki/index.md b/docs/agent-wiki/wiki/index.md
index a43c70f..2677855 100644
--- a/docs/agent-wiki/wiki/index.md
+++ b/docs/agent-wiki/wiki/index.md
@@ -1,45 +1,47 @@
 # Agent Wiki 索引
 
-这里是 Team Cross 当前 Codex 原生协作主线的任务导航。遵守根目录 [AGENTS.md](../../../AGENTS.md)，按修改范围直接进入来源或代码；需要跨主题上下文时选读概念页。不熟悉产品或启动方式时再读 [README](../../../README.md)。
+按问题直接进入来源或代码；需要理解对象关系时选读下方概念页。仓库约束见
+[AGENTS.md](../../../AGENTS.md)，产品概览与启动入口见 [README](../../../README.md)。
 
 面向用户的详细操作见 [使用指南](../../user-guide.md)，本地开发与构建入口见 [开发与构建](../sources/development.md)。
 
 ## 按任务阅读
 
-| 当前任务 | 优先阅读 | 主要实现 |
+| 当前任务 | 主要来源 | 实现入口 |
 | --- | --- | --- |
 | 搭建环境、本地开发或构建 | [开发与构建](../sources/development.md) | [Makefile](../../../Makefile)、[工具链要求](../../../package.json) |
-| 判断产品范围、命名或用户流程 | [产品模型与词汇](concepts/product-model-and-glossary.md) | [协作类型](../../../internal/collab/types.go)、[WebGUI](../../../packages/web/src/) |
-| 修改只读分享、三人以上与多会话材料 | [协作空间](concepts/collaboration-spaces.md) | [空间](../../../internal/collab/spaces.go)、[材料](../../../internal/collab/materials.go)、[MCP](../../../internal/mcp/materials.go) |
-| 调整模块、启动或数据路径 | [运行时架构](concepts/runtime-architecture.md) | [CLI](../../../cmd/teamcross/main.go)、[协作核心](../../../internal/collab/app.go) |
+| 判断定位、产品范围或命名 | [项目简报](../sources/project-brief.md)、[核心词汇](../sources/product-core-and-glossary.md) | [协作类型](../../../internal/collab/types.go) |
+| 修改只读分享、三人以上与多会话材料 | [空间契约](../sources/decisions/collaboration-spaces.md)、[材料协议](../sources/protocol.md#已发布会话材料) | [空间](../../../internal/collab/spaces.go)、[材料](../../../internal/collab/materials.go)、[MCP](../../../internal/mcp/materials.go) |
+| 调整模块、启动或数据路径 | [架构](../sources/architecture.md)、[协议](../sources/protocol.md) | [CLI](../../../cmd/teamcross/main.go)、[协作核心](../../../internal/collab/app.go) |
 | 修改原目录、worktree、fork 或恢复 | [目录与生命周期](../sources/decisions/workspace-and-lifecycle.md) | [workspace](../../../internal/workspace/)、[app.go](../../../internal/collab/app.go) |
 | 修改 TUI/Desktop、登录、模型或原生接入 | [原生客户端与模型](../sources/decisions/native-clients-and-models.md) | [nativecodex](../../../internal/nativecodex/)、[本机路由](../../../internal/collab/local_client.go) |
+| 修改受限/信任模式与原生配置继承 | [协作模式](../sources/decisions/runtime-modes.md) | [模式定义](../../../internal/runtimeconfig/mode.go)、[创建与恢复](../../../internal/collab/app.go) |
+| 修改实验性 Claude TUI 或辅助入口 | [Claude 接入契约](../sources/decisions/claude-native-tui.md) | [nativeclaude](../../../internal/nativeclaude/)、[协作适配](../../../internal/collab/claude.go) |
 | 修改邀请、输入交接、审批或断线处理 | [输入协调与共享](../sources/decisions/input-and-sharing.md) | [rpc.go](../../../internal/collab/rpc.go)、[network.go](../../../internal/collab/network.go) |
-| 修改页面、上下文、批注或辅助工具 | [WebGUI 与本地 MCP](concepts/webgui-and-mcp.md) | [WebGUI](../../../packages/web/src/)、[MCP](../../../internal/mcp/server.go) |
+| 修改用户流程、页面、阅读、批注或界面语言 | [产品流程](../sources/product-flows.md)、[前端与本机界面](../sources/development.md#前端与本机界面) | [WebGUI](../../../packages/web/src/)、[流程测试](../../../packages/web/src/test/flows.test.tsx) |
+| 修改 MCP 管理、当前 Session 分享或按需读取 | [协议](../sources/protocol.md)、[目录与生命周期](../sources/decisions/workspace-and-lifecycle.md) | [MCP](../../../internal/mcp/)、[延后分享](../../../internal/collab/current_share.go) |
 | 修改资源库、选择清单或菜单栏速览 | [资源库与速览](../sources/decisions/resource-library.md) | [资源库](../../../internal/collab/library.go)、[界面](../../../packages/web/src/components/Library.tsx)、[App](../../../apps/macos/TeamCross.swift) |
 | 修改会话配对与交给 Agent | [配对契约](../sources/decisions/agent-pairing.md) | [Core](../../../internal/collab/agents.go)、[MCP](../../../internal/mcp/agents.go)、[界面](../../../packages/web/src/components/AgentPairings.tsx) |
 | 修改 ChatGPT 本机 WebGUI 插件或宿主消息桥 | [本机插件](../sources/decisions/chatgpt-local-plugin.md) | [UI MCP](../../../internal/mcp/ui.go)、[包管理](../../../internal/pluginpack/plugin.go)、[共同入口](../../../packages/web/src/main.tsx)、[插件环境](../../../packages/web/src/plugin/environment.ts) |
 | 修改空间请求、简报或可选专用会话 | [空间工作台契约](../sources/decisions/space-workbench.md) | [空间业务](../../../internal/collab/workbench.go)、[接收会话](../../../internal/collab/space_receivers.go)、[工作台](../../../packages/web/src/components/SpaceWorkbench.tsx) |
 | 修改持续关注、Cloud 事件或订阅回执 | [空间事件契约](../sources/decisions/space-events.md) | [MCP Events](../../../internal/mcpevents/)、[Core](../../../internal/collab/space_events.go)、[隔离网关](../../../cmd/teamcross/events.go) |
-| 选择测试与通过标准 | [验证层次](concepts/validation-gates.md) | [自动化与真实验证方法](../sources/validation/test-gates.md) |
+| 选择测试与通过标准 | [验证门槛](../sources/validation/test-gates.md) | 页内按改动范围选择自动化、客户端与网络入口 |
 | 判断支持范围与实际验收结论 | [验证范围与证据入口](../sources/validation/evidence-map.md) | 先确定具体路径，再核对契约、实现和对应报告 |
 | 安装、App 外壳与首次体验 | [分发与首次体验](../sources/distribution-and-onboarding.md) | [公共启动器](../../../internal/service/service.go)、[App](../../../apps/macos/TeamCross.swift)、[构建](../../../scripts/build-release.py) |
 | 构建产物、发布或更新 Homebrew | [构建与发布](../sources/releasing.md) | [构建](../../../scripts/build-release.py)、[发布 workflow](../../../.github/workflows/release-unsigned.yml)、[Homebrew workflow](../../../.github/workflows/homebrew-publish.yml) |
 
-## 完整事实来源
+## 按需理解概念关系
 
-- [个人资源库与资源速览决策](../sources/decisions/resource-library.md)：本机索引、固定引用编号、个人/共享入口、设置保留和菜单栏取舍。
-- [只读分享与多人协作空间](../sources/decisions/collaboration-spaces.md)：用户确认的空间组织方式、设计基线、已实现范围与限制；具体测试证据见对应验收记录。
-- [项目简报](../sources/project-brief.md)：定位、支持范围与主要边界。
-- [核心模型与词汇](../sources/product-core-and-glossary.md)、[产品流程](../sources/product-flows.md)：产品语义与用户动作。
-- [架构](../sources/architecture.md)、[协议](../sources/protocol.md)：完整职责、数据流、字段与路由。
-- [协作模式决策](../sources/decisions/runtime-modes.md)：创建时固定的受限/信任模式、原生配置继承、两种 Provider 的生命周期和权限边界。
-- [目录与生命周期决策](../sources/decisions/workspace-and-lifecycle.md)、[原生客户端与模型决策](../sources/decisions/native-clients-and-models.md)、[输入与共享决策](../sources/decisions/input-and-sharing.md)：取舍及重新评估条件。
-- [Claude 原生 TUI 接入](../sources/decisions/claude-native-tui.md)：实验性 Provider、后台 job、原生审批、接力与明确能力边界。
-- [主线迁移记录](../../../IMPLEMENTATION.md)：旧现场归档与提交来源。
+| 理解的问题 | 概念页 |
+| --- | --- |
+| 个人会话、材料与共同执行如何关联 | [产品模型与词汇](concepts/product-model-and-glossary.md) |
+| 成员、公开范围、执行访问与输入权怎样区分 | [协作空间](concepts/collaboration-spaces.md) |
+| 空间、Core、原生运行时与成员主机如何分工 | [运行时架构](concepts/runtime-architecture.md) |
+| 人与 Agent 的入口怎样共用内容、分别接收请求 | [WebGUI 与 MCP](concepts/webgui-and-mcp.md) |
+| 方法、实测结果与当前能力判断怎样关联 | [验证与证据](concepts/validation-gates.md) |
 
 ## 维护
 
-本索引按问题导航；概念页解释跨主题关系，完整规范和领域契约在来源中维护。事实变化更新其主要来源，只有解释或导航变化时才更新概念页与本索引；维护方法见 [Agent Wiki 说明](../README.md)。任务文件按需创建，收尾后移入 `docs/agent-wiki/tasks/finished_archived/`，影响能力判断的证据入口维护在 [evidence-map](../sources/validation/evidence-map.md)，本索引不追加历史报告清单。旧原型与已结束任务的归档只用于定向追溯，当前产品范围由有效来源文档与用户已确认的决定确定。
-
-安装和首次体验：[分发与首次体验](../sources/distribution-and-onboarding.md)。
+文档职责、概念抽象与更新方式见 [Agent Wiki 说明](../README.md)。
+验收判断从 [证据入口](../sources/validation/evidence-map.md) 定向读取报告；旧原型迁移从
+[IMPLEMENTATION](../../../IMPLEMENTATION.md) 追溯。本索引维护当前入口，不累积历史报告清单。