用途:bm-status 用于快速诊断 Basic Memory 插件在某个项目中的当前状态,并输出简洁摘要,不做过度调查。
主要检查内容: CLI 可用性:依次运行 basic-memory --version、bm --version、uvx --prerelease=allow basic-memory --version;若无启动器可用,则标记 CLI 为不可用,继续 MCP/配置检查。 配置:按钩子优先级读取 basicMemory 块。用户级基础为 CLAUDE_CONFIG_DIR 存在时在该变量字面值后拼接 settings.json(不裁剪、不展开 ~、空值不视为未设置);变量缺失时用 ~/.claude/settings.json。项目级 .claude/settings.json 与 .claude/settings.local.json 按 key 覆盖。报告 basicMemory 块中的 primaryProject、secondaryProjects、teamProjects、captureFolder、rememberFolder、preCompactCapture、sessionProfile、repository、captureEvents;并报告根设置对象中 outputStyle 是否为 basic-memory。 钩子健康:用首个可用启动器运行 basic-memory hook status --harness claude --project-dir <project-root>,报告 shared inbox 路径、pending/archived envelopes、pending checkpoint requests、last flush、settings 状态、解析出的主项目、capture 状态、capture 文件夹、Basic Memory 版本与 uv 版本。收件箱计数为跨 harness 全局值。若该命令的设置解析与手工合并配置不一致,显示差异。 最近检查点:search_notes 使用 metadata_filters={"type": "session"},page_size 5;若 sessionProfile 为 coding,再加上 metadata_filters={"type": "coding_session", "repository": "<configured repository>"},合并去重后按时间倒序保留最新 5 条,列出标题与 permalink。 活动任务:search_notes 使用 metadata_filters={"type": "task", "status": "active"},仅报告数量。 作用域:查询 primaryProject 时以 project 传入,若是 external_id UUID 则以 project_id 传入。
输出:按固定清单呈现 CLI 版本、项目、团队读取来源、共享目标、capture/remember 文件夹、输出样式、PreCompact、会话配置、仓库、事件捕获、共享钩子收件箱及计数、最近检查点与活动任务数;无法确定的值写“—”。无检查点时提示会在上下文压缩前自动写入,且必须设置 primaryProject。事件捕获开启且 pending 累积或 last flush 为 never 时应警告,并说明其他 harness 也可能贡献共享计数;捕获关闭时不要对空收件箱发出警告。