TencentDB Agent Memory开发环境搭建从源码编译到调试的完整流程【免费下载链接】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-MemoryTencentDB Agent Memory是一款团队级AI Agent记忆中枢能将对话、文档和代码转化为四种可复用的记忆资产Chat Memory、Skill、LLM-Wiki、Code-Graph实现跨Agent和框架的治理、共享与装备。本文将为你提供从源码克隆到调试运行的完整开发环境搭建指南帮助你快速上手这个强大的AI记忆管理工具。 环境准备开发前的必要检查在开始搭建TencentDB Agent Memory开发环境之前请确保你的系统满足以下要求Node.js版本需≥22.16.0推荐使用nvm管理多版本Node.jsnpm通常随Node.js一起安装推荐版本≥10.0.0Git用于克隆项目源码系统依赖根据你的操作系统可能需要安装额外的系统库如build-essential、python3等你可以通过以下命令检查Node.js和npm版本node -v npm -v如果你的Node.js版本低于要求建议使用nvm安装或升级nvm install 22.16.0 nvm use 22.16.0 源码获取克隆与目录结构首先我们需要从Git仓库克隆TencentDB Agent Memory的源码git clone https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory cd TencentDB-Agent-Memory克隆完成后让我们了解一下项目的主要目录结构src/核心源代码目录包含适配器、CLI命令、核心功能模块等scripts/各类脚本文件包括迁移工具、诊断导出、安装脚本等hermes-plugin/Hermes插件相关代码docker/Docker相关配置文件assets/静态资源包括图片等其中开发过程中最常用的目录是src/特别是src/core/和src/gateway/分别包含了核心功能和网关服务代码。 依赖安装快速配置项目依赖TencentDB Agent Memory使用npm作为包管理工具。在项目根目录下执行以下命令安装依赖npm install --omitdev这个命令会安装生产环境所需的依赖不包括开发依赖从而减小安装体积。如果你需要进行开发和测试建议使用完整安装npm install对于某些特定功能如Gateway启动还需要安装tsxnpm install tsx如果你在安装过程中遇到问题可以参考项目中的安装脚本scripts/install_hermes_memory_tencentdb.sh该脚本提供了更详细的安装步骤和错误处理。 编译构建从TypeScript到可执行代码TencentDB Agent Memory主要使用TypeScript开发因此需要将TypeScript代码编译为JavaScript。项目提供了便捷的构建命令npm run build这个命令会执行以下操作使用tsdown构建插件编译各类脚本迁移脚本、导出脚本等如果你只需要构建特定部分可以使用更具体的命令# 仅构建插件 npm run build:plugin # 仅构建迁移脚本 npm run build:migrate-sqlite-to-vdb构建过程中TypeScript编译器会根据各个目录下的tsconfig.json文件进行配置例如scripts/migrate-sqlite-to-tcvdb/tsconfig.json。 运行与调试启动开发服务器开发环境下我们可以使用tsx直接运行TypeScript代码无需先编译npx tsx src/gateway/server.ts这会启动Gateway服务器默认监听相应的端口。你也可以通过设置环境变量来自定义启动参数MEMORY_TENCENTDB_GATEWAY_CMDsh -c cd ~/.memory-tencentdb/tdai-memory-openclaw-plugin exec npx tsx src/gateway/server.ts调试模式为了更方便地进行开发调试可以使用以下方法添加调试日志项目中已经集成了调试日志功能如scripts/openclaw-after-tool-call-messages.patch.sh中的debug函数。你可以在代码中添加类似的调试输出。使用Node.js调试器结合tsx和Node.js内置调试器node --inspect --import tsx src/gateway/server.ts然后在Chrome浏览器中打开chrome://inspect即可进行断点调试。 测试验证确保代码质量TencentDB Agent Memory使用vitest作为测试框架。执行以下命令运行测试# 运行所有测试 npm run test # 运行测试并生成覆盖率报告 npm run test:coverage # 监听文件变化自动重新运行测试 npm run test:watch项目中的测试文件通常与被测试文件放在同一目录下以.test.ts结尾例如src/utils/no-think-fetch.test.ts。 架构概览理解项目核心TencentDB Agent Memory采用了层次化的内存架构如下图所示这个架构从下到上分为四个层次L0 Raw Log全量保留原始对话与事件流确保原始信息不丢失L1 Atomic Memory自动提取事实、偏好、约束、状态从语音中稳定抽出关键信息L2 Scene Block按项目/主题/工作流场景聚类带上文召回减少单场误用L3 Persona稳定的用户偏好与服务方式画像让Agent按用户习惯协作理解这个架构有助于你更好地理解代码组织和功能实现。核心代码主要位于src/core/目录下包括对话管理、钩子、角色生成、场景提取等模块。 开发技巧提高开发效率使用CLI工具项目提供了src/cli/目录下的命令行工具可以帮助你快速执行常见任务。利用脚本scripts/目录下提供了各种实用脚本如数据库迁移、诊断信息导出等可以直接使用或作为参考。代码规范项目遵循一定的代码规范贡献代码前请阅读CONTRIBUTING.md和CONTRIBUTING_CN.md。查看变更日志CHANGELOG.md记录了项目的重要变更有助于你了解最新功能和修复的问题。 常见问题解决开发中的痛点依赖安装失败尝试删除node_modules目录和package-lock.json文件然后重新运行npm install。编译错误确保你的TypeScript版本与项目要求一致可以通过npm ls typescript检查版本。启动问题检查端口是否被占用环境变量是否正确设置。可以查看Gateway配置文件src/gateway/config.ts了解默认配置。测试失败确保所有依赖都已正确安装特别是开发依赖。如果是特定测试用例失败可以单独运行该用例进行调试。通过以上步骤你应该已经成功搭建了TencentDB Agent Memory的开发环境。现在你可以开始探索这个强大的AI记忆管理工具进行功能开发和优化了。祝你开发顺利【免费下载链接】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），仅供参考