用途:为当前项目配置 Basic Memory 插件。先确认 Basic Memory MCP 服务器已连接(调用 list_memory_projects),未连接则先安装(uv tool install basic-memory --prerelease=allow 或 pip install basic-memory,版本 >= 0.19.0)并连接(claude mcp add basic-memory -- uvx --prerelease=allow basic-memory mcp),重启会话后重新检查。
主要能力:通过简短自适应访谈确定用途(代码/研究/写作/知识捕获/规划或混合)、项目映射(已有项目或新建,本地路径默认 ~/basic-memory/<name>/,云项目需云连接服务器与工作区选择器)、云/团队工作区读取(secondaryProjects 只读,SessionStart 简报每会话最多读前 6 个共享项目)、可选共享目标(teamProjects 配 promoteFolder,共享始终手动)、放置约定(已有笔记则学习,空项目则建议 3-5 个顶层文件夹)、schema 播种(coding-session.md 或 session.md,加 decision.md、task.md)、生命周期事件捕获(默认开启,仅本地)、输出风格(默认启用 basic-memory)、可选安装共享 memory-* 技能(npx skills add basicmachines-co/basic-memory/skills -g)。
使用方式:访谈完成后写入 basicMemory 设置块(含 primaryProject、captureFolder、rememberFolder、recallTimeframe、preCompactCapture、sessionProfile、repository、captureEvents、placementConventions、teamProjects)与 outputStyle,合并进 .claude/settings.json 或 .claude/settings.local.json。schema 用 write_note 写入,metadata 传嵌套 dict,不要把 frontmatter 放进 content。最后做冒烟测试:search-notes --type schema --page-size 10 验证主项目,basic-memory hook status --harness claude --project-dir <project-root> 检查钩子健康。
限制:编码配置需确认 Git 仓库标识(owner/name),远程缺失或含糊时不要猜测;云写入路径存在嵌套 YAML 被转为字符串的问题,需用 metadata 参数并验证;共享项目只读,自动捕获不写入团队项目;输出风格在会话启动时固定,启用后需重启会话才生效,召回与 PreCompact 检查点当前会话即可用。具体收费、价格与平台支持资料暂未提供。