# 安全说明

## 凭证

插件配置只保存引用名，凭证值由 DSH credentials 服务管理。客户端每次操作解析凭证；浏览器设置状态不返回已保存的密钥。密钥草稿在保存前存在于浏览器内存中。

不要将真实凭证提交到 Git、Issue、测试夹具或截图。自定义服务端点会收到对应鉴权头，应仅配置可信端点并使用 HTTPS。

插件 API 请求拒绝 HTTP 重定向；自定义端点需使用最终地址。静态 HTTP 路径由宿主执行独立的重定向与地址校验策略。

Firecrawl 免密钥模式仅用于官方 HTTPS Search / Scrape 端点，仍会向服务方发送查询及目标 URL，受匿名额度和限流约束。自定义端点不能因密钥留空而启用匿名请求。

## 外部请求

搜索查询会发送给已配置、参与调用且未熔断的搜索服务。动态提取会将完整目标 URL 发送给选中的第三方服务；重排会将查询及候选标题、摘要发送给硅基流动。URL 中的查询参数可能包含私密数据，提交前需检查。正文来源说明会保留服务返回的 URL。

静态 HTTP 路径使用 DSH HTTP 提取器的地址策略。动态提取依赖第三方服务处理目标，不继承本地 HTTP 提取器的地址校验或大小限制。仅向工具提供允许外部服务访问的公开 URL。

AIHOT 专用 API 仅接受受支持的 HTTPS 路径，优先于通用分流直接读取。JSON 和 Markdown 保留来源及分页信息；不自动执行翻页、同步写入或创建定时任务。

网页内容和搜索结果属于不可信输入，可能包含提示注入或错误信息。插件提供提取与排序，不验证内容真实性，也不执行网页中的指令。

## 日志与资源限制

插件日志记录服务状态、延迟、熔断、请求次数、正文整理摘要，以及旧版模式的提取评分和正文指纹。错误消息可能保留服务方返回的文本，该文本不等于已脱敏数据。分享日志前需检查密钥、查询内容和私密 URL。

并发请求会消耗多个服务的额度。`controls` 限制每次 provider 操作的插件请求次数和总限时，重试、额度检查及重排也计数；这不是金额或账户额度上限。扩展服务的文本响应限制为 1,000,000 字节、映射后的正文最多 100,000 字符，但通用 JSON 响应、Firecrawl / AnySearch 提取及 SSE 缓冲没有统一的读取上限。正文整理在转换前拒绝超过 1,000,000 字符的输入，分块后限制 2,000 块；这不能限制收到响应前的网络缓冲。部署时应限制工具并发并评估响应体大小。插件面向受控 DSH 环境，不应作为未经访问控制的公共抓取服务。

AIHOT 默认关闭，启用前应阅读 [AIHOT 使用规则](https://aihot.news/terms)。个人非商业、公益非商业及组织内部用途可按规则使用；对外提供代理、收费产品或数据再分发等需获得书面授权。插件的 MIT 许可不包含数据服务授权。

## 漏洞报告

仓库已启用 GitHub Private vulnerability reporting。发现安全问题时，请使用[私密漏洞报告入口](https://github.com/qikairo7/dsh-web-search-fetch/security/advisories/new)，报告内容不公开。

若入口不可用，不要把可利用细节或私密数据放入公开 Issue；可提交不含这些细节的联系请求，待维护者提供私密沟通方式。报告应包含受影响版本、可复现条件、影响和脱敏复现材料。本项目暂未承诺固定安全响应时限。