Wave 2: 五件套打通全链路（安装/检测/配置/授权/诊断）

- 五个适配器 YAML 全字段补齐（codex/claude-code/gemini/kimi/opencode） - agentdock-config：TOML/JSON 编解码 + 原子写 + 自动备份 - agentdock-diag：PATH/依赖版本/版本冲突/配置损坏四类规则 - agentdock-core：detectCli/previewAction/runAction 流式/readConfig/writeConfig/authStatus/diagnose - Tauri IPC 命令 + CLI 详情页/安装确认弹窗/配置表单/诊断页 - cargo test 75 项通过（含 4 项真机 ignored 自测），前端 build 通过
2026-08-25 08:58:38 +08:00
parent c47494180b
commit 01996a80fe
33 changed files with 9404 additions and 152 deletions
@@ -1,28 +1,136 @@
 # ============================================================
-# 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 适配器 · Kimi CLI（月之暗面 Moonshot）（Wave 2 全字段）
+# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md（Kimi 章节）+ 架构 §3.3
+# 铁律：只走官方 code.kimi.com 脚本 / PyPI kimi-cli，严禁 npm（仿名包）。
 # ============================================================
 id: kimi
 name: Kimi CLI
 name_zh: Kimi CLI
 vendor: 月之暗面
 status: available
+adapter_version: 1.0.0
+license: Apache-2.0
+
+platforms:
+  windows:
+    architectures: [x64]
+    notes: 原生支持（PowerShell 脚本安装，非 WSL）
+  linux:
+    distributions: [ubuntu]
+    architectures: [x64]
+
+official:
+  homepage: https://github.com/MoonshotAI/kimi-cli
+  docs: https://moonshotai.github.io/kimi-cli/en/guides/getting-started.html
+  allowed_hosts: [code.kimi.com, pypi.org, github.com]
+
+runtime_deps:
+  - id: uv
+    semver_range: ">=0"
+    required_for: [install]
+  - id: python
+    semver_range: ">=3.12"
+    required_for: [run]
+
+install:
+  preferred: pypi_uv
+  channels:
+    - id: pypi_uv
+      platforms: [windows, linux]
+      command: [uv, tool, install, kimi-cli]
+      package: kimi-cli
+      elevate: never
+      post_checks: [detect]
+    - id: official_script
+      platforms: [windows]
+      script:
+        url: https://code.kimi.com/install.ps1
+        kind: powershell_irm
+      elevate: never
+      post_checks: [detect]
+    - id: official_script
+      platforms: [linux]
+      script:
+        url: https://code.kimi.com/install.sh
+        kind: bash_pipe
+      elevate: never
+      post_checks: [detect]
+
+detect:
+  executable: kimi
+  version_args: ["--version"]
+
+update:
+  method: pypi_upgrade
+  command: [uv, tool, upgrade, kimi-cli]
+
+uninstall:
+  method: package_manager
+  command: [uv, tool, uninstall, kimi-cli]
+  keep_config_default: true
+
+authorization:
+  modes:
+    - mode: browser_oauth
+      command: [kimi, login]
+      notes_zh: Kimi Code 浏览器 OAuth（推荐）
+    - mode: api_key
+      env_keys: [KIMI_API_KEY]
+      notes_zh: Moonshot 开放平台 API Key
+
+configuration:
+  files:
+    - path: "~/.kimi/config.toml"
+      format: toml
+      scope: user
+  environment:
+    - key: KIMI_API_KEY
+      sensitive: true
+      maps_to_field: api_key
+    - key: KIMI_BASE_URL
+      sensitive: false
+      maps_to_field: base_url
+  fields:
+    - id: default_model
+      label_zh: 默认模型
+      help_zh: Kimi CLI 使用的默认模型
+      required: false
+      sensitive: false
+      type: string
+      storage: file
+    - id: env.KIMI_BASE_URL
+      label_zh: Base URL
+      help_zh: 自定义 OpenAI 兼容端点
+      required: false
+      sensitive: false
+      type: url
+      storage: file
+    - id: api_key
+      label_zh: API Key
+      help_zh: 存入系统密钥库（对应 KIMI_API_KEY）
+      required: false
+      sensitive: true
+      type: string
+      storage: keyring
+
+diagnostics:
+  - rule_id: path.not_installed
+  - rule_id: path.not_in_path
+  - rule_id: dependency.uv
+  - rule_id: dependency.python_below_min
+  - rule_id: version_conflict.multiple_copies
+  - rule_id: config.corrupt
+
+documentation:
+  quickstart_zh: 安装后运行 `kimi login` 登录，或用 `kimi -p "提示词"` 无头执行。
+  commands:
+    - cmd: kimi
+      desc_zh: 启动交互式会话
+    - cmd: kimi login
+      desc_zh: 登录（浏览器 OAuth 或 API Key）
+    - cmd: kimi -p "提示词"
+      desc_zh: 无头单次执行
+  updated_at: "2026-08-24"
+  risks_zh:
+    - 严禁 npm：npm 上的 kimi-code 是第三方仿名包，与月之暗面无关
+    - 官方脚本会自动安装 uv 并从 PyPI kimi-cli 安装