# ============================================================
# AgentDock 适配器 · Cline（Wave 3）
# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md + 架构 §3.3
# ============================================================
id: cline
name: Cline
name_zh: Cline
vendor: Cline
status: available
adapter_version: 1.1.0
license: Apache-2.0

platforms:
  windows:
    architectures: [x64]
    notes: 原生支持（npm，非 WSL）
  linux:
    distributions: [ubuntu]
    architectures: [x64]

official:
  homepage: https://github.com/cline/cline
  docs: https://docs.cline.bot/
  allowed_hosts: [registry.npmjs.org, github.com, docs.cline.bot]

runtime_deps:
  - id: node
    semver_range: ">=22"
    required_for: [install, run]

install:
  preferred: npm
  channels:
    - id: npm
      platforms: [windows, linux]
      command: [npm, install, -g, "cline"]
      package: cline
      elevate: never
      post_checks: [detect]
    - id: npm
      platforms: [windows, linux]
      command: [npm, install, -g, "cline@nightly"]
      package: cline
      elevate: never
      post_checks: [detect]

detect:
  executable: cline
  version_args: ["--version"]

update:
  method: npm_update
  command: [npm, update, -g, "cline"]
  source:
    kind: npm
    package: cline

uninstall:
  method: npm_uninstall
  command: [npm, uninstall, -g, "cline"]
  keep_config_default: true

authorization:
  modes:
    - mode: browser_oauth
      command: [cline]
      notes_zh: 运行 cline 后按提示浏览器登录（各家模型账号）
    - mode: api_key
      env_keys: [ANTHROPIC_API_KEY, OPENAI_API_KEY]
      notes_zh: 各家 API Key（存入系统钥匙串；Cline 密钥本就进系统 keychain）

# 配置机制（调研底稿 Cline 章节）：用户级 ~/.cline/data/settings/providers.json（JSON）。
# 密钥已用系统 keychain（与 AgentDock 密钥库策略一致）。
configuration:
  files:
    - path: "~/.cline/data/settings/providers.json"
      format: json
      scope: user
  environment:
    - key: ANTHROPIC_API_KEY
      sensitive: true
      maps_to_field: api_key
  fields:
    - id: api_key
      label_zh: API Key
      group: auth
      help_zh: 存入系统密钥库（对应 ANTHROPIC_API_KEY 等环境变量）
      required: false
      sensitive: true
      type: string
      storage: keyring
      docs_url: https://docs.cline.bot/

diagnostics:
  - rule_id: path.not_installed
  - rule_id: path.not_in_path
  - rule_id: dependency.node_below_min
  - rule_id: version_conflict.multiple_copies
  - rule_id: config.corrupt

documentation:
  quickstart_zh: 安装后运行 `cline` 登录，或用 `cline -p "提示词"` 无头执行。
  install_zh: 推荐 `npm install -g cline`（本适配器默认渠道，需 Node 22+）；另有 nightly 通道 `npm install -g cline@nightly`。
  auth_zh: ① 浏览器登录（运行 `cline` 后按提示）；② API Key（各家模型，存入系统钥匙串）；③ 本地模型（Ollama/LM Studio 等）。密钥本就进系统 keychain。
  commands:
    - cmd: cline
      desc_zh: 启动交互式会话
    - cmd: cline -p "提示词"
      desc_zh: 无头单次执行
    - cmd: cline --model <模型>
      desc_zh: 指定模型
    - cmd: cline --version
      desc_zh: 显示版本号
  params:
    - param: -p / --print
      desc_zh: 无头模式执行后退出
    - param: --model
      desc_zh: 指定模型
    - param: --allowedTools
      desc_zh: 预授权工具
    - param: --continue
      desc_zh: 续接最近会话
  updated_at: "2026-08-25"
  risks_zh:
    - 密钥存入系统 keychain（与 AgentDock 密钥库策略一致，不额外落明文）
    - providers.json 多 provider 高级配置本表单不覆盖，以官方文档为准