| doc-id | 00-index | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| title | 索引与导航 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| status | active | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| version | 2.13.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| last-updated | 2026-09-09 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| source-range | 原文开篇说明；全量章节导航（非内容迁移）；既有核心/AI/Next 导航；组件数据链路目标规范与 Vite + React 18 Beta 实现状态；外部 Agent 交接与主动适配目标规范及本地验证状态；完整 UI 本地开发 P0/P1 实现与后续真实宿主验收规划；跨框架 Runtime 与 npm 发布一致性门禁；浮动工作台已实现基线与持续 Shell 动效目标方案；上下文问答完整目标规范与未实施状态 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参考文献/依赖 |
|
2026-09-05 新增 Astro 功能对齐规范与本轮验收及 Astro 包使用说明。当前代码已接入原生/React 岛屿定位、数据链路、Ask、外部 Agent 和 Astro 可信检查，公共包已发布；发布版本与本地 Runtime 的一致性由 跨框架 Runtime 与发布一致性方案约束。首轮 源码设计与验收记录保留为历史，不能替代本轮功能证据。
本文是 SpotPatch v1 核心、v1.1 可选 AI 扩展、v1.2 产品化工作台、Next.js 支持规划与上下文问答目标方案的规范性开发文档。它定义产品边界、支持矩阵、架构、源码组织、模块职责、公共 API、通信协议、安全要求、关键算法、测试方式和验收标准。实现与本文冲突时，应先更新设计决策，再修改代码，避免“代码先跑起来、规则后补”的失控状态。其中 上下文问答/ 当前仅是已完成的目标设计，不表示代码已实现。
本页只负责导航、追溯和规范治理，不重复定义任何业务常量、协议或数据模型。拆分后的活动规范共同构成完整的 v1/v1.1/v1.2 开发依据；AI 扩展默认关闭，不改变核心多目标 Prompt 工作台的独立可用性。Next适配/ 同时记录已分发的 0.x 公共预览和仍待完成的正式支持矩阵；包可安装不代表已经正式支持。
- 中文架构导读 / English architecture：按当前 11 个包核对的职责和直接依赖。
- 文档与素材事实核对：源码/npm 快照、成熟度与概念配图边界。
- 中文 README / English README：接入、功能、灵动岛和支持范围。
docs/技术方案/
├── 00-索引与导航.md
├── 01-产品定义与边界.md
├── 02-总体架构与技术栈.md
├── 03-公共API与数据模型.md
├── 04-Vite插件实现.md
├── 05-Runtime与生命周期.md
├── 06-源码解析与置信度.md
├── 07-DOM与CSS上下文采集.md
├── 08-源码片段与Prompt.md
├── 09-本地协议与安全.md
├── 10-UI与诊断.md
├── 11-编码规范.md
├── 12-测试与验收.md
├── 13-当前项目接入.md
├── 14-实施计划.md
├── 15-风险与架构决策.md
├── 16-AIAgent执行与变更审阅.md
├── 17-模型提供商与凭据配置.md
├── 18-组件数据链路检查器提案.md
├── 19-外部Agent连接与交接提案.md
├── 20-本地开发与完整产品验收环境.md
├── 21-浮动工作台与灵动岛交互方案.md
├── 22-持续Shell与灵动岛动效系统方案.md
├── 23-跨框架Runtime与发布一致性方案.md
├── 24-文档与素材事实核对.md
├── 上下文问答/
│ ├── 00-索引与决策摘要.md
│ ├── 01-需求与产品语义.md
│ ├── 02-实仓审计与能力矩阵.md
│ ├── 03-总体架构与包边界.md
│ ├── 04-领域模型与本地协议.md
│ ├── 05-Key只读执行器.md
│ ├── 06-ManagedCodex只读适配器.md
│ ├── 07-UI状态机与交互规范.md
│ ├── 08-安全隐私性能与可观测性.md
│ ├── 09-测试验收与实施计划.md
│ └── 10-后续会话与外部回流演进.md
├── 外部Agent连接/
│ ├── 00-索引与决策摘要.md
│ ├── 01-需求与产品语义.md
│ ├── 02-官方能力与兼容矩阵.md
│ ├── 03-总体架构与包边界.md
│ ├── 04-交接模型与本地协议.md
│ ├── 05-MCP与CLI设计.md
│ ├── 06-安全隐私与权限边界.md
│ ├── 07-交互性能与可观测性.md
│ ├── 08-测试验收与实施计划.md
│ ├── 09-主动派发与Agent适配器.md
│ └── 10-连接生命周期执行契约与产品收敛.md
├── 组件数据链路/
│ ├── 00-索引与交付边界.md
│ ├── 01-需求与产品语义.md
│ ├── 02-实仓审计与支持矩阵.md
│ ├── 03-总体架构与包组织.md
│ ├── 04-静态分析与精确归属.md
│ ├── 05-运行时观测与生命周期.md
│ ├── 06-参数响应与数据来源.md
│ ├── 07-领域模型本地协议与配置.md
│ ├── 08-数据接口页面与交互规范.md
│ ├── 09-AI辅助与准确上下文契约.md
│ ├── 10-安全隐私与性能预算.md
│ ├── 11-测试验收与发布门禁.md
│ ├── 12-实施计划复核与ADR.md
│ ├── 13-Beta实现状态与使用手册.md
│ └── 14-特殊调用形态与适配器方案.md
├── Next适配/
│ ├── 00-索引与架构摘要.md
│ ├── 01-官方调研与兼容矩阵.md
│ ├── 02-包边界与总体架构.md
│ ├── 03-接入API与生命周期.md
│ ├── 04-构建转换与源码定位.md
│ ├── 05-Sidecar与协议承载.md
│ ├── 06-RSC与客户端Runtime.md
│ ├── 07-安全与生产隔离.md
│ └── 08-测试验收与实施计划.md
├── SpotPatch开发规格书.md
└── archive/
└── SpotPatch开发规格书-v1.0.0.md
| 文档 | doc-id | 单一职责 |
|---|---|---|
| 00-索引与导航.md | 00-index |
文档地图、原章节映射、依赖关系和术语入口 |
| 01-产品定义与边界.md | (见 doc-id:01-product-boundary) | 产品定位、v1 核心、可选 AI、产品化工作台、源码导航和支持矩阵 |
| 02-总体架构与技术栈.md | (见 doc-id:02-architecture-stack) | 总体分层、依赖方向、技术选型、Monorepo 结构和发布策略 |
| 03-公共API与数据模型.md | (见 doc-id:03-public-api-models) | 公共配置、默认值、语言/说明上限、接入 API、Agent limits/状态和跨模块不可变数据模型 |
| 04-Vite插件实现.md | (见 doc-id:04-vite-plugin) | Vite 插件拆分、过滤、source marker/registry、AST 注入、source map 和转换错误策略 |
| 05-Runtime与生命周期.md | (见 doc-id:05-runtime-lifecycle) | Runtime 注入、单例/HMR、状态机、多目标选择、命中和几何 |
| 06-源码解析与置信度.md | (见 doc-id:06-source-resolution) | 源码解析优先级、置信度语义、React Adapter、业务组件识别和降级 |
| 07-DOM与CSS上下文采集.md | (见 doc-id:07-dom-css-collection) | DOM/CSS 采集范围、属性、样式规则、computed style 和浏览器限制 |
| 08-源码片段与Prompt.md | (见 doc-id:08-code-prompt) | 源码片段边界、逐目标双语 Prompt、固定段落和公平预算裁剪 |
| 09-本地协议与安全.md | (见 doc-id:09-local-protocol-security) | 本地 HTTP/Job 协议、错误码、文件/会话安全、清洗与安全验收 |
| 10-UI与诊断.md | (见 doc-id:10-ui-diagnostics) | 品牌视觉、双语 Shadow DOM UI、逐目标/Agent 工作台、源码快捷入口、开源入口、无障碍与诊断 |
| 11-编码规范.md | (见 doc-id:11-coding-standards) | 目录约束、严格 TypeScript、函数副作用、去冗余和注释规则 |
| 12-测试与验收.md | (见 doc-id:12-testing-acceptance) | 单测/E2E、兼容 CI、性能预算、功能/性能验收和 PR 门禁 |
| 13-当前项目接入.md | (见 doc-id:13-project-integration) | spotpatch-web 的实际约束、插件顺序和专项验证 |
| 14-实施计划.md | (见 doc-id:14-implementation-plan) | Milestone 0–12、工期、任务和完成标准 |
| 15-风险与架构决策.md | (见 doc-id:15-risks-adr) | 风险登记、ADR、一手依据和最终工程判断 |
| 16-AIAgent执行与变更审阅.md | (见 doc-id:16-ai-agent-execution) | Agent 工具循环、本地工具、Git worktree、检查、Diff、Apply 和 Revert |
| 17-模型提供商与凭据配置.md | (见 doc-id:17-model-provider-credentials) | Provider URL、凭据、模型、协议、能力探测和远程数据边界 |
| 18-组件数据链路检查器提案.md | (见 doc-id:18-component-data-flow-inspector) | 方案与状态入口、实仓摘要、百分比口径和专题导航 |
| 19-外部Agent连接与交接提案.md | (见 doc-id:19-external-agent-handoff) | Claude Code、Cursor、Codex 与通用 Agent 的方案入口；公共实现处于本地验证阶段，尚未形成客户端支持声明 |
| 20-本地开发与完整产品验收环境.md | (见 doc-id:20-local-development-acceptance) | 已实现唯一完整 playground 与 Runtime 增量构建；确定性假宿主和真实 Agent 兼容 Gate 待完成 |
| 21-浮动工作台与灵动岛交互方案.md | (见 doc-id:21-floating-workbench-island) | 默认右下角、自由拖拽、边缘吸附、会话位置恢复、基础入口反馈、旧定位清理和专项验收；Runtime 已实现，真实浏览器视觉验收待完成 |
| 22-持续Shell与灵动岛动效系统方案.md | (见 doc-id:22-persistent-shell-motion-system) | 单一持续 Shell、独立 GSAP Motion bundle、真实状态投影、Agent 派发反馈与执行岛；代码和自动化 Gate 已完成，真实 Chromium Gate 待完成 |
| 23-跨框架Runtime与发布一致性方案.md | (见 doc-id:23-framework-runtime-release-parity) | Vite/Astro/Next 共享 Runtime 的源码所有权、Changeset 扇出、packed npm 消费验证与发布事实边界 |
| 上下文问答/00-索引与决策摘要.md | (见 doc-id:context-qa-00-index) | 专题状态、首阶段边界、核心决策、文档地图和规范所有权 |
| 上下文问答/01-需求与产品语义.md | (见 doc-id:context-qa-01-requirements) | 至少一目标、单次问答、显式 Ask/Change、引用与转修改草稿 |
| 上下文问答/02-实仓审计与能力矩阵.md | (见 doc-id:context-qa-02-audit-compatibility) | change-only 根因、可复用资产、官方能力证据和执行器矩阵 |
| 上下文问答/03-总体架构与包边界.md | (见 doc-id:context-qa-03-architecture) | Runtime/dev-server/agent/bridge 分层、端口、只读 snapshot 和依赖方向 |
| 上下文问答/04-领域模型与本地协议.md | (见 doc-id:context-qa-04-model-protocol) | Selection/Task/Answer/Source/Job Schema、endpoint、限制和错误码 |
| 上下文问答/05-Key只读执行器.md | (见 doc-id:context-qa-05-key-executor) | Configured Key 的只读工具循环、Prompt、引用账本与 submit-answer |
| 上下文问答/06-ManagedCodex只读适配器.md | (见 doc-id:context-qa-06-managed-codex) | App Server read-only profile、源码投影、answer item、thread 与 cleanup Gate |
| 上下文问答/07-UI状态机与交互规范.md | (见 doc-id:context-qa-07-ui-state) | 单一 Planner/Shell、双草稿、答案卡/引用、状态、动效与无障碍 |
| 上下文问答/08-安全隐私性能与可观测性.md | (见 doc-id:context-qa-08-security-performance) | 只读证明、读取授权、数据保留、性能策略、日志和失败降级 |
| 上下文问答/09-测试验收与实施计划.md | (见 doc-id:context-qa-09-testing-delivery) | Q0–Q7、Key/Codex POC、跨框架/平台矩阵、迁移和发布定义 |
| 上下文问答/10-后续会话与外部回流演进.md | (见 doc-id:context-qa-10-evolution) | 连续追问、Claude/Cursor 回传、跨页面会话的独立演进 Gate |
| 外部Agent连接/00-索引与决策摘要.md | (见 doc-id:external-agent-00-index) | 专题状态、问题拆分、决策摘要、术语和规范优先级 |
| 外部Agent连接/01-需求与产品语义.md | (见 doc-id:external-agent-01-requirements) | 用户流程、功能/非功能需求、可验证状态和范围外 |
| 外部Agent连接/02-官方能力与兼容矩阵.md | (见 doc-id:external-agent-02-research-compatibility) | MCP、Claude Code、Cursor、Codex 一手能力与兼容目标 |
| 外部Agent连接/03-总体架构与包边界.md | (见 doc-id:external-agent-03-architecture-packages) | 浏览器/Node/Connector 分层、包职责、Broker 和 Vite/Next 复用 |
| 外部Agent连接/04-交接模型与本地协议.md | (见 doc-id:external-agent-04-handoff-protocol) | Handoff 状态、授权快照、Browser API、Broker 和发现描述符 |
| 外部Agent连接/05-MCP与CLI设计.md | (见 doc-id:external-agent-05-mcp-cli) | MCP tools/resources/prompts、CLI JSON、设置和厂商增强边界 |
| 外部Agent连接/06-安全隐私与权限边界.md | (见 doc-id:external-agent-06-security) | 双认证域、威胁模型、数据生命周期和外部执行边界 |
| 外部Agent连接/07-交互性能与可观测性.md | (见 doc-id:external-agent-07-ux-performance-observability) | 发送/等待/回执 UI、集中预算、诊断和零遥测 |
| 外部Agent连接/08-测试验收与实施计划.md | (见 doc-id:external-agent-08-testing-delivery) | 编码前 POC、真实客户端矩阵、Gate、阶段和回滚 |
| 外部Agent连接/09-主动派发与Agent适配器.md | (见 doc-id:external-agent-09-active-dispatch-adapters) | 单活 Event Pump、Claude Channel、Codex App Server、生命周期与扩展 Gate |
| 外部Agent连接/10-连接生命周期执行契约与产品收敛.md | (见 doc-id:external-agent-10-convergence) | managed Supervisor、独立快照、显式验证、安全回写、状态轴和固定降级契约 |
| 组件数据链路/00-索引与交付边界.md | (见 doc-id:data-flow-00-index) | 专题治理、目标规范/当前事实分工、术语与交付边界 |
| 组件数据链路/01-需求与产品语义.md | (见 doc-id:data-flow-01-requirements) | 用户目标、用例、功能/非功能要求、首发范围与无结果语义 |
| 组件数据链路/02-实仓审计与支持矩阵.md | (见 doc-id:data-flow-02-repository-audit) | 匿名调研方法、通用项目形态与仓内可移植 oracle |
| 组件数据链路/03-总体架构与包组织.md | (见 doc-id:data-flow-03-architecture-packages) | Node/浏览器分层、包职责、依赖方向、Adapter、复用和去冗余 |
| 组件数据链路/04-静态分析与精确归属.md | (见 doc-id:data-flow-04-static-attribution) | 稳定 ID、模块/符号/事件图、invocation provenance 与零误归属规则 |
| 组件数据链路/05-运行时观测与生命周期.md | (见 doc-id:data-flow-05-runtime-observation) | 最早期 prelude、fetch/XHR、result tap、epoch、观测模式和清理 |
| 组件数据链路/06-参数响应与数据来源.md | (见 doc-id:data-flow-06-data-provenance) | 参数来源、响应三层语义、request-origin、data-fed-by 与数据位置 |
| 组件数据链路/07-领域模型本地协议与配置.md | (见 doc-id:data-flow-07-model-protocol-config) | 当前 Beta DTO/Schema、endpoint、capability、配置所有权和版本策略 |
| 组件数据链路/08-数据接口页面与交互规范.md | (见 doc-id:data-flow-08-ui-interaction) | 数据链路/页面接口/详情、状态矩阵、双语、响应式与无障碍 |
| 组件数据链路/09-AI辅助与准确上下文契约.md | (见 doc-id:data-flow-09-ai-assistance) | AI Explain/Assist Find、上下文预览、证据引用和只读工具边界 |
| 组件数据链路/10-安全隐私与性能预算.md | (见 doc-id:data-flow-10-security-performance) | 增量威胁模型、源头清洗、生命周期、集中预算和生产零残留 |
| 组件数据链路/11-测试验收与发布门禁.md | (见 doc-id:data-flow-11-testing-acceptance) | 百分比公式、oracle、测试矩阵、实仓指标和 Gate D0–D7 |
| 组件数据链路/12-实施计划复核与ADR.md | (见 doc-id:data-flow-12-delivery-adr) | POC/Beta 复核、剩余阶段、代码纪律、风险与 ADR |
| 组件数据链路/13-Beta实现状态与使用手册.md | (见 doc-id:data-flow-13-beta-implementation) | 当前代码、启用方式、UI、支持矩阵、可移植 oracle、验证结果与未实现项 |
| 组件数据链路/14-特殊调用形态与适配器方案.md | (见 doc-id:data-flow-14-special-adapters) | 组件 render 请求、React Query、tRPC 和其他调用形态的当前能力与后续 Gate |
| Next适配/00-索引与架构摘要.md | (见 doc-id:next-00-index) | Next.js 公共预览状态、文档地图、仓库决策和正式支持入口 |
| Next适配/01-官方调研与兼容矩阵.md | (见 doc-id:next-01-research-compatibility) | Next.js 一手事实、计划支持范围、不支持项和阻断未知项 |
| Next适配/02-包边界与总体架构.md | (见 doc-id:next-02-package-architecture) | @spotpatch/next、公共 compiler/dev-server 与平级适配器边界 |
| Next适配/03-接入API与生命周期.md | (见 doc-id:next-03-integration-lifecycle) | 配置包装器、初始化、开发 CLI、Next phase 和配置组合规则 |
| Next适配/04-构建转换与源码定位.md | (见 doc-id:next-04-transform-source) | Turbopack/webpack Loader、注册、RSC marker 与 source map 承载 |
| Next适配/05-Sidecar与协议承载.md | (见 doc-id:next-05-sidecar-protocol) | Sidecar 进程、信任通道、bootstrap、rewrite 和退出恢复 |
| Next适配/06-RSC与客户端Runtime.md | (见 doc-id:next-06-rsc-runtime) | hydration 前初始化、RSC/Fiber 边界、Router 与客户端降级 |
| Next适配/07-安全与生产隔离.md | (见 doc-id:next-07-security-production) | Next.js 增量威胁模型、开发期暴露、cache 与生产零残留 |
| Next适配/08-测试验收与实施计划.md | (见 doc-id:next-08-testing-delivery) | 阻断式 POC、测试矩阵、Milestone 15–20 与正式支持门禁 |
| SpotPatch开发规格书.md | legacy-spec-redirect |
旧路径迁移说明；不再承载规范事实 |
| archive/SpotPatch开发规格书-v1.0.0.md | 无活动 doc-id | 拆分前原文归档；只用于审计，不作为实现依据 |
目录结构在原 16 份核心活动文档上增加组件数据链路、Next.js、外部 Agent、上下文问答、本地完整产品验收、浮动工作台和持续 Shell 动效专题，并继续保留 archive/。组件数据链路的目标设计与当前 Beta 事实通过 00/13/14 分工；外部 Agent 的 Inbox、主动派发和 managed 实现状态只在 (见 doc-id:external-agent-00-index) 维护；上下文问答的设计/实现状态只在 (见 doc-id:context-qa-00-index) 维护，当前是设计完成、代码未实现。其他专题页只定义契约并引用证据，避免重复状态漂移；任何 local-validation 或 design-complete 都不得与 beta/released 支持声明混淆。本地验收环境的规划与当前实现由 (见 doc-id:20-local-development-acceptance) 明确分开；已实现的浮动位置、拖拽与基础反馈由 (见 doc-id:21-floating-workbench-island) 维护，已实现的持续 Shell、Agent 动效和剩余 Chromium Gate 由 (见 doc-id:22-persistent-shell-motion-system) 维护。archive/ 继续隔离原始快照，使旧文可审计，同时避免其与活动规范并列成为事实来源。
| 原文范围 | 新文档 | 迁移说明 |
|---|---|---|
| 开篇说明 | 本文档 | 规范定位和变更纪律 |
| §1、§1.1–§1.3 | (见 doc-id:01-product-boundary) | 完整迁移 |
| §2.1–§2.2 | (见 doc-id:02-architecture-stack) | 定位/语义分离，AST/Fiber 分工 |
| §2.3 | (见 doc-id:09-local-protocol-security) | 浏览器数据边界统一归入安全规范 |
| §2.4 第 1 条 | (见 doc-id:04-vite-plugin) | AST fail-open |
| §2.4 第 2 条 | (见 doc-id:06-source-resolution) | React Adapter 降级 |
| §2.4 第 3 条 | (见 doc-id:10-ui-diagnostics) | Shadow DOM 隔离 |
| §2.4 第 4–5 条 | (见 doc-id:05-runtime-lifecycle) | 资源释放和 HMR 单例 |
| §2.5 | (见 doc-id:08-code-prompt) | 最相关上下文和预算原则 |
| §3、§3.1 | (见 doc-id:02-architecture-stack) | 总体架构和依赖方向 |
| §4、§4.1–§4.3 | (见 doc-id:02-architecture-stack) | 技术栈、质量工具和不引入依赖 |
| §5、§5.2 | (见 doc-id:02-architecture-stack) | Monorepo 树和发布策略 |
| §5.1 | (见 doc-id:11-coding-standards) | 目录与模块编码约束 |
| §6、§6.1、§7 | (见 doc-id:03-public-api-models) | 完整迁移 |
| §8、§8.1–§8.6 | (见 doc-id:04-vite-plugin) | 完整迁移 |
| §9、§9.1–§9.3（§9.1 末段除外） | (见 doc-id:05-runtime-lifecycle) | Runtime 注入、单例/HMR 和状态机 |
| §9.1 末段 | (见 doc-id:09-local-protocol-security) | 禁止向浏览器注入的敏感信息 |
| 原文无有效一级标题的“元素选择器”、§10.1–§10.3 | (见 doc-id:05-runtime-lifecycle) | 按内容恢复为元素选择器主题；不新增业务规则 |
| §11、§11.1–§11.5 | (见 doc-id:06-source-resolution) | 完整迁移 |
| §12.1–§12.2 | (见 doc-id:07-dom-css-collection) | DOM 采集范围与保留属性 |
| §12.3–§12.4 | (见 doc-id:09-local-protocol-security) | 脱敏和展示安全统一归入安全规范 |
| §13、§13.1–§13.4 | (见 doc-id:07-dom-css-collection) | 完整迁移 |
| §14、§14.1–§14.4、§15、§15.1–§15.3 | (见 doc-id:09-local-protocol-security) | 协议、错误码、文件和会话安全 |
| §16、§16.1–§16.2、§17、§17.1–§17.2 | (见 doc-id:08-code-prompt) | 完整迁移 |
| §18、§18.1–§18.3、§22 | (见 doc-id:10-ui-diagnostics) | UI、无障碍、日志和诊断聚合 |
| §19、§19.1–§19.4 | (见 doc-id:11-coding-standards) | 完整迁移 |
| §20、§20.1–§20.6、§21、§21.1–§21.3 | (见 doc-id:12-testing-acceptance) | 测试、兼容 CI 和性能预算 |
| §23 | (见 doc-id:13-project-integration) | 完整迁移 |
| §24、Milestone 0–5 | (见 doc-id:14-implementation-plan) | 完整迁移 |
| §25.1、§25.3、§26 | (见 doc-id:12-testing-acceptance) | 功能/性能验收和 PR 门禁 |
| §25.2 | (见 doc-id:09-local-protocol-security) | 安全验收与安全规则共址 |
| §27–§30 | (见 doc-id:15-risks-adr) | 风险、ADR、依据和最终判断 |
| v1.1 新增：Agent 工具、本地执行、Git、审阅与撤销 | (见 doc-id:16-ai-agent-execution) | 新能力规范；不声称迁移自 v1 原文 |
| v1.1 新增：Provider、URL、Key、模型与协议兼容 | (见 doc-id:17-model-provider-credentials) | 新能力规范；不声称迁移自 v1 原文 |
| Next.js 新增：调研、包边界、接入、构建、Sidecar、RSC、安全和验收 | (见 doc-id:next-00-index) | 公共预览与正式支持规划；不声称迁移自 v1 原文，也不表示已经正式支持 |
| 组件数据链路新增：接口、参数、响应、来源、存储、页面总览与 AI 辅助 | (见 doc-id:data-flow-00-index) | 不声称迁移自 v1 原文；当前 Beta 与未实现差异见 (见 doc-id:data-flow-13-beta-implementation) |
| 外部 Agent 连接新增：显式交接、MCP/CLI、Broker、兼容、安全、交互和发布 Gate | (见 doc-id:external-agent-00-index) | 不声称迁移自 v1 原文；当前公共实现与未完成发布 Gate 见专题状态入口 |
| 浮动工作台新增：默认右下角、用户拖拽、位置恢复和基础入口反馈 | (见 doc-id:21-floating-workbench-island) | 新交互能力；不声称迁移自 v1 原文；Runtime 已实现，浏览器视觉验收待完成 |
| 持续 Shell 动效新增：真实状态投影、派发反馈、执行岛和结果反馈 | (见 doc-id:22-persistent-shell-motion-system) | 新交互能力；独立 GSAP Motion bundle、执行岛和连续 Morph 已实现；真实 Chromium Gate 待完成 |
| 上下文问答新增：选中元素后的只读单次问答、Key/Managed Codex、源码引用与转修改草稿 | (见 doc-id:context-qa-00-index) | 新目标能力；不声称迁移自 v1 原文；设计完整但代码未实现，追问/Claude/Cursor/跨页会话后置 |
箭头表示“左侧文档依赖右侧文档中的规范事实”。
| 文档 | 直接依赖 |
|---|---|
| (见 doc-id:01-product-boundary) | (见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:next-00-index)、(见 doc-id:next-01-research-compatibility)、(见 doc-id:context-qa-00-index) |
| (见 doc-id:02-architecture-stack) | (见 doc-id:01-product-boundary)、(见 doc-id:03-public-api-models)、(见 doc-id:04-vite-plugin)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:06-source-resolution)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:11-coding-standards)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:next-02-package-architecture) |
| (见 doc-id:03-public-api-models) | (见 doc-id:04-vite-plugin)、(见 doc-id:08-code-prompt)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:04-vite-plugin) | (见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security)、(见 doc-id:11-coding-standards)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:next-02-package-architecture)、(见 doc-id:next-04-transform-source) |
| (见 doc-id:05-runtime-lifecycle) | (见 doc-id:03-public-api-models)、(见 doc-id:04-vite-plugin)、(见 doc-id:06-source-resolution)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:12-testing-acceptance)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:06-source-resolution) | (见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:04-vite-plugin)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr) |
| (见 doc-id:07-dom-css-collection) | (见 doc-id:03-public-api-models)、(见 doc-id:08-code-prompt)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:12-testing-acceptance) |
| (见 doc-id:08-code-prompt) | (见 doc-id:03-public-api-models)、(见 doc-id:06-source-resolution)、(见 doc-id:07-dom-css-collection)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:09-local-protocol-security) | (见 doc-id:03-public-api-models)、(见 doc-id:04-vite-plugin)、(见 doc-id:07-dom-css-collection)、(见 doc-id:08-code-prompt)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:10-ui-diagnostics) | (见 doc-id:03-public-api-models)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:06-source-resolution)、(见 doc-id:07-dom-css-collection)、(见 doc-id:08-code-prompt)、(见 doc-id:09-local-protocol-security)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:21-floating-workbench-island)、(见 doc-id:22-persistent-shell-motion-system) |
| (见 doc-id:11-coding-standards) | (见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:12-testing-acceptance)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:12-testing-acceptance) | (见 doc-id:01-product-boundary)、(见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:04-vite-plugin)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:06-source-resolution)、(见 doc-id:07-dom-css-collection)、(见 doc-id:08-code-prompt)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:11-coding-standards)、(见 doc-id:13-project-integration)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:21-floating-workbench-island)、(见 doc-id:22-persistent-shell-motion-system)、(见 doc-id:next-08-testing-delivery) |
| (见 doc-id:13-project-integration) | (见 doc-id:01-product-boundary)、(见 doc-id:03-public-api-models)、(见 doc-id:04-vite-plugin)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:06-source-resolution)、(见 doc-id:07-dom-css-collection)、(见 doc-id:09-local-protocol-security)、(见 doc-id:12-testing-acceptance)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:14-implementation-plan) | (见 doc-id:01-product-boundary)、(见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:04-vite-plugin)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:06-source-resolution)、(见 doc-id:07-dom-css-collection)、(见 doc-id:08-code-prompt)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:11-coding-standards)、(见 doc-id:12-testing-acceptance)、(见 doc-id:13-project-integration)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:next-08-testing-delivery) |
| (见 doc-id:15-risks-adr) | (见 doc-id:01-product-boundary)、(见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:04-vite-plugin)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:06-source-resolution)、(见 doc-id:07-dom-css-collection)、(见 doc-id:08-code-prompt)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:12-testing-acceptance)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:next-00-index)、(见 doc-id:next-02-package-architecture)、(见 doc-id:next-03-integration-lifecycle)、(见 doc-id:next-04-transform-source)、(见 doc-id:next-05-sidecar-protocol)、(见 doc-id:next-06-rsc-runtime)、(见 doc-id:next-07-security-production)、(见 doc-id:next-08-testing-delivery)、(见 doc-id:external-agent-00-index)、(见 doc-id:external-agent-02-research-compatibility)、(见 doc-id:external-agent-03-architecture-packages)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-08-testing-delivery)、(见 doc-id:external-agent-09-active-dispatch-adapters) |
| (见 doc-id:16-ai-agent-execution) | (见 doc-id:01-product-boundary)、(见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:08-code-prompt)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:11-coding-standards)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:17-model-provider-credentials) | (见 doc-id:01-product-boundary)、(见 doc-id:03-public-api-models)、(见 doc-id:08-code-prompt)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution) |
| (见 doc-id:18-component-data-flow-inspector) | (见 doc-id:01-product-boundary)、(见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security)、(见 doc-id:11-coding-standards)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr)、(见 doc-id:data-flow-00-index)、(见 doc-id:data-flow-01-requirements)、(见 doc-id:data-flow-02-repository-audit)、(见 doc-id:data-flow-03-architecture-packages)、(见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-06-data-provenance)、(见 doc-id:data-flow-07-model-protocol-config)、(见 doc-id:data-flow-08-ui-interaction)、(见 doc-id:data-flow-09-ai-assistance)、(见 doc-id:data-flow-10-security-performance)、(见 doc-id:data-flow-11-testing-acceptance)、(见 doc-id:data-flow-12-delivery-adr)、(见 doc-id:data-flow-13-beta-implementation) |
| (见 doc-id:19-external-agent-handoff) | (见 doc-id:external-agent-00-index)、(见 doc-id:external-agent-01-requirements)、(见 doc-id:external-agent-02-research-compatibility)、(见 doc-id:external-agent-03-architecture-packages)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-07-ux-performance-observability)、(见 doc-id:external-agent-08-testing-delivery)、(见 doc-id:external-agent-09-active-dispatch-adapters)、(见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution) |
| (见 doc-id:20-local-development-acceptance) | (见 doc-id:00-index)、(见 doc-id:04-vite-plugin)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:11-coding-standards)、(见 doc-id:12-testing-acceptance)、(见 doc-id:14-implementation-plan)、(见 doc-id:external-agent-00-index)、(见 doc-id:external-agent-02-research-compatibility)、(见 doc-id:external-agent-08-testing-delivery)、(见 doc-id:external-agent-10-convergence) |
| (见 doc-id:21-floating-workbench-island) | (见 doc-id:05-runtime-lifecycle)、(见 doc-id:09-local-protocol-security)、(见 doc-id:11-coding-standards)、(见 doc-id:12-testing-acceptance)、(见 doc-id:20-local-development-acceptance) |
| (见 doc-id:22-persistent-shell-motion-system) | (见 doc-id:05-runtime-lifecycle)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:11-coding-standards)、(见 doc-id:12-testing-acceptance)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:19-external-agent-handoff)、(见 doc-id:21-floating-workbench-island)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-07-ux-performance-observability) |
| (见 doc-id:context-qa-00-index) | (见 doc-id:01-product-boundary)、(见 doc-id:03-public-api-models)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:09-local-protocol-security)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:15-risks-adr)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:external-agent-00-index)、(见 doc-id:data-flow-09-ai-assistance)、(见 doc-id:22-persistent-shell-motion-system) |
| (见 doc-id:context-qa-01-requirements) | (见 doc-id:context-qa-00-index)、(见 doc-id:context-qa-04-model-protocol)、(见 doc-id:context-qa-07-ui-state)、(见 doc-id:01-product-boundary) |
| (见 doc-id:context-qa-02-audit-compatibility) | (见 doc-id:context-qa-00-index)、(见 doc-id:context-qa-03-architecture)、(见 doc-id:external-agent-02-research-compatibility)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:context-qa-03-architecture) | (见 doc-id:context-qa-00-index)、(见 doc-id:context-qa-02-audit-compatibility)、(见 doc-id:context-qa-04-model-protocol)、(见 doc-id:02-architecture-stack)、(见 doc-id:11-coding-standards) |
| (见 doc-id:context-qa-04-model-protocol) | (见 doc-id:context-qa-01-requirements)、(见 doc-id:context-qa-03-architecture)、(见 doc-id:09-local-protocol-security)、(见 doc-id:03-public-api-models) |
| (见 doc-id:context-qa-05-key-executor) | (见 doc-id:context-qa-03-architecture)、(见 doc-id:context-qa-04-model-protocol)、(见 doc-id:context-qa-08-security-performance)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:context-qa-06-managed-codex) | (见 doc-id:context-qa-02-audit-compatibility)、(见 doc-id:context-qa-03-architecture)、(见 doc-id:context-qa-04-model-protocol)、(见 doc-id:context-qa-08-security-performance)、(见 doc-id:external-agent-10-convergence) |
| (见 doc-id:context-qa-07-ui-state) | (见 doc-id:context-qa-01-requirements)、(见 doc-id:context-qa-04-model-protocol)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:21-floating-workbench-island)、(见 doc-id:22-persistent-shell-motion-system) |
| (见 doc-id:context-qa-08-security-performance) | (见 doc-id:context-qa-04-model-protocol)、(见 doc-id:context-qa-05-key-executor)、(见 doc-id:context-qa-06-managed-codex)、(见 doc-id:09-local-protocol-security)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:context-qa-09-testing-delivery) | (见 doc-id:context-qa-00-index)、(见 doc-id:context-qa-04-model-protocol)、(见 doc-id:context-qa-05-key-executor)、(见 doc-id:context-qa-06-managed-codex)、(见 doc-id:context-qa-07-ui-state)、(见 doc-id:context-qa-08-security-performance)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr) |
| (见 doc-id:context-qa-10-evolution) | (见 doc-id:context-qa-00-index)、(见 doc-id:context-qa-04-model-protocol)、(见 doc-id:context-qa-06-managed-codex)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-09-active-dispatch-adapters) |
| (见 doc-id:external-agent-00-index) | (见 doc-id:19-external-agent-handoff)、(见 doc-id:external-agent-01-requirements)、(见 doc-id:external-agent-02-research-compatibility)、(见 doc-id:external-agent-03-architecture-packages)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-07-ux-performance-observability)、(见 doc-id:external-agent-08-testing-delivery)、(见 doc-id:external-agent-09-active-dispatch-adapters)、(见 doc-id:15-risks-adr) |
| (见 doc-id:external-agent-01-requirements) | (见 doc-id:external-agent-00-index)、(见 doc-id:external-agent-02-research-compatibility)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-07-ux-performance-observability)、(见 doc-id:03-public-api-models)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:10-ui-diagnostics) |
| (见 doc-id:external-agent-02-research-compatibility) | (见 doc-id:external-agent-00-index)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-08-testing-delivery) |
| (见 doc-id:external-agent-03-architecture-packages) | (见 doc-id:external-agent-00-index)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-06-security)、(见 doc-id:02-architecture-stack)、(见 doc-id:04-vite-plugin)、(见 doc-id:09-local-protocol-security)、(见 doc-id:11-coding-standards)、(见 doc-id:next-02-package-architecture)、(见 doc-id:next-05-sidecar-protocol) |
| (见 doc-id:external-agent-04-handoff-protocol) | (见 doc-id:external-agent-01-requirements)、(见 doc-id:external-agent-03-architecture-packages)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-07-ux-performance-observability)、(见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security) |
| (见 doc-id:external-agent-05-mcp-cli) | (见 doc-id:external-agent-02-research-compatibility)、(见 doc-id:external-agent-03-architecture-packages)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-08-testing-delivery) |
| (见 doc-id:external-agent-06-security) | (见 doc-id:external-agent-01-requirements)、(见 doc-id:external-agent-03-architecture-packages)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-08-testing-delivery)、(见 doc-id:09-local-protocol-security)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:external-agent-07-ux-performance-observability) | (见 doc-id:external-agent-01-requirements)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-08-testing-delivery)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:12-testing-acceptance) |
| (见 doc-id:external-agent-08-testing-delivery) | (见 doc-id:external-agent-00-index)、(见 doc-id:external-agent-02-research-compatibility)、(见 doc-id:external-agent-03-architecture-packages)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-07-ux-performance-observability)、(见 doc-id:11-coding-standards)、(见 doc-id:12-testing-acceptance)、(见 doc-id:14-implementation-plan)、(见 doc-id:15-risks-adr) |
| (见 doc-id:external-agent-09-active-dispatch-adapters) | (见 doc-id:external-agent-00-index)、(见 doc-id:external-agent-02-research-compatibility)、(见 doc-id:external-agent-03-architecture-packages)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-05-mcp-cli)、(见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-07-ux-performance-observability)、(见 doc-id:external-agent-08-testing-delivery)、(见 doc-id:15-risks-adr) |
| (见 doc-id:data-flow-00-index) | (见 doc-id:18-component-data-flow-inspector)、(见 doc-id:01-product-boundary)、(见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security)、(见 doc-id:11-coding-standards)、(见 doc-id:12-testing-acceptance)、(见 doc-id:15-risks-adr) |
| (见 doc-id:data-flow-01-requirements) | (见 doc-id:data-flow-00-index)、(见 doc-id:data-flow-02-repository-audit)、(见 doc-id:data-flow-08-ui-interaction)、(见 doc-id:data-flow-10-security-performance)、(见 doc-id:data-flow-11-testing-acceptance)、(见 doc-id:01-product-boundary) |
| (见 doc-id:data-flow-02-repository-audit) | (见 doc-id:data-flow-01-requirements)、(见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-06-data-provenance)、(见 doc-id:04-vite-plugin)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:06-source-resolution) |
| (见 doc-id:data-flow-03-architecture-packages) | (见 doc-id:data-flow-01-requirements)、(见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-07-model-protocol-config)、(见 doc-id:02-architecture-stack)、(见 doc-id:11-coding-standards)、(见 doc-id:next-02-package-architecture) |
| (见 doc-id:data-flow-04-static-attribution) | (见 doc-id:data-flow-03-architecture-packages)、(见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-06-data-provenance)、(见 doc-id:06-source-resolution) |
| (见 doc-id:data-flow-05-runtime-observation) | (见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-06-data-provenance)、(见 doc-id:data-flow-10-security-performance)、(见 doc-id:04-vite-plugin)、(见 doc-id:05-runtime-lifecycle) |
| (见 doc-id:data-flow-06-data-provenance) | (见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-07-model-protocol-config)、(见 doc-id:data-flow-10-security-performance) |
| (见 doc-id:data-flow-07-model-protocol-config) | (见 doc-id:data-flow-03-architecture-packages)、(见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-06-data-provenance)、(见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security) |
| (见 doc-id:data-flow-08-ui-interaction) | (见 doc-id:data-flow-01-requirements)、(见 doc-id:data-flow-02-repository-audit)、(见 doc-id:data-flow-06-data-provenance)、(见 doc-id:data-flow-07-model-protocol-config)、(见 doc-id:data-flow-09-ai-assistance)、(见 doc-id:10-ui-diagnostics) |
| (见 doc-id:data-flow-09-ai-assistance) | (见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-07-model-protocol-config)、(见 doc-id:data-flow-08-ui-interaction)、(见 doc-id:data-flow-10-security-performance)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:context-qa-00-index)、(见 doc-id:context-qa-03-architecture)、(见 doc-id:context-qa-04-model-protocol) |
| (见 doc-id:data-flow-10-security-performance) | (见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-06-data-provenance)、(见 doc-id:data-flow-07-model-protocol-config)、(见 doc-id:data-flow-09-ai-assistance)、(见 doc-id:09-local-protocol-security)、(见 doc-id:12-testing-acceptance) |
| (见 doc-id:data-flow-11-testing-acceptance) | (见 doc-id:data-flow-02-repository-audit)、(见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-08-ui-interaction)、(见 doc-id:data-flow-09-ai-assistance)、(见 doc-id:data-flow-10-security-performance)、(见 doc-id:12-testing-acceptance) |
| (见 doc-id:data-flow-12-delivery-adr) | (见 doc-id:data-flow-00-index)、(见 doc-id:data-flow-03-architecture-packages)、(见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-11-testing-acceptance)、(见 doc-id:14-implementation-plan)、(见 doc-id:15-risks-adr) |
| (见 doc-id:data-flow-13-beta-implementation) | (见 doc-id:data-flow-00-index)、(见 doc-id:data-flow-02-repository-audit)、(见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-07-model-protocol-config)、(见 doc-id:data-flow-08-ui-interaction)、(见 doc-id:data-flow-10-security-performance)、(见 doc-id:data-flow-11-testing-acceptance)、(见 doc-id:data-flow-12-delivery-adr) |
| (见 doc-id:data-flow-14-special-adapters) | (见 doc-id:data-flow-01-requirements)、(见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-05-runtime-observation)、(见 doc-id:data-flow-09-ai-assistance)、(见 doc-id:data-flow-11-testing-acceptance)、(见 doc-id:data-flow-13-beta-implementation) |
| (见 doc-id:next-00-index) | (见 doc-id:01-product-boundary)、(见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security)、(见 doc-id:15-risks-adr)、(见 doc-id:next-01-research-compatibility)、(见 doc-id:next-02-package-architecture)、(见 doc-id:next-03-integration-lifecycle)、(见 doc-id:next-04-transform-source)、(见 doc-id:next-05-sidecar-protocol)、(见 doc-id:next-06-rsc-runtime)、(见 doc-id:next-07-security-production)、(见 doc-id:next-08-testing-delivery) |
| (见 doc-id:next-01-research-compatibility) | (见 doc-id:next-08-testing-delivery) |
| (见 doc-id:next-02-package-architecture) | (见 doc-id:02-architecture-stack)、(见 doc-id:03-public-api-models)、(见 doc-id:11-coding-standards)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:next-04-transform-source)、(见 doc-id:next-05-sidecar-protocol)、(见 doc-id:next-06-rsc-runtime) |
| (见 doc-id:next-03-integration-lifecycle) | (见 doc-id:03-public-api-models)、(见 doc-id:09-local-protocol-security)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:next-07-security-production) |
| (见 doc-id:next-04-transform-source) | (见 doc-id:03-public-api-models)、(见 doc-id:04-vite-plugin)、(见 doc-id:06-source-resolution)、(见 doc-id:next-02-package-architecture)、(见 doc-id:next-05-sidecar-protocol)、(见 doc-id:next-06-rsc-runtime)、(见 doc-id:next-08-testing-delivery) |
| (见 doc-id:next-05-sidecar-protocol) | (见 doc-id:09-local-protocol-security)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials) |
| (见 doc-id:next-06-rsc-runtime) | (见 doc-id:03-public-api-models)、(见 doc-id:05-runtime-lifecycle)、(见 doc-id:06-source-resolution)、(见 doc-id:07-dom-css-collection)、(见 doc-id:08-code-prompt)、(见 doc-id:10-ui-diagnostics)、(见 doc-id:next-08-testing-delivery) |
| (见 doc-id:next-07-security-production) | (见 doc-id:09-local-protocol-security)、(见 doc-id:16-ai-agent-execution)、(见 doc-id:17-model-provider-credentials)、(见 doc-id:next-08-testing-delivery) |
| (见 doc-id:next-08-testing-delivery) | (见 doc-id:12-testing-acceptance)、(见 doc-id:14-implementation-plan)、(见 doc-id:next-02-package-architecture) |
本表只指向规范定义位置，不在索引中重复定义。
| 术语 | 唯一规范位置 |
|---|---|
| v1 边界、正式支持矩阵 | (见 doc-id:01-product-boundary) |
| 总体分层、依赖方向、技术栈 | (见 doc-id:02-architecture-stack) |
| SourceRef、SpotTargetContext、SpotAnnotation、locale、目标/说明上限、ContextBudget、AI 配置、Agent limits/状态 | (见 doc-id:03-public-api-models) |
| source marker、fileId、SourceRegistry | (见 doc-id:04-vite-plugin) |
| Runtime 状态、picker、hit test | (见 doc-id:05-runtime-lifecycle) |
| SourceOrigin、SourceConfidence 的判定语义 | (见 doc-id:06-source-resolution) |
| DOM/CSS 上下文 | (见 doc-id:07-dom-css-collection) |
| CodeContext 边界、逐目标 Prompt 与预算 | (见 doc-id:08-code-prompt) |
| API 路径、请求头、ErrorCode、安全边界 | (见 doc-id:09-local-protocol-security) |
| SpotPatch 品牌/视觉令牌、UI marker、双语交互、诊断命名空间 | (见 doc-id:10-ui-diagnostics) |
| 浮动工作台锚点、拖拽、吸附、位置恢复与基础入口反馈 | (见 doc-id:21-floating-workbench-island) |
| 持续 Shell、真实状态 Morph、Agent 派发动效与 Motion 性能边界 | (见 doc-id:22-persistent-shell-motion-system) |
| 目录、TypeScript 与去冗余规则 | (见 doc-id:11-coding-standards) |
| 质量门禁、验收指标 | (见 doc-id:12-testing-acceptance) |
| 当前目标项目约束 | (见 doc-id:13-project-integration) |
| Milestone 0–14 与 Next.js Milestone 15–20 入口 | (见 doc-id:14-implementation-plan) |
| ADR-001–ADR-044 | (见 doc-id:15-risks-adr) |
| Agent 工具循环、worktree、checks、Diff、Apply/Revert | (见 doc-id:16-ai-agent-execution) |
| Provider URL、Key、模型、协议、能力探测、远程数据 | (见 doc-id:17-model-provider-credentials) |
| 上下文问答首阶段边界与实现状态 | (见 doc-id:context-qa-00-index) |
| Ask/Change 任务、Answer/Source/Job 协议与集中限制 | (见 doc-id:context-qa-04-model-protocol) |
| Ask UI、答案引用与转修改草稿 | (见 doc-id:context-qa-07-ui-state) |
| Ask 安全、隐私、性能、测试和发布 Gate | (见 doc-id:context-qa-08-security-performance)、(见 doc-id:context-qa-09-testing-delivery) |
| 外部 Agent Handoff、MCP/CLI、Broker、显式发布与兼容矩阵 | (见 doc-id:external-agent-00-index)、(见 doc-id:external-agent-04-handoff-protocol)、(见 doc-id:external-agent-05-mcp-cli) |
| 外部 Agent 权限/隐私边界与发布 Gate | (见 doc-id:external-agent-06-security)、(见 doc-id:external-agent-08-testing-delivery) |
| 组件数据链路专题导航与交付边界 | (见 doc-id:data-flow-00-index) |
| 当前 Vite + React 18 Beta 事实 | (见 doc-id:data-flow-13-beta-implementation) |
| render 请求、React Query、tRPC 与特殊调用形态 | (见 doc-id:data-flow-14-special-adapters) |
| 组件接口归属、参数/响应/数据来源 | (见 doc-id:data-flow-04-static-attribution)、(见 doc-id:data-flow-06-data-provenance) |
| 数据链路/页面接口 UI 与未来 AI 辅助 | (见 doc-id:data-flow-08-ui-interaction)、(见 doc-id:data-flow-09-ai-assistance) |
| 数据链路百分比、测试与发布 Gate | (见 doc-id:data-flow-11-testing-acceptance) |
| Next.js 公共预览状态与专题导航 | (见 doc-id:next-00-index) |
| Next.js 计划支持矩阵与阻断未知项 | (见 doc-id:next-01-research-compatibility) |
| Next.js 包、Loader、Sidecar、RSC 与生产隔离 | (见 doc-id:next-02-package-architecture)、(见 doc-id:next-04-transform-source)、(见 doc-id:next-05-sidecar-protocol)、(见 doc-id:next-06-rsc-runtime)、(见 doc-id:next-07-security-production) |
- 跨文档正文引用统一使用半角括号包裹“见
doc-id:<目标文档 ID>”；文件链接只用于本索引中的人工导航。 - 常量、协议、数据模型只在其唯一规范位置定义，消费方只能引用。
- 修改公共行为时，应同时检查依赖图中的消费文档，但不得复制定义。
archive/内文件是审计快照，不能覆盖活动文档中的规则。- 任何实现与规范冲突，先更新对应活动文档；涉及架构决策时同时更新 ADR (见 doc-id:15-risks-adr)。
校验范围现为 69 份 active/proposed 主题文档：23 份根级索引/入口/核心主题、9 份 Next.js、15 份组件数据链路、11 份外部 Agent 专题、11 份上下文问答专题。组件数据链路中已落地契约与当前 Beta 事实为 active，未交付目标仍保持 proposed；外部 Agent 专题统一以 local-validation 区分工作区实现与尚未通过的发布矩阵；上下文问答专题明确为 design-complete/implementation-not-started；浮动工作台 Runtime 基线和持续 Shell 动效均为 active，持续 Shell 仅保留真实浏览器视觉/性能验收缺口。deprecated 旧路径入口和 archive/ 原文快照不参与活动事实源的重复定义统计。原文覆盖审计仍针对 v1 归档；新增能力文档不伪装成原文迁移内容。
| 校验项 | 结果 |
|---|---|
| 章节覆盖 | 开篇说明与原 §1–§30 均已进入映射表；原文缺失显式 §10 一级标题的内容已按“元素选择器”归入 Runtime |
| Front-matter | 69/69 份 active/proposed 文档具备必需字段；doc-id 全局唯一；Next.js、组件数据链路、外部 Agent、上下文问答、浮动工作台和持续 Shell 动效均明确区分目标矩阵和当前实现 |
| 引用闭包 | 69 份 active/proposed 正文中的 doc-id 引用可解析；上下文问答、特殊调用形态、外部 Agent 主动适配、浮动工作台和持续 Shell 动效入口已纳入导航与依赖图 |
| 文件导航 | 索引中的全部 Markdown 文件链接均存在 |
| 定义去重 | 活动文档间 0 个重复导出定义；协议路径、请求头、marker、默认配置、核心模型、computed 白名单均只有一个定义文档 |
| 原文覆盖审计 | 对归档原文的 1,188 条非空、非标题内容行比对：1,164 条逐字保留；其余 24 条均为标题/代码围栏规范化，或以唯一常量和 doc-id 引用替换重复字面量，已逐项人工核对 |
| 归档完整性 | 原文正文共 1,732 行；SHA-256：8385225fdadb596a92f47aec46922dc31baf14ca1593d9b56ac47fc652950e25 |
唯一事实归属抽查：
| 事实类型 | 唯一归属 |
|---|---|
| 公共配置默认值、editor/locale/说明上限、官方仓库 URL、核心数据模型、Agent limits/状态 | (见 doc-id:03-public-api-models) |
| source marker、fileId、SourceRegistry | (见 doc-id:04-vite-plugin) |
| computed style 白名单 | (见 doc-id:07-dom-css-collection) |
| HTTP/Job 路径、token header、错误码、清洗、保护路径和安全规则 | (见 doc-id:09-local-protocol-security) |
| 品牌/视觉令牌、UI marker、双语交互、日志命名空间 | (见 doc-id:10-ui-diagnostics) |
| ADR-001–ADR-044 | (见 doc-id:15-risks-adr) |
| Agent 工具、Git、检查、审阅、应用与撤销 | (见 doc-id:16-ai-agent-execution) |
| Provider、凭据、模型、协议与能力探测 | (见 doc-id:17-model-provider-credentials) |
| 外部 Agent 交接模型、MCP/CLI、Broker、安全与发布 Gate | (见 doc-id:external-agent-00-index) 及其专题文档 |
| 上下文问答任务/答案/引用、Key/Codex 执行、安全与发布 Gate | (见 doc-id:context-qa-00-index) 及其专题文档 |
原文存在两处结构/文字缺陷，本次未擅自修改业务含义：一是 §9 后缺失显式的 §10 一级标题；二是 AST 判断规则“名称包含”后缺失具体字符。两处均已在对应新文档中标注，后续应通过勘误或 ADR 处理。