QuickerOrg · ceastld · Sep 6, 2026 · Sep 6, 2026
diff --git a/README.md b/README.md
@@ -14,7 +14,7 @@ Codex 插件 `quicker` 已提供 GitHub 市场安装入口，采用 [MIT 许可
 | Cursor | 计划接入 | 待开发和实机验证 |
 | 其他 Agent | 按需求扩展 | 先确认其 MCP 和插件机制 |
 
-当前 Quicker 只有 Debug 版开放 MCP；Release 没有入口，也不监听。完整状态及验收标准见[兼容性说明](docs/兼容性.md)。
+需要使用设置 → Agent 中带「启用 MCP」入口、并包含默认技能包发现修复的 Quicker 新构建。Release 支持已实现，待包含这些变更的正式版发布；已发布旧版没有该入口时仍不可用。本次已验证 Debug 的草稿编写与预览，Release 配置内核测试和正式前端构建通过，正式安装包端到端仍待验收，详见[兼容性说明](docs/兼容性.md)。
 
 ## 安装 Codex 插件
 
@@ -29,13 +29,13 @@ codex plugin add quicker@quicker-agent-integrations
 
 插件运行时需要 Windows PowerShell 5.1 和 Quicker。它不依赖 Python、Node 或 `plugin-creator`。
 
-需要已有带 MCP 设置入口的 Quicker Debug 构建；公开正式版目前不提供此入口。安装后，在 Quicker Debug 设置中启用 MCP 和「允许 MCP 写入」，然后新建 Codex 任务。首次连接时，在 Quicker 的客户端同意窗口确认所显示的客户端。
+安装并运行受支持的 Quicker 构建，在设置 → Agent 中启用 MCP 和「允许 MCP 写入」，然后新建 Codex 任务。MCP 默认关闭，安装插件不会自动开启服务或写入权限。首次连接时，在 Quicker 的客户端同意窗口确认所显示的客户端。
 
 可以这样开始：
 
 > 用 Quicker 写一个动作，显示“来自 Codex”，保存到暂存区并打开预览，不运行。
 
-动作默认保存到暂存区。正式保留到场景、覆盖原动作或执行动作，由用户要求和 Quicker 的审批机制决定。
+动作默认保存到暂存区。支持 MCP 的 Release 构建在 Quicker 内嵌设计器中预览，不返回 HTTP URL；只有 Debug + Vite 时才可能返回浏览器 URL。正式保留到场景、覆盖原动作或执行动作，由用户要求和 Quicker 的审批机制决定。
 
 ## 连接方式
 

diff --git a/docs/兼容性.md b/docs/兼容性.md
@@ -7,12 +7,16 @@
 | 项目 | 状态 |
 | --- | --- |
 | Codex 插件结构与技能 | 已实现；v0.1.1 包通过 Codex plugin-creator 校验 |
-| Codex GitHub 市场安装 | 2026-09-07：从公开仓库安装，Codex 确认 installed=true、enabled=true |
-| Codex 原生缓存启动与工具发现 | 2026-09-07：Codex CLI 0.153.0；完整包经隔离市场安装，app-server 从缓存启动转接并发现 fixture 工具；未调用模型或创建任务 |
+| Codex GitHub 市场安装 | 2026-09-07：从公开仓库安装 v0.1.1，真实用户配置下的 Codex app-server 确认 installed=true、enabled=true |
+| Codex 原生缓存启动与工具发现 | 2026-09-07：Windows、Codex CLI 0.153.0；按实际安装缓存的 MCP 配置启动 PowerShell 5.1 转接，连接真实 Quicker，发现 18 个工具及运行时技能 |
 | PowerShell 5.1 传输 | 2026-09-07：独立仓库 16 项契约测试全部通过，包含实际启动配置、中文与空格安装目录 |
-| 真实 Quicker 创建、保存和预览 | 尚待启用本机 MCP 后验收 |
-| Quicker Debug | 提供当前 MCP 接口，需手动启用和授权 |
-| Quicker Release | 当前没有 MCP 入口，不监听 |
+| 真实 Quicker 创建、保存和预览（Debug） | 2026-09-07：加载 action-source、创建、写入、保存与读回核对通过；浏览器设计器显示对应草稿标题和提示消息步骤。未执行动作 |
+| 真实只读切换与拒绝访问 | 本次未验证；隔离传输测试不能替代真实权限验收 |
+| Quicker Debug | 本次验收依赖包含默认技能包发现修复的本地构建，该修复尚未公开发布；需启用 MCP 和允许写入并完成客户端授权 |
+| Quicker Release | 支持已实现，待包含 MCP 新入口与默认技能包发现修复的正式版发布；已发布旧版没有 MCP 入口时仍不可用 |
+| MCP 内核测试 | 2026-09-07：Debug 41/41 通过；Release 配置 41 项覆盖通过（40 项全量通过，启停新增用例修正后单项复验通过） |
+| 正式前端构建 | 2026-09-07：生产前端构建与产物审计通过 |
+| 正式安装包端到端 | 尚未执行正式 MSI / 混淆 Release 的完整验收；不将内核测试或 Debug 草稿验收视为正式安装包已验证 |
 | Cursor 与其他 Agent | 计划接入，尚未实现和验收 |
 
 ## 版本记录
@@ -21,11 +25,24 @@
 
 当前 Codex 包版本为 `0.1.1`，通过 GitHub 市场分发。旧个人市场原型使用的 `+codex.<时间戳>` 后缀只用于刷新开发缓存，不代表跨平台发布版本。
 
-`0.1.1` 修复 `0.1.0` 安装成功但 MCP 无法启动的问题：当前 Codex legacy MCP 加载器不会展开参数中的 `${PLUGIN_ROOT}`，现改用 `cwd: "."` 与包内相对脚本路径。旧版用户按 README 的市场升级与重新安装步骤更新。原生启动验证使用隔离 HTTP fixture，真实 Quicker 动作验收仍单独记录。
+`0.1.1` 修复 `0.1.0` 安装成功但 MCP 无法启动的问题：当前 Codex legacy MCP 加载器不会展开参数中的 `${PLUGIN_ROOT}`，现改用 `cwd: "."` 与包内相对脚本路径。旧版用户按 README 的市场升级与重新安装步骤更新。隔离 HTTP fixture 用于传输回归，真实 Quicker 验收证据见下。
+
+Release 支持与默认技能包发现修复已实现，待包含这些变更的正式版发布。受支持的新构建在设置 → Agent 中提供「启用 MCP」入口，Debug / Release 均默认关闭；用户要编写动作，还需开启「允许 MCP 写入」并完成客户端同意，loopback、Bearer 与工具审批边界不变。支持 MCP 的 Release 构建在 Quicker 内嵌设计器中预览，不返回 HTTP URL；只有 Debug + Vite 时才可能返回浏览器 URL。
+
+上述产品变更尚未正式发布，已发布旧版没有 MCP 入口时仍不可用。插件 0.1.1 的安装成功不表示产品已具备 MCP 能力；Release 配置内核测试已通过，最低适用正式版本与正式安装包端到端结果仍待确认。
 
 ## 真实验收
 
-使用用户授权的测试环境与一个容易识别的动作标题，依次验证：
+2026-09-07 在 Windows 上，使用已从公开市场安装的 `quicker@quicker-agent-integrations` 0.1.1 完成以下验证：
+
+- Codex app-server 在真实用户配置下识别已安装并启用的插件，未使用隔离的 Codex 配置目录。按安装缓存内 `.mcp.json` 启动 Windows PowerShell 5.1 转接，成功连接真实 Quicker。
+- 初始化返回运行时技能索引，发现 18 个工具，`skill_load(action-source)` 成功。
+- 创建测试草稿、写入程序，`quicker_save` 返回 `saved=true`；读回规范化 YAML 与动作信息，核对内容一致。
+- `quicker_preview` 返回设计器 URL；实际浏览器中的设计器显示对应标题、提示消息步骤及本机暂存提示。
+
+Quicker MCP 服务报告版本为 `2.3.0`，但本次使用包含默认技能包发现修复的本地 Debug 构建，该修复尚未公开发布。上述结果不代表所有 `2.3.0` 或其他 Debug 构建均兼容。动作没有执行，真实拒绝访问及只读切换也未验证。
+
+后续构建复验时，使用用户授权的测试环境与一个容易识别的动作标题，记录具体构建范围，依次验证：
 
 1. 从平台发现 Quicker 工具，读取运行时 action-source 技能。
 2. 创建草稿，记录 actionId 和 slot，写入只显示提示的程序。

diff --git a/docs/接入约定.md b/docs/接入约定.md
@@ -2,7 +2,9 @@
 
 本仓库维护外部 Agent 的连接、安装与使用引导。Quicker 提供动作工具、实时知识、草稿存储和审批。各平台适配遵循本文，平台交付要求见[新增平台](新增平台.md)。
 
-当前 Codex 为原型，Cursor 尚在规划。现有连接面适用启用 MCP 的 Windows Quicker Debug 版；当前 Release 没有 MCP 入口或监听能力。安装插件不会开启 Quicker 的 MCP 或写入权限。
+Codex 插件 0.1.1 已通过原生安装及真实 Quicker Debug 草稿编写、保存和预览验收，Cursor 尚在规划。使用前确认 Quicker 的设置 → Agent 中有「启用 MCP」入口，并使用包含默认技能包发现修复的新构建；不能仅凭 `2.3.0` 版本号判断兼容。
+
+Release 支持已实现，待包含这些变更的正式版发布；已发布旧版没有 MCP 入口时仍不可用。新构建的 Debug / Release 均默认关闭 MCP，由用户在设置中启用；安装插件不会开启服务或写入权限。具体构建、测试与正式发布情况见[兼容性说明](兼容性.md)。
 
 ## 连接与发现
 
@@ -28,7 +30,7 @@
 2. 新建用 `quicker_create`；修改已有动作用 `quicker_search` 找到明确目标后 `quicker_open`。打开正式动作产生编辑草稿。
 3. 保留返回的 slot 和 actionId。文件操作始终使用 `<slot>/program.source.yaml`、`<slot>/info.yaml` 或 `<slot>/files/...`；保存传 `quicker_save {"path":"<slot>"}`。这些是 Quicker 虚拟路径，必须使用 Quicker 的文件工具，不能交给本地文件系统工具。
 4. `program.source.yaml` 写程序，`info.yaml` 写标题、说明和外观；`data.json`、`info.json` 为 Host 内部文件。保存后检查校验结果并修复错误。
-5. 默认交付保存到暂存区的草稿。需要展示时调用 `quicker_preview {"target":"<slot>"}`；浏览器只打开工具实际返回的 URL。
+5. 默认交付保存到暂存区的草稿。需要展示时调用 `quicker_preview {"target":"<slot>"}`。支持 MCP 的 Release 构建使用 Quicker 内嵌设计器，不返回 HTTP URL；只有 Debug + Vite 时才可能返回浏览器 URL。浏览器只打开工具实际返回的 URL，不根据内部 route 拼接地址。
 
 不同客户端或任务仍可能编辑同一动作，必须串行处理同一 slot，不能依赖隐式当前位置。保存草稿、保留到场景、覆盖原动作和运行是不同结果：用户指定唯一既有目标场景时才 promote；overwrite、run 按用户请求和 Quicker 审批执行。完成说明应写清实际到达哪一步。