Wave 3.1：老板十项返工（kimi 换代 kimi-code/授权检测/可更新判定/模型列表+测试连通/系统环境诊断/外链/命令复制/官方图标主色）

Co-authored-by: multica-agent <github@multica.ai>
2026-08-25 22:52:33 +08:00
parent 0cec468ae6
commit b19efef0f3
30 changed files with 1594 additions and 124 deletions
@@ -1,57 +1,52 @@
 # ============================================================
-# AgentDock 适配器 · Kimi CLI（月之暗面 Moonshot）（Wave 2.1）
-# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md（Kimi 章节）+ 架构 §3.3
-# 铁律：只走官方 code.kimi.com 脚本 / PyPI kimi-cli，严禁 npm（仿名包）。
+# AgentDock 适配器 · Kimi Code CLI（月之暗面 Moonshot）（Wave 3.1 换代）
+# 换代依据：老板实测官方现行安装已切换至 kimi-code 线，本适配器弃用旧 kimi-cli（PyPI）线。
+# 核对来源（当日官方页面为准，2026-08-25）：
+#   - 仓库/README：https://github.com/MoonshotAI/kimi-code
+#   - 官方文档：https://moonshotai.github.io/kimi-code/en/
+#   - 配置：https://moonshotai.github.io/kimi-code/en/configuration/config-files.html
+#   - 数据位置：https://moonshotai.github.io/kimi-code/en/configuration/data-locations.html
 # ============================================================
 id: kimi
-name: Kimi CLI
-name_zh: Kimi CLI
+name: Kimi Code CLI
+name_zh: Kimi Code CLI
 vendor: 月之暗面
 status: available
-adapter_version: 1.1.0
-license: Apache-2.0
+adapter_version: 1.2.0
+license: MIT

 platforms:
  windows:
    architectures: [x64]
-    notes: 原生支持（PowerShell 脚本安装，非 WSL）
+    notes: 原生支持（官方 PowerShell 脚本安装，需 Git for Windows 作 shell 环境）
  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]
+  homepage: https://github.com/MoonshotAI/kimi-code
+  docs: https://moonshotai.github.io/kimi-code/en/
+  allowed_hosts: [code.kimi.com, moonshotai.github.io, github.com, api.github.com, api.kimi.com, api.moonshot.cn]

 runtime_deps:
-  - id: uv
+  - id: git
    semver_range: ">=0"
-    required_for: [install]
-  - id: python
-    semver_range: ">=3.12"
    required_for: [run]

 install:
-  preferred: pypi_uv
+  preferred: official_script
  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
+        url: https://code.kimi.com/kimi-code/install.ps1
        kind: powershell_irm
      elevate: never
      post_checks: [detect]
    - id: official_script
      platforms: [linux]
      script:
-        url: https://code.kimi.com/install.sh
+        url: https://code.kimi.com/kimi-code/install.sh
        kind: bash_pipe
      elevate: never
      post_checks: [detect]
@@ -61,110 +56,126 @@ detect:
  version_args: ["--version"]

 update:
-  method: pypi_upgrade
-  command: [uv, tool, upgrade, kimi-cli]
+  method: manual
+  command: []
+  source:
+    kind: github
+    repo: MoonshotAI/kimi-code

 uninstall:
-  method: package_manager
-  command: [uv, tool, uninstall, kimi-cli]
+  method: manual_delete
+  command: []
  keep_config_default: true

 authorization:
  modes:
    - mode: browser_oauth
-      command: [kimi, login]
-      notes_zh: Kimi Code 浏览器 OAuth（推荐）
+      command: [kimi]
+      notes_zh: 运行 kimi 后在界面输入 /login，选 Kimi Code OAuth（推荐）
    - mode: api_key
-      env_keys: [KIMI_API_KEY]
-      notes_zh: Moonshot 开放平台 API Key
+      notes_zh: Moonshot 开放平台 API Key（官方写入 config.toml providers；AgentDock 密钥存系统密钥库）
+  credential_files:
+    - "~/.kimi-code/credentials"
+  test:
+    url: https://api.moonshot.cn/v1/models
+    key_header: Authorization
+    bearer: true

-# 配置机制（调研底稿 Kimi 章节）：~/.kimi/config.toml（TOML，兼容 JSON）
-# 可配 default_model、providers（type/base_url/api_key）、models 等；
-# 环境变量：KIMI_API_KEY / KIMI_BASE_URL / KIMI_MODEL_NAME / KIMI_MODEL_TEMPERATURE。
+# 配置机制（官方 config-files 文档）：~/.kimi-code/config.toml（TOML，snake_case）
+# 常用字段：default_model / default_permission_mode（manual|yolo|auto）/ default_plan_mode；
+# providers 表（type/base_url/api_key）、models 表（模型别名）。默认模型别名必须定义在 models 表。
+# 环境变量：KIMI_CODE_HOME（数据目录）、KIMI_MODEL_*（临时模型），密钥不自动从 shell 环境变量读取。
 configuration:
  files:
-    - path: "~/.kimi/config.toml"
+    - path: "~/.kimi-code/config.toml"
      format: toml
      scope: user
-  environment:
-    - key: KIMI_API_KEY
-      sensitive: true
-      maps_to_field: api_key
+  environment: []
  fields:
    - id: default_model
      label_zh: 默认模型
      group: common
-      help_zh: 官方键 default_model，Kimi CLI 使用的默认模型
+      help_zh: 官方键 default_model（模型别名，须已在 models 表定义），如 kimi-code/k3
      required: false
      sensitive: false
      type: string
      storage: file
-      docs_url: https://moonshotai.github.io/kimi-cli/en/configuration/config-files.html
-    - id: env.KIMI_BASE_URL
-      label_zh: Base URL
+      docs_url: https://moonshotai.github.io/kimi-code/en/configuration/config-files.html
+    - id: default_permission_mode
+      label_zh: 权限模式
      group: advanced
-      help_zh: 官方环境变量 KIMI_BASE_URL（自定义 OpenAI 兼容端点）；写入 config.toml 的 env 表，若需进程级生效请以官方 env-vars 文档为准
+      help_zh: 官方键 default_permission_mode，新会话默认权限模式
      required: false
      sensitive: false
-      type: url
+      type: enum
      storage: file
-      docs_url: https://moonshotai.github.io/kimi-cli/en/configuration/env-vars.html
+      docs_url: https://moonshotai.github.io/kimi-code/en/configuration/config-files.html
+      options:
+        - value: manual
+          label_zh: 手动确认（每次询问）
+        - value: yolo
+          label_zh: 自动放行（可能仍会提问）
+        - value: auto
+          label_zh: 全自动（自主决定）
    - id: api_key
      label_zh: API Key
      group: auth
-      help_zh: 存入系统密钥库（对应环境变量 KIMI_API_KEY，Moonshot 开放平台获取）
+      help_zh: 存入系统密钥库（Moonshot 开放平台 API Key；官方也支持写入 config.toml providers.api_key，AgentDock 密钥不落明文）
      required: false
      sensitive: true
      type: string
      storage: keyring
-      docs_url: https://moonshotai.github.io/kimi-cli/en/configuration/env-vars.html
+      docs_url: https://moonshotai.github.io/kimi-code/en/configuration/config-files.html
+
+# 模型清单（官方 config-files 示例中 /login 预置的 managed:kimi-code 别名）
+models:
+  list:
+    - id: kimi-code/k3
+      label_zh: K3（旗舰推理）
+    - id: kimi-code/kimi-for-coding
+      label_zh: Kimi for Coding（均衡）
+    - id: kimi-code/kimi-for-coding-highspeed
+      label_zh: Kimi for Coding 高速版

 diagnostics:
  - rule_id: path.not_installed
  - rule_id: path.not_in_path
-  - rule_id: dependency.uv
-  - rule_id: dependency.python_below_min
+  - rule_id: dependency.git
  - rule_id: version_conflict.multiple_copies
  - rule_id: config.corrupt

 documentation:
-  quickstart_zh: 安装后运行 `kimi login` 登录，或用 `kimi -p "提示词"` 无头执行。
-  install_zh: 只走官方渠道：`uv tool install kimi-cli`（本适配器默认）或官方脚本 code.kimi.com/install.sh（install.ps1）。脚本会自动装 uv 并从 PyPI kimi-cli 安装。严禁 npm（npm 上的 kimi-code 是第三方仿名包）。
-  auth_zh: ① Kimi Code 浏览器 OAuth（推荐，`kimi login`）；② Moonshot 开放平台 API Key（platform 侧获取后粘贴，经 KIMI_API_KEY 注入）。`kimi logout` 清除 OAuth 凭据。
+  quickstart_zh: 安装后运行 `kimi` 进入交互界面，首次启动输入 `/login` 选 Kimi Code OAuth 或 Moonshot API Key；也可 `kimi -p "提示词"` 无头执行。
+  install_zh: 只走官方脚本：Windows `irm https://code.kimi.com/kimi-code/install.ps1 | iex`，macOS/Linux `curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash`（单二进制发行，无需 Node.js）。Windows 首次启动前需装 Git for Windows（作 shell 环境）。
+  auth_zh: ① Kimi Code OAuth（推荐，TUI 内 /login）；② Moonshot 开放平台 API Key。登录凭据存于 `~/.kimi-code/credentials/`，/logout 清除。
  commands:
    - cmd: kimi
-      desc_zh: 启动交互式会话
-    - cmd: kimi login
-      desc_zh: 登录（浏览器 OAuth 或 API Key）
-    - cmd: kimi logout
-      desc_zh: 清除 OAuth 凭据
+      desc_zh: 启动交互式会话（TUI）
    - cmd: kimi -p "提示词"
-      desc_zh: 无头单次执行
-    - cmd: kimi --output-format stream-json -p "提示词"
-      desc_zh: print 模式 JSON 流输出
-    - cmd: kimi --quiet
-      desc_zh: 静默模式
+      desc_zh: 无头单次执行（print 模式）
    - cmd: kimi --version
      desc_zh: 显示版本号
-    - cmd: kimi info
-      desc_zh: 显示版本与协议信息
    - cmd: kimi acp
      desc_zh: IDE 集成 stdio（ACP 协议）
+    - cmd: /login
+      desc_zh: 登录（Kimi Code OAuth 或 Moonshot API Key）
+    - cmd: /model
+      desc_zh: 切换模型
+    - cmd: /mcp-config
+      desc_zh: 配置 MCP 服务器
  params:
-    - param: -p / --prompt
-      desc_zh: 处理后退出（无头模式）
-    - param: --print
-      desc_zh: 打印模式
+    - param: -p / --print
+      desc_zh: 无头模式，执行后退出
    - param: --output-format
      desc_zh: 输出格式（如 stream-json）
+    - param: -m / --model
+      desc_zh: 指定模型别名
    - param: --quiet
      desc_zh: 静默模式
-    - param: --afk
-      desc_zh: 离键模式
-    - param: --config-file
-      desc_zh: 指定配置文件路径
+    - param: --session
+      desc_zh: 恢复指定会话
  updated_at: "2026-08-25"
  risks_zh:
-    - 严禁 npm：npm 上的 kimi-code 是第三方仿名包，与月之暗面无关
-    - 官方脚本会自动安装 uv 并从 PyPI kimi-cli 安装（Python 3.12–3.14）
-    - providers 表（type/base_url/api_key 多 provider）等高级配置本表单不覆盖，以官方 config-files 文档为准
+    - 已换代：旧 PyPI `kimi-cli` 线废止，官方现行安装为 kimi-code 脚本（本适配器 1.2.0 已改）
+    - 官方密钥不自动从 shell 环境变量读取，需写入 config.toml providers 表；AgentDock 密钥存系统密钥库（测试连通直连官方接口），OAuth 登录为推荐路径
+    - 模型别名与 providers/models 高级配置以官方 config-files 文档为准，本表单不覆盖