OpenViking 接入 TRAE / TraeCode CLI國內(nèi) 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 上下文數(shù)據(jù)庫與自我進化上下文數(shù)據(jù)庫通過 Hooks MCP 讓國內(nèi) Agent 記住你的偏好、項目知識并隨時主動召回。跟著本文10 分鐘即可完成接入。一、OpenViking 是什么為什么 TRAE 需要它OpenViking自我進化上下文數(shù)據(jù)庫是一個專為 AI Agent 設(shè)計的上下文數(shù)據(jù)庫統(tǒng)一管理三樣?xùn)|西Agent 記憶Memory跨會話記住你的偏好、項目背景知識檢索RAG把文檔、代碼倉庫變成可檢索知識?技能Skills沉淀可復(fù)用的操作經(jīng)驗。TRAE 作為國產(chǎn) IDE/Agent 工具默認只有會話內(nèi)記憶——關(guān)掉窗口上下文就清零。接入 OpenViking 后你告訴 Agent 以后都用 pnpm 管理依賴下一次新開會話它還記得。二、接入原理4 個 Hook 事件 1 個 MCP 服務(wù)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 事件觸發(fā)時機作用SessionStart會話開始自動加載用戶畫像 當前項目記憶UserPromptSubmit你每次提問根據(jù)問題自動召回相關(guān)上下文并注入PreToolUse調(diào)用文件/Shell 工具前攔截viking://虛擬路徑引導(dǎo)改用 MCP 工具Stop每輪回復(fù)結(jié)束捕獲本輪對話并立即提交給記憶抽取器此外還注冊了一個名為openviking-memory的MCP Server透傳服務(wù)端 15 個工具讓 Agent 可以主動管理記憶最常用的幾個工具用途search/find語義搜索記憶與知識modecontext返回組裝好的上下文read/list/tree瀏覽記憶目錄結(jié)構(gòu)remember/write/forget寫入、編輯、刪除記憶health健康檢查驗證連通性三、TRAE 桌面端安裝步驟圖文前置條件macOS 或 Linux、Node.js 18且 TRAE 版本支持 Hook 機制。第 1 步準備 OpenViking 服務(wù)并創(chuàng)建 API Key?；鹕揭?OpenViking 云服務(wù)用戶直接使用控制臺生成的 Key自建用戶確保本機已啟動 OpenViking 服務(wù)。第 2 步打開 TRAE 設(shè)置。第 3 步進入 MCP 設(shè)置面板。第 4 步添加 MCP 服務(wù)器。運行安裝命令后安裝器會自動寫入配置如需手動添加選擇手動配置# 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安裝過程中會引導(dǎo)你填寫 OpenViking 的 URL 與 API Key。第 5 步啟用服務(wù)器。確認openviking狀態(tài)為已連接。第 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 配置復(fù)用 examples/codex-memory-plugin/ 的會話轉(zhuǎn)錄解析與記憶提交流程寫入與 TRAE 圖形端相同的 URI 保護規(guī)則examples/memory-plugin-shared/lib/ 中的共享運行時。驗證安裝trae-cli plugin list輸出中出現(xiàn)openviking-memory且狀態(tài)為啟用即接入成功。卸載trae-cli plugin uninstall openviking-memoryopenviking五、接入后怎么用3 步驗證記憶生效新會話提問問一個與已有項目相關(guān)的問題如這個項目的依賴管理方式是什么確認回答引用了歷史記憶告知偏好告訴 Agent 一個臨時偏好等待回復(fù)完成——StopHook 會在本輪結(jié)束時自動提交內(nèi)容給記憶抽取器跨會話驗證新建會話再次詢問同一偏好若 Agent 依然記得說明捕獲 → 提交 → 召回全鏈路生效 ?六、常見問題速查表現(xiàn)象原因與處理安裝后沒有自動召回完全退出客戶端后重啟并新建 Agent 會話MCP 未連接檢查~/.openviking/ovcli.conf中的 URL / API Key然后重啟客戶端新會話記不住上一輪設(shè)置OPENVIKING_DEBUG1查看 Hook 日志TRAE 為~/.openviking/logs/trae-hooks.logTRAE CN 為trae-cn-hooks.log確認Stop已執(zhí)行且提交無鑒權(quán)錯誤同一內(nèi)容被重復(fù)捕獲用戶級與項目級 Hook 中殘留舊版腳本重跑安裝器會自動移除 OpenViking 管理的舊條目CLI 未列出插件運行trae-cli plugin list缺少時用--harness trae-cli重跑安裝器七、相關(guān)資源官方集成指南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 總結(jié)OpenViking 用被動 Hook 捕獲 主動 MCP 檢索的雙通道設(shè)計為 TRAE 與 TraeCode CLI 補齊了國產(chǎn) Agent 最缺的一塊——跨會話上下文增強。一次安裝所有會話共享同一份記憶?！久赓M下載鏈接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.項目地址: https://gitcode.com/GitHub_Trending/op/OpenViking創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考