【开发者速查】智能体长期记忆常用指令表与 Codex / Claude Code 跨设备配置备忘录
速查导言：本卡片专为需要快速上手或排障的工程师设计，汇总了 Basic Memory CLI 的全部核心命令、Codex / Claude Code 插件快捷指令 以及常见 MCP 报错排障方案。如需阅读完整系统架构分析，请参阅姊妹站深度专栏：【DevNotes 智能体长期记忆全流程搭建】。
图 1：Git 远程同步 Markdown + 本地各端独立构建索引模型
一、 Basic Memory CLI 核心命令速查表
| 分类 | 执行命令 | 说明与用途 |
|---|---|---|
| 安装 | uv tool install basic-memory |
使用 uv 进行全局隔离安装（需 Python 3.12+） |
| 状态检测 | basic-memory status |
检查核心服务运行状态与向量数据库健康度 |
| 项目创建 | bm project add "NAME" "/PATH" |
添加本地 Markdown 目录为独立知识库 |
| 设为默认 | bm project default "NAME" |
设为主项目，供所有 Agent 默认读写 |
| 升级更新 | uv tool upgrade basic-memory |
快速拉取官方最新发布的补丁与索引引擎 |
二、 Codex 插件与常用 Skills 快捷调用表
常用指令（直接在 Agent 输入框调用）：
/bm-setup — 将当前工作目录映射并绑定到指定 Basic Memory/memory-onboarding — 交互式提问并自动规划标准的 5 级记忆文件夹树/bm-decide — 记录跨会话保留的不可逆正式架构决定/bm-remember — 将用户的明确事实或即时规范写入记忆/memory-ingest [path] — 批量吸收并蒸馏指定目录下的旧笔记与讨论记录/memory-capture — 提炼当前长对话的最终结论并归档
三、 常见报错与排障 FAQ
Q: 在 Windows 上配置 MCP 时，路径报错或无法启动？
A: JSON 文件中反斜杠必须转义（如 C:\\Users\\Name\\...）或统一改用正斜杠 /；确保在系统环境变量中将 %USERPROFILE%\.local\bin 加入 PATH。
Q: Git 同步时提示 SQLite 数据库锁定冲突？
A: 严禁将 .sqlite、.vector_cache 纳入 Git 版本控制！在 .gitignore 中排除所有二进制与缓存文件，仅同步 .md 文件，让各端本地后台自动更新各自的 SQLite 索引。
⚡ 极速 Agent 编码算力直供专区
为 Codex、Claude Code、Cursor 开发者提供稳定长上下文 Claude 3.5 Sonnet / Opus 独享账号、OpenAI o1 深度推理额度、DeepSeek 直连 API，支持高并发，防封质保。