客户端示例
WorkBuddy
在 WorkBuddy 的自定义模型或 models.json 中接入 AsterMesh。
WorkBuddy 是腾讯云代码助手（CodeBuddy）团队推出的 AI Agent 办公工具，支持通过 OpenAI 兼容的 Chat Completions 接口添加自定义模型。
url 要填完整接口地址
WorkBuddy 的 url 字段与多数客户端不同：要填完整接口路径 https://console.astermesh.cn/v1/chat/completions，而不是只到 /v1 的 Base URL。
方式一：界面配置
- 打开 WorkBuddy，点击右上角账户菜单 → 设置 → 模型。
- 点击 添加模型，选择 自定义 模型。
- 填入接口地址、AsterMesh API Key 和控制台复制的模型 ID，保存。
方式二：models.json
配置文件路径（用户级）：
~/.workbuddy/models.json项目级配置 <项目根目录>/.workbuddy/models.json 优先级更高。写入：
{
"models": [
{
"id": "MODEL_ID",
"name": "AsterMesh Model",
"vendor": "Custom",
"url": "https://console.astermesh.cn/v1/chat/completions",
"apiKey": "${ASTERMESH_API_KEY}",
"maxInputTokens": 128000,
"maxOutputTokens": 8192,
"supportsToolCall": true,
"supportsImages": false
}
],
"availableModels": ["MODEL_ID"]
}把 MODEL_ID 换成控制台模型列表里的完整模型 ID。apiKey 支持 ${ASTERMESH_API_KEY} 环境变量引用语法，避免把明文 Key 写进配置文件。
注意事项：
- 文件保存为 UTF-8（无 BOM）。
- 改完配置需要完全退出并重启 WorkBuddy 才会加载。
- 同团队的 CodeBuddy 使用相同的配置结构，路径是
~/.codebuddy/models.json。
验证
重启后在模型选择器里选择刚添加的模型，发一条简单消息：
请回复：AsterMesh WorkBuddy 配置成功。常见问题
- 模型没有出现在列表里：检查 JSON 是否合法（尤其是逗号和引号）、文件编码是否为 UTF-8 无 BOM，以及是否重启了应用。
- 鉴权失败：确认
${ASTERMESH_API_KEY}环境变量已设置，或直接在apiKey里填写 Key 测试。 - 404：
url必须是完整接口地址，检查是否漏了/chat/completions。