TRAE、TRAE CN 与 TraeCode CLI 2.0 记忆集成

为 TRAE、TRAE CN 和 TraeCode CLI 2.0 添加跨项目、跨会话的长期记忆。安装后，OpenViking Hook 会自动加载相关上下文、捕获每轮对话并提交给记忆抽取器；MCP 用于主动搜索、读取和管理记忆。

安装

前置条件：macOS 或 Linux、Node.js 18+，以及支持 SessionStart、UserPromptSubmit、PreToolUse、Stop Hook 的 TRAE/TRAE CN 版本。TraeCode CLI 2.0 直接使用兼容 Codex 的插件格式。安装过程中会引导配置 OpenViking 连接信息。

安装器询问连接方式时，火山引擎云服务用户请选择 火山引擎 OpenViking 云服务 并填写 API Key。只有本机已运行 OpenViking 服务时才选择 自建 / 本地。

# 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-cli

GitHub 访问受限时使用 TOS 镜像：

bash <(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

安装后完全退出并重启对应客户端。

安装内容

• SessionStart：加载用户画像和当前项目记忆。
• UserPromptSubmit：根据当前问题召回并注入相关内容。
• PreToolUse：阻止把 viking:// 虚拟路径当作本地文件访问，并提示改用 OpenViking MCP 工具。
• Stop：捕获本轮消息并立即提交，使短会话也能进入记忆抽取流程。
• OpenViking MCP Server：透传服务端完整 MCP 工具集（15 个工具）：find、search、read、list、tree、remember、write、edit、add_resource、list_watches、cancel_watch、grep、glob、forget、health。其中 search 的 mode="context" 可返回组装后的上下文。

验证

1. 重启 TRAE、TRAE CN 或 TraeCode CLI 2.0，并新建 Agent 会话。
2. 在客户端的 MCP 设置中确认 openviking 已连接。
3. 提问一个与已有项目或个人偏好相关的问题，确认回答使用了已有记忆。
4. 告诉 Agent 一个临时偏好，等待回复完成；新建会话后再次询问，确认捕获、提交和跨会话召回均生效。
5. 对 TraeCode CLI 2.0，运行 trae-cli plugin list，确认 openviking-memory 已启用。

需要排查 Hook 时，设置 OPENVIKING_DEBUG=1 后启动客户端，并查看：

• TRAE：~/.openviking/logs/trae-hooks.log
• TRAE CN：~/.openviking/logs/trae-cn-hooks.log
• TraeCode CLI 2.0：~/.openviking/logs/codex-hooks.log

升级与卸载

重复运行对应安装命令即可升级。卸载时也应使用原安装渠道：

# 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-memory@openviking。安装器的 --harness trae-cli --uninstall 只用于移除旧安装中已弃用的独立 Hooks 集成。

故障排查

现象	原因与处理
安装后没有自动召回	完全退出客户端后重新启动，并新建 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 重跑安装器。

参见

• 集成能力参考
• 鉴权