用途:诊断和配置 MemSearch 的记忆行为,仅管理 MemSearch 自身设置,不是宿主代理内置的记忆/配置系统。适用于用户询问 MemSearch 配置、插件摘要、PROJECT.md/USER.md 维护等场景。
主要能力:运行诊断(配置列表、版本与索引健康检查);读取已解析/全局/项目配置值;设置、启用或禁用配置;排查不抓取、搜索为空、无记忆等问题;配置 OpenAI/Gemini/Anthropic/native 等提供商路由;配置 PROJECT.md/USER.md 等高级维护;启用或调优技能蒸馏(记忆转技能);解释或配置提示词覆盖。
使用方式:先读取与当前平台匹配的参考文件(Claude Code、Codex、OpenClaw、OpenCode、DeepSeek Harness),再执行平台特定诊断或配置。常用命令:memsearch config list --resolved、--global、--project;memsearch --version;memsearch stats;memsearch config set/get/list;memsearch config init(全局交互式初始化),memsearch config init --project(项目索引配置);改用 uv tool install -U "memsearch[onnx]" 或 uv tool upgrade memsearch 更新。
配置逻辑:配置按内置默认、全局配置、项目配置、env: 引用和运行时环境解析。自 v0.4.11 起,项目本地 .memsearch.toml 仅接受少量低风险本地索引键(如 milvus.collection、embedding.batch_size、chunking.max_chunk_size、indexing.ignore_files 等),提供商/模型/API 端点/API 密钥、[llm]、[prompts] 及插件自动化键须放在全局配置或通过 CLI 参数传入。模型解析顺序为任务级模型、命名提供商模型、内置默认。API 密钥应使用 env 引用,不要粘贴到对话中。
限制:启用外部或付费提供商、更改输出路径、重建索引、删除状态或扩大索引范围前须询问用户;高级维护默认关闭以避免后台模型调用;空字段应通过 --resolved 判断,不能仅凭原始 TOML 判定为未设置;插件密钥不能用 --project 写入。部分平台细节(版本检查命令、plugins.<platform>.* 键、原生模型默认、重启指引)位于各平台参考文件。官方文本暂未提供。