OpenViking 接入 TRAE / TraeCode CLI：国内 Agent 上下文增强完整指南

OpenViking 接入 TRAE / TraeCode CLI国内 Agent 上下文增强完整指南【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking想让TRAE或TraeCode CLI拥有跨会话的长期记忆本文介绍OpenViking 记忆插件一套 AI Agent 上下文数据库与自我进化上下文数据库通过 Hooks MCP 让国内 Agent 记住你的偏好、项目知识并随时主动召回。跟着本文10 分钟即可完成接入。一、OpenViking 是什么为什么 TRAE 需要它OpenViking自我进化上下文数据库是一个专为 AI Agent 设计的上下文数据库统一管理三样东西Agent 记忆Memory跨会话记住你的偏好、项目背景知识检索RAG把文档、代码仓库变成可检索知识️技能Skills沉淀可复用的操作经验。TRAE 作为国产 IDE/Agent 工具默认只有会话内记忆——关掉窗口上下文就清零。接入 OpenViking 后你告诉 Agent 以后都用 pnpm 管理依赖下一次新开会话它还记得。二、接入原理4 个 Hook 事件 1 个 MCP 服务OpenViking 对 TRAE / TRAE CN / TraeCode CLI 2.0 的集成由 memory-plugin-shared/install.sh 一键安装核心是 4 个生命周期 Hook适配器源码在 examples/trae-memory-hooks/ 与 examples/trae-cli-memory-hooks/Hook 事件触发时机作用SessionStart会话开始自动加载用户画像 当前项目记忆UserPromptSubmit你每次提问根据问题自动召回相关上下文并注入PreToolUse调用文件/Shell 工具前拦截viking://虚拟路径引导改用 MCP 工具Stop每轮回复结束捕获本轮对话并立即提交给记忆抽取器此外还注册了一个名为openviking-memory的MCP Server透传服务端 15 个工具让 Agent 可以主动管理记忆最常用的几个工具用途search/find语义搜索记忆与知识modecontext返回组装好的上下文read/list/tree浏览记忆目录结构remember/write/forget写入、编辑、删除记忆health健康检查验证连通性三、TRAE 桌面端安装步骤图文前置条件macOS 或 Linux、Node.js 18且 TRAE 版本支持 Hook 机制。第 1 步准备 OpenViking 服务并创建 API Key。火山引擎 OpenViking 云服务用户直接使用控制台生成的 Key自建用户确保本机已启动 OpenViking 服务。第 2 步打开 TRAE 设置。第 3 步进入 MCP 设置面板。第 4 步添加 MCP 服务器。运行安装命令后安装器会自动写入配置如需手动添加选择手动配置# TRAE bash examples/memory-plugin-shared/install.sh --harness trae # TRAE CN bash examples/memory-plugin-shared/install.sh --harness trae-cn # 两者同时安装 bash examples/memory-plugin-shared/install.sh --harness trae,trae-cn安装过程中会引导你填写 OpenViking 的 URL 与 API Key。第 5 步启用服务器。确认openviking状态为已连接。第 6 步验证。在 TRAE 的 Agent 会话中运行ov-ls查看记忆目录运行health检查连通性⚠️ 如果 MCP 连接报 schema 错误通常是 Node.js 版本过低要求 18或旧版 TRAE 的 JSON Schema 校验较严格完整图文版教程见官方文档docs/zh/agent-integrations/13-trae.md。四、TraeCode CLI 2.0 接入方案TraeCode CLI 2.0 直接使用兼容 Codex 的插件格式无需单独写 Hook 适配器旧版独立 Hooks 集成 examples/trae-cli-memory-hooks/ 已标记弃用仅用于兼容卸载。一键安装bash examples/memory-plugin-shared/install.sh --harness trae-cli安装器会完成三件事把openviking-memory插件注册进~/.trae/traecli.toml的 MCP 配置复用 examples/codex-memory-plugin/ 的会话转录解析与记忆提交流程写入与 TRAE 图形端相同的 URI 保护规则examples/memory-plugin-shared/lib/ 中的共享运行时。验证安装trae-cli plugin list输出中出现openviking-memory且状态为启用即接入成功。卸载trae-cli plugin uninstall openviking-memoryopenviking五、接入后怎么用3 步验证记忆生效新会话提问问一个与已有项目相关的问题如这个项目的依赖管理方式是什么确认回答引用了历史记忆告知偏好告诉 Agent 一个临时偏好等待回复完成——StopHook 会在本轮结束时自动提交内容给记忆抽取器跨会话验证新建会话再次询问同一偏好若 Agent 依然记得说明捕获 → 提交 → 召回全链路生效 ✅六、常见问题速查表现象原因与处理安装后没有自动召回完全退出客户端后重启并新建 Agent 会话MCP 未连接检查~/.openviking/ovcli.conf中的 URL / API Key然后重启客户端新会话记不住上一轮设置OPENVIKING_DEBUG1查看 Hook 日志TRAE 为~/.openviking/logs/trae-hooks.logTRAE CN 为trae-cn-hooks.log确认Stop已执行且提交无鉴权错误同一内容被重复捕获用户级与项目级 Hook 中残留旧版脚本重跑安装器会自动移除 OpenViking 管理的旧条目CLI 未列出插件运行trae-cli plugin list缺少时用--harness trae-cli重跑安装器七、相关资源官方集成指南docs/zh/agent-integrations/13-trae.md集成能力全景docs/zh/agent-integrations/16-capability-reference.mdTRAE Hook 适配器源码examples/trae-memory-hooks/README.mdCLI 适配器说明examples/trae-cli-memory-hooks/README.md共享安装器examples/memory-plugin-shared/install.sh插件能力声明examples/trae-memory-hooks/openviking.integration.json 总结OpenViking 用被动 Hook 捕获 主动 MCP 检索的双通道设计为 TRAE 与 TraeCode CLI 补齐了国产 Agent 最缺的一块——跨会话上下文增强。一次安装所有会话共享同一份记忆。【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考