open-websearch-maintainer

Open WebSearch 维护指南

修改 open-websearch 代码库本身时，请使用此技能。

如果此技能与当前仓库行为不一致，请以仓库代码、测试和预期的变更范围为准，并在完成前更新此技能或文档。

首先对变更进行分类

• 引擎变更：新增引擎、引擎解析、引擎分页、反机器人处理。
• 网络变更：代理、TLS、请求构建器、Playwright 交互、浏览器回退。
• 工具接口变更：MCP 工具注册、架构、引擎规范化、配置公开。
• 仅验证变更：在不打算改变代码路径行为的情况下修改测试、文档或发布相关内容。

以此分类作为执行入口。先选择一个类别，只加载与之匹配的检查清单；仅当变更的代码路径确实跨越其他边界时，才扩大范围。

范围控制

• 在实际故障面允许的范围内，尽量局部修复。
• 没有依据时，不要把解析或特定引擎的问题扩展成共享网络重构。
• 不要仅为通过某项测试而扩大不安全行为或放宽兼容性限制。
• 除非变更是有意为之、经过验证且有文档说明，否则不要更改工具契约或全局行为。

核心规则

• 除非变更明确要求进行破坏性更改，否则保持 MCP 工具契约稳定。
• 基于 Axios 的网络请求应通过共享 HTTP 请求构建器处理，而不是使用临时的代理处理方式。
• 将代理、TLS 和 Playwright 行为视为跨领域问题。变更后请明确验证这些内容。
• 新增引擎或更改行为时，请更新测试和 README 文件。

请勿

• 不要为了修复某个引擎的问题而绕过共享 HTTP 请求构建器。
• 除非仓库明确采用该策略，否则不要在单个引擎中悄悄分叉代理行为。
• 不要将不安全 TLS 行为扩大到所需范围之外的代码路径。
• 更改工具契约前，请先检查测试、配置处理和 README 文件。
• 如果变更仅涉及结果解析或文档，不要修改共享网络代码。

变更检查清单

新增或更改搜索引擎时：

• 更新 src/config.ts
• 更新 src/tools/setupTools.ts
• 添加或更新引擎测试
• 更新 README.md 和 README-zh.md

更改网络行为时：

• 优先使用 src/utils/httpRequest.ts
• 明确保留 Axios 的 proxy: false 行为
• 仅在必要时启用不安全 TLS，并限定其作用范围

验证

• 首先运行 TypeScript 检查。
• 对受影响的部分运行针对性测试。
• 如果变更依赖真实网络行为，请运行实时测试。

审查重点

• 分页和空结果处理
• 反机器人／验证页面检测
• 代理与 USE_PROXY 和 PROXY_URL 的交互
• 请求模式与 Playwright 模式的行为
• 文档偏差

实现变更时，请阅读 references/workflow.md；完成补丁前，请阅读 references/validation.md。