From 8f66d41d6c0e8033d808265bacac9025753582a1 Mon Sep 17 00:00:00 2001 From: Cea <61349137+ceastld@users.noreply.github.com> Date: Mon, 7 Sep 2026 03:43:46 +0800 Subject: [PATCH] =?UTF-8?q?docs(mcp):=20=E5=90=8C=E6=AD=A5=E5=AE=89?= =?UTF-8?q?=E8=A3=85=E5=89=8D=E7=BD=AE=E6=9D=A1=E4=BB=B6=E4=B8=8E=E9=AA=8C?= =?UTF-8?q?=E8=AF=81=E8=8C=83=E5=9B=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 ++-- .../\345\205\274\345\256\271\346\200\247.md" | 31 ++++++++++++++----- ...45\345\205\245\347\272\246\345\256\232.md" | 6 ++-- 3 files changed, 31 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 33c39c2..5f850ab 100644 --- 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/\345\205\274\345\256\271\346\200\247.md" "b/docs/\345\205\274\345\256\271\346\200\247.md" index 8f01bc0..89d89e8 100644 --- "a/docs/\345\205\274\345\256\271\346\200\247.md" +++ "b/docs/\345\205\274\345\256\271\346\200\247.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/\346\216\245\345\205\245\347\272\246\345\256\232.md" "b/docs/\346\216\245\345\205\245\347\272\246\345\256\232.md" index 7bca309..d560627 100644 --- "a/docs/\346\216\245\345\205\245\347\272\246\345\256\232.md" +++ "b/docs/\346\216\245\345\205\245\347\272\246\345\256\232.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。文件操作始终使用 `/program.source.yaml`、`/info.yaml` 或 `/files/...`；保存传 `quicker_save {"path":""}`。这些是 Quicker 虚拟路径，必须使用 Quicker 的文件工具，不能交给本地文件系统工具。 4. `program.source.yaml` 写程序，`info.yaml` 写标题、说明和外观；`data.json`、`info.json` 为 Host 内部文件。保存后检查校验结果并修复错误。 -5. 默认交付保存到暂存区的草稿。需要展示时调用 `quicker_preview {"target":""}`；浏览器只打开工具实际返回的 URL。 +5. 默认交付保存到暂存区的草稿。需要展示时调用 `quicker_preview {"target":""}`。支持 MCP 的 Release 构建使用 Quicker 内嵌设计器，不返回 HTTP URL；只有 Debug + Vite 时才可能返回浏览器 URL。浏览器只打开工具实际返回的 URL，不根据内部 route 拼接地址。 不同客户端或任务仍可能编辑同一动作，必须串行处理同一 slot，不能依赖隐式当前位置。保存草稿、保留到场景、覆盖原动作和运行是不同结果：用户指定唯一既有目标场景时才 promote；overwrite、run 按用户请求和 Quicker 审批执行。完成说明应写清实际到达哪一步。