一、前置条件
开始配置前,请确认已满足以下条件:
1. Memory Hub 已部署并可正常访问。
2. 已在 Memory Hub 的 API Key 页面获取以下两项信息:
·客户端接入地址:找到 CodeBuddy 对应的地址,单击复制。
·User Key:以 sk-mem- 开头的密钥,用于身份认证。
3. 已安装 CodeBuddy。
二、配置步骤
CodeBuddy 的接入配置集中在 ~/.codebuddy/models.json 文件中,通过 baseURL 与 apiKey 两个字段完成配置。
注意:说明:
注意:~ 表示当前登录用户的主目录,例如 Windows 下为 C:\\Users\\用户名,macOS / Linux 下为 /home/用户名 或 /Users/用户名。
三、步骤一:配置接入地址
编辑 ~/.codebuddy/models.json,将模型的 baseURL 字段设置为从 Memory Hub 复制的 CodeBuddy 接入地址:
{ "models": [ { "id": "memory-proxy", "name": "memory-proxy", "url": "http://<memory接入地址>/codebuddy/default", "apiKey": "sk-mem-xxxxxxxxxxxxxxxx" } ]}
上述参数的含义如下:
| 参数 | 作用 | 是否需要修改 |
| id | 模型条目的唯一标识,CodeBuddy 内部用于识别该模型配置项。可任意取值,建议与 name 保持一致 | 否 |
| name | 自定义的模型标识名称,显示在 CodeBuddy 的模型选择列表中,仅用于辨认,不影响实际功能。可任意取名,如 memory-proxy、memory 等 | 否 |
| url | Memory 的接入地址拼接 CodeBuddy 的接入后缀 /codebuddy/default,决定请求实际发送的目标。格式为 https://<memory接入地址>/codebuddy/default | 是,粘贴从 Memory Hub 复制的地址 |
| apiKey | 用于身份认证的 User Key | 是,粘贴从 Memory Hub 获取的密钥 |
注意:说明:
注意:登录 Memory Hub,进入 API Key 页面,找到 DeepSeek Harness 对应的客户端接入地址与 User Key。
四、步骤二:配置认证密钥
将 apiKey 字段的值设置为从 Memory Hub 获取的 User Key,将 sk-mem-xxxxxxxxxxxxxxxx 替换为实际的 User Key。
五、启动并完成首次初始化
1. 启动 CodeBuddy,选择刚配置的 memory-proxy 模型。
2. 发送任意消息(例如 hi),Proxy 会依次返回以下选择器(按钮形式):
·是否关联团队资产(Associate team assets?):选择 Yes 注入团队上下文,选择 No 跳过。
·选择团队(Team):仅存在一个团队时会自动跳过。
·选择 Agent:在所选团队下选择 Agent。
·选择任务(Task):首行是虚拟的 "No task" 条目。
3. 完成选择后,Agent 会进行自我介绍,并在后续每轮对话中自动注入以下上下文:会话上下文(<session_context>)、可用的技能列表(<available_skills>)与用户画像记忆(<tdai_profile_memory>)。
4. 初始化完成后,可在聊天中输入以下斜杠命令使用相关能力:
·mem:help:查看记忆命令的帮助。
·mem:sync:同步记忆。
·mem:create-skill:创建技能。
六、常见问题
| 现象 | 可能原因 | 解决方法 |
| 模型列表未显示新配置 | models.json 格式错误或未重启 | 检查 JSON 语法是否合法,重启 CodeBuddy 后重试 |
| 发送消息后提示连接失败 | 接入地址不正确或 Proxy 未启动 | 确认 Proxy 服务正常运行,检查 baseURL 是否与 Memory Hub 页面一致 |
| 发送消息后无选择器弹出 | User Key 无效或过期 | 重新从 Memory Hub 复制 User Key,更新 apiKey 字段 |