MemPalace Agent Skill 實(shí)戰(zhàn)指南三步安裝、三大拓?fù)渑c Shared Brain 協(xié)調(diào)協(xié)議的完整落地方案【免費(fèi)下載鏈接】mempalaceThe best-benchmarked open-source AI memory system. And its free.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/me/mempalace本指南以 MemPalace 倉庫中skills/mempalace/SKILL.md的 Setup Protocol 為主干講解如何以 Skill 優(yōu)先skill-first的方式完成 MemPalace 的安裝、初始化、MCP 接線以及私有本地宮殿private local palace、共享大腦樞紐shared-brain hub與加入現(xiàn)有樞紐的客戶端client三種拓?fù)涞倪x型與實(shí)施。讀完本文你將掌握mempalace instructions、mempalace mcp、mempalace serve、mempalace rules、mempalace logstream與mempalace update等核心命令的正確使用姿勢(shì)并能在接入共享大腦時(shí)理解身份、協(xié)調(diào)與升級(jí)策略的底層約定。這個(gè) Skill 解決什么問題MemPalace 是一套開源 AI 記憶系統(tǒng)a searchable memory palace。當(dāng)你要把某個(gè) AgentClaude Code、Codex、Cursor 等接入記憶宮殿時(shí)正確的安裝順序、拓?fù)溥x型和 MCP 配置缺一不可——而mempalaceSkill 的價(jià)值正在于此它在 MemPalace Python 包或 MCP server 尚未存在時(shí)就可以被安裝npx skills add是正常的引導(dǎo)bootstrap路徑先讓 Agent 擁有一份如何搭起來的步驟清單再去執(zhí)行mempalace init等底層命令。從倉庫結(jié)構(gòu)看mempalaceSkill 與另外兩個(gè) Skill 形成分工mempalace-recall負(fù)責(zé)先檢索再回答的回憶協(xié)議見 skills/mempalace-recall/SKILL.mdmempalace-task負(fù)責(zé)通過 logstream 在 Agent 間傳遞任務(wù)見 skills/mempalace-task/SKILL.md而本 Skill 專管安裝、配置與運(yùn)行——setup、mining、status 三件事。倉庫中對(duì)應(yīng)的交互命令宏slash command文檔位于 commands/mempalace-init.md、commands/mempalace-mine.md、commands/mempalace-search.md、commands/mempalace-status.md、commands/mempalace-help.md它們統(tǒng)一的做法就是調(diào)用mempalaceskill 并執(zhí)行mempalace instructions name然后按輸出的步驟操作。第一步動(dòng)手前先檢查環(huán)境Inspect before changing anythingSetup Protocol 的第一條紀(jì)律是在改動(dòng)任何東西之前先檢查核心原因在于Skill 是被獨(dú)立引導(dǎo)進(jìn) Agent 的Agent 無法假設(shè) Python 包已經(jīng)裝在 PATH 上。檢查項(xiàng)包括檢測(cè)操作系統(tǒng)與當(dāng)前 Agent harness是 CLI 還是 IDE、能否跑后臺(tái)進(jìn)程等。版本探測(cè)運(yùn)行mempalace --version、uv --version并做一次 Python 版本檢查Python 3.9。不要假設(shè)已安裝的 Python 包一定在 PATH 上可達(dá)——它在某個(gè)未激活的 venv 里是完全可能的。檢查是否已存在 palace 與 MCP 注冊(cè)。絕不為了讓安裝更簡(jiǎn)單而重新初始化或重建已有 palace——數(shù)據(jù)與索引重建不可逆會(huì)波及歷史抽屜與日記。mempalace/instructions/init.md中把這一步拆得更細(xì)python3 --versionWindows 用python --version確認(rèn)不低于 3.9隨后運(yùn)行mempalace --version只有命令真的成功才算已安裝——即使pip show mempalace或uv tool list報(bào)告包已存在只要command not found就按未安裝處理并進(jìn)入重裝流程否則后續(xù)mempalace init ...會(huì)直接失敗。第二步僅在必要時(shí)安裝 CLI并優(yōu)先使用 uv當(dāng)檢查發(fā)現(xiàn) CLI 缺失時(shí)首選隔離的 uv tool 安裝uv tool install mempalace如果uv不可用退回到 PATH 可見的 Python 環(huán)境python -m pip install mempalace安裝后務(wù)必再次運(yùn)行mempalace --version若仍不可達(dá)要么修復(fù) PATH要么改用對(duì)應(yīng)的uv tool run調(diào)用方式再進(jìn)行下一步。mempalace/instructions/init.md為安裝失敗給出了一份有序的回退與排障清單uv tool install失敗就換pip install mempalace反之亦然嘗試pip3 install mempalace嘗試python -m pip install mempalace或python3 -m pip install ...若報(bào)錯(cuò)涉及缺失構(gòu)建工具或編譯失敗常見于 chromadb 及其原生依賴Linux/macOS 上裝build-essential python3-devDebian/Ubuntu或xcode-select --installmacOSWindows 上裝 Microsoft C Build Tools然后重試全部失敗則如實(shí)上報(bào)錯(cuò)誤并停下不掩蓋問題繼續(xù)。之所以強(qiáng)調(diào)uv從源碼注釋也可印證uv tool install把 CLI 與系統(tǒng) Python 隔離能規(guī)避大多數(shù)環(huán)境相關(guān)故障見 mempalace/instructions/init.md。第三步與用戶確認(rèn)三大拓?fù)湓谶x擇任何安裝動(dòng)作前需要向用戶確認(rèn)目標(biāo)形態(tài)除非需求已經(jīng)明確。SKILL 定義了三種互斥的拓?fù)渌接斜镜貙m殿private local palace單機(jī)本地 stdio MCP記憶只屬于這臺(tái)機(jī)器共享大腦樞紐shared-brain hub本機(jī)擁有 palace并向整個(gè) Agent 艦隊(duì)提供讀寫與協(xié)調(diào)服務(wù)加入現(xiàn)有樞紐的客戶端client joining an existing hub本機(jī)只作為客戶端連接別處擁有的 hub。同時(shí)詢問要初始化的項(xiàng)目/會(huì)話語料默認(rèn)當(dāng)前工作目錄。共享大腦客戶端絕不能去初始化一份第二個(gè) palace——記憶只有一份屬于樞紐所有者。這三者在后續(xù)步驟的分叉非常明顯新建本地 palace 或 hub 走mempalace instructions init客戶端則跳過本地初始化直接向用戶索要 hub URL 與 bearer token。第四步用版本正確的指令做初始化MemPalace 設(shè)計(jì)了一個(gè)巧妙的機(jī)制來對(duì)抗文檔漂移CLI 本身就是文檔源按當(dāng)前安裝版本動(dòng)態(tài)輸出與該版本嚴(yán)格匹配的指導(dǎo)內(nèi)容命令是mempalace instructions command其中command取值為help、init、mine、search、status。在源碼中對(duì)應(yīng)cmd_instructions處理器它轉(zhuǎn)發(fā)到mempalace/instructions_cli.py的run_instructions并把指令打到 stdout見 mempalace/cli.py。倉庫內(nèi)各命令的指令正文分散在 mempalace/instructions/ 目錄init.md、mine.md、search.md、status.md、help.md。正確流程是先運(yùn)行對(duì)應(yīng)的 instructions 命令拿到當(dāng)前版本的步驟清單再逐條照做。例如 mempalace/instructions/init.md 給出了完整的初始化鏈問項(xiàng)目目錄 →mempalace init --yes dir→ 配置 MCP →mempalace status驗(yàn)證 → 提示下一步用 mine / search。SKILL 在 Step 4 特別強(qiáng)調(diào)了兩點(diǎn)新建本地 palace 或 hub遵循mempalace instructions init配置好所選語料再用mempalace status驗(yàn)證客戶端跳過本地初始化取得 hub URL 與 bearer token。初始化是冪等保護(hù)的重災(zāi)區(qū)這也是第一步絕不重建已有 palace的紀(jì)律延伸。第五步接線 MCP——stdio、hub 與 HTTP 客戶端的正確姿勢(shì)本地 stdio 集成本地集成使用mempalace mcp打印出來的接線命令。該命令在源碼中根據(jù) palace 路徑拼出可復(fù)制的命令行見 mempalace/cli.py典型注冊(cè)如下claude mcp add mempalace -- mempalace-mcp codex mcp add mempalace -- mempalace-mcp其中mempalace-mcp是 stdio MCP server 的可執(zhí)行入口。安裝包本身不等于 MCP 已連接——接線完成后必須重啟/重連 harness并核驗(yàn)實(shí)時(shí) MCP 工具列表中真的出現(xiàn)了 MemPalace 工具。SKILL 與 mempalace/instructions/init.md 都用整段篇幅強(qiáng)調(diào)這一點(diǎn)。共享大腦 hubmempalace serve選共享大腦時(shí)指導(dǎo)用戶運(yùn)行mempalace serve并參考倉庫內(nèi)的 website/guide/shared-brain.md 完整教程。serve是mempalace-mcp --transport http的封裝它會(huì)解析 bearer token非 loopback 綁定時(shí)自動(dòng)生成強(qiáng) token、打印可直接粘貼的客戶端配置然后以前臺(tái)進(jìn)程 exec 真正的 server便于 Docker/systemd 托管進(jìn)程生命周期見 mempalace/cli.py。一個(gè)serve進(jìn)程持有 palace 的寫入租約兩個(gè) server 進(jìn)程絕不能指向同一個(gè) palace。hub 與純本地的關(guān)鍵差異在于本機(jī) stdio 客戶端會(huì)每請(qǐng)求檢查一次palace 是否有活的 hub一旦發(fā)現(xiàn)就把請(qǐng)求自動(dòng)代理auto-proxy給 hub而不是自己打開數(shù)據(jù)庫句柄這是 fleet 免配置共享記憶的底層機(jī)制?？蛻舳薍TTP MCP bearer token加入現(xiàn)有 hub 的客戶端需要在 harness 上配置 HTTP MCP 傳輸并攜帶用戶提供的 bearer token。SKILL 有一條安全紅線絕不把 token 打印或存儲(chǔ)到項(xiàng)目指令、抽屜drawers或 logstream 事件里。部署角度的延伸見 website/guide/remote-server.md。驗(yàn)證環(huán)節(jié)不可跳過無論哪種拓?fù)渥詈笠徊蕉际侵貑?重連 harness → 檢查實(shí)時(shí) MCP 工具列表已包含 MemPalace 工具。包安裝成功不能作為 MCP 已連接的證明。第六步共享大腦的身份與協(xié)調(diào)配置當(dāng)共享大腦模式被選中時(shí)SKILL 要求依次處理以下事項(xiàng)約定穩(wěn)定身份為該 Agent 商定一個(gè)machine-harness形式的穩(wěn)定身份例如mac-claude、windows-codex永不輪換、絕不冒充他人——事件流只能靠穩(wěn)定身份才能審計(jì)。渲染規(guī)范規(guī)則塊mempalace rules --agent machine-harness該命令由cmd_rules實(shí)現(xiàn)按給定 agent 身份輸出共享大腦規(guī)則塊見 mempalace/cli.py實(shí)現(xiàn)轉(zhuǎn)發(fā)到instructions_cli.run_rules。website/guide/shared-brain.md 進(jìn)一步說明輸出被!-- mempalace-shared-brain:start/end --標(biāo)記包裹更新協(xié)議后應(yīng)重渲染并整塊替換而不是手改 N 份系統(tǒng)提示詞放哪取決于 harnessClaude Code 放~/.claude/CLAUDE.mdCodex 放~/.codex/AGENTS.mdAntigravity 等另有位置。核驗(yàn)協(xié)調(diào)可達(dá)性用只讀的mempalace logstream list或等效的 MCP 事件列表調(diào)用確認(rèn)能讀到事件流。logstream 與記憶抽屜是兩層記憶層drawers / KG / diary存值得回想的持久知識(shí)logstream 層events / artifacts存需要在 Agent 間流轉(zhuǎn)的進(jìn)行中工作。確定監(jiān)視watcher模式按 Agent 能力分流能維持后臺(tái) watcher 的本地 palace 所有者或同步副本準(zhǔn)備mempalace logstream watch --agent ... --state-file ...命令詳見 website/guide/shared-brain.md 第 7 節(jié)--agent id展開為--to-agent id --exclude-from-agent id自排除對(duì)防自喚醒是承重的退出碼才是喚醒信號(hào)0有匹配、2空閑超時(shí)、130被打斷純遠(yuǎn)程 MCP 客戶端只能用重復(fù)的mempalace_event_wait調(diào)用做長輪詢把最后處理的事件 id 作為since_event_id攜帶前進(jìn)——絕不能指向本地 SQLite watcher兩者都做不到的輪轉(zhuǎn)型 Agent明確記錄turn-based喚醒時(shí)必須用mempalace_event_list清掃 MCP 收件箱并解釋可能需要給 watch 命令做權(quán)限白名單。另外不要未經(jīng)告知就發(fā)測(cè)試事件logstream 事件不可變append-only。用戶批準(zhǔn)冒煙事件時(shí)要窄化其主題并以一個(gè)確認(rèn)事件閉環(huán)。第七步匯報(bào)就緒狀態(tài)與可選的每周穩(wěn)定版檢查配置結(jié)束后向用戶匯總安裝版本、palace 位置或 hub URL不含機(jī)密、MCP 連接狀態(tài)、穩(wěn)定 Agent 身份、watcher 模式以及第一個(gè)安全的下一步動(dòng)作。若涉及活躍委派轉(zhuǎn)交mempalace-taskSkill見 skills/mempalace-task/SKILL.md。每周穩(wěn)定版檢查默認(rèn)關(guān)閉且從不自動(dòng)安裝SKILL 明確要詢問用戶是否需要每周穩(wěn)定版檢查默認(rèn)否。啟用前應(yīng)說明該功能會(huì)聯(lián)系 PyPI但不發(fā)送任何 palace 內(nèi)容、身份或遙測(cè)。啟用時(shí)務(wù)必記錄實(shí)際使用的安裝器mempalace update configure --enable --installer uv-tool # 或 pipx / pip mempalace update configure --disable # 退出源碼證據(jù)update_awareness.py的_INSTALL_ACTIONS精確限定uv-tool/pipx/pip三種安裝器configure_updates把策略寫入~/.mempalace/updates.jsonchannel固定為stable、默認(rèn)interval_days7且啟用時(shí)未提供合法 installer 會(huì)直接拋錯(cuò)見 mempalace/update_awareness.py 與 mempalace/update_awareness.py。mempalace update configure由cmd_update驅(qū)動(dòng)見 mempalace/cli.py。讀取mempalace_status時(shí)必須正確區(qū)分兩個(gè)版本字段updates.serverpalace 服務(wù)的運(yùn)行時(shí)hubupdates.client存在時(shí)本地代理/客戶端的運(yùn)行時(shí)。兩者版本與安裝器不可混為一談?？蛻舳说纳?jí)走本機(jī)的mempalace update plan遠(yuǎn)程 server 的升級(jí)對(duì)客戶端只是信息性提示——自然地向用戶呈現(xiàn)并請(qǐng) hub 操作者在 palace 所在機(jī)器上準(zhǔn)備與授權(quán)該計(jì)劃。兩條鐵律絕不把客戶端生成的計(jì)劃用于升級(jí) server任何計(jì)劃未經(jīng)明確授權(quán)絕不執(zhí)行。這與_INSTALL_ACTIONS體現(xiàn)的只產(chǎn)出命令由用戶執(zhí)行的保守設(shè)計(jì)一脈相承?；貞浥c任務(wù)的邊界何時(shí)轉(zhuǎn)交其他 SkillmempalaceSkill 只覆蓋 setup、mining 與 status。凡是涉及過去的工作、先前的決策、已經(jīng)歸檔的人這類問題SKILL 明確要求轉(zhuǎn)交mempalace-recallSkill見 skills/mempalace-recall/SKILL.md——它強(qiáng)制執(zhí)行先檢索再回答search-before-answer讓 Agent 讀 palace 而不是靠模型記憶猜測(cè)?；貞浌ぞ叩倪x擇邏輯在那里被整理成一張清晰的映射表需求工具按語義找任意記憶mempalace_search起點(diǎn)實(shí)體的關(guān)系型/時(shí)間型事實(shí)mempalace_kg_query替換單值事實(shí)mempalace_kg_supersede實(shí)體的時(shí)間線故事mempalace_kg_timeline近期會(huì)話連續(xù)性mempalace_diary_read枚舉 wing / roommempalace_list_wings/mempalace_list_rooms記錄本次會(huì)話mempalace_diary_write需要強(qiáng)調(diào)的邊界活躍協(xié)調(diào)不是回憶。向共享 hub 上的其他 Agent 委派任務(wù)、或等待其回復(fù)/補(bǔ)丁時(shí)應(yīng)當(dāng)使用 logstream 工具mempalace_event_append、mempalace_event_wait、mempalace_patch_submit、mempalace_artifact_get而不是抽屜或搜索。同樣的邊界規(guī)則也寫在記憶層的回憶協(xié)議與協(xié)調(diào)協(xié)議兩個(gè)規(guī)范文件中見 integrations/shared/recall-protocol.md 與 integrations/shared/coordination-protocol.md。Cursor 專屬注意事項(xiàng)Cursor 環(huán)境有三條特別提示Cursor 插件會(huì)自動(dòng)注冊(cè)mempalace-mcp而獨(dú)立的npx skills add安裝不會(huì)——所以檢查實(shí)時(shí)工具列表這一驗(yàn)證環(huán)節(jié)在 Cursor 下同樣不可省略commands/mempalace-init.md 也重申了這點(diǎn)插件已自動(dòng)注冊(cè)無需手改mcp.json。若需要每 N 輪 Agent 自動(dòng)后臺(tái)保存 會(huì)話開始時(shí)的記憶召回還要從克隆的 MemPalace 倉庫單獨(dú)運(yùn)行hooks/cursor/install.sh --scope user安裝 Cursor hooks完整教程見倉庫內(nèi)的 website/guide/cursor-hooks.md。從 Cursor 會(huì)話調(diào)用mempalace_diary_write時(shí)推薦的agent_name是cursor-ide——與claude-code、codex的命名先例保持一致這是穩(wěn)定身份規(guī)則在具體 harness 上的落地樣例。規(guī)范參考把協(xié)議落在倉庫里原 SKILL 指向的規(guī)范文檔在倉庫內(nèi)均有對(duì)應(yīng)文件可直接按根目錄相對(duì)路徑閱讀外部站點(diǎn)鏈接不在此展開共享大腦完整教程hub 啟動(dòng)、本地代理自動(dòng)代理、遠(yuǎn)程機(jī)器接線、身份、首次委派、喚醒機(jī)制、跨機(jī)同步等website/guide/shared-brain.mdAgent 協(xié)調(diào)協(xié)議logstream 事件模型與 watcher 紀(jì)律的單一事實(shí)源integrations/shared/coordination-protocol.md回憶協(xié)議與 Cursor recall rule 及各集成共享的標(biāo)準(zhǔn)文本integrations/shared/recall-protocol.mdMCP 集成與部署擴(kuò)展倉庫 website/guide/mcp-integration.md、website/guide/remote-server.md。整體走查一遍可以看出這個(gè) Skill 的技術(shù)要點(diǎn)最終都收斂到同幾條倉庫級(jí)紀(jì)律上先查再動(dòng)不重建已有 palace、版本即文檔一切以mempalace instructions輸出為準(zhǔn)、身份穩(wěn)定machine-harness永不輪換、事件不可變logstream append-only閉環(huán)必須靠新的 ack 事件、更新從不開箱即裝檢查只報(bào)信安裝必須顯式授權(quán)。這套引導(dǎo)協(xié)議既適合單機(jī)首次接入也完整覆蓋了共享大腦艦隊(duì)從接線到升級(jí)的運(yùn)營生命周期?！久赓M(fèi)下載鏈接】mempalaceThe best-benchmarked open-source AI memory system. And its free.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/me/mempalace創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考