169 lines
5.5 KiB
YAML
169 lines
5.5 KiB
YAML
# ============================================================
|
||
# 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 配置
|
||
- 专有许可：只引导官方渠道安装，不重打包、不修改二进制
|