用途：在 Scrivener 项目内跨文档查找文本，定位哪些文档提到某个词，并返回匹配文档的标识与上下文片段。搜索为只读，可随时安全运行。
主要能力：默认覆盖 title、text、synopsis、notes 四个字段，可用 --fields 以逗号分隔缩小范围；搜索不区分大小写，text 与 notes 会先由 RTF 转为纯文本再匹配。加 --regex 可把查询当作 Python 正则；不加则按字面匹配并自动转义特殊字符。结果默认输出 JSON，加 --format text 得到可读列表，每条包含文档 uuid、标题、命中的字段和约 30 字符上下文的片段，同一文档每个命中字段各出现一次。
使用方式：运行 python3 ${CLAUDE_PLUGIN_ROOT}/tools/scrivener/cli.py search "lighthouse" --project "<path.scriv>" --format text；按字段搜索示例：search "inciting incident" --fields text,synopsis --project "<path.scriv>"；正则示例：search "Mr?s?.? [A-Z][a-z]+" --regex --fields text --project "<path.scriv>"。用返回的 uuid 配合 scrivener-inspect 打开文档；标题不唯一，修改类命令前应先解析为 uuid。需要出现次数而非片段时，改用 scrivener-stats。
限制：目前 CLI 仅有 search。project-replace、单文档 replace、search-saved、find-duplicates 及整词、精确、draft/exclude-trash/compile-included 等操作符与范围均属规划功能，暂未提供，不要假装运行。替换在 Scrivener 中不可逆，未来使用前应先备份并关闭项目、等待云同步完成；单文档修改现可用 scrivener-edit set-text（保留 token）。docs.checksum 不匹配仅为提示，不代表损坏。