OpenViking 接入 TRAE / TraeCode CLI國內(nèi) Agent 上下文增強(qiáng)完整指南【免費(fèi)下載鏈接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/op/OpenViking想讓TRAE或TraeCode CLI擁有跨會話的長期記憶本文介紹OpenViking 記憶插件一套 AI Agent 上下文數(shù)據(jù)庫與自我進(jìn)化上下文數(shù)據(jù)庫通過 Hooks MCP 讓國內(nèi) Agent 記住你的偏好、項(xiàng)目知識并隨時主動召回。跟著本文10 分鐘即可完成接入。一、OpenViking 是什么為什么 TRAE 需要它OpenViking自我進(jìn)化上下文數(shù)據(jù)庫是一個專為 AI Agent 設(shè)計(jì)的上下文數(shù)據(jù)庫統(tǒng)一管理三樣?xùn)|西Agent 記憶Memory跨會話記住你的偏好、項(xiàng)目背景知識檢索RAG把文檔、代碼倉庫變成可檢索知識?技能Skills沉淀可復(fù)用的操作經(jīng)驗(yàn)。TRAE 作為國產(chǎn) IDE/Agent 工具默認(rèn)只有會話內(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ā)時機(jī)作用SessionStart會話開始自動加載用戶畫像 當(dāng)前項(xiàng)目記憶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健康檢查驗(yàn)證連通性三、TRAE 桌面端安裝步驟圖文前置條件macOS 或 Linux、Node.js 18且 TRAE 版本支持 Hook 機(jī)制。第 1 步準(zhǔn)備 OpenViking 服務(wù)并創(chuàng)建 API Key。火山引擎 OpenViking 云服務(wù)用戶直接使用控制臺生成的 Key自建用戶確保本機(jī)已啟動 OpenViking 服務(wù)。第 2 步打開 TRAE 設(shè)置。第 3 步進(jìn)入 MCP 設(shè)置面板。第 4 步添加 MCP 服務(wù)器。運(yùn)行安裝命令后安裝器會自動寫入配置如需手動添加選擇手動配置# 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ù)器。確認(rèn)openviking狀態(tài)為已連接。第 6 步驗(yàn)證。在 TRAE 的 Agent 會話中運(yùn)行ov-ls查看記憶目錄運(yùn)行health檢查連通性?? 如果 MCP 連接報 schema 錯誤通常是 Node.js 版本過低要求 18或舊版 TRAE 的 JSON Schema 校驗(yàn)較嚴(yán)格完整圖文版教程見官方文檔docs/zh/agent-integrations/13-trae.md。四、TraeCode CLI 2.0 接入方案TraeCode CLI 2.0 直接使用兼容 Codex 的插件格式無需單獨(dú)寫 Hook 適配器舊版獨(dú)立 Hooks 集成 examples/trae-cli-memory-hooks/ 已標(biāo)記棄用僅用于兼容卸載。一鍵安裝bash examples/memory-plugin-shared/install.sh --harness trae-cli安裝器會完成三件事把openviking-memory插件注冊進(jìn)~/.trae/traecli.toml的 MCP 配置復(fù)用 examples/codex-memory-plugin/ 的會話轉(zhuǎn)錄解析與記憶提交流程寫入與 TRAE 圖形端相同的 URI 保護(hù)規(guī)則examples/memory-plugin-shared/lib/ 中的共享運(yùn)行時。驗(yàn)證安裝trae-cli plugin list輸出中出現(xiàn)openviking-memory且狀態(tài)為啟用即接入成功。卸載trae-cli plugin uninstall openviking-memoryopenviking五、接入后怎么用3 步驗(yàn)證記憶生效新會話提問問一個與已有項(xiàng)目相關(guān)的問題如這個項(xiàng)目的依賴管理方式是什么確認(rèn)回答引用了歷史記憶告知偏好告訴 Agent 一個臨時偏好等待回復(fù)完成——StopHook 會在本輪結(jié)束時自動提交內(nèi)容給記憶抽取器跨會話驗(yàn)證新建會話再次詢問同一偏好若 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確認(rèn)Stop已執(zhí)行且提交無鑒權(quán)錯誤同一內(nèi)容被重復(fù)捕獲用戶級與項(xiàng)目級 Hook 中殘留舊版腳本重跑安裝器會自動移除 OpenViking 管理的舊條目CLI 未列出插件運(yùn)行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è)計(jì)為 TRAE 與 TraeCode CLI 補(bǔ)齊了國產(chǎn) Agent 最缺的一塊——跨會話上下文增強(qiáng)。一次安裝所有會話共享同一份記憶?！久赓M(fèi)下載鏈接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/op/OpenViking創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考