前言¶
在 DSH 里让 Agent 使用 web_search 和 web_fetch 时，常见做法是只看最终回答里有没有引用链接，却很难回答「这一轮到底搜了什么、返回了哪些页、哪些被读过、哪些进了上下文」。排查幻觉来源、对比不同 prompt 的检索行为，也缺少结构化记录。下面介绍的插件把每次联网调用的关键词、结果 URL 与抓取结果写成可审计日志，并在界面里按轮次和会话汇总引用与抓取情况，方便回看与筛选。
这是什么¶
dsh-web-search-insights（npm 包名 @ypingcn/dsh-web-search-insights）是 DeepSeek Harness 的 web profile 插件，维护者为 ypingcn，在社区目录中归类为「记忆」。它针对 Agent 的 web_search / web_fetch 使用方式，提供 JSONL 审计日志、会话级统计投影，以及在聊天界面中的引用入口、右侧「搜索记录」面板和会话顶部的「快速搜索」视图。
核心功能¶
审计日志¶
每次 web_search 会记录搜索关键词以及结果中的网址与标题；每次 web_fetch 会记录 URL 与 HTTP 结果。日志写入 JSONL。失败调用可按需记录错误码；正文内容不会写入日志，避免把整页网页堆进本地文件。
会话统计（webSearchInsights）¶
插件通过 webSearchInsights 投影产出：
- 本轮 / 本会话的引用来源与返回来源；
- 被
web_fetch实际抓取过的页面。
这些数字与列表会驱动回答下方的引用入口和右侧栏面板。
界面入口¶
- 回答末尾：显示来源图标、本轮与会话的引用数，以及「查看」按钮。搜索轮展示引用/返回数；仅发生
web_fetch的轮次还会展示抓取/失败数（可在配置页关闭该入口）。 - 右侧栏「搜索记录」：支持本轮/本会话切换；按已引用、未引用、已抓取筛选；来源与抓取页面均可按域名分组；头部与工具栏吸顶。
- 会话顶部「快速搜索」：不写入审计日志的独立搜索视图与结果列表；依赖宿主提供的同源 HTTP 路由（web profile 自带）。
依赖要求¶
安装前请确认环境满足 README 中的约束：
- DSH：
>=0.2.1-rc.2且<0.3.0； - Node.js：
^22.19.0或>=24.0.0； - 快速搜索功能需要 web profile 提供的同源 HTTP 路由。
安装与启用¶
推荐使用 npm 发布包，且需指定 web profile：
dsh plugin --profile web add @ypingcn/dsh-web-search-insights
若要从 GitHub 安装：
dsh plugin --profile web add github:ypingcn/dsh-web-search-insights
本地开发调试可使用 link 方式：
dsh plugin --profile web add link:/path/to/dsh-web-search-insights
安装完成后，在插件管理页打开「搜索溯源」，详情页中会出现配置表单，可按需调整（例如是否显示回答末尾的引用入口）。
典型用法¶
插件启用后无需单独调用 API：Agent 在正常对话中触发 web_search / web_fetch 时，插件会自动写 JSONL 并更新统计。
人工回看时，可按下面路径操作：
- 在某条回答下方点击引用入口，查看该轮引用与返回情况；
- 打开右侧栏「搜索记录」，切换「本轮 / 本会话」，并用「已引用 / 未引用 / 已抓取」筛选；
- 需要按站点归类时，在面板中使用按域名分组；
- 若只想快速查网页而不留审计记录，使用会话顶部的「快速搜索」视图。
适用场景与注意¶
适合谁：在 DSH web profile 下开发或调试联网 Agent、需要核对「搜了什么、回了哪些链、读了哪些页」的开发者；希望用会话级统计对比多轮检索行为的场景。
注意：
- 插件在当前 DSH 进程权限下运行，日志与配置落在本地；安装前建议阅读 GitHub 仓库 源码与许可证（package.json 中版本为
0.1.0，以仓库为准）。 - 社区插件目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，本插件为社区维护项。
- 快速搜索依赖 web profile 路由；非 web profile 或未满足 Node / DSH 版本要求时，部分能力可能不可用。
结尾¶
dsh-web-search-insights 把联网搜索从「黑盒回答」拆成可审计的 JSONL 与可筛选的界面统计，便于对齐 Agent 的实际检索与阅读路径。进一步了解与 issue 反馈见：
- 目录页：https://www.skillhub.cn/plugins/ypingcn/dsh-web-search-insights
- GitHub：https://github.com/ypingcn/dsh-web-search-insights
