Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
docs: cover TraeCode CLI 2.0 in the TRAE onboarding cards (#5259)
t0sakibdff7dbaac8b
diff --git a/docs/en/agent-integrations/13-trae.md b/docs/en/agent-integrations/13-trae.mdindex cf12dbb3b..f902194c8 100644--- a/docs/en/agent-integrations/13-trae.md+++ b/docs/en/agent-integrations/13-trae.md@@ -41,7 +41,7 @@ Quit and restart the corresponding client after installation.### TraeCode CLI 2.0: trust the hooks on first launch-TraeCode CLI 2.0 uses the Codex plugin format, where hooks only run once you trust them. Starting `trae-cli` stops on this prompt — pick **Trust all and continue**, or Review hooks first if you want to read the commands:+TraeCode CLI 2.0 hooks only run once you trust them. Starting `trae-cli` stops on this prompt — pick **Trust all and continue**, or Review hooks first if you want to read the commands:```textHooks need reviewdiff --git a/docs/images/agents/en/trae.md b/docs/images/agents/en/trae.mdindex f3750a59b..87a55a008 100644--- a/docs/images/agents/en/trae.md+++ b/docs/images/agents/en/trae.md@@ -1,6 +1,6 @@## Step 1: Install-1. Run the command that matches your TRAE version:+1. Run the command that matches your client:**Trae International**@@ -14,6 +14,12 @@bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) --harness trae-cn --dist tos```+ **TraeCode CLI 2.0**++ ```bash+ bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) --harness trae-cli --dist tos+ ```+2. The installer will ask for language (English / Chinese) and OpenViking credentials. In the OpenViking credential step, choose **VolcEngine OpenViking Cloud Service [api.vikingdb.cn-beijing.volces.com]** and enter the API KEY:```text@@ -22,17 +28,32 @@## Step 2: Verify-Open **Settings → MCP → Configured MCP Servers** and confirm that the `openviking` entry is visible.+**TRAE / TRAE CN**: open **Settings → MCP → Configured MCP Servers** and confirm that the `openviking` entry is visible.++**TraeCode CLI 2.0**: hooks only run once you trust them. Start `trae-cli` and pick **Trust all and continue** at the prompt:++```text+Hooks need review+6 hooks are new or changed.+Hooks can run outside the sandbox after you trust them.++ 1. Review hooks+> 2. Trust all and continue+ 3. Continue without trusting (hooks won't run)+```++Then run `trae-cli plugin list` and confirm that `openviking-memory` is enabled. If you miss the prompt or pick the third option, the hooks never run: enter `/hooks` to trust and enable the entries, and check `/plugins` shows the plugin as enabled — two independent switches, both have to be on. A plugin update that touches a hook asks for trust again.## Troubleshoot| Problem | Fix ||---|---|| No auto recall | Quit TRAE completely, restart, new Agent session |-| Connection / auth fails | Check `~/.openviking/ovcli.conf` and restart TRAE |-| Need logs | `~/.openviking/logs/trae-hooks.log` or `trae-cn-hooks.log` |+| TraeCode CLI 2.0 has the plugin but recalls nothing | The startup hook trust was skipped: trust and enable in `/hooks`, confirm the plugin is enabled in `/plugins` |+| Connection / auth fails | Check `~/.openviking/ovcli.conf` and restart the client |+| Need logs | `~/.openviking/logs/trae-hooks.log`, `trae-cn-hooks.log`, or `codex-hooks.log` (TraeCode CLI 2.0) |## Reference- Docs on Manual Settings: [TRAE](https://docs.openviking.net/en/agent-integrations/13-trae)-- Code: [examples/agent-hook-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/agent-hook-plugin)+- Code: [examples/agent-hook-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/agent-hook-plugin) (TRAE / TRAE CN), [examples/codex-memory-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/codex-memory-plugin) (TraeCode CLI 2.0)diff --git a/docs/images/agents/zh/trae.md b/docs/images/agents/zh/trae.mdindex 08081d5e5..6b08d9e55 100644--- a/docs/images/agents/zh/trae.md+++ b/docs/images/agents/zh/trae.md@@ -1,6 +1,6 @@## 步骤1:安装-1. 根据所使用的版本,在终端执行对应的安装命令:+1. 根据所使用的客户端,在终端执行对应的安装命令:**Trae 国际版**@@ -14,6 +14,12 @@bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) --harness trae-cn --dist tos```+ **TraeCode CLI 2.0**++ ```bash+ bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) --harness trae-cli --dist tos+ ```+2. 安装器会依次询问以下信息:语言(English / 中文)、OpenViking 凭据。在 OpenViking 凭据配置中,选择连接至「火山引擎 OpenViking 云服务 [api.vikingdb.cn-beijing.volces.com]」,并填入 API KEY:```text@@ -22,17 +28,32 @@## 步骤2:验证-在「设置 → MCP → 已配置的 MCP Servers」中确认能够看到 `openviking` 条目即表示接入成功。+**TRAE / TRAE CN**:在「设置 → MCP → 已配置的 MCP Servers」中确认能够看到 `openviking` 条目即表示接入成功。++**TraeCode CLI 2.0**:Hook 要先信任才会运行。启动 `trae-cli`,在信任确认上选 **Trust all and continue**:++```text+Hooks need review+6 hooks are new or changed.+Hooks can run outside the sandbox after you trust them.++ 1. Review hooks+> 2. Trust all and continue+ 3. Continue without trusting (hooks won't run)+```++再执行 `trae-cli plugin list`,确认 `openviking-memory` 已启用。错过这个提示,或当时选了第 3 项,Hook 就不会运行:输入 `/hooks` 补上信任并开启条目,`/plugins` 里确认插件已启用——两个开关相互独立,都要是开着的。插件更新动了 Hook 时会再要求信任一次。## 故障排查| 问题 | 处理 ||---|---|| 没有自动召回 | 完全退出 TRAE,重启,再建会话 |-| 连接 / 鉴权失败 | 检查 `~/.openviking/ovcli.conf`,重启 TRAE |-| 需要日志 | `~/.openviking/logs/trae-hooks.log` 或 `trae-cn-hooks.log` |+| TraeCode CLI 2.0 装了插件但不召回 | 启动时的 Hook 信任被跳过:`/hooks` 里信任并开启,`/plugins` 里确认插件已启用 |+| 连接 / 鉴权失败 | 检查 `~/.openviking/ovcli.conf`,重启客户端 |+| 需要日志 | `~/.openviking/logs/trae-hooks.log`、`trae-cn-hooks.log` 或 `codex-hooks.log`(TraeCode CLI 2.0) |## 参考- 手动配置文档:[TRAE](https://docs.openviking.net/zh/agent-integrations/13-trae)-- 源码:[examples/agent-hook-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/agent-hook-plugin)+- 源码:[examples/agent-hook-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/agent-hook-plugin)(TRAE / TRAE CN)、[examples/codex-memory-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/codex-memory-plugin)(TraeCode CLI 2.0)diff --git a/docs/zh/agent-integrations/13-trae.md b/docs/zh/agent-integrations/13-trae.mdindex 60562c41c..f8cab7b03 100644--- a/docs/zh/agent-integrations/13-trae.md+++ b/docs/zh/agent-integrations/13-trae.md@@ -41,7 +41,7 @@ bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shar### TraeCode CLI 2.0:首次启动信任 hooks-TraeCode CLI 2.0 用的是 Codex 插件格式,hooks 要先信任才会运行。启动 `trae-cli` 时会停在这个确认上,选 **Trust all and continue**;想先看一眼 hook 命令就选 Review hooks:+TraeCode CLI 2.0 的 hooks 要先信任才会运行。启动 `trae-cli` 时会停在这个确认上,选 **Trust all and continue**;想先看一眼 hook 命令就选 Review hooks:```textHooks need review