OpenViking × TRAE 记忆集成为 TRAE、TRAE CN 与 TraeCode CLI 2.0 打通跨项目、跨会话长期记忆【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking本篇技术指南讲解如何在 TRAE、TRAE CN 与 TraeCode CLI 2.0 中安装并启用 OpenViking 记忆集成让这些编码 Agent 具备跨项目、跨会话的长期记忆能力。读完本文你将掌握从一键安装、Hook 与 MCP 双层架构原理到验证、升级、卸载与故障排查的完整实战方案并能在源码层面理解每条记忆管线的底层调用关系。集成原理Hook 负责喂记忆MCP 负责取记忆TRAE 系列的记忆集成采用生命周期 Hook MCP Server的双层架构Hook 层借助 TRAE/TRAE CN 支持的SessionStart、UserPromptSubmit、PreToolUse、Stop四个生命周期事件自动加载上下文、捕获每轮对话并提交给 OpenViking 记忆抽取器MCP 层OpenViking MCP Server 透传服务端完整 MCP 工具集供 Agent 主动搜索、读取和管理记忆。该设计的关键点在于 TRAE 的捕获逻辑不复用 Claude Code 的 transcript 解析而是直接从Stop事件中读取prompt、text_content与last_assistant_message字段并以tr-TRAE或trcn-TRAE CN前缀存储会话见 trae-memory-hooks/README.md。也就是说每条记忆在服务端都带有明确的客户端来源标记多客户端共存时不会互相污染。前置条件操作系统macOS 或 Linux运行时Node.js 18客户端版本支持SessionStart、UserPromptSubmit、PreToolUse、StopHook 的 TRAE / TRAE CN 版本TraeCode CLI 2.0 则直接使用兼容 Codex 的插件格式接入无需单独适配OpenViking 服务本机已运行 OpenViking 服务或持有火山引擎 OpenViking 云服务账号与 API Key。安装过程中安装器会引导配置 OpenViking 连接信息URL / API Key。连接方式二选一切勿选错火山引擎云服务用户选择火山引擎 OpenViking 云服务并填写 API Key本机已运行 OpenViking 服务选择自建 / 本地。安装一条命令完成三个客户端的接入安装脚本位于仓库 examples/memory-plugin-shared/install.sh通过--harness参数指定目标客户端。从脚本源码可见--harness支持逗号分隔的多目标列表claude, codex, cursor, trae, trae-cn, trae-cli, zcode, opencode, pi, dsh且脚本会主动探测本机已安装的 TRAE 系列客户端install.sh中分别检查/Applications/Trae.app、/Applications/Trae CN.app及trae-cli/traecli/traex等命令便于交互式选择。# TRAE bash (curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/memory-plugin-shared/install.sh) \ --harness trae # TRAE CN bash (curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/memory-plugin-shared/install.sh) \ --harness trae-cn # 同时安装 bash (curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/memory-plugin-shared/install.sh) \ --harness trae,trae-cn # TraeCode CLI 2.0 bash (curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/memory-plugin-shared/install.sh) \ --harness trae-cliGitHub 访问受限时使用 TOS 镜像--dist tosbash (curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) \ --harness trae,trae-cn --dist tos # TraeCode CLI 2.0 bash (curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) \ --harness trae-cli --dist tos安装完成后完全退出并重启对应客户端让新写入的 Hook 与 MCP 配置生效。安装内容逐项拆解四个 Hook 与 15 个 MCP 工具Hook 清单安装器会在用户级与项目级配置中注册以下四个生命周期 Hook具体声明可参见 trae-memory-hooks/hooks/hooks.jsonHook 事件动作默认超时SessionStart加载用户画像和当前项目记忆30sUserPromptSubmit根据当前问题召回并注入相关内容20sPreToolUse阻止把viking://虚拟路径当作本地文件访问提示改用 MCP 工具5sStop捕获本轮消息并立即提交短会话也能进入记忆抽取流程30s在 trae-hook.mjs 中可以看到每个事件的具体处理逻辑SessionStart进入withAgentHookLock临界区后先回放上次中断遗留的待提交消息replayAgentPending再通过buildAgentProfile构建用户画像最终把结果以openviking-context sourcesession-start标签注入会话。源码中用 2 秒窗口去重避免重复触发UserPromptSubmit对用户输入做cleanTraeText清洗剔除上一轮注入的openviking-context与relevant-memories标签再调用recallForPrompt完成召回结果作为additionalContext注入。同时记录 prompt 哈希与事件 ID防止同一 prompt 被重复召回Stop由 trae-turns.mjs 从Stop事件中提取user来自input.prompt或待提交的 pendingPrompt与assistant来自last_assistant_message或text_content两个角色的一轮对话去重后调用addAgentMessages写入会话随后立即调用commitAgentSession触发记忆抽取——这正是短会话也能入库的实现原理PreToolUse通过 uri-guard.mjs 内的evaluateAgentUriGuard判断工具与输入若命中viking://虚拟路径则返回permissionDecision: deny并附带原因提示把 Agent 引导回 OpenViking MCP 工具Hook 配置中该事件只匹配Read|Glob|Grep|Bash|RunCommand这类可能触碰文件系统的工具开销极小5s 超时。OpenViking MCP Server15 个工具MCP Server 透传 OpenViking 服务端的完整 MCP 工具集共 15 个工具find、search、read、list、tree、remember、write、edit、add_resource、list_watches、cancel_watch、grep、glob、forget、health。其中值得关注的是search的modecontext该模式返回组装后的上下文而非原始命中片段。在 recall-core.mjs 的buildContextSearchBody中可以看到插件声明mode: context、purpose: coding与score_threshold默认 0.35把配额分配、层级降级、跨轮次去重等机制交给服务端默认策略处理同时支持按需携带quotas、max_tokens、session_id、query_expansion、dedup_turns默认 5 轮等参数精细控制召回行为。这意味着你在 TRAE 中获得的召回结果与 CLI、其他 IDE 插件使用的是同一套上下文组装管线。验证五个步骤确认记忆闭环重启 TRAE、TRAE CN 或 TraeCode CLI 2.0并新建 Agent 会话在客户端的 MCP 设置中确认openviking已连接提问一个与已有项目或个人偏好相关的问题确认回答使用了已有记忆可在会话开头观察到openviking-context/relevant-memories注入告诉 Agent 一个临时偏好等待回复完成新建会话后再次询问确认捕获、提交和跨会话召回均生效对 TraeCode CLI 2.0运行trae-cli plugin list确认openviking-memory已启用。查看 Hook 调试日志需要排查 Hook 时设置OPENVIKING_DEBUG1后启动客户端然后查看对应日志客户端日志路径TRAE~/.openviking/logs/trae-hooks.logTRAE CN~/.openviking/logs/trae-cn-hooks.logTraeCode CLI 2.0~/.openviking/logs/codex-hooks.log日志由createAgentLogger按客户端与事件维度写入能够区分profile、recall、pending、uncaught等不同阶段的错误是定位问题的一手依据。升级与卸载升级重复运行对应安装命令即可安装器会覆盖更新由 OpenViking 管理的 Hook 条目与脚本。卸载务必使用原安装渠道GitHub 或 TOS避免残留# GitHub以 TRAE CN 为例 bash (curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/memory-plugin-shared/install.sh) \ --harness trae-cn --uninstall --yes # TOS以 TRAE CN 为例 bash (curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) \ --harness trae-cn --uninstall --yes将trae-cn替换为trae即可管理 TRAE 集成。TraeCode CLI 2.0 请执行trae-cli plugin uninstall openviking-memoryopenviking注意安装器的--harness trae-cli --uninstall只用于移除旧安装中已弃用的独立 Hooks 集成TraeCode CLI 2.0 的当前安装形态是 Codex 兼容插件应按插件方式卸载。故障排查现象原因与处理安装后没有自动召回完全退出客户端后重新启动并新建 Agent 会话。MCP 未连接检查~/.openviking/ovcli.conf中的 URL/API Key然后重启客户端。新会话无法回忆上一轮内容查看 Hook 日志确认Stop已执行且/commit没有连接或鉴权错误。同一内容被捕获多次检查用户级与项目级 Hook 中是否仍有旧版trae-auto-recall.mjs或trae-auto-capture.mjs重跑安装器会移除由 OpenViking 管理的旧条目。TraeCode CLI 2.0 未列出插件运行trae-cli plugin list若没有openviking-memory使用--harness trae-cli重跑安装器。若上述步骤无法解决建议先开OPENVIKING_DEBUG1复现问题再结合对应客户端的 Hook 日志见上文日志路径定位具体环节是发生在召回recall、画像profile、待提交回放pending还是鉴权阶段。关联资料集成能力参考查看各客户端支持能力矩阵与 Hook/MCP 能力边界鉴权配置 OpenViking 连接与 API Key 的完整说明TRAE 记忆 Hook 源码TRAE / TRAE CN 专用生命周期适配器实现TraeCode CLI 记忆 Hook 源码TraeCode CLI 2.0Codex 兼容插件实现共享安装器支持多客户端的一键安装/升级/卸载脚本。【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考