# ============================================================
# AgentDock 适配器 · CodeBuddy Code（腾讯）（Wave 3）
# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md + 架构 §3.3 + 真机实测
# 真机：codebuddy --version → 2.132.0；配置 ~/.codebuddy/settings.json（JSON，实测补齐）
# 双升级路径：npm（@tencent-ai/codebuddy-code）/ 原生（codebuddy install stable）
# ============================================================
id: codebuddy
name: CodeBuddy Code
name_zh: CodeBuddy Code
vendor: 腾讯
status: available
adapter_version: 1.1.0
license: 专有（仅官方渠道安装、不重打包）

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

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

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

install:
  preferred: npm
  channels:
    - id: npm
      platforms: [windows, linux]
      command: [npm, install, -g, "@tencent-ai/codebuddy-code"]
      package: "@tencent-ai/codebuddy-code"
      elevate: never
      post_checks: [detect]
    - id: official_script
      platforms: [windows, linux]
      command: [codebuddy, install, stable]
      package: codebuddy-native
      elevate: never
      post_checks: [detect]

detect:
  executable: codebuddy
  version_args: ["--version"]
  version_regex: "^v?(\\d+\\.\\d+\\.\\d+)"

update:
  method: npm_update
  command: [npm, update, -g, "@tencent-ai/codebuddy-code"]
  source:
    kind: npm
    package: "@tencent-ai/codebuddy-code"

uninstall:
  method: npm_uninstall
  command: [npm, uninstall, -g, "@tencent-ai/codebuddy-code"]
  keep_config_default: true

authorization:
  modes:
    - mode: browser_oauth
      command: [codebuddy]
      notes_zh: 运行 codebuddy 后按提示用微信扫码登录（也可在会话中输入 /login）
    - mode: local_tui
      command: [codebuddy]
      notes_zh: 在一次性终端窗口内完成微信扫码登录

# 配置机制（真机实测补齐）：~/.codebuddy/settings.json（JSON）。
# 官方未披露配置文件位置，本波真机定位到 ~/.codebuddy/settings.json；
# 主要配置经 `codebuddy config set [-g] <key> <value>` 管理，API Key 未确认（以微信登录为主）。
configuration:
  files:
    - path: "~/.codebuddy/settings.json"
      format: json
      scope: user
  environment: []
  fields:
    - id: model
      label_zh: 默认模型
      group: common
      help_zh: 默认模型 ID（对应 --model 参数，如 deepseek-v4-pro / glm-5.3 等）；可用 `codebuddy config set -g model <id>` 设置
      required: false
      sensitive: false
      type: string
      storage: file
      docs_url: https://codebuddy.ai/docs
    - id: theme
      label_zh: 主题
      group: common
      help_zh: 界面主题（对应 `codebuddy config set -g theme <dark|light>`）
      required: false
      sensitive: false
      type: enum
      storage: file
      docs_url: https://codebuddy.ai/docs
      options:
        - value: dark
          label_zh: 深色
        - value: light
          label_zh: 浅色
    - id: sandbox.enabled
      label_zh: 沙箱模式
      group: advanced
      help_zh: 官方键 sandbox.enabled，是否启用沙箱（默认关闭）
      required: false
      sensitive: false
      type: bool
      storage: file
      docs_url: https://codebuddy.ai/docs

models:
  list:
    - id: deepseek-v4-pro
      label_zh: DeepSeek V4 Pro
    - id: glm-5.3
      label_zh: GLM 5.3

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: 安装后运行 `codebuddy` 微信扫码登录，或用 `codebuddy -p "提示词"` 无头执行。
  install_zh: 双升级路径：① npm `@tencent-ai/codebuddy-code`（本适配器默认渠道，需 Node 22+）；② 原生线 `codebuddy install stable`。两线均走官方渠道，不重打包。
  auth_zh: 微信扫码登录（运行 `codebuddy` 后按提示，或在会话中输入 /login）。API Key 官方未确认，本适配器不提供。
  commands:
    - cmd: codebuddy
      desc_zh: 启动交互式会话
    - cmd: codebuddy -p "提示词"
      desc_zh: 无头单次执行（--print）
    - cmd: codebuddy --output-format json -p "提示词"
      desc_zh: 以 JSON 输出
    - cmd: codebuddy --model <模型>
      desc_zh: 指定模型
    - cmd: codebuddy config set -g theme dark
      desc_zh: 修改全局配置项
    - cmd: codebuddy install stable
      desc_zh: 安装原生线稳定版
    - cmd: codebuddy update
      desc_zh: 检查并安装更新
    - cmd: codebuddy doctor
      desc_zh: 自更新健康检查
  params:
    - param: -p / --print
      desc_zh: 无头模式，执行后退出
    - param: --output-format
      desc_zh: 输出格式（text / json / stream-json）
    - param: --model
      desc_zh: 指定模型 ID
    - param: -c / --continue
      desc_zh: 续接最近会话
    - param: -y / --dangerously-skip-permissions
      desc_zh: 跳过权限检查（仅限无外网沙箱）
  updated_at: "2026-08-25"
  risks_zh:
    - 配置路径官方未披露，本波真机实测定位到 ~/.codebuddy/settings.json
    - API Key 官方未确认，本适配器仅提供微信登录，不提供 API Key 配置
    - 专有许可：只引导官方渠道安装，不重打包、不修改二进制