Wave 3: 补齐九个适配器（Qwen/CodeBuddy/Cline/Copilot/Crush/Goose/Aider/Cursor/Warp）

Co-authored-by: multica-agent <github@multica.ai>
2026-08-25 19:13:37 +08:00
parent 4a2be5899d
commit b0d7124170
13 changed files with 1345 additions and 193 deletions
@@ -1,28 +1,156 @@
 # ============================================================
-# AgentDock 适配器占位（Wave 1，对齐架构 §3.1 完整 schema）
-# 本波仅填五字段（id/name/name_zh/vendor/status）；其余字段留空，
-# Wave 2 起按调研底稿 agent-cli-survey-2026-08-24.md 逐项填充，禁止编造。
-#
-# 完整字段（全部留空占位，Wave 2 填写）：
-#   adapter_version    # semver，如 1.2.0
-#   license            # 展示用；专有许可注明「仅官方渠道安装、不重打包」
-#   platforms          # windows/linux：architectures、notes、min_ubuntu
-#   official           # homepage / docs / allowed_hosts（网络白名单）
-#   runtime_deps       # [ { id, semver_range, required_for: [install|run] } ]
-#   install            # preferred + channels[ {id, platforms, command[], script, package, elevate, elevate_reason_zh, post_checks} ]
-#   detect             # executable / version_args / version_regex / version_unconfirmed / path_hints
-#   update             # method + command[]
-#   uninstall          # method + command[] + keep_config_default
-#   authorization      # modes[ {mode, command[], env_keys[], status_command[], notes_zh} ]
-#   configuration      # files[] / environment[] / fields[]
-#   diagnostics        # [ { rule_id } ]
-#   documentation      # quickstart_zh / commands[] / updated_at / risks_zh[]
-#
-# 铁律：所有 command 一律 argv 数组，禁止 shell 元字符（| & ; $ \ > < (`）；
-#       本波不实现任何真实安装/检测/配置/授权命令（那是 Wave 2 的事）。
+# AgentDock 适配器 · Cursor CLI（Wave 3）
+# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md + 架构 §3.3 + 真机实测
+# 真机：agent --version → 2026.08.11-e8db854；配置 ~/.cursor/cli-config.json（JSON）。
+# 铁律：命令名是 `agent`（不是 cursor-agent）；只有官方脚本渠道，无 npm。
 # ============================================================
 id: cursor
 name: Cursor CLI
 name_zh: Cursor CLI
 vendor: Cursor
 status: available
+adapter_version: 1.1.0
+license: 专有（仅官方渠道安装、不重打包）
+
+platforms:
+  windows:
+    architectures: [x64]
+    notes: 仅官方脚本渠道；命令名为 agent
+  linux:
+    distributions: [ubuntu]
+    architectures: [x64]
+
+official:
+  homepage: https://cursor.com
+  docs: https://cursor.com/docs/cli
+  allowed_hosts: [cursor.com, api2.cursor.sh]
+
+runtime_deps: []
+
+install:
+  preferred: official_script
+  channels:
+    - id: official_script
+      platforms: [windows]
+      script:
+        url: https://cursor.com/install.ps1
+        kind: powershell_irm
+      elevate: never
+      post_checks: [detect]
+    - id: official_script
+      platforms: [linux]
+      script:
+        url: https://cursor.com/install.sh
+        kind: bash_pipe
+      elevate: never
+      post_checks: [detect]
+
+detect:
+  executable: agent
+  version_args: ["--version"]
+  version_regex: "^(\\d{4}\\.\\d{2}\\.\\d{2})"
+  path_hints:
+    - "%LOCALAPPDATA%\\cursor-agent\\agent.cmd"
+
+update:
+  method: self_update_cmd
+  command: [agent, update]
+
+uninstall:
+  method: manual_delete
+  command: []
+  keep_config_default: true
+
+authorization:
+  modes:
+    - mode: browser_oauth
+      command: [agent, login]
+      status_command: [agent, status]
+      notes_zh: 浏览器登录 Cursor 账号（NO_OPEN_BROWSER 可禁用自动打开浏览器）
+    - mode: api_key
+      env_keys: [CURSOR_API_KEY]
+      notes_zh: API Key（CURSOR_API_KEY 环境变量或 --api-key 参数）
+
+# 配置机制（真机实测）：~/.cursor/cli-config.json（JSON）。
+# 账户体系为主（authInfo 存 OAuth 登录态）；model.modelId / approvalMode 可经文件或 agent 命令调整。
+configuration:
+  files:
+    - path: "~/.cursor/cli-config.json"
+      format: json
+      scope: user
+  environment:
+    - key: CURSOR_API_KEY
+      sensitive: true
+      maps_to_field: api_key
+  fields:
+    - id: model.modelId
+      label_zh: 默认模型
+      group: common
+      help_zh: 官方键 model.modelId，默认模型（真机为 default，即 auto）
+      required: false
+      sensitive: false
+      type: string
+      storage: file
+      docs_url: https://cursor.com/docs/cli
+    - id: approvalMode
+      label_zh: 审批模式
+      group: advanced
+      help_zh: 官方键 approvalMode（allowlist / yolo / default 等）
+      required: false
+      sensitive: false
+      type: string
+      storage: file
+      docs_url: https://cursor.com/docs/cli
+    - id: api_key
+      label_zh: API Key
+      group: auth
+      help_zh: 存入系统密钥库（对应 CURSOR_API_KEY 环境变量；一般用账号登录即可，无需 API Key）
+      required: false
+      sensitive: true
+      type: string
+      storage: keyring
+      docs_url: https://cursor.com/docs/cli
+
+diagnostics:
+  - rule_id: path.not_installed
+  - rule_id: path.not_in_path
+  - rule_id: version_conflict.multiple_copies
+  - rule_id: config.corrupt
+
+documentation:
+  quickstart_zh: 安装后运行 `agent login` 登录 Cursor 账号，或用 `agent -p "提示词"` 无头执行。
+  install_zh: 仅官方脚本渠道（Windows install.ps1 / Linux install.sh），无 npm。`agent` 命令随 Cursor 安装（也可在 Cursor 内「Install agent command」）。
+  auth_zh: ① 浏览器登录：`agent login`（`agent status` 查看状态）；② API Key：CURSOR_API_KEY 环境变量或 --api-key。
+  commands:
+    - cmd: agent
+      desc_zh: 启动交互式会话
+    - cmd: agent -p "提示词"
+      desc_zh: 无头单次执行
+    - cmd: agent login
+      desc_zh: 浏览器登录 Cursor 账号
+    - cmd: agent status
+      desc_zh: 查看认证状态
+    - cmd: agent --model <模型>
+      desc_zh: 指定模型
+    - cmd: agent update
+      desc_zh: 更新到最新版
+    - cmd: agent --list-models
+      desc_zh: 列出可用模型
+    - cmd: agent --version
+      desc_zh: 显示版本号
+  params:
+    - param: -p / --print
+      desc_zh: 无头模式执行后退出
+    - param: --model
+      desc_zh: 指定模型
+    - param: --output-format
+      desc_zh: 输出格式（text / json / stream-json）
+    - param: --sandbox
+      desc_zh: 沙箱模式（enabled / disabled）
+    - param: --list-models
+      desc_zh: 列出可用模型
+  updated_at: "2026-08-25"
+  risks_zh:
+    - 命令名是 `agent`（不是 cursor-agent），detect 以 agent 为准
+    - 真机 `agent --version` 返回日期式版本 2026.08.11-e8db854（version_regex 已据此填写）
+    - 账户体系为主，cli-config.json 高级键本表单只覆盖常用项，以官方文档为准