SuperAPI AI 工具集

siteos-search

办公与效率

查看项目

更新于 10-16 03:41

技能介绍

SiteOS Search 用于在外部网站项目中搭建和运营 SiteOS 搜索,涵盖创建、选择、配置、验证、修复与日常报告。它从目标项目根目录执行,也可显式指定项目根目录;任务开始前先读共享执行契约,再套用本技能的服务工作流。

主要能力:托管读取接口包括列出索引、获取建议、查询、列出内容、访客、相关性、连接、爬虫、诊断与分析;支持爬虫路径(公开 HTML 抓取、站点地图发现、所有权验证、抽取、定时爬取与受保护自动发布)、本地 source-handler 路径、预置导入路径与 Algolia 路径;支持内容导入预览、精选建议词、单篇文章活动与筛选、相关性调优、可恢复的安装检查、聚合访客分析及可选同意控制。

使用方式:先在内容、结果、原生网站界面之间选择最短设置路径,再选定爬虫、本地 source-handler、预置导入或 Algolia 路径。搜索资源设置与索引/查询凭据管理只能通过受支持 CLI 命令,不支持旧版组织令牌和项目 API 密钥。运行凭据只写入 CLI 安装的、被忽略的仅所有者可读 .env;不得把搜索令牌、环境 slug 或搜索源做成浏览器公开变量(如 NEXT_PUBLIC_SITEOS_SEARCH_TOKEN)。本地 source-handler 入职时用 scripts/session-state-cli.mjs 维护 .siteos/temp/search/session-<started-at>.json,按固定步骤 id 记录进度,清理前先生成计划并需用户确认。准备情况用 npx @siteoshq/cli search diagnostics --environment <slug> --json 判定为 ready、not-ready 或 api-blocked。只读或报告类请求直接走分析工作流,不要触发入职、同步或 UI 改动。

限制:抓取源不要求本地 source-handler 脚手架;爬虫和预置导入/迁移路径不创建抽取会话;网站页面浏览、自定义事件和转化属于 $siteos-analytics。不得输出或回显任何密钥、令牌、授权码或完整配置 JSON,也不得检查含密环境文件。具体界面细节与页面路由等资料暂未提供。