2026/9/2 13:46:54
FEATURED · 精选文章 
MemPalace CLI命令全集mine、search、sweep、repair、export逐个讲透【免费下载链接】mempalaceThe best-benchmarked open-source AI memory system. And its free.项目地址: https://gitcode.com/GitHub_Trending/me/mempalaceMemPalace 是一个本地免费、无需 API Key 的开源AI 记忆系统而它的 CLI 命令行是日常使用中最直接的入口。本文带你快速掌握 MemPalace CLI 命令全集从最核心的mine挖掘记忆、search精准搜索、sweep补漏挖掘到repair索引修复和export记忆导出逐个讲透每个命令的用途、常用参数和使用场景新手照着敲一遍就能上手。所有命令都集中在 mempalace/cli.py 中定义直接输入mempalace --help即可查看全部用法。一、先建立心智模型宫殿、机翼、房间在使用 CLI 之前先花 30 秒理解三个名词后面所有命令都会用到Palace宫殿你的记忆库本地存储Wing机翼一个项目或一个来源例如某个代码仓库Room房间机翼下按目录结构自动划分的主题分区init命令就是干这件事的扫描项目目录自动检测房间结构。mempalace init ~/projects/my_app检测逻辑见 project_scanner.py房间识别见 room_detector_local.py。二、mine把文件挖掘进记忆库mine是最常用的命令负责把内容写入宫殿。它支持三种挖掘模式参数定义见 cli.py# 模式1代码与文档默认 mempalace mine ~/projects/my_app # 模式2聊天记录Claude Code、ChatGPT、Slack 导出 mempalace mine ~/convo_dir --mode convos # 模式3办公文档PDF、DOCX、PPTX、EPUB 等 mempalace mine ~/docs_dir --mode extract几个新手最常用的可选参数参数作用--wing 名称指定机翼名默认用目录名--dry-run只预览不真正写入--limit N最多处理 N 个文件适合先小试牛刀--no-gitignore连 .gitignore 里的文件也一起挖掘--daemon --background丢进后台守护队列立即返回任务 ID挖掘执行器在 miner.py。一个实用技巧先用--dry-run --limit 10试跑确认分类合理后再全量挖掘。三、sweep给漏网之鱼补挖sweep是 tandem miner搭档矿工主挖掘器没抓到的消息它会按消息级别、基于时间戳做二次捕捉且幂等可重复执行不会写入重复记忆实现见 sweeper.py。# 扫一个 .jsonl 会话记录文件 mempalace sweep ~/.claude/projects/xxx/session.jsonl # 或递归扫一个目录 mempalace sweep ~/.claude/projects/什么时候用当你发现某次对话的关键结论搜索不到时对原始会话文件跑一次sweep即可补齐。四、search用精确的词语找到一切MemPalace 的搜索强调 exact words关键词精确匹配 语义召回的混合检索支持按机翼、房间和时间范围过滤mempalace search 为什么我们改用了 GraphQL # 限定某个项目的某个房间 mempalace search 定价讨论 --wing my_app --room costs # 只看某时间段之后归档的记忆 mempalace search 重构方案 --since 2026-04-01 --results 10常用参数定义见 cli.py--wing限定项目、--room限定房间、--results N控制结果条数默认 5、--since/--before限定归档时间窗口。检索核心逻辑在 searcher.py。 长尾技巧查不到结果时先去掉--room放宽范围再用--since缩小时间窗口往往比反复换词更有效。五、repair向量索引坏了一键重建升级存储后端版本、索引损坏后search可能报集合打不开或结果异常。repair命令就是官方急救方案提供三种修复模式参数定义见 cli.py模式适用场景legacy默认整个宫殿全量重建索引from-sqlite客户端打不开集合时直接从 SQLite 读行重建max-seq-id修复被旧版 shim 污染的 max_seq_id 行# 安全姿势先干跑看看要做什么 mempalace repair --dry-run # 执行默认重建 mempalace repair --yes # 客户端无法打开集合时的兜底方案自动先归档损坏副本 mempalace repair --mode from-sqlite --archive-existing两个重要的安全特性默认执行前自动备份 SQLite--backup以及repair-status这个只读体检命令——它对比 SQLite 与 HNSW 的元素数量而不打开任何客户端适合定期巡检mempalace repair-status修复实现位于 repair.py备份逻辑见 backups.py。六、export把记忆导出成可读文件MemPalace 支持把整个宫殿导出为 Markdown 文件方便人工审阅、迁移或备份。导出功能实现在 exporter.py 的export_palace中通过 Python API 一行调用from mempalace.exporter import export_palace export_palace(palace_path, output_dir, formatmarkdown)AI 客户端中也可以直接让 MCP 工具完成导出。建议在每次repair或大版本升级前导出一份作为人工可读的快照。七、日常运维命令速查表除了主角命令还有几个高频运维命令值得一看命令一句话说明mempalace status查看宫殿里已归档了什么机翼/房间统计mempalace split dir把连在一起的超大会话文件拆成按会话分的文件跑 mine 之前先执行mempalace sync清理源文件已被删除/gitignore 的抽屉默认 dry-run加--apply才真删mempalace compress用 AAAK 方言压缩抽屉体积约降 30 倍mempalace wake-up输出 600-900 token 的唤醒上下文喂给 AI 快速恢复现场mempalace hallways列出实体间的走廊关联图谱mempalace mcp打印把 MemPalace 接入 AI 客户端的 MCP 配置命令mempalace serve启动远程 HTTP MCP 服务器团队共享一个宫殿mempalace daemon start/stop/status管理本地守护进程配合--daemon跑后台任务mempalace migrate跨存储后端版本升级的迁移工具支持--dry-run完整命令清单可以在 mempalace/instructions/help.md 中对照查看MCP 侧的工具列表同样在该文件中。八、新手推荐工作流把上面的命令串起来就是一套完整的日常操作初始化mempalace init ~/projects/my_app挖掘mempalace mine ~/projects/my_app先--dry-run试跑补漏mempalace sweep ~/.claude/projects/补齐会话记忆检索mempalace search 关键词 --wing my_app体检mempalace statusmempalace repair-status急救索引异常时mempalace repair --dry-run→--yes掌握mine、search、sweep、repair、export这条主线再配合status、sync、migrate等运维命令MemPalace 的命令行能力你基本就用完了——本地、免费、无需 API Key给你的 AI 装上一套真正属于自己的长期记忆。 ️【免费下载链接】mempalaceThe best-benchmarked open-source AI memory system. And its free.项目地址: https://gitcode.com/GitHub_Trending/me/mempalace创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
MemPalace CLI命令全集：mine、search、sweep、repair、export逐个讲透
MemPalace CLI命令全集mine、search、sweep、repair、export逐个讲透【免费下载链接】mempalaceThe best-benchmarked open-source AI memory system. And its free.项目地址: https://gitcode.com/GitHub_Trending/me/mempalaceMemPalace 是一个本地免费、无需 API Key 的开源AI 记忆系统而它的 CLI 命令行是日常使用中最直接的入口。本文带你快速掌握 MemPalace CLI 命令全集从最核心的mine挖掘记忆、search精准搜索、sweep补漏挖掘到repair索引修复和export记忆导出逐个讲透每个命令的用途、常用参数和使用场景新手照着敲一遍就能上手。所有命令都集中在 mempalace/cli.py 中定义直接输入mempalace --help即可查看全部用法。一、先建立心智模型宫殿、机翼、房间在使用 CLI 之前先花 30 秒理解三个名词后面所有命令都会用到Palace宫殿你的记忆库本地存储Wing机翼一个项目或一个来源例如某个代码仓库Room房间机翼下按目录结构自动划分的主题分区init命令就是干这件事的扫描项目目录自动检测房间结构。mempalace init ~/projects/my_app检测逻辑见 project_scanner.py房间识别见 room_detector_local.py。二、mine把文件挖掘进记忆库mine是最常用的命令负责把内容写入宫殿。它支持三种挖掘模式参数定义见 cli.py# 模式1代码与文档默认 mempalace mine ~/projects/my_app # 模式2聊天记录Claude Code、ChatGPT、Slack 导出 mempalace mine ~/convo_dir --mode convos # 模式3办公文档PDF、DOCX、PPTX、EPUB 等 mempalace mine ~/docs_dir --mode extract几个新手最常用的可选参数参数作用--wing 名称指定机翼名默认用目录名--dry-run只预览不真正写入--limit N最多处理 N 个文件适合先小试牛刀--no-gitignore连 .gitignore 里的文件也一起挖掘--daemon --background丢进后台守护队列立即返回任务 ID挖掘执行器在 miner.py。一个实用技巧先用--dry-run --limit 10试跑确认分类合理后再全量挖掘。三、sweep给漏网之鱼补挖sweep是 tandem miner搭档矿工主挖掘器没抓到的消息它会按消息级别、基于时间戳做二次捕捉且幂等可重复执行不会写入重复记忆实现见 sweeper.py。# 扫一个 .jsonl 会话记录文件 mempalace sweep ~/.claude/projects/xxx/session.jsonl # 或递归扫一个目录 mempalace sweep ~/.claude/projects/什么时候用当你发现某次对话的关键结论搜索不到时对原始会话文件跑一次sweep即可补齐。四、search用精确的词语找到一切MemPalace 的搜索强调 exact words关键词精确匹配 语义召回的混合检索支持按机翼、房间和时间范围过滤mempalace search 为什么我们改用了 GraphQL # 限定某个项目的某个房间 mempalace search 定价讨论 --wing my_app --room costs # 只看某时间段之后归档的记忆 mempalace search 重构方案 --since 2026-04-01 --results 10常用参数定义见 cli.py--wing限定项目、--room限定房间、--results N控制结果条数默认 5、--since/--before限定归档时间窗口。检索核心逻辑在 searcher.py。 长尾技巧查不到结果时先去掉--room放宽范围再用--since缩小时间窗口往往比反复换词更有效。五、repair向量索引坏了一键重建升级存储后端版本、索引损坏后search可能报集合打不开或结果异常。repair命令就是官方急救方案提供三种修复模式参数定义见 cli.py模式适用场景legacy默认整个宫殿全量重建索引from-sqlite客户端打不开集合时直接从 SQLite 读行重建max-seq-id修复被旧版 shim 污染的 max_seq_id 行# 安全姿势先干跑看看要做什么 mempalace repair --dry-run # 执行默认重建 mempalace repair --yes # 客户端无法打开集合时的兜底方案自动先归档损坏副本 mempalace repair --mode from-sqlite --archive-existing两个重要的安全特性默认执行前自动备份 SQLite--backup以及repair-status这个只读体检命令——它对比 SQLite 与 HNSW 的元素数量而不打开任何客户端适合定期巡检mempalace repair-status修复实现位于 repair.py备份逻辑见 backups.py。六、export把记忆导出成可读文件MemPalace 支持把整个宫殿导出为 Markdown 文件方便人工审阅、迁移或备份。导出功能实现在 exporter.py 的export_palace中通过 Python API 一行调用from mempalace.exporter import export_palace export_palace(palace_path, output_dir, formatmarkdown)AI 客户端中也可以直接让 MCP 工具完成导出。建议在每次repair或大版本升级前导出一份作为人工可读的快照。七、日常运维命令速查表除了主角命令还有几个高频运维命令值得一看命令一句话说明mempalace status查看宫殿里已归档了什么机翼/房间统计mempalace split dir把连在一起的超大会话文件拆成按会话分的文件跑 mine 之前先执行mempalace sync清理源文件已被删除/gitignore 的抽屉默认 dry-run加--apply才真删mempalace compress用 AAAK 方言压缩抽屉体积约降 30 倍mempalace wake-up输出 600-900 token 的唤醒上下文喂给 AI 快速恢复现场mempalace hallways列出实体间的走廊关联图谱mempalace mcp打印把 MemPalace 接入 AI 客户端的 MCP 配置命令mempalace serve启动远程 HTTP MCP 服务器团队共享一个宫殿mempalace daemon start/stop/status管理本地守护进程配合--daemon跑后台任务mempalace migrate跨存储后端版本升级的迁移工具支持--dry-run完整命令清单可以在 mempalace/instructions/help.md 中对照查看MCP 侧的工具列表同样在该文件中。八、新手推荐工作流把上面的命令串起来就是一套完整的日常操作初始化mempalace init ~/projects/my_app挖掘mempalace mine ~/projects/my_app先--dry-run试跑补漏mempalace sweep ~/.claude/projects/补齐会话记忆检索mempalace search 关键词 --wing my_app体检mempalace statusmempalace repair-status急救索引异常时mempalace repair --dry-run→--yes掌握mine、search、sweep、repair、export这条主线再配合status、sync、migrate等运维命令MemPalace 的命令行能力你基本就用完了——本地、免费、无需 API Key给你的 AI 装上一套真正属于自己的长期记忆。 ️【免费下载链接】mempalaceThe best-benchmarked open-source AI memory system. And its free.项目地址: https://gitcode.com/GitHub_Trending/me/mempalace创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
