ceastld · Sep 7, 2026 · Sep 7, 2026
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -0,0 +1,16 @@
+{
+  "name": "quicker-agent-integrations",
+  "owner": {
+    "name": "QuickerOrg"
+  },
+  "plugins": [
+    {
+      "name": "quicker",
+      "source": "./plugins/quicker-claude",
+      "description": "通过本机 Quicker MCP 编写、保存和预览自动化动作。"
+    }
+  ],
+  "metadata": {
+    "description": "通过本机 Quicker 编写和预览自动化动作的插件。"
+  }
+}
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
@@ -0,0 +1,13 @@
+{
+  "name": "quicker-agent-integrations",
+  "owner": {
+    "name": "QuickerOrg"
+  },
+  "plugins": [
+    {
+      "name": "quicker",
+      "source": "./plugins/quicker-cursor",
+      "description": "通过本机 Quicker MCP 编写、保存和预览自动化动作。"
+    }
+  ]
+}
diff --git a/README.md b/README.md
@@ -4,18 +4,56 @@
 
 这个仓库集中维护各平台插件、安装与更新工具、MCP 接入约定、开发指南和契约测试。插件通过 Quicker 的公开接口工作，步骤知识由运行中的 Quicker 实时提供。
 
-Codex 插件 `quicker` 已提供 GitHub 市场安装入口，采用 [MIT 许可证](LICENSE)。Cursor 接入列入后续工作。
+提供 Codex、Cursor、Claude Code 插件及 VS Code / Gemini CLI 的 MCP 配置安装器，采用 [MIT 许可证](LICENSE)。
 
 ## 支持情况
 
 | 平台 | 状态 | 使用范围 |
 | --- | --- | --- |
-| Codex | 已实现，v0.1.1 | Windows；读取知识、编写/保存草稿、预览 |
-| Cursor | 计划接入 | 待开发和实机验证 |
-| 其他 Agent | 按需求扩展 | 先确认其 MCP 和插件机制 |
+| Codex | 已实现，v0.2.0 | Windows；读取知识、编写/保存草稿、预览 |
+| Cursor | 本地插件；CLI 真实写动作通过 | Windows；技能、草稿创建/保存/预览 |
+| Claude Code | 原生插件安装和真实 MCP 连接通过 | 尚未完成模型写动作验收 |
+| VS Code / Copilot、Gemini CLI | 配置安装器 | 默认 Windows 用户配置；尚未完成各客户端写动作验收 |
 
 需要使用设置 → Agent 中带「启用 MCP」入口、并包含默认技能包发现修复的 Quicker 新构建。Release 支持已实现，待包含这些变更的正式版发布；已发布旧版没有该入口时仍不可用。本次已验证 Debug 的草稿编写与预览，Release 配置内核测试和正式前端构建通过，正式安装包端到端仍待验收，详见[兼容性说明](docs/兼容性.md)。
 
+## 安装 Cursor 插件
+
+在 Windows PowerShell 中执行（需要 Git）：
+
+```powershell
+$quickerInstall = Join-Path $env:TEMP ("quicker-agent-" + [guid]::NewGuid().ToString("N"))
+git clone --depth 1 https://github.com/QuickerOrg/quicker-agent-integrations.git $quickerInstall
+if ($LASTEXITCODE -eq 0) {
+    powershell.exe -NoProfile -ExecutionPolicy Bypass -File (Join-Path $quickerInstall "scripts/install-client.ps1") -Client cursor
+}
+```
+
+安装器把自包含插件复制到 `%USERPROFILE%/.cursor/plugins/local/quicker`，运行时不依赖临时检出。执行 **Developer: Reload Window**，再新建对话，在 Cursor 插件设置确认 Quicker 的技能及 MCP 已加载。团队策略须允许本地插件导入；同名市场插件可能优先于本地版本。本项目尚未在 Cursor 官方市场上架。
+
+Cursor CLI 可显式加载已安装的插件：
+
+```powershell
+cursor-agent --plugin-dir "$env:USERPROFILE/.cursor/plugins/local/quicker"
+```
+
+若 PATH 中没有 `cursor-agent`，使用 Cursor CLI 安装时提供的完整命令路径。先启用 Quicker 设置 → Agent 中的 MCP 与允许写入，再让 Cursor 创建、保存并预览一个测试草稿。CLI 非交互测试还有独立的工具调用授权要求，见[各平台安装与诊断](docs/客户端安装.md)。
+
+## 安装 Claude Code 插件
+
+```powershell
+claude plugin marketplace add QuickerOrg/quicker-agent-integrations
+claude plugin install quicker@quicker-agent-integrations --scope user
+```
+
+执行 `/reload-plugins` 或重启 Claude Code，再用 `/mcp` 检查 Quicker。已通过 Claude Code 2.1.263 官方清单校验、本地市场安装和真实 MCP 连接检查；本机没有 Claude 登录状态，尚未完成模型写动作验收。
+
+## VS Code / Copilot 与 Gemini CLI
+
+使用上述下载步骤，将安装器参数分别改为 `-Client vscode` 或 `-Client gemini`。安装器只合并自己的 MCP 项，保留其他服务与设置，token 始终由本地转接读取。
+
+VS Code：执行 **MCP: List Servers**，启动或重启 quicker，然后在 Copilot Agent 模式试写。Gemini CLI：重启后用 `/mcp` 检查。默认配置路径、JSONC / 自定义配置的替代方式、更新与卸载见[客户端安装](docs/客户端安装.md)。本轮只验证安装与转接，未声称这些客户端已通过真实动作编写。
+
 ## 安装 Codex 插件
 
 在 Windows 上执行以下两条 Codex CLI 命令，无需克隆本仓库或安装 Python：
@@ -46,7 +84,7 @@ Agent 平台插件
     → 查询知识 / 编辑动作草稿 / 保存 / 预览
 ```
 
-当前 Codex 包内的 PowerShell 脚本在每次请求时读取本机 Quicker 的端口和 token，不把 token 写入插件、命令行或 Codex 配置；只请求 loopback，不使用代理或跟随重定向。它不修改 Quicker 的授权设置。
+各安装包内的 PowerShell 脚本在每次请求时读取本机 Quicker 的端口和 token，不把 token 写入插件、命令行或 Codex 配置；只请求 loopback，不使用代理或跟随重定向。它不修改 Quicker 的授权设置。
 
 查看安装状态：
 
@@ -101,7 +139,7 @@ tests/
   test_quicker_mcp.py     独立的传输契约测试
 ```
 
-后续平台在 `plugins/` 下增加安装单元，由对应平台的市场清单声明路径。每个安装包自包含；当第二个平台需要复用传输代码时，再抽取共享源码并在打包时放入各安装单元。
+Cursor、Claude 和 Codex 分别由自己的 marketplace 清单声明包路径。`shared/` 是传输与写动作技能的唯一源码，`python scripts/sync-packages.py` 同步到各自包含安装包，`--check` 在 CI 验证无漂移。
 
 ## 开发与验证
 

diff --git a/docs/兼容性.md b/docs/兼容性.md
@@ -17,13 +17,15 @@
 | MCP 内核测试 | 2026-09-07：Debug 41/41 通过；Release 配置 41 项覆盖通过（40 项全量通过，启停新增用例修正后单项复验通过） |
 | 正式前端构建 | 2026-09-07：生产前端构建与产物审计通过 |
 | 正式安装包端到端 | 尚未执行正式 MSI / 混淆 Release 的完整验收；不将内核测试或 Debug 草稿验收视为正式安装包已验证 |
-| Cursor 与其他 Agent | 计划接入，尚未实现和验收 |
+| Cursor CLI | 2026-09-07：2026.08.11-e8db854；v0.2.0 本地安装包技能加载、实时知识发现、4 步动作创建/保存/预览通过。IDE 3.7.12 的插件设置界面重载尚未单独操作验收 |
+| Claude Code | 2026-09-07：2.1.263；v0.2.0 插件与市场通过官方 validator，在隔离配置中原生安装并 enabled=true；mcp list 连接真实 Quicker 成功。无 Claude 登录状态，未验证模型写动作 |
+| VS Code / Gemini CLI | v0.2.0 默认用户配置安装/更新/卸载和隔离传输通过；尚未完成实际客户端写动作验收 |
 
 ## 版本记录
 
 每个平台使用自己的插件 manifest 版本。发布记录应包含平台版本、Quicker 版本或构建、操作系统、插件版本与实测结果。尚未实测的最低版本写为未知，不猜测兼容范围。
 
-当前 Codex 包版本为 `0.1.1`，通过 GitHub 市场分发。旧个人市场原型使用的 `+codex.<时间戳>` 后缀只用于刷新开发缓存，不代表跨平台发布版本。
+当前各安装包版本为 `0.2.0`，通过 GitHub 市场分发。旧个人市场原型使用的 `+codex.<时间戳>` 后缀只用于刷新开发缓存，不代表跨平台发布版本。
 
 `0.1.1` 修复 `0.1.0` 安装成功但 MCP 无法启动的问题：当前 Codex legacy MCP 加载器不会展开参数中的 `${PLUGIN_ROOT}`，现改用 `cwd: "."` 与包内相对脚本路径。旧版用户按 README 的市场升级与重新安装步骤更新。隔离 HTTP fixture 用于传输回归，真实 Quicker 验收证据见下。
 
@@ -51,3 +53,17 @@ Quicker MCP 服务报告版本为 `2.3.0`，但本次使用包含默认技能包
 5. 单独验证只读模式和客户端拒绝访问的行为，记录现象。
 
 只记录结果、版本及非敏感错误码。配置文件、token、真实动作库和客户端同意记录不作为测试附件上传。
+
+## 0.2.0 跨平台验收
+
+共享转接与技能通过 sync-packages.py 生成独立包。保留 Codex 0.1.1 已验证的相对 cwd 方式；Cursor / Claude 使用其实际支持的插件根变量。Codex 0.2.0 已通过插件校验器和原启动方式回归，未将旧客户端安装结果冒充本次更新安装。
+
+Cursor CLI 从安装器生成的 `%USERPROFILE%/.cursor/plugins/local/quicker` 加载插件，读取 write-action skill 与服务端 action-source。生成“Cursor MCP 验收 · 文本摘要”，4 步完成参数文本修剪、字符数、非空行数和消息框摘要；校验保存到暂存区，quicker_preview 返回对应设计器。实际过程先出现 CLI print 模式自动拒绝；在专用测试目录授权需要的 Quicker 工具后成功，Quicker 权限和批准方式未修改。第一次源文本转义不当由 Cursor 读回发现并修正，保存结果 saved=true。动作未运行，因此这里不声称运行时统计已验收。
+
+Quicker 使用 d921319283 的 Debug 构建，MCP 启用、允许写入、sandbox_confirm。新插件没有伪装已授权客户端；Client 参数分别发出 cursor-quicker-plugin / claude-quicker-plugin。所有原始日志只留本机，不提交个人配置或 token。
+
+Claude Code 初次 npm 包缺少可选原生二进制；安装对应 Windows x64 2.1.263 包后官方校验、安装和 MCP 健康检查成功。首次默认 30 秒连接超时，使用该客户端 MCP_TIMEOUT=180000 复验 Connected；该变量只用于验收进程，没有修改全局权限或客户端配置。首次连接应留意 Quicker 的同意窗口。
+
+第二轮 Cursor CLI 不传 --plugin-dir，仍自动发现安装器写入的本地插件。打开同一暂存动作，修改说明，保存 editVersion=4，读回说明一致并再次预览；actionId 与 slot 保持一致，没有新建或覆盖正式动作。更新后的安装包 `-Check` 返回 enabled/allowWrites/portReachable=true，无 token 内容。
+
+0.2.0 最终 Windows 测试：23 项通过（16 项传输回归 + 7 项包/安装验证），覆盖两种原生插件启动参数、客户端标识、中文/空格用户目录、重复安装/更新/卸载、已有配置保留、外来同名项与本地修改拒绝、JSONC 原文不改写。
diff --git a/docs/客户端安装.md b/docs/客户端安装.md
@@ -0,0 +1,61 @@
+# 客户端安装与诊断
+
+核对日期：2026-09-07。所有连接都在 Windows 本机执行，不能让远程 Cloud Agent 访问用户电脑的 127.0.0.1。
+
+## 安装机制
+
+| 客户端 | 安装单元 | 加载方式 |
+| --- | --- | --- |
+| Cursor | plugins/quicker-cursor | `.cursor-plugin/plugin.json` + `mcp.json` + skills；本地目录或显式 `--plugin-dir` |
+| Claude Code | plugins/quicker-claude | `.claude-plugin/plugin.json` + `.mcp.json` + skills；原生市场 |
+| Codex | plugins/quicker | `.codex-plugin/plugin.json` + `.mcp.json` + skills；原生市场 |
+| VS Code / Gemini CLI | plugins/quicker-mcp | 安装本地 stdio 转接并合并客户端 MCP JSON；编写规则来自 MCP initialize 与 skill_load |
+
+Cursor 和 Claude 分别展开 `${CURSOR_PLUGIN_ROOT}`、`${CLAUDE_PLUGIN_ROOT}`，Codex 使用包内相对 cwd。安装后各包独立运行，不访问 shared/ 或开发检出。
+
+## 安装器的范围
+
+从本仓库执行 `powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/install-client.ps1 -Client cursor`。支持 cursor、vscode、gemini。安装器不会打开 Quicker 权限开关。
+
+- Cursor：`%USERPROFILE%/.cursor/plugins/local/quicker`。
+- VS Code 默认用户：`%USERPROFILE%/AppData/Roaming/Code/User/mcp.json` 的 `servers.quicker`。
+- Gemini CLI：`%USERPROFILE%/.gemini/settings.json` 的 `mcpServers.quicker`。
+- 通用转接安装目录：`%USERPROFILE%/.quicker/agent-integrations/<client>`。
+
+现有 quicker 项、插件目录不属于此安装器，或已安装文件被手动修改时会拒绝覆盖。安装器保留其他设置，替换前备份原配置/包，已安装包用归属标记和文件 hash 校验。备份保存在本机，不上传。JSON 不能解析时原文件不变；VS Code JSONC（注释、尾逗号）、便携版、自定义用户数据目录和 Profile 不由此安装器自动处理。
+
+这些情况请使用客户端原生 MCP 配置界面：先把 plugins/quicker-mcp 复制到稳定的本机目录，再配置以下 stdio 服务，将脚本路径换成实际安装位置，Client 换成 vscode 或 gemini：
+
+```json
+{
+  "command": "powershell.exe",
+  "args": ["-NoLogo", "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", "<安装目录>/scripts/quicker-mcp.ps1", "-Client", "vscode"]
+}
+```
+
+VS Code 的服务项还需 `"type": "stdio"`。不填 URL、Authorization 或 token；转接自动发现本机 Quicker 设置。通过原生 UI 手工添加的条目不会被安装器接管。
+
+## 更新与卸载
+
+重新下载最新仓库并运行相同安装命令即可更新；安装器移走旧包，因此旧版已删除文件不会残留。已编辑安装内容时先核对差异，不能强制覆盖。
+
+```powershell
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/install-client.ps1 -Client cursor -Uninstall
+```
+
+VS Code / Gemini 同样替换 Client。卸载只删除归属匹配且未编辑的当前包与对应 MCP 项，保留其他配置与旧备份。Codex 和 Claude Code 使用各自原生插件卸载命令。
+
+## Cursor CLI 验收
+
+已验证 Cursor IDE 3.7.12 对应机器上的 Cursor CLI 2026.08.11-e8db854，通过独立安装的本地包 `--plugin-dir` 加载技能和 `plugin-quicker-quicker` 工具；第二轮不传此参数也能自动发现并再次保存。IDE 重载后的界面发现尚未独立验收。
+
+`--approve-mcps` 只同意服务器加载；非交互 `--print` 的工具调用仍有独立权限。自动化验收可在专用测试工作区 `.cursor/cli.json` 按实际需要列出 `Mcp(plugin-quicker-quicker:skill_load)`、`Mcp(plugin-quicker-quicker:quicker_create)` 等精确权限。不要给普通安装器附加全局自动批准，不要把 CLI 的自动拒绝误报为 Quicker 403。交互对话正常按客户端提示授权。
+
+Quicker 的同意与运行审批仍然独立生效。使用显式 slot；保存草稿、覆盖原动作、运行不是同一结果。诊断 `-Check` 只验证配置及 TCP，不表示已经写动作成功。
+
+## 官方依据
+
+- [Cursor 插件清单、MCP 和本地安装](https://cursor.com/docs/reference/plugins)，[本地插件目录](https://cursor.com/docs/plugins#test-plugins-locally)，[CLI MCP 权限](https://cursor.com/docs/cli/reference/permissions)。
+- [Claude Code 插件与 MCP](https://code.claude.com/docs/en/plugins-reference)。
+- [VS Code MCP 配置](https://code.visualstudio.com/docs/agent-customization/mcp-servers)。
+- [Gemini CLI MCP 配置](https://geminicli.com/docs/tools/mcp-server/)。
diff --git a/docs/接入约定.md b/docs/接入约定.md
@@ -2,7 +2,7 @@
 
 本仓库维护外部 Agent 的连接、安装与使用引导。Quicker 提供动作工具、实时知识、草稿存储和审批。各平台适配遵循本文，平台交付要求见[新增平台](新增平台.md)。
 
-Codex 插件 0.1.1 已通过原生安装及真实 Quicker Debug 草稿编写、保存和预览验收，Cursor 尚在规划。使用前确认 Quicker 的设置 → Agent 中有「启用 MCP」入口，并使用包含默认技能包发现修复的新构建；不能仅凭 `2.3.0` 版本号判断兼容。
+Codex 插件 0.1.1 已通过原生安装及真实 Quicker Debug 草稿编写、保存和预览验收，Cursor、Claude Code 与通用 MCP 安装器现由同一共享源码生成。使用前确认 Quicker 的设置 → Agent 中有「启用 MCP」入口，并使用包含默认技能包发现修复的新构建；不能仅凭 `2.3.0` 版本号判断兼容。
 
 Release 支持已实现，待包含这些变更的正式版发布；已发布旧版没有 MCP 入口时仍不可用。新构建的 Debug / Release 均默认关闭 MCP，由用户在设置中启用；安装插件不会开启服务或写入权限。具体构建、测试与正式发布情况见[兼容性说明](兼容性.md)。
 

diff --git a/docs/新增平台.md b/docs/新增平台.md
@@ -1,6 +1,6 @@
 # 新增 Agent 平台
 
-本仓库在 `plugins/` 下放置完整安装单元，由各平台市场清单声明路径；当前 Codex 使用 `plugins/quicker/`。共同语义遵循[接入约定](接入约定.md)。Cursor 仅为规划；增加目录或配置示例不等于平台已经支持。
+本仓库在 `plugins/` 下放置完整安装单元，由各平台市场清单声明路径；当前 Codex 使用 `plugins/quicker/`。共同语义遵循[接入约定](接入约定.md)。现有 Cursor / Claude 包可作平台清单示例；增加目录或配置示例不等于真实客户端已经验收。
 
 ## 先确认接入方式
 
@@ -27,7 +27,7 @@
 
 ## 共享的时机
 
-当前转接脚本保留在 Codex 包内。出现第二个实际消费者后，再按已有差异提取公共实现：优先共享 MCP 转接和契约测试，清单、平台身份、安装器及客户端重载提示仍留在平台层。
+当前 shared/ 保存转接与技能唯一源码，sync-packages.py 复制到 Codex / Cursor / Claude / 通用 MCP 安装单元。平台身份由受限 Client 参数指定；清单与重载方式各自维护。
 
 若提取到 `shared/`，指定唯一源码，通过一个确定的打包步骤复制到各安装单元；验证复制结果与源码一致，并测试最终包。不要手工维护多份转接实现，也不要为尚未开发的平台预建抽象框架。
 

diff --git a/plugins/quicker-claude/.claude-plugin/plugin.json b/plugins/quicker-claude/.claude-plugin/plugin.json
@@ -0,0 +1,10 @@
+{
+  "name": "quicker",
+  "version": "0.2.0",
+  "description": "通过本机 Quicker MCP 编写、保存和预览自动化动作。",
+  "author": {
+    "name": "QuickerOrg"
+  },
+  "license": "MIT",
+  "repository": "https://github.com/QuickerOrg/quicker-agent-integrations"
+}
diff --git a/plugins/quicker-claude/.mcp.json b/plugins/quicker-claude/.mcp.json
@@ -0,0 +1,18 @@
+{
+  "mcpServers": {
+    "quicker": {
+      "command": "powershell.exe",
+      "args": [
+        "-NoLogo",
+        "-NoProfile",
+        "-NonInteractive",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-File",
+        "${CLAUDE_PLUGIN_ROOT}/scripts/quicker-mcp.ps1",
+        "-Client",
+        "claude"
+      ]
+    }
+  }
+}
diff --git a/plugins/quicker-claude/README.md b/plugins/quicker-claude/README.md
@@ -0,0 +1,9 @@
+# Quicker claude 接入包
+
+Windows PowerShell 5.1 + 支持 MCP 的本机 Quicker。此目录是完整运行单元，不依赖开发检出。
+
+安装、更新、卸载和实测兼容状态见 [公开仓库](https://github.com/QuickerOrg/quicker-agent-integrations#readme) 与 [客户端安装](https://github.com/QuickerOrg/quicker-agent-integrations/blob/main/docs/客户端安装.md)。
+
+启用 Quicker 设置 → Agent 中的 MCP 与允许写入，然后重新加载客户端并完成 Quicker 客户端授权。插件读取实时动作知识，默认把结果保存到暂存区；安装本身不授予执行或覆盖权限。运行时不需要 Git、Python 或 Node。
+
+传输脚本与技能由 shared/ 生成；维护时运行 scripts/sync-packages.py，不手工修改副本。