機制深度解析)
ai-memory run工作原理原生會話恢復(fù)機制深度解析【免費下載鏈接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors項目地址: https://gitcode.com/GitHub_Trending/ai/ai-memoryai-memory 是一個面向 agent 編碼 CLI 的長期記憶開源方案其核心命令ai-memory run會為每個編碼 CLI 透明地創(chuàng)建或恢復(fù)原生會話讓一條邏輯工作線Workstream在 Claude Code、Codex、OpenCode 等不同廠商的工具之間無縫續(xù)接。本文從新手視角完整拆解 ai-memory run 的會話恢復(fù)機制90 秒租約、30 秒心跳、只讀轉(zhuǎn)錄導(dǎo)入是如何協(xié)作保證你換工具不丟上下文的。ai-memory run 是什么一條命令串起多個編碼 CLI 的會話沒有 ai-memory 時你與 Claude Code 的對話存在 Claude 的本地會話庫與 Codex 的對話存在 Codex 的本地會話庫——兩者互不可見切換工具等于從零開始。ai-memory run是一個可選啟用opt-in的啟動器它把你的原生 harness 啟動包成一次托管運行并在每個 agent 退出后以只讀方式讀取該 agent 寫入本地的會話轉(zhuǎn)錄導(dǎo)入到共享的 Workstream 賬本中。常見用法harness 名之后的一切都是原生參數(shù)無需--分隔符ai-memory run claude # 啟動 Claude Code自動綁定當(dāng)前 Workstream # 退出后換 Codex 繼續(xù)同一條邏輯工作線 ai-memory run codex # 或直接裸跑自動繼續(xù)最近一次可用的本地會話 ai-memory run三個值得先建立的心智模型沒有全局開關(guān)、沒有 switch 命令——用了run就是托管模式同一個倉庫 worktree 映射到同一條 Workstream多臺機器可共享同一份記憶適配器從不寫任何 harness 的私有會話存儲只讀不寫。三個核心概念Workstream、租約與 Launch Plan讀懂流程前先記住三個概念 概念作用Workstream工作流一條邏輯連續(xù)的工作線以(workspace, project, 倉庫指紋, worktree 指紋)定位Lease90 秒可續(xù)租約一條 Workstream 同時只允許一個寫入者防止兩個終端同時改動原生會話指針Launch Planai-memory 補好創(chuàng)建/恢復(fù)選擇器后的最終原生命令行用戶自帶的參數(shù)永遠(yuǎn)不被改寫一次 ai-memory run 的完整五步拆解第一步解析作用域并獲取 90 秒租約客戶端先解析 workspace/project 作用域與穩(wěn)定的倉庫指紋再向服務(wù)器申請托管運行。若另一個啟動器還在收尾客戶端會在 5 秒窗口內(nèi)每 250ms 重試一次而不是直接報錯——這是兩個終端交接時的常見場景。第二步自動挑選最近會話所屬的 harness裸模式不指定 harness時ai-memory 會掃描本檢出版 Claude Code、Codex、OpenCode、Pi、Crush、Kimi Code、Command Code 以及 Kiro CLI v2/v3 的本地會話按更新時間排序并只保留可執(zhí)行文件確實可用的候選。對于已建立established的 Workstream服務(wù)器狀態(tài)優(yōu)先恢復(fù)最近綁定過、且本地仍可用的 harness——絕不會僅僅因為另一個工具的會話文件時間戳更新就去選一個早已過期的會話。第三步為每個 harness 生成差異化的原生恢復(fù)命令這是原生會話恢復(fù)的心臟所在。harness.rs 中的build_launch_plan按 harness 注入對應(yīng)的會話選擇器且僅當(dāng)用戶沒有自帶原生選擇器時才注入Harness新會話恢復(fù)已有會話只讀轉(zhuǎn)錄源Claude Code生成 UUID 注入--session-id--resume id~/.claude/projects/**/*.jsonlCodex原生默認(rèn)創(chuàng)建resume id~/.codex/sessions/**/rollout-*.jsonlOpenCode原生默認(rèn)創(chuàng)建--session idopencode.db只讀打開Pi生成 UUID 注入--session-id--session id~/.pi/agent/sessions/**/*.jsonlKiro CLI原生默認(rèn)創(chuàng)建--resume-id uuid$KIRO_HOME/sessions/**Antigravity原生默認(rèn)創(chuàng)建--conversation id~/.gemini/antigravity-cli/conversations/注入恢復(fù)標(biāo)志前啟動器會先在原生會話庫中只讀核驗該會話是否真實存在——如果轉(zhuǎn)錄已被刪除就新建會話并在觀察到新會話后把 Workstream 重新指過去讓你不會卡死在一個壞鏈上。第四步拉起 agent 進(jìn)程并維持 30 秒心跳子進(jìn)程啟動時ai-memory 注入AI_MEMORY_RUN_ID與AI_MEMORY_WORKSTREAM_ID兩個環(huán)境變量讓生命周期鉤子認(rèn)出這是托管運行SessionStart 鉤子把真實的原生會話綁定到 Workstream并只注入該會話還沒見過的便攜式歷史。與此同時父進(jìn)程每 30 秒發(fā)一次心跳10 秒超時維持租約服務(wù)器短暫失聯(lián)時只打印一條提示、靜默重試恢復(fù)后再打印一條心跳已恢復(fù)——你正在終端里的 agent 全程不受影響。第五步退出后只讀導(dǎo)出轉(zhuǎn)錄分批導(dǎo)入賬本子進(jìn)程退出后客戶端依次做四件事等待轉(zhuǎn)錄落盤導(dǎo)出可見的用戶/助手消息、已完成工具調(diào)用與壓縮摘要隱藏推理與私有記錄一律不復(fù)制并記錄為抽取損耗標(biāo)注按400 個事件或 1MB為一批的有界批次上報服務(wù)器使用確定性事件 ID 增量源游標(biāo)重試不會產(chǎn)生重復(fù)歷史把不可變的已脫敏 JSONL 段寫入賬本原樣保留原生進(jìn)程的退出碼返回給 shell。下一個接手的 harness 收到的只是有界的最近增量——沒有任何 agent 的上下文窗口能安全吞下無界轉(zhuǎn)錄。完整賬本仍然可以在 agent 進(jìn)程內(nèi)用ai-memory workstream-search搜索。原生會話恢復(fù)的三個關(guān)鍵細(xì)節(jié)首次采納一鍵續(xù)接已有的本地會話Workstream 還是空的、且是交互式啟動時ai-memory 只讀不修改該 harness 的會話庫列出最多 8 個記錄的工作目錄與當(dāng)前檢出匹配的近期會話直接回車恢復(fù)最新的輸序號恢復(fù)指定的輸入0開始全新會話。其他目錄的會話永遠(yuǎn)不會出現(xiàn)在列表里。需要強調(diào)采納只是引導(dǎo)bootstrap行為。一旦有任何 harness 綁定過會話或貢獻(xiàn)過便攜歷史Workstream 即已建立——之后換工具只恢復(fù)該工具自己綁定的那個會話不會去翻舊的不相干會話。孤兒會話回退轉(zhuǎn)錄丟失時自動新建并重指在添加恢復(fù)標(biāo)志之前run.rs 中的build_preflighted_launch_plan會先在原生存儲中校驗綁定會話。若轉(zhuǎn)錄被刪除、清空或隨沙盒覆蓋丟失ai-memory 會新建一個原生會話等新會話被觀察到后把同一條 Workstream 重指過去而讀不懂的會話庫會被報告但不會被誤判為會話丟失。想刻意跳過綁定會話時用--fresh它不能與原生 resume/continue 選擇器同用。顯式選擇器永遠(yuǎn)優(yōu)先原生 --resume 永不被覆蓋如果你已經(jīng)寫了原生選擇器Claude 的--resume、Codex 的resume、OpenCode 的--session、Antigravity 的--conversation等ai-memory 從不改寫只負(fù)責(zé)綁定該會話并重置不相干的適配器游標(biāo)。這是透明啟動器承諾的底線你的原生用法永遠(yuǎn)是權(quán)威。容錯設(shè)計kill -9 與服務(wù)器中斷都不丟會話正常退出導(dǎo)入轉(zhuǎn)錄、釋放租約、返回退出碼一氣呵成kill -9 強殺租約在 90 秒內(nèi)自動過期下一次托管運行從上次已提交的游標(biāo)繼續(xù)缺失的尾部可以被補齊導(dǎo)入且已導(dǎo)入的事件不會重復(fù)服務(wù)器中斷心跳探測間隔 30 秒、請求超時 10 秒保證 90 秒租約能扛過普通的服務(wù)器重啟中斷超過一個租約窗口后舊啟動器只有在沒有更新啟動器接管時才允許續(xù)租進(jìn)程啟動前服務(wù)器/鑒權(quán)失敗快速失敗——ai-memory 絕不悄悄啟動一個無人管理的 agent。如何深入源碼與官方文檔托管運行邏輯集中在兩個 crate閱讀路徑很清晰啟動器主流程run.rs——租約、會話采納、拉起子進(jìn)程、心跳、分批導(dǎo)入都在這里各 harness 原生適配器harness.rs——12 個 harness 的創(chuàng)建/恢復(fù)選擇器規(guī)則與--yolo標(biāo)志翻譯表官方文檔docs/managed-workstreams.md——What happens on each run 五步流程與完整原生適配器行為表真機驗收腳本scripts/managed-workstream-acceptance.sh——跨 harness 真實會話往返驗證。會話記憶積累之后你可以在 Web 界面瀏覽由原生會話編譯出的 wiki 頁面總結(jié)一句話概括 ai-memory run 的工作原理它沒有重造會話系統(tǒng)而是給每個 harness 的原生會話套上一層綁定、只讀導(dǎo)入、心跳保護(hù)的托管殼——首次運行時可以采納已有本地會話切換工具時自動注入正確的 resume 標(biāo)志與有界上下文退出時把轉(zhuǎn)錄導(dǎo)出進(jìn)共享賬本。從此agent 的長期記憶不再依附于任何單一工具換廠商也能無縫續(xù)寫 【免費下載鏈接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors項目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 ai-memory run工作原理：原生會話恢復(fù)機制深度解析
ai-memory run工作原理原生會話恢復(fù)機制深度解析【免費下載鏈接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors項目地址: https://gitcode.com/GitHub_Trending/ai/ai-memoryai-memory 是一個面向 agent 編碼 CLI 的長期記憶開源方案其核心命令ai-memory run會為每個編碼 CLI 透明地創(chuàng)建或恢復(fù)原生會話讓一條邏輯工作線Workstream在 Claude Code、Codex、OpenCode 等不同廠商的工具之間無縫續(xù)接。本文從新手視角完整拆解 ai-memory run 的會話恢復(fù)機制90 秒租約、30 秒心跳、只讀轉(zhuǎn)錄導(dǎo)入是如何協(xié)作保證你換工具不丟上下文的。ai-memory run 是什么一條命令串起多個編碼 CLI 的會話沒有 ai-memory 時你與 Claude Code 的對話存在 Claude 的本地會話庫與 Codex 的對話存在 Codex 的本地會話庫——兩者互不可見切換工具等于從零開始。ai-memory run是一個可選啟用opt-in的啟動器它把你的原生 harness 啟動包成一次托管運行并在每個 agent 退出后以只讀方式讀取該 agent 寫入本地的會話轉(zhuǎn)錄導(dǎo)入到共享的 Workstream 賬本中。常見用法harness 名之后的一切都是原生參數(shù)無需--分隔符ai-memory run claude # 啟動 Claude Code自動綁定當(dāng)前 Workstream # 退出后換 Codex 繼續(xù)同一條邏輯工作線 ai-memory run codex # 或直接裸跑自動繼續(xù)最近一次可用的本地會話 ai-memory run三個值得先建立的心智模型沒有全局開關(guān)、沒有 switch 命令——用了run就是托管模式同一個倉庫 worktree 映射到同一條 Workstream多臺機器可共享同一份記憶適配器從不寫任何 harness 的私有會話存儲只讀不寫。三個核心概念Workstream、租約與 Launch Plan讀懂流程前先記住三個概念 概念作用Workstream工作流一條邏輯連續(xù)的工作線以(workspace, project, 倉庫指紋, worktree 指紋)定位Lease90 秒可續(xù)租約一條 Workstream 同時只允許一個寫入者防止兩個終端同時改動原生會話指針Launch Planai-memory 補好創(chuàng)建/恢復(fù)選擇器后的最終原生命令行用戶自帶的參數(shù)永遠(yuǎn)不被改寫一次 ai-memory run 的完整五步拆解第一步解析作用域并獲取 90 秒租約客戶端先解析 workspace/project 作用域與穩(wěn)定的倉庫指紋再向服務(wù)器申請托管運行。若另一個啟動器還在收尾客戶端會在 5 秒窗口內(nèi)每 250ms 重試一次而不是直接報錯——這是兩個終端交接時的常見場景。第二步自動挑選最近會話所屬的 harness裸模式不指定 harness時ai-memory 會掃描本檢出版 Claude Code、Codex、OpenCode、Pi、Crush、Kimi Code、Command Code 以及 Kiro CLI v2/v3 的本地會話按更新時間排序并只保留可執(zhí)行文件確實可用的候選。對于已建立established的 Workstream服務(wù)器狀態(tài)優(yōu)先恢復(fù)最近綁定過、且本地仍可用的 harness——絕不會僅僅因為另一個工具的會話文件時間戳更新就去選一個早已過期的會話。第三步為每個 harness 生成差異化的原生恢復(fù)命令這是原生會話恢復(fù)的心臟所在。harness.rs 中的build_launch_plan按 harness 注入對應(yīng)的會話選擇器且僅當(dāng)用戶沒有自帶原生選擇器時才注入Harness新會話恢復(fù)已有會話只讀轉(zhuǎn)錄源Claude Code生成 UUID 注入--session-id--resume id~/.claude/projects/**/*.jsonlCodex原生默認(rèn)創(chuàng)建resume id~/.codex/sessions/**/rollout-*.jsonlOpenCode原生默認(rèn)創(chuàng)建--session idopencode.db只讀打開Pi生成 UUID 注入--session-id--session id~/.pi/agent/sessions/**/*.jsonlKiro CLI原生默認(rèn)創(chuàng)建--resume-id uuid$KIRO_HOME/sessions/**Antigravity原生默認(rèn)創(chuàng)建--conversation id~/.gemini/antigravity-cli/conversations/注入恢復(fù)標(biāo)志前啟動器會先在原生會話庫中只讀核驗該會話是否真實存在——如果轉(zhuǎn)錄已被刪除就新建會話并在觀察到新會話后把 Workstream 重新指過去讓你不會卡死在一個壞鏈上。第四步拉起 agent 進(jìn)程并維持 30 秒心跳子進(jìn)程啟動時ai-memory 注入AI_MEMORY_RUN_ID與AI_MEMORY_WORKSTREAM_ID兩個環(huán)境變量讓生命周期鉤子認(rèn)出這是托管運行SessionStart 鉤子把真實的原生會話綁定到 Workstream并只注入該會話還沒見過的便攜式歷史。與此同時父進(jìn)程每 30 秒發(fā)一次心跳10 秒超時維持租約服務(wù)器短暫失聯(lián)時只打印一條提示、靜默重試恢復(fù)后再打印一條心跳已恢復(fù)——你正在終端里的 agent 全程不受影響。第五步退出后只讀導(dǎo)出轉(zhuǎn)錄分批導(dǎo)入賬本子進(jìn)程退出后客戶端依次做四件事等待轉(zhuǎn)錄落盤導(dǎo)出可見的用戶/助手消息、已完成工具調(diào)用與壓縮摘要隱藏推理與私有記錄一律不復(fù)制并記錄為抽取損耗標(biāo)注按400 個事件或 1MB為一批的有界批次上報服務(wù)器使用確定性事件 ID 增量源游標(biāo)重試不會產(chǎn)生重復(fù)歷史把不可變的已脫敏 JSONL 段寫入賬本原樣保留原生進(jìn)程的退出碼返回給 shell。下一個接手的 harness 收到的只是有界的最近增量——沒有任何 agent 的上下文窗口能安全吞下無界轉(zhuǎn)錄。完整賬本仍然可以在 agent 進(jìn)程內(nèi)用ai-memory workstream-search搜索。原生會話恢復(fù)的三個關(guān)鍵細(xì)節(jié)首次采納一鍵續(xù)接已有的本地會話Workstream 還是空的、且是交互式啟動時ai-memory 只讀不修改該 harness 的會話庫列出最多 8 個記錄的工作目錄與當(dāng)前檢出匹配的近期會話直接回車恢復(fù)最新的輸序號恢復(fù)指定的輸入0開始全新會話。其他目錄的會話永遠(yuǎn)不會出現(xiàn)在列表里。需要強調(diào)采納只是引導(dǎo)bootstrap行為。一旦有任何 harness 綁定過會話或貢獻(xiàn)過便攜歷史Workstream 即已建立——之后換工具只恢復(fù)該工具自己綁定的那個會話不會去翻舊的不相干會話。孤兒會話回退轉(zhuǎn)錄丟失時自動新建并重指在添加恢復(fù)標(biāo)志之前run.rs 中的build_preflighted_launch_plan會先在原生存儲中校驗綁定會話。若轉(zhuǎn)錄被刪除、清空或隨沙盒覆蓋丟失ai-memory 會新建一個原生會話等新會話被觀察到后把同一條 Workstream 重指過去而讀不懂的會話庫會被報告但不會被誤判為會話丟失。想刻意跳過綁定會話時用--fresh它不能與原生 resume/continue 選擇器同用。顯式選擇器永遠(yuǎn)優(yōu)先原生 --resume 永不被覆蓋如果你已經(jīng)寫了原生選擇器Claude 的--resume、Codex 的resume、OpenCode 的--session、Antigravity 的--conversation等ai-memory 從不改寫只負(fù)責(zé)綁定該會話并重置不相干的適配器游標(biāo)。這是透明啟動器承諾的底線你的原生用法永遠(yuǎn)是權(quán)威。容錯設(shè)計kill -9 與服務(wù)器中斷都不丟會話正常退出導(dǎo)入轉(zhuǎn)錄、釋放租約、返回退出碼一氣呵成kill -9 強殺租約在 90 秒內(nèi)自動過期下一次托管運行從上次已提交的游標(biāo)繼續(xù)缺失的尾部可以被補齊導(dǎo)入且已導(dǎo)入的事件不會重復(fù)服務(wù)器中斷心跳探測間隔 30 秒、請求超時 10 秒保證 90 秒租約能扛過普通的服務(wù)器重啟中斷超過一個租約窗口后舊啟動器只有在沒有更新啟動器接管時才允許續(xù)租進(jìn)程啟動前服務(wù)器/鑒權(quán)失敗快速失敗——ai-memory 絕不悄悄啟動一個無人管理的 agent。如何深入源碼與官方文檔托管運行邏輯集中在兩個 crate閱讀路徑很清晰啟動器主流程run.rs——租約、會話采納、拉起子進(jìn)程、心跳、分批導(dǎo)入都在這里各 harness 原生適配器harness.rs——12 個 harness 的創(chuàng)建/恢復(fù)選擇器規(guī)則與--yolo標(biāo)志翻譯表官方文檔docs/managed-workstreams.md——What happens on each run 五步流程與完整原生適配器行為表真機驗收腳本scripts/managed-workstream-acceptance.sh——跨 harness 真實會話往返驗證。會話記憶積累之后你可以在 Web 界面瀏覽由原生會話編譯出的 wiki 頁面總結(jié)一句話概括 ai-memory run 的工作原理它沒有重造會話系統(tǒng)而是給每個 harness 的原生會話套上一層綁定、只讀導(dǎo)入、心跳保護(hù)的托管殼——首次運行時可以采納已有本地會話切換工具時自動注入正確的 resume 標(biāo)志與有界上下文退出時把轉(zhuǎn)錄導(dǎo)出進(jìn)共享賬本。從此agent 的長期記憶不再依附于任何單一工具換廠商也能無縫續(xù)寫 【免費下載鏈接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors項目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考