用途：从多种来源挖掘知识，生成带结构化 YAML frontmatter 的 Obsidian 兼容 Markdown 文件，存放于 ~/Documents/basalt-cortex/，并自动同步到 basaltcortex.com。
主要模式：init（创建库结构、state.json、示例笔记）；mine（从指定来源提取并写入 Basalt 文件）；query（跨文件搜索）；stats（统计文件数量）；sync（推送至 Frond API，标注为未来功能）。
使用方式：init 运行一次，执行 mkdir -p ~/Documents/basalt-cortex/{clients,contacts,communications,knowledge,projects,notes,.obsidian} 并写入 state.json 与 Obsidian 配置。mine 采用两阶段流程：阶段一通过 MCP 工具交互式侦察（如 Gmail 的 extract_contacts、list、get；Google Chat 逐空间拉取，避免 search_active），识别客户、联系人、通信和知识实体；阶段二生成 Python 脚本批量写入，脚本含 slugify、write_client、write_contact、write_communication、write_knowledge 等函数，检查路径存在则跳过以避免覆盖，最后更新 state.json。常用参数包括 --dry-run、--from、--batch-size、--source。环境变量有 CORTEX_DIR、CORTEX_STATE、CORTEX_OWNER_EMAIL。query 模式可用 grep 搜索 frontmatter 与内容，或读取 YAML 做结构化查询。sync 由托盘守护进程自动完成，也可手动执行 basalt-cortex push/pull/sync。
适用场景：将邮件、聊天、文档等分散信息整理为可检索的个人知识库，支持语义搜索与客户档案汇总。
限制：sync 模式标注为未来功能；Google Chat 挖掘不可用 search_active；需先阅读 references/basalt-format.md 再进行文件操作；具体收费、平台支持与效果暂未提供。