拓冰网站定制 
CodeBuddy 如何接入 TencentDB Agent Memory Proxy 并避开 4.10.2-4.10.4 版本问题【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory如果你的 CodeBuddy 想用上团队级记忆能力记忆注入、Skill、Knowledge 回流到 system prompt需要把它的对话请求路由到 TencentDB Agent Memory 的 Proxy 服务上。接入前必须先确认版本号CodeBuddy 4.10.2、4.10.3、4.10.4 存在已知 Bug——这些版本不会在请求中携带sessionId导致 Proxy 无法完成 Session 初始化记忆功能整体失效。请使用 CodeBuddy ≥ 4.10.5 或 ≤ 4.10.1。满足这个前提后只需在~/.codebuddy/models.json中加一段自定义模型配置就能在 IDE 内获得与 Claude Code 相同的记忆体验。本文的操作路径基于 INSTALL.md 中的“Using Proxy with CodeBuddy”章节与 INSTALL_CN.md 对应章节前置部署依据 deploy/global-images/README.md。先核对 CodeBuddy 版本打开 CodeBuddy 查看当前版本号落在4.10.2、4.10.3、4.10.4区间内的先升级到4.10.5及以上或降级回4.10.1及以下再继续。原因如上Session 初始化依赖请求里带的sessionId这三个版本不携带该字段Proxy 侧无法注册会话后续的记忆注入和对话回流都不会生效——这不是配置问题改任何配置都绕不过只能换版本。准备条件Proxy 三件套与业务资产CodeBuddy 接入的前提是 Memory Core Memory Hub Proxy 三件套已在运行端口分配为服务端口用途Memory Core8420记忆读写、鉴权、skill/RAG 数据面Panel UI8125团队记忆管理面板Knowledge8424Wiki / Code-Graph 服务Proxy8096LLM 请求代理Anthropic / OpenAI 双协议如果还没部署用官方脚本一键拉起环境要求 macOS / Linux Docker# 1) 拿脚本 git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git cd TencentDB-Agent-Memory/deploy/global-images # 2) 准备 .env把 LLM 相关字段填成真值 cp .env.example .env $EDITOR .env # MEMORY_LLM_BASE_URL / MEMORY_LLM_API_KEY / MEMORY_LLM_MODEL ← memory hub 内部用 # PROXY_UPSTREAM_URL / PROXY_UPSTREAM_API_KEY / PROXY_UPSTREAM_MODEL ← proxy 转发到的上游 # 3) 干跑校验可选会真做 LLM 通路预检加 --skip-llm 跳过 ./verify.sh # 4) 一键起 ./start-all.shverify.sh会预检两组 LLM 通路OpenAI 协议只验 key URLAnthropic 协议发一条max_tokens1的最小消息API key、URL、模型名配错会在启动前被拦下。启动完成后还要做两件事CodeBuddy 的请求才有资产可绑建业务用户。用start-all.sh结尾打印的 adminuser_key持久化在deploy/global-images/.admin-key形如sk-mem-...创建一个业务用户ADMIN_KEY$(cat ./.admin-key) curl -sS -X POST http://localhost:8420/v3/meta/user/create \ -H x-tdai-user-key: $ADMIN_KEY \ -H x-tdai-service-id: default \ -H Content-Type: application/json \ -d {username:you} | jq返回体里data.default_user_key就是这个业务用户的登录 key只在创建时返回一次保存好。文档明确不建议 CodeBuddy 直接使用 admin key。建 Team / AgentTask 可选。打开面板 http://localhost:8125用业务用户 key 登录后在左侧「团队」新建 Team进入 Team 新建 Agent填好descriptionsystem prompt。至少 1 个 Team 1 个 Agent 是必须的Task 不建也能用只是 L2/L3 会缺 Task 维度。配置 ~/.codebuddy/models.json在开发机的~/.codebuddy/models.json文件中写入以下内容{ models: [ { id: claude-sonnet-4-20250514, name: proxy-memory-agent, vendor: claude, apiKey: 业务用户的 sk-mem-... user_key, maxInputTokens: 200000, url: http://127.0.0.1:8096/codebuddy/default, supportsToolCall: true, supportsImages: true } ] }各字段含义均来自 INSTALL 文档说明idProxy 上游 LLM 支持的模型 ID必须与你.env里PROXY_UPSTREAM_MODEL配置的值或上游模型列表中的某个模型匹配。文档示例值claude-sonnet-4-20250514如果你的上游不是这个模型替换成你的上游模型 ID。name在 CodeBuddy 对话框中显示的名称可自定义。vendor模型供应商标识仅用于 UI 展示不影响实际请求。apiKey上一步创建业务用户时返回的user_keysk-mem-...与 Claude Code 的ANTHROPIC_AUTH_TOKEN是同一把 key。urlProxy 地址 /codebuddy/default路径默认端口8096其中default是 memory 实例 ID本地部署固定叫default。maxInputTokens、supportsToolCall、supportsImages按文档示例原样保留即可文档未展开解释其内部机制改动前请自行评估。在 CodeBuddy 中使用配置完成后在 CodeBuddy 对话框中选择刚才配置的模型名称如proxy-memory-agent开始对话。首个会话的 Session init 流程与 Claude Code 一致proxy 会引导你依次选择Team → Agent → Task选择完成后 proxy 记住这次会话的绑定后续每一轮请求自动把该 agent 的 L2/L3 记忆、skill、knowledge 注入 system promptL0 原始对话自动写回 memory-core。Proxy 侧对每个请求的处理顺序是auth校验 user_key→sessionInit选 team/agent/task 表单→injection注入记忆→ 转发到上游 LLM详见 MemoryProxy/README_CN.md 的请求处理流程章节。验证接入是否生效文档给出了几个可核对的验证点Proxy 健康检查curl http://127.0.0.1:8096/health文档示例返回storage.effective是存储后端的观测锚点{ status: ok, version: 0.2.0, upstream: https://tokenhub.example.com/v1, storage: { enabled: false, requested: sqlite, effective: sqlite, degraded: false } }面板里看记忆是否长出来聊完一段真实工作对话后在面板 http://localhost:8125 的「记忆」→ Chat Memory 里应能看到 L0 原始对话被切分成的 scene「Agent」详情页的 Profile 里 L2 scene 与 L3 persona 会逐步累积「Skill」列表在 LLM 判定有可复用操作方法时会自动出现抽取的 skill。后台 pipeline 是否在干活curl -s http://localhost:8420/health | jq .services.pipelineWorker期望tasksConsumed/tasksCompleted随对话增长数字会随你的使用变化不是固定值。如果表单弹出来了、对话也正常回流说明 Session 初始化成功如果第一个会话就没出现选择流程按下一节排查。常见问题与限制会话没有弹选择表单可能 proxy 里PROXY_ENABLE_SESSION_INIT1没开。start-all.sh默认PROXY_FULL_STACK1已经打开如果你手动改过.env或用PROXY_FULL_STACK0起的重启 proxyPROXY_FULL_STACK1 ./start-proxy.sh。表单选择项是空的或只有别人的 team确认当前账号已在面板中创建过 Team 和 Agent——apiKey用谁的 key就只显示谁 own 的资产。proxy 转发返回 401PROXY_UPSTREAM_API_KEY无效或PROXY_UPSTREAM_URL不匹配用docker logs tdai-proxy看错误。L1/L2 一直没跑起来、records/ 目录没东西默认promptModechat对普通对话能抽出 memory如果你配了code而对话都是闲聊LLM 会认为没有可沉淀的东西返回 0。改回chat或跟 agent 做真实工作对话改文件、跑测试、给出结论。面板显示“Panel API 8125 未启动”docker ps检查tdai-memory-hub是否 healthy不 healthy 就看docker logs tdai-memory-hub找报错大概率是REMOTE_INSTANCE_URL/LLM_BASE_URL之类配错。想切换到别的 team/agent开一个全新的 CodeBuddy 会话就会重新走选择流程同一个会话内不会重复问。需要停掉整套服务时用 deploy/global-images 提供的脚本./stop-all.sh # 停容器保留 volume 数据 admin key ./stop-all.sh --purge # 连 volume、admin key、proxy config 一起清注意--purge会删除持久化数据volume和 admin key属于不可逆操作确认不再需要本地数据后再执行。边界说明本文路径对应本地一键部署形态default实例 ID、127.0.0.1:8096本机地址。如果 Proxy 部署在别的机器上把url换成对应宿主机地址即可——Panel UI 的“客户端接入地址”卡片会自动拼上宿主机 LAN IP PROXY_PORT例如http://192.168.1.100:8096/codebuddy/default别人复制过去就能直接连。其他接入形态OpenClaw、Hermes、SDK、源码启动等不在本文范围内参见 deploy/global-images/README.md 与 MemoryCore/README_CN.md。【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CodeBuddy 如何接入 TencentDB Agent Memory Proxy 并避开 4.10.2-4.10.4 版本问题
CodeBuddy 如何接入 TencentDB Agent Memory Proxy 并避开 4.10.2-4.10.4 版本问题【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory如果你的 CodeBuddy 想用上团队级记忆能力记忆注入、Skill、Knowledge 回流到 system prompt需要把它的对话请求路由到 TencentDB Agent Memory 的 Proxy 服务上。接入前必须先确认版本号CodeBuddy 4.10.2、4.10.3、4.10.4 存在已知 Bug——这些版本不会在请求中携带sessionId导致 Proxy 无法完成 Session 初始化记忆功能整体失效。请使用 CodeBuddy ≥ 4.10.5 或 ≤ 4.10.1。满足这个前提后只需在~/.codebuddy/models.json中加一段自定义模型配置就能在 IDE 内获得与 Claude Code 相同的记忆体验。本文的操作路径基于 INSTALL.md 中的“Using Proxy with CodeBuddy”章节与 INSTALL_CN.md 对应章节前置部署依据 deploy/global-images/README.md。先核对 CodeBuddy 版本打开 CodeBuddy 查看当前版本号落在4.10.2、4.10.3、4.10.4区间内的先升级到4.10.5及以上或降级回4.10.1及以下再继续。原因如上Session 初始化依赖请求里带的sessionId这三个版本不携带该字段Proxy 侧无法注册会话后续的记忆注入和对话回流都不会生效——这不是配置问题改任何配置都绕不过只能换版本。准备条件Proxy 三件套与业务资产CodeBuddy 接入的前提是 Memory Core Memory Hub Proxy 三件套已在运行端口分配为服务端口用途Memory Core8420记忆读写、鉴权、skill/RAG 数据面Panel UI8125团队记忆管理面板Knowledge8424Wiki / Code-Graph 服务Proxy8096LLM 请求代理Anthropic / OpenAI 双协议如果还没部署用官方脚本一键拉起环境要求 macOS / Linux Docker# 1) 拿脚本 git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git cd TencentDB-Agent-Memory/deploy/global-images # 2) 准备 .env把 LLM 相关字段填成真值 cp .env.example .env $EDITOR .env # MEMORY_LLM_BASE_URL / MEMORY_LLM_API_KEY / MEMORY_LLM_MODEL ← memory hub 内部用 # PROXY_UPSTREAM_URL / PROXY_UPSTREAM_API_KEY / PROXY_UPSTREAM_MODEL ← proxy 转发到的上游 # 3) 干跑校验可选会真做 LLM 通路预检加 --skip-llm 跳过 ./verify.sh # 4) 一键起 ./start-all.shverify.sh会预检两组 LLM 通路OpenAI 协议只验 key URLAnthropic 协议发一条max_tokens1的最小消息API key、URL、模型名配错会在启动前被拦下。启动完成后还要做两件事CodeBuddy 的请求才有资产可绑建业务用户。用start-all.sh结尾打印的 adminuser_key持久化在deploy/global-images/.admin-key形如sk-mem-...创建一个业务用户ADMIN_KEY$(cat ./.admin-key) curl -sS -X POST http://localhost:8420/v3/meta/user/create \ -H x-tdai-user-key: $ADMIN_KEY \ -H x-tdai-service-id: default \ -H Content-Type: application/json \ -d {username:you} | jq返回体里data.default_user_key就是这个业务用户的登录 key只在创建时返回一次保存好。文档明确不建议 CodeBuddy 直接使用 admin key。建 Team / AgentTask 可选。打开面板 http://localhost:8125用业务用户 key 登录后在左侧「团队」新建 Team进入 Team 新建 Agent填好descriptionsystem prompt。至少 1 个 Team 1 个 Agent 是必须的Task 不建也能用只是 L2/L3 会缺 Task 维度。配置 ~/.codebuddy/models.json在开发机的~/.codebuddy/models.json文件中写入以下内容{ models: [ { id: claude-sonnet-4-20250514, name: proxy-memory-agent, vendor: claude, apiKey: 业务用户的 sk-mem-... user_key, maxInputTokens: 200000, url: http://127.0.0.1:8096/codebuddy/default, supportsToolCall: true, supportsImages: true } ] }各字段含义均来自 INSTALL 文档说明idProxy 上游 LLM 支持的模型 ID必须与你.env里PROXY_UPSTREAM_MODEL配置的值或上游模型列表中的某个模型匹配。文档示例值claude-sonnet-4-20250514如果你的上游不是这个模型替换成你的上游模型 ID。name在 CodeBuddy 对话框中显示的名称可自定义。vendor模型供应商标识仅用于 UI 展示不影响实际请求。apiKey上一步创建业务用户时返回的user_keysk-mem-...与 Claude Code 的ANTHROPIC_AUTH_TOKEN是同一把 key。urlProxy 地址 /codebuddy/default路径默认端口8096其中default是 memory 实例 ID本地部署固定叫default。maxInputTokens、supportsToolCall、supportsImages按文档示例原样保留即可文档未展开解释其内部机制改动前请自行评估。在 CodeBuddy 中使用配置完成后在 CodeBuddy 对话框中选择刚才配置的模型名称如proxy-memory-agent开始对话。首个会话的 Session init 流程与 Claude Code 一致proxy 会引导你依次选择Team → Agent → Task选择完成后 proxy 记住这次会话的绑定后续每一轮请求自动把该 agent 的 L2/L3 记忆、skill、knowledge 注入 system promptL0 原始对话自动写回 memory-core。Proxy 侧对每个请求的处理顺序是auth校验 user_key→sessionInit选 team/agent/task 表单→injection注入记忆→ 转发到上游 LLM详见 MemoryProxy/README_CN.md 的请求处理流程章节。验证接入是否生效文档给出了几个可核对的验证点Proxy 健康检查curl http://127.0.0.1:8096/health文档示例返回storage.effective是存储后端的观测锚点{ status: ok, version: 0.2.0, upstream: https://tokenhub.example.com/v1, storage: { enabled: false, requested: sqlite, effective: sqlite, degraded: false } }面板里看记忆是否长出来聊完一段真实工作对话后在面板 http://localhost:8125 的「记忆」→ Chat Memory 里应能看到 L0 原始对话被切分成的 scene「Agent」详情页的 Profile 里 L2 scene 与 L3 persona 会逐步累积「Skill」列表在 LLM 判定有可复用操作方法时会自动出现抽取的 skill。后台 pipeline 是否在干活curl -s http://localhost:8420/health | jq .services.pipelineWorker期望tasksConsumed/tasksCompleted随对话增长数字会随你的使用变化不是固定值。如果表单弹出来了、对话也正常回流说明 Session 初始化成功如果第一个会话就没出现选择流程按下一节排查。常见问题与限制会话没有弹选择表单可能 proxy 里PROXY_ENABLE_SESSION_INIT1没开。start-all.sh默认PROXY_FULL_STACK1已经打开如果你手动改过.env或用PROXY_FULL_STACK0起的重启 proxyPROXY_FULL_STACK1 ./start-proxy.sh。表单选择项是空的或只有别人的 team确认当前账号已在面板中创建过 Team 和 Agent——apiKey用谁的 key就只显示谁 own 的资产。proxy 转发返回 401PROXY_UPSTREAM_API_KEY无效或PROXY_UPSTREAM_URL不匹配用docker logs tdai-proxy看错误。L1/L2 一直没跑起来、records/ 目录没东西默认promptModechat对普通对话能抽出 memory如果你配了code而对话都是闲聊LLM 会认为没有可沉淀的东西返回 0。改回chat或跟 agent 做真实工作对话改文件、跑测试、给出结论。面板显示“Panel API 8125 未启动”docker ps检查tdai-memory-hub是否 healthy不 healthy 就看docker logs tdai-memory-hub找报错大概率是REMOTE_INSTANCE_URL/LLM_BASE_URL之类配错。想切换到别的 team/agent开一个全新的 CodeBuddy 会话就会重新走选择流程同一个会话内不会重复问。需要停掉整套服务时用 deploy/global-images 提供的脚本./stop-all.sh # 停容器保留 volume 数据 admin key ./stop-all.sh --purge # 连 volume、admin key、proxy config 一起清注意--purge会删除持久化数据volume和 admin key属于不可逆操作确认不再需要本地数据后再执行。边界说明本文路径对应本地一键部署形态default实例 ID、127.0.0.1:8096本机地址。如果 Proxy 部署在别的机器上把url换成对应宿主机地址即可——Panel UI 的“客户端接入地址”卡片会自动拼上宿主机 LAN IP PROXY_PORT例如http://192.168.1.100:8096/codebuddy/default别人复制过去就能直接连。其他接入形态OpenClaw、Hermes、SDK、源码启动等不在本文范围内参见 deploy/global-images/README.md 与 MemoryCore/README_CN.md。【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考