olares-search

search（桌面端全局搜索）

**统一入口：**加载 ../olares-shared/SKILL.md，了解套件路由、活动配置文件选择、平台入口，以及身份验证继续/停止关卡。仅当实际需要登录、切换配置文件、存储令牌或恢复身份验证时，才加载其中的身份验证参考。

使用 olares-cli search <subcommand> --help 查看语法。

适用场景

• 按名称/内容查找 Drive、Sync、Google Drive、Dropbox 或 Wise 中的文件或知识条目。在 Olares 1.12.7 及更高版本上，一条 search drive 命令即可覆盖所有四个文件来源。
• 按可见标题查找已安装的应用。

理解方式：search drive / search sync / search knowledge 通过查询预先构建的每用户索引，回答“哪个文件包含这段文本”。search app 回答“哪个已安装应用与此名称匹配”。它不是生命周期清单（market list --mine / market status），也不是资源排名（dashboard applications）。要列出或读取已知路径，请使用 olares-files（files ls / files cat / files download）。

快捷方式

任务	阅读	首条命令
按名称或内容查找文件	本文件	olares-cli search drive "quarterly report" -o json
按标题查找已安装的应用	本文件	olares-cli search app music -o json
在 Wise 中查找内容	本文件	olares-cli search knowledge "retrieval" -o json
区分“未编入索引”和“不存在”	本文件，然后为已知路径阅读 olares-files	olares-cli settings search status -o json

子命令索引

子命令	用途	触发时阅读
drive（files）	一次搜索 Drive、Sync、Google Drive 和 Dropbox	索引覆盖范围 — 索引覆盖范围决定了未找到是否能说明问题
sync	仅搜索 Sync（Seafile）库	索引 — 查看 drive 已覆盖内容的精简视图
knowledge（wise）	Wise/Knowledge 内容搜索	索引 — 此索引由 Wise 管理；需要 Olares 1.12.7 及更高版本
app	按可见标题搜索已安装的应用	无需进一步阅读；这是标题匹配，不是生命周期清单

没有单独的 gdrive 或 dropbox 子命令：在 Olares 1.12.7 及更高版本上，drive 会通过一次异步联邦请求搜索 files_v2、google_drive、dropbox 和 seafile，与桌面端对话框中单个“Files”入口的行为一致。sync 则将同一通道限制为 seafile。Olares 1.12.6 及更早版本没有联邦通道：在这些版本上，drive 仅覆盖本地 Drive 文件，而 sync 会回退到 /api/search/sync，因此在这些版本上需要同时使用两条命令，才能覆盖 Olares 1.12.7 及更高版本上一条命令所覆盖的范围。

google/<account>/... 和 dropbox/<account>/... 等云端结果位置是有效的文件路径，可用于 files ls、files cat 或 files download。Sync 位置使用 /sync/<repo_id>/...，并附有库的显示名称 — files ls sync/<repo_id>/ 接受的是 ID，而不是名称。

Google Drive 和 Dropbox 结果需要 Olares 1.12.7 及更高版本，并且必须已绑定集成：未绑定的账户会作为失败来源返回，而不是报错，因此任务仍会完成，并打印其他来源的结果。

索引（drive / sync / cloud / knowledge）

索引是异步的。搜索无结果并不能证明内容不存在。对于已知路径，请使用 files ls 验证；使用 settings search status 检查提取失败和索引进度。只有在确认覆盖范围并获得批准后，才重建索引。

Google Drive 和 Dropbox 在绑定账号后会由服务商端进行爬取。使用 olares-cli settings integration accounts list-by-type google|dropbox 检查账号是否已实际绑定：空列表可用于区分“未集成”和“已索引但无匹配结果”，而云端搜索无法告诉你属于哪种情况。绑定操作需在 LarePass → 设置 → Integration 中完成，不能通过 CLI 完成。Knowledge 索引由 Wise 负责。

索引覆盖范围（仅限 drive）

• 文件名索引覆盖范围广，但受排除模式限制。
• 默认对 Drive /Documents/ 中的内容进行全文索引；其他目录需要使用 settings search dirs add 添加。
• 即使是受支持的格式，也可能因文件已加密、损坏或超出大小限制而无法提取。请检查 settings search status -o json。
• 排除模式仍需在“设置”界面中管理；不要臆造 CLI 子命令。

安全与升级处理

• 搜索为只读操作。settings search dirs add/rm 和 rebuild 是单独的配置变更，需先确认。
• 不要将“无结果”视为文件或应用不存在的证明。应区分索引延迟、覆盖范围、提取失败、未集成、可见性以及确实无匹配结果。
• 如果用户要求绑定集成或重建索引，但未授权这项单独操作，请停止并转交给 olares-settings。