# ============================================================
# 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 安装