151 lines
4.9 KiB
YAML
151 lines
4.9 KiB
YAML
# ============================================================
|
||
# AgentDock 适配器 · Qwen Code（阿里巴巴）（Wave 3）
|
||
# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md + 架构 §3.3 + 真机实测
|
||
# 真机：qwen --version → 0.21.15；配置 ~/.qwen/settings.json（JSON，env/modelProviders/model）
|
||
# ============================================================
|
||
id: qwen
|
||
name: Qwen Code
|
||
name_zh: Qwen Code
|
||
vendor: 阿里巴巴
|
||
status: available
|
||
adapter_version: 1.1.0
|
||
license: Apache-2.0
|
||
|
||
platforms:
|
||
windows:
|
||
architectures: [x64]
|
||
notes: 原生支持（npm / 阿里 OSS 独立脚本，非 WSL）
|
||
linux:
|
||
distributions: [ubuntu]
|
||
architectures: [x64]
|
||
|
||
official:
|
||
homepage: https://github.com/QwenLM/qwen-code
|
||
docs: https://qwen.ai/
|
||
allowed_hosts: [registry.npmjs.org, github.com, qwen.ai, dashscope.aliyuncs.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, "@qwen-code/qwen-code"]
|
||
package: "@qwen-code/qwen-code"
|
||
elevate: never
|
||
post_checks: [detect]
|
||
|
||
detect:
|
||
executable: qwen
|
||
version_args: ["--version"]
|
||
version_regex: "^v?(\\d+\\.\\d+\\.\\d+)"
|
||
|
||
update:
|
||
method: npm_update
|
||
command: [npm, update, -g, "@qwen-code/qwen-code"]
|
||
source:
|
||
kind: npm
|
||
package: "@qwen-code/qwen-code"
|
||
|
||
uninstall:
|
||
method: npm_uninstall
|
||
command: [npm, uninstall, -g, "@qwen-code/qwen-code"]
|
||
keep_config_default: true
|
||
|
||
authorization:
|
||
modes:
|
||
- mode: api_key
|
||
env_keys: [DASHSCOPE_API_KEY]
|
||
notes_zh: 免费 OAuth 已停用（qwen auth 命令已移除），仅支持 API Key（阿里云百炼 DashScope；也可在 settings.json 接 OpenAI 兼容端点）
|
||
|
||
# 配置机制（真机 ~/.qwen/settings.json，JSON）：model.name / model.baseUrl 设默认模型；
|
||
# env 块注入环境变量（API Key）；modelProviders 接多 provider（含 OpenAI 兼容端点）。
|
||
configuration:
|
||
files:
|
||
- path: "~/.qwen/settings.json"
|
||
format: json
|
||
scope: user
|
||
environment:
|
||
- key: DASHSCOPE_API_KEY
|
||
sensitive: true
|
||
maps_to_field: api_key
|
||
fields:
|
||
- id: model.name
|
||
label_zh: 默认模型
|
||
group: common
|
||
help_zh: 官方键 model.name，settings.json 中的默认模型
|
||
required: false
|
||
sensitive: false
|
||
type: string
|
||
storage: file
|
||
docs_url: https://qwen.ai/
|
||
- id: model.baseUrl
|
||
label_zh: Base URL
|
||
group: advanced
|
||
help_zh: 官方键 model.baseUrl，默认模型服务端点（OpenAI 兼容网关/代理场景）
|
||
required: false
|
||
sensitive: false
|
||
type: url
|
||
storage: file
|
||
docs_url: https://qwen.ai/
|
||
- id: api_key
|
||
label_zh: API Key
|
||
group: auth
|
||
help_zh: 存入系统密钥库（对应环境变量 DASHSCOPE_API_KEY，阿里云百炼申请）
|
||
required: false
|
||
sensitive: true
|
||
type: string
|
||
storage: keyring
|
||
docs_url: https://qwen.ai/
|
||
|
||
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: 安装后配置 API Key，用 `qwen -p "提示词"` 无头执行，或 `qwen` 进入交互会话。
|
||
install_zh: 推荐 `npm install -g @qwen-code/qwen-code`（需 Node 22+）；也可用 `npx @qwen-code/qwen-code` 临时试用。阿里 OSS 独立脚本见官方文档。
|
||
auth_zh: 仅支持 API Key：免费 OAuth 已停用（`qwen auth` 命令已移除）。请在阿里云百炼（DashScope）申请 API Key 后粘贴保存（经 DASHSCOPE_API_KEY 注入）；也可在 settings.json 的 modelProviders 接 OpenAI 兼容端点（自定义 envKey）。
|
||
commands:
|
||
- cmd: qwen
|
||
desc_zh: 启动交互式会话
|
||
- cmd: qwen -p "提示词"
|
||
desc_zh: 无头单次执行
|
||
- cmd: qwen -m <模型>
|
||
desc_zh: 指定模型
|
||
- cmd: qwen -o json -p "提示词"
|
||
desc_zh: 以 JSON 输出
|
||
- cmd: qwen --version
|
||
desc_zh: 显示版本号
|
||
- cmd: qwen update
|
||
desc_zh: 检查并安装更新
|
||
- cmd: qwen sessions
|
||
desc_zh: 管理会话
|
||
- cmd: npx @qwen-code/qwen-code
|
||
desc_zh: 免安装临时运行
|
||
params:
|
||
- param: -p / --prompt
|
||
desc_zh: 无头模式单次执行
|
||
- param: -m / --model
|
||
desc_zh: 指定模型
|
||
- param: -o / --output-format
|
||
desc_zh: 输出格式（text / json / stream-json）
|
||
- param: -s / --sandbox
|
||
desc_zh: 沙箱执行
|
||
- param: -c / --continue
|
||
desc_zh: 续接最近会话
|
||
- param: -v / --version
|
||
desc_zh: 显示版本号
|
||
updated_at: "2026-08-25"
|
||
risks_zh:
|
||
- 免费 OAuth 已停用，仅支持 API Key（真机 `qwen auth` 命令显示 removed）
|
||
- 真机 `qwen --version` 返回 0.21.15，版本检测已据此确认
|
||
- modelProviders 多 provider / env 块自定义 envKey 等高级配置本表单不覆盖，以官方文档为准
|