戰(zhàn)指南：三步安裝、三大拓?fù)渑c Shared Brain 協(xié)調(diào)協(xié)議的完整落地方案)
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 倉(cāng)庫(kù)中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 解決什么問(wèn)題MemPalace 是一套開(kāi)源 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 擁有一份如何搭起來(lái)的步驟清單再去執(zhí)行mempalace init等底層命令。從倉(cāng)庫(kù)結(jié)構(gòu)看mempalaceSkill 與另外兩個(gè) Skill 形成分工mempalace-recall負(fù)責(zé)先檢索再回答的回憶協(xié)議見(jiàn) skills/mempalace-recall/SKILL.mdmempalace-task負(fù)責(zé)通過(guò) logstream 在 Agent 間傳遞任務(wù)見(jiàn) skills/mempalace-task/SKILL.md而本 Skill 專管安裝、配置與運(yùn)行——setup、mining、status 三件事。倉(cāng)庫(kù)中對(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 無(wú)法假設(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 可見(jiàn)的 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)建工具或編譯失敗常見(jiàn)于 chromadb 及其原生依賴Linux/macOS 上裝build-essential python3-devDebian/Ubuntu或xcode-select --installmacOSWindows 上裝 Microsoft C Build Tools然后重試全部失敗則如實(shí)上報(bào)錯(cuò)誤并停下不掩蓋問(wèn)題繼續(xù)。之所以強(qiáng)調(diào)uv從源碼注釋也可印證uv tool install把 CLI 與系統(tǒng) Python 隔離能規(guī)避大多數(shù)環(huán)境相關(guān)故障見(jià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ě)與協(xié)調(diào)服務(wù)加入現(xiàn)有樞紐的客戶端client joining an existing hub本機(jī)只作為客戶端連接別處擁有的 hub。同時(shí)詢問(wèn)要初始化的項(xiàng)目/會(huì)話語(yǔ)料默認(rèn)當(dāng)前工作目錄。共享大腦客戶端絕不能去初始化一份第二個(gè) palace——記憶只有一份屬于樞紐所有者。這三者在后續(xù)步驟的分叉非常明顯新建本地 palace 或 hub 走mempalace instructions init客戶端則跳過(guò)本地初始化直接向用戶索要 hub URL 與 bearer token。第四步用版本正確的指令做初始化MemPalace 設(shè)計(jì)了一個(gè)巧妙的機(jī)制來(lái)對(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見(jiàn) mempalace/cli.py。倉(cāng)庫(kù)內(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 給出了完整的初始化鏈問(wèn)項(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配置好所選語(yǔ)料再用mempalace status驗(yàn)證客戶端跳過(guò)本地初始化取得 hub URL 與 bearer token。初始化是冪等保護(hù)的重災(zāi)區(qū)這也是第一步絕不重建已有 palace的紀(jì)律延伸。第五步接線 MCP——stdio、hub 與 HTTP 客戶端的正確姿勢(shì)本地 stdio 集成本地集成使用mempalace mcp打印出來(lái)的接線命令。該命令在源碼中根據(jù) palace 路徑拼出可復(fù)制的命令行見(jiàn) 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并參考倉(cāng)庫(kù)內(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)程生命周期見(jiàn) mempalace/cli.py。一個(gè)serve進(jìn)程持有 palace 的寫(xiě)入租約兩個(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而不是自己打開(kāi)數(shù)據(jù)庫(kù)句柄這是 fleet 免配置共享記憶的底層機(jī)制。客戶端HTTP MCP bearer token加入現(xiàn)有 hub 的客戶端需要在 harness 上配置 HTTP MCP 傳輸并攜帶用戶提供的 bearer token。SKILL 有一條安全紅線絕不把 token 打印或存儲(chǔ)到項(xiàng)目指令、抽屜drawers或 logstream 事件里。部署角度的延伸見(jiàn) website/guide/remote-server.md。驗(yàn)證環(huán)節(jié)不可跳過(guò)無(wú)論哪種拓?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ī)則塊見(jiàn) mempalace/cli.py實(shí)現(xiàn)轉(zhuǎn)發(fā)到instructions_cli.run_rules。website/guide/shared-brain.md 進(jìn)一步說(shuō)明輸出被!-- 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 ...命令詳見(jiàn) website/guide/shared-brain.md 第 7 節(jié)--agent id展開(kāi)為--to-agent id --exclude-from-agent id自排除對(duì)防自喚醒是承重的退出碼才是喚醒信號(hào)0有匹配、2空閑超時(shí)、130被打斷純遠(yuǎn)程 MCP 客戶端只能用重復(fù)的mempalace_event_wait調(diào)用做長(zhǎng)輪詢把最后處理的事件 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見(jiàn) skills/mempalace-task/SKILL.md。每周穩(wěn)定版檢查默認(rèn)關(guān)閉且從不自動(dòng)安裝SKILL 明確要詢問(wèn)用戶是否需要每周穩(wěn)定版檢查默認(rèn)否。啟用前應(yīng)說(shuō)明該功能會(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把策略寫(xiě)入~/.mempalace/updates.jsonchannel固定為stable、默認(rèn)interval_days7且啟用時(shí)未提供合法 installer 會(huì)直接拋錯(cuò)見(jiàn) mempalace/update_awareness.py 與 mempalace/update_awareness.py。mempalace update configure由cmd_update驅(qū)動(dòng)見(jiàn) 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。凡是涉及過(guò)去的工作、先前的決策、已經(jīng)歸檔的人這類問(wèn)題SKILL 明確要求轉(zhuǎn)交mempalace-recallSkill見(jiàn) skills/mempalace-recall/SKILL.md——它強(qiáng)制執(zhí)行先檢索再回答search-before-answer讓 Agent 讀 palace 而不是靠模型記憶猜測(cè)?；貞浌ぞ叩倪x擇邏輯在那里被整理成一張清晰的映射表需求工具按語(yǔ)義找任意記憶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é)議與協(xié)調(diào)協(xié)議兩個(gè)規(guī)范文件中見(jiàn) 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è)無(wú)需手改mcp.json。若需要每 N 輪 Agent 自動(dòng)后臺(tái)保存 會(huì)話開(kāi)始時(shí)的記憶召回還要從克隆的 MemPalace 倉(cāng)庫(kù)單獨(dú)運(yùn)行hooks/cursor/install.sh --scope user安裝 Cursor hooks完整教程見(jiàn)倉(cāng)庫(kù)內(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é)議落在倉(cāng)庫(kù)里原 SKILL 指向的規(guī)范文檔在倉(cāng)庫(kù)內(nèi)均有對(duì)應(yīng)文件可直接按根目錄相對(duì)路徑閱讀外部站點(diǎn)鏈接不在此展開(kāi)共享大腦完整教程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ò)展倉(cāng)庫(kù) website/guide/mcp-integration.md、website/guide/remote-server.md。整體走查一遍可以看出這個(gè) Skill 的技術(shù)要點(diǎn)最終都收斂到同幾條倉(cāng)庫(kù)級(jí)紀(jì)律上先查再動(dòng)不重建已有 palace、版本即文檔一切以mempalace instructions輸出為準(zhǔn)、身份穩(wěn)定machine-harness永不輪換、事件不可變logstream append-only閉環(huán)必須靠新的 ack 事件、更新從不開(kāi)箱即裝檢查只報(bào)信安裝必須顯式授權(quán)。這套引導(dǎo)協(xié)議既適合單機(jī)首次接入也完整覆蓋了共享大腦艦隊(duì)從接線到升級(jí)的運(yùn)營(yíng)生命周期?！久赓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），僅供參考 MemPalace Agent Skill 實(shí)戰(zhàn)指南：三步安裝、三大拓?fù)渑c Shared Brain 協(xié)調(diào)協(xié)議的完整落地方案
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 倉(cāng)庫(kù)中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 解決什么問(wèn)題MemPalace 是一套開(kāi)源 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 擁有一份如何搭起來(lái)的步驟清單再去執(zhí)行mempalace init等底層命令。從倉(cāng)庫(kù)結(jié)構(gòu)看mempalaceSkill 與另外兩個(gè) Skill 形成分工mempalace-recall負(fù)責(zé)先檢索再回答的回憶協(xié)議見(jiàn) skills/mempalace-recall/SKILL.mdmempalace-task負(fù)責(zé)通過(guò) logstream 在 Agent 間傳遞任務(wù)見(jiàn) skills/mempalace-task/SKILL.md而本 Skill 專管安裝、配置與運(yùn)行——setup、mining、status 三件事。倉(cāng)庫(kù)中對(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 無(wú)法假設(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 可見(jiàn)的 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)建工具或編譯失敗常見(jiàn)于 chromadb 及其原生依賴Linux/macOS 上裝build-essential python3-devDebian/Ubuntu或xcode-select --installmacOSWindows 上裝 Microsoft C Build Tools然后重試全部失敗則如實(shí)上報(bào)錯(cuò)誤并停下不掩蓋問(wèn)題繼續(xù)。之所以強(qiáng)調(diào)uv從源碼注釋也可印證uv tool install把 CLI 與系統(tǒng) Python 隔離能規(guī)避大多數(shù)環(huán)境相關(guān)故障見(jià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ě)與協(xié)調(diào)服務(wù)加入現(xiàn)有樞紐的客戶端client joining an existing hub本機(jī)只作為客戶端連接別處擁有的 hub。同時(shí)詢問(wèn)要初始化的項(xiàng)目/會(huì)話語(yǔ)料默認(rèn)當(dāng)前工作目錄。共享大腦客戶端絕不能去初始化一份第二個(gè) palace——記憶只有一份屬于樞紐所有者。這三者在后續(xù)步驟的分叉非常明顯新建本地 palace 或 hub 走mempalace instructions init客戶端則跳過(guò)本地初始化直接向用戶索要 hub URL 與 bearer token。第四步用版本正確的指令做初始化MemPalace 設(shè)計(jì)了一個(gè)巧妙的機(jī)制來(lái)對(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見(jiàn) mempalace/cli.py。倉(cāng)庫(kù)內(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 給出了完整的初始化鏈問(wèn)項(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配置好所選語(yǔ)料再用mempalace status驗(yàn)證客戶端跳過(guò)本地初始化取得 hub URL 與 bearer token。初始化是冪等保護(hù)的重災(zāi)區(qū)這也是第一步絕不重建已有 palace的紀(jì)律延伸。第五步接線 MCP——stdio、hub 與 HTTP 客戶端的正確姿勢(shì)本地 stdio 集成本地集成使用mempalace mcp打印出來(lái)的接線命令。該命令在源碼中根據(jù) palace 路徑拼出可復(fù)制的命令行見(jiàn) 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并參考倉(cāng)庫(kù)內(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)程生命周期見(jiàn) mempalace/cli.py。一個(gè)serve進(jìn)程持有 palace 的寫(xiě)入租約兩個(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而不是自己打開(kāi)數(shù)據(jù)庫(kù)句柄這是 fleet 免配置共享記憶的底層機(jī)制。客戶端HTTP MCP bearer token加入現(xiàn)有 hub 的客戶端需要在 harness 上配置 HTTP MCP 傳輸并攜帶用戶提供的 bearer token。SKILL 有一條安全紅線絕不把 token 打印或存儲(chǔ)到項(xiàng)目指令、抽屜drawers或 logstream 事件里。部署角度的延伸見(jiàn) website/guide/remote-server.md。驗(yàn)證環(huán)節(jié)不可跳過(guò)無(wú)論哪種拓?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ī)則塊見(jiàn) mempalace/cli.py實(shí)現(xiàn)轉(zhuǎn)發(fā)到instructions_cli.run_rules。website/guide/shared-brain.md 進(jìn)一步說(shuō)明輸出被!-- 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 ...命令詳見(jiàn) website/guide/shared-brain.md 第 7 節(jié)--agent id展開(kāi)為--to-agent id --exclude-from-agent id自排除對(duì)防自喚醒是承重的退出碼才是喚醒信號(hào)0有匹配、2空閑超時(shí)、130被打斷純遠(yuǎn)程 MCP 客戶端只能用重復(fù)的mempalace_event_wait調(diào)用做長(zhǎng)輪詢把最后處理的事件 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見(jiàn) skills/mempalace-task/SKILL.md。每周穩(wěn)定版檢查默認(rèn)關(guān)閉且從不自動(dòng)安裝SKILL 明確要詢問(wèn)用戶是否需要每周穩(wěn)定版檢查默認(rèn)否。啟用前應(yīng)說(shuō)明該功能會(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把策略寫(xiě)入~/.mempalace/updates.jsonchannel固定為stable、默認(rèn)interval_days7且啟用時(shí)未提供合法 installer 會(huì)直接拋錯(cuò)見(jiàn) mempalace/update_awareness.py 與 mempalace/update_awareness.py。mempalace update configure由cmd_update驅(qū)動(dòng)見(jiàn) 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。凡是涉及過(guò)去的工作、先前的決策、已經(jīng)歸檔的人這類問(wèn)題SKILL 明確要求轉(zhuǎn)交mempalace-recallSkill見(jiàn) skills/mempalace-recall/SKILL.md——它強(qiáng)制執(zhí)行先檢索再回答search-before-answer讓 Agent 讀 palace 而不是靠模型記憶猜測(cè)?；貞浌ぞ叩倪x擇邏輯在那里被整理成一張清晰的映射表需求工具按語(yǔ)義找任意記憶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é)議與協(xié)調(diào)協(xié)議兩個(gè)規(guī)范文件中見(jiàn) 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è)無(wú)需手改mcp.json。若需要每 N 輪 Agent 自動(dòng)后臺(tái)保存 會(huì)話開(kāi)始時(shí)的記憶召回還要從克隆的 MemPalace 倉(cāng)庫(kù)單獨(dú)運(yùn)行hooks/cursor/install.sh --scope user安裝 Cursor hooks完整教程見(jiàn)倉(cāng)庫(kù)內(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é)議落在倉(cāng)庫(kù)里原 SKILL 指向的規(guī)范文檔在倉(cāng)庫(kù)內(nèi)均有對(duì)應(yīng)文件可直接按根目錄相對(duì)路徑閱讀外部站點(diǎn)鏈接不在此展開(kāi)共享大腦完整教程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ò)展倉(cāng)庫(kù) website/guide/mcp-integration.md、website/guide/remote-server.md。整體走查一遍可以看出這個(gè) Skill 的技術(shù)要點(diǎn)最終都收斂到同幾條倉(cāng)庫(kù)級(jí)紀(jì)律上先查再動(dòng)不重建已有 palace、版本即文檔一切以mempalace instructions輸出為準(zhǔn)、身份穩(wěn)定machine-harness永不輪換、事件不可變logstream append-only閉環(huán)必須靠新的 ack 事件、更新從不開(kāi)箱即裝檢查只報(bào)信安裝必須顯式授權(quán)。這套引導(dǎo)協(xié)議既適合單機(jī)首次接入也完整覆蓋了共享大腦艦隊(duì)從接線到升級(jí)的運(yùn)營(yíng)生命周期?！久赓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），僅供參考