dsh-web-search-chrome 文档索引
August 15, 2026 · View on GitHub
| 文档 | 内容 | 读者 |
|---|---|---|
| ../README.md | 主文档：功能概述、安装、配置表、错误语义、跨平台说明、实测范围、开发命令、License | 使用者（安装/配置/排障） |
| ../CHANGELOG.md | 版本变更记录（0.1.0） | 升级者 |
| prd-dsh-web-search-chrome.md | 原始 PRD（需求规格，Google 单引擎）。实现按 §D7 决策偏离：默认引擎为 Bing、支持 engine 切换 | 规格追溯 |
| decisions-010.md | §10 待确认项实测结论：headless+--profile 兼容性、eval --stdin 输出格式、agent-browser 失败模式、磁盘缓存策略（D1–D6），以及引擎决策 D7（默认 Bing 的动因与证据） | 架构/演进决策 |
| configuration.md | 配置参考：完整 schema、示例、缓存语义、单次搜索流程、错误码 | 配置者 |
| acceptance-m3.md | M3 端到端验收记录：PRD §8 九项逐项证据、遗留项、实测中发现并修复的问题、独立评审修复 | 验收/回归 |
| enable-local-chrome.patch.yml | 一键启用 patch：覆盖到 profile 的 cordis.patch.yml 后重启生效（切换 searchProvider: local-chrome） | 安装者 |
文档与代码的对应
- 配置 schema 的唯一事实源：
src/index.ts（Config）；本文档与docs/configuration.md须与其同步（lib/是 tsdown 构建产物）。 - SERP 提取选择器唯一位置：
src/serp.ts（EXTRACTION_SCRIPT，引擎自适应）；引擎 DOM 变更只改这一处。 - 测试：
tests/unit.test.ts（19 项单测，vitest 直测 src）+tests/live.test.ts（1 项，WSC_LIVE=1门控）、tests/fixture/{bing,serp}.html+scripts/verify-extraction.mjs（双引擎提取管线）、scripts/e2e-live.mjs（真实引擎 seam 级验收）。
状态速览
- 0.1 功能完整并已发布（
dsh-web-search-chrome@0.1.0on npm）：M1 实现（19 项单测 + live 门控）、M2 安装验证、M3 端到端验收（§8 九项，第 2 项 2026-08-15 以 Bing 完成）、M4 发布产物；CI 全绿（GitHub Actions，node 22/24）。 - 默认引擎：Bing（Google 被 IP 信誉拦截的网络的替代方案，见
decisions-010.md§D7）。 - 待办（v1.1 候选）：登录态启用、磁盘缓存增强、跨平台 Chrome 自动启动、macOS/Linux 原生实测。