用途：创建或修改 sense 配置，在 Markdown 目录树上完成索引搭建；查询已有索引树属于 sense 技能，不在本技能范围。常见树形的示例配置见 EXAMPLES.md。
初始化：全局安装 CLI 后在 Markdown 根目录运行 npm install -g sensemaking，cd path/to/notes，sense init，sense status。sense init 会写出 sense.config.json；配置发现从当前目录向上查找，可用 --config <path> 指定其他文件。默认索引自身目录，顶层 root 也可指向另一棵 Markdown 树；相对 root 从配置目录解析，.sense/ 与配置同放。
存储选择：无其他工作流偏好时先用 sqlite（Node 自带、支持 FTS5 高级搜索语法、可并发）；需要 DuckDB 分析类型与 SQL、本地或云端流程时选 duckdb；倾向 Rust 嵌入引擎或 Tantivy 索引时选 turso。duckdb 与 turso 在 Sense 中为实验性适配器，原生安装较大，且同一时间只允许一个连接。换存储会重建索引而非迁移旧缓存；各存储缓存文件独立，命令与公共表通用，原始 SQL 与高级词搜索语法随所择引擎而异。
Preset 设计：preset 是命名的独立范围，默认 preset 必需的 default 服务裸命令，其余按名称选用。字段包括 include/exclude（必须提供 include）、k（默认 10）、signals（默认全部信号权重 1）、where（常驻 frontmatter 过滤，默认无）。任一 preset 包含即被索引，preset 可重叠，全部未包含的文件不入索引。路径用于稳定分层（raw/、notes/、archive/），frontmatter 过滤用于变化状态（status、project、日期）。
向量：顶层 embed 块指定 model 与 provider，preset 的 signals 决定该范围是否使用向量。配置默认 "build": true 允许 CLI 查询自备所需能力；"build": false 适合手动构建或 watch 流程。首次启用向量的搜索会下载具名静态模型并嵌入其适用范围，sense build 与 sense watch 会准备全部已配置能力，sense download 可提前获取模型。
可查询笔记设计：frontmatter 字段保持一致才能做精确过滤与保存报告；ISO 8601 日期可被存储的日期函数比较，混合格式不可靠；单行 summary 出现在结果中且词法权重更高；文件夹是 preset 覆盖的自然单位，frontmatter 是状态与归属的自然单位；小笔记命中精确、整文件读取便宜，大笔记靠 peek、sections 与搜索行指向区间，向量分块会切分长节。可用 queries 保存反复出现的问题：{ "sql": "..." } 用于确定性过滤与报告，{ "search": "..." } 用于排序检索。保留 frontmatter 键为 path、_mtime、_ctime、_size、_rank、_parse_error、content、links、sections，sense 会丢弃并给出警告。
校验与限制：改配置后运行 sense status 确认存储、缓存、文档数、嵌入状态、watcher 状态与 preset 覆盖，运行 sense map 确认发现的字段及观测类型；编辑后要运行每个保存的查询。应为 setup 对话之外留存的选择记录在树的 agent 指南或自撰笔记中；sense 配置应只含可执行设置与可复用查询，不含文字性政策。资料未提供具体收费、价格与效果说明。