站内搜索

Stellar 默认启用本地搜索，无需额外安装搜索索引生成器。它会在构建时写出索引，读者可以从结果直接跳到匹配的章节。

配置搜索索引

search:
  provider: local
  local:
    scope: all
    include_content: true
    cache_ttl_seconds: 86400

scope 可选 all/post/page，决定索引包含哪些内容；include_content: false 不索引正文。页面 visibility.searchable: false 排除该页。Wiki、Topic、Notebook Collection 也可以设置同名字段作为所有成员的默认值，成员 Front Matter 可显式覆盖。

搜索入口与范围

固定菜单使用 type: search 打开搜索。博客、Wiki、Topic 和 Notebook 根据页面归属提供相应的搜索范围；搜索范围按内容归属划分。Topic 可以在博客与当前专栏范围中检索，实际可用范围还受全局索引 scope 限制。

本地结果按章节定位，打开结果会携带关键词与标题 hash。可用 Ctrl/⌘ + K 打开搜索，Esc 关闭。

使用 Algolia

search:
  provider: algolia
  algolia:
    appId: YOUR_APP_ID
    apiKey: YOUR_SEARCH_ONLY_KEY
    indexName: YOUR_INDEX

主题提供查询端；索引上传由站点自己的构建流程负责。浏览器只使用查询密钥。search.provider: null 关闭主题搜索。

配置修改后需要重新生成 search.json。找不到某篇内容时，可检查它是否被 scope、Collection 或页面的 visibility.searchable 排除。visibility.listed 只影响列表，不会代替搜索开关。