溯源搜索 shi004/better-search

better-search

给 DeepSeek Harness（DSH）的可溯源网页研究技能：官方与一手信源优先，第三方平台内容默认只当线索（可验证的官方账号除外）；需要全面搜索时覆盖论坛/社区/社交平台线索并逐条核验；关键结论必须带 URL、日期与原文证据。

English — Two DSH skills for traceable web research. web-research prefers official and first-party sources, treats third-party platform content as leads by default (verified official accounts excepted), scans relevant forums/communities/social platforms for comprehensive requests and verifies each lead, and requires URL/date/quote evidence for important conclusions. use-my-browser is a vendored MIT browser-routing skill.

本仓库提供两个技能：web-research（研究入口）与 use-my-browser（浏览器路由）。

这是什么

- web-research：先判任务类型，再按 L1/L2/L3 分级检索、取证和输出。适合查资料、核实信息、多源对比，以及市场、生活、设计类调研；纯本地文件、代码或数据任务不需要加载。
- use-my-browser：判定「该不该用浏览器、能不能读到」。任务点名微信公众号/小红书/抖音/微博/B 站/知乎等平台，或涉及已登录站点时，规划期就加载它判路由；静态抓取失败不等于来源不可读，访问状态与 blocked 语义由它统一。基线来自 xixu-me/skills（MIT），本项目在其上增补了会话墙路由、访问状态、站点笔记与委派契约。

本项目的新贡献

本项目在 nWave（MIT）的信源判断、报告模板与质量门内容基础上，做了面向 DSH 的整合与增补：

- 单入口整合：把 nWave 的多个研究/信源技能合并为 web-research 入口 + 三份按需读取的 references（信源、处理、输出），去掉 nWave 专属流程与路径。
- 输出分级：L1 快速查（短答 + 来源，不读模板）、L2 标准调研（结论 + 证据表含核验状态 + 存疑项）、L3 深度报告（完整模板 + 平台覆盖/线索核验 + 质量门）。
- 事实与经验分流：规则/事实型按官方与一手源取证；经验/操作型允许社区实践作为主要依据；混合型分开取证、分别标注。
- 新增经验证据规则：可复现、共识度、版本/时间匹配、作者利益披露、样本范围、可验证出处；医疗、金融、法律等高风险主题不得只靠社区经验。
- 信源/处理分层：sources.md 负责信源清单、分级与账号主体；source-handling.md 负责核验、冲突、时效、引用与经验证据；报告模板独立。
- 多平台线索与核验：低信任平台改为「仅线索」而非排除；新增论坛、贴吧、小红书、B 站、知乎、Steam、微博、小黑盒、微信公众号、抖音、快手等平台清单，以及帖子/视频下的评论区、回复、弹幕、留言；评论只作 UGC 线索、可按主题抽样，不作为独立来源；微信公众号等按账号主体判定官方性；报告模板增加核验状态与线索表。
- 工具路由：按来源分流——普通页面静态优先；点名平台/登录态页面则在规划期判为 browser-required 并直接走浏览器（不再「抓失败再升级」）。访问状态统一为 read-in-browser / static-only / static-blocked / browser-blocked / capability-missing / not-attempted，只有 browser-blocked 允许说「需登录/被拦截/不可访问」；静态墙（环境异常 / poc_token / 验证码 / 403 / 412）只算 static-blocked（undetermined）。
- 误报防线：新增 ## Access-state claims（访问状态 + 来源访问台账）、blocked 证据门槛、「用户说已登录则先实读」、「capability-missing 须先做能力探测」、「子代理不继承登录态、不得把 static-blocked 升级为 blocked」，以及交付前 20 秒自检。
- 站点笔记：use-my-browser/references/site-patterns/ 新增 4 个实测笔记（mp.weixin.qq.com、weixin.sogou.com、xiaohongshu.com、douyin.com），记录路由形状、选择器、风控特征与坑；下次遇到同名站点不再靠猜。
- 双技能配合：web-research 负责「证据/性质/置信度」，use-my-browser 是「浏览器是否必需」的唯一裁判；路由与访问状态归后者，能否作官方一手归前者，冲突时按此裁决。
- DSH 适配：中文改写、安全与失败边界、引用去重、安装与许可打包。
- 边界：use-my-browser 是 xixu-me/skills 的 MIT 原样再分发，不是本项目原创；nWave 来源内容按 MIT 改写并保留署名。

安装

复制两个技能目录到 DSH 的技能根：

- 全局：<DSH_HOME>/skills/（Windows 通常为 %USERPROFILE%\.dsh\skills\）
- 项目级：项目根目录下的 .dsh/skills/

Windows PowerShell：

$dest = "$env:USERPROFILE\.dsh\skills"
New-Item -ItemType Directory -Force $dest | Out-Null

首次安装可跳过；从旧版升级时先清理旧目录 Remove-Item -Recurse -Force (Join-Path $dest 'web-research') -ErrorAction SilentlyContinue

Copy-Item -Recurse .\web-research, .\use-my-browser $dest -Force

macOS / Linux：

mkdir -p ~/.dsh/skills

首次安装可跳过；从旧版升级时先清理旧目录

rm -rf ~/.dsh/skills/web-research

cp -r web-research use-my-browser ~/.dsh/skills/

从旧版升级时，必须先删除旧 web-research 目录；否则已删除的 source-rules.md 会残留在技能目录中。

DSH 会监视技能根目录并热加载；新增、改名或 frontmatter 变化后，下一轮的技能目录会更新，无需重启。

使用

- L1 快速查：只想「查一下/在哪/给个链接」时，直接给 1–3 句答案 + 1–3 条来源。
- L2 标准调研：需要对比、判断、核实或多源汇总时，给结论 + 证据表（含性质/核验状态） + 存疑项。
- L3 深度报告：尽调、完整调研或需要方法论时，使用完整报告模板（含平台覆盖与线索核验） + 质量门。
- 全面搜索：说「尽量搜全/多平台对比/看看社区真实反馈」时，先官方源，再按主题检索相关平台线索，评论/回复/弹幕可按主题抽样，逐条回溯核验；未核验的只列为线索。
- 微信公众号等平台账号：认证主体为该实体的官方账号，可就其自身发布的事实按官方一手处理；个人号、自媒体号、转载按线索/二手处理。
- 经验/操作型问题：攻略、菜谱、使用技巧、维修、体验评测等，允许社区实践经验作为主要依据，但必须符合 web-research/references/source-handling.md 第 6 节。
- 高风险主题：不得只靠社区经验；按规则从严取证并给出风险提示。

web-research 按来源分流：普通页面先用内置搜索/静态抓取；任务点名微信公众号、小红书、抖音、微博、B 站、知乎等平台或已登录站点时，规划期加载 use-my-browser 判路由并直接走浏览器，静态抓取失败只记「静态受限（未证实不可读）」，不得推断「需登录/被拦截」。MCP 浏览器直接复用你日常浏览器的登录态；涉及提交、发布、支付、删除等操作应先确认。详细规则和输出格式见 web-research/SKILL.md、use-my-browser/SKILL.md 与其 references。

仓库结构

web-research/ # 研究入口：L1/L2/L3、任务分流、工具路由 ├─ SKILL.md ├─ ATTRIBUTION.md # 来源、许可范围与改写说明 ├─ LICENSE-nWave-MIT.md # nWave 的 MIT 许可全文 └─ references/ ├─ sources.md # 信源清单、官方源、账号主体、分级 ├─ source-handling.md # 交叉验证、冲突、偏见、时效、引用、经验证据 └─ report-template.md # L2 证据表 / L3 报告 / 质量门

use-my-browser/ # 浏览器路由与访问状态（基线 xixu-me/skills，MIT；本项目增补） ├─ SKILL.md ├─ ATTRIBUTION.md ├─ LICENSE # MIT └─ references/ ├─ task-routing.md # 路由分类 + Access-state claims（访问状态权威清单） ├─ anti-automation-friction.md # 反爬诊断 + 静态抓取误报 ├─ parallel-browser-ownership.md # 页面所有权 + 委派契约 ├─ site-patterns/ # 实测平台笔记：公众号/搜狗微信/小红书/抖音 └─ …（其余操作类参考）

兼容性

- 适配 DSH 0.2.x 的技能目录与按需加载机制。
- 技能名使用 kebab-case，目录名与 frontmatter name 一致，格式为 <name>/SKILL.md。
- 使用内置 web_search / web_fetch 与当前环境提供的任意 MCP 浏览器实现。

来源与许可

| 内容 | 来源 | 许可 |
| web-research/ | 改写自 nWave | MIT；nWave 部分 © 2026 Alessandro Digioia & Michele Brissoni；本项目修改 © 2026 sjx；全文见 web-research/LICENSE-nWave-MIT.md |
| use-my-browser/ | 原样再分发自 xixu-me/skills | MIT；© 2026 Xi Xu；全文见 use-my-browser/LICENSE |
| README、LICENSE、THIRD-PARTY-NOTICES.md、.gitattributes | 本项目 | MIT；© 2026 sjx；全文见 LICENSE |

- 更完整的来源、commit 与许可说明：THIRD-PARTY-NOTICES.md、web-research/ATTRIBUTION.md、use-my-browser/ATTRIBUTION.md。
- 相关项目 odysseus（AGPL-3.0）仅作一般流程概念参考；本仓库不包含其文件或文本，AGPL 仅适用于其上游项目。
- 顶级 LICENSE 不改变 web-research/、use-my-browser/ 中第三方作者的版权。

免责声明

本项目为个人维护的非官方 DSH 技能分发，与 DeepSeek 官方无隶属或背书关系。内容按「现状」提供，不构成专业建议；涉及医疗、法律、金融等高风险决策时，请咨询有资质专业人士并自行承担使用风险。

License

本项目原创与适配修改采用 MIT。第三方内容按各自许可分发，详见 THIRD-PARTY-NOTICES.md。