dsh-apradar:在 DSH 里做 AI 产品变化追踪与证据留存

前言

做 AI 产品或重度使用 Agent Harness 时,往往要盯一批竞品、开源项目或 npm 包的公开动态。通用新闻阅读器能告诉你「今天有什么热点」,却很难稳定回答:相对上一版到底变没变、原始证据在哪、这条变化和自己项目有没有关系。DeepSeek Harness(DSH)支持以插件扩展宿主能力;社区目录 SkillHub 上的 dsh-apradar(AI 产品雷达)就是面向这类问题的联网工具——关注公开来源、识别前后变化、查看原始证据、把值得跟进的点沉淀到机会池。

这是什么

AI 产品雷达(AI Product Radar) 是维护者 PolinniZhong 发布的 DSH 插件,npm 包名 dsh-apradar,当前版本 0.1.2,许可证 MIT。它不替代通用 AI 资讯客户端,而是帮助你在 Harness 右侧栏里完成「抓取 → 规范化与去重 → 差异检测 → 快照与导出」这一条产品变化研究链路。界面不提供模拟数据;抓不到或失败会把原因展示出来。

宿主要求(见 package.json):Node >=22.19,DSH >=0.2.0-rc.1。

核心功能

下列能力均来自仓库 README 与实现说明,P0 全量完成且部分 P1 已落地。

右栏三视图与 Host 路由

安装并重启 Harness 后,仅在右侧边栏出现「AI 产品雷达」页签,包含:

  1. 变化收件箱:相对上一版的差异与发现时间。
  2. 关注源管理:配置要监控的公开来源。
  3. 产品机会池:记录与自身项目相关的跟进点。

Host 侧通过同源路由 /apradar 提供服务(README 记载 22 条端点),插件路由只服务回环地址,非回环请求返回 403。

抓取、解析与差异检测

对外请求一律走 DSH 核验过的 ctx.web.fetch(),不使用 Node 原生 fetch 绕过 URL 校验、SSRF 白名单、超时与响应体上限。

解析适配器(5 类):

  • github_releases(优先 GitHub API,因部分环境 github.com 不可达)
  • github_repo(仓库定位;Stars 仅作里程碑参考)
  • npm_package(单版本清单)
  • rss_atom
  • html_static

另有 9 条预置模板。README 写明已对 api.github.com 与 4 个真实 Feed 做过出网实测(细节见仓库 TECH-SPIKE.md)。

规范化、指纹去重、差异检测已实现且 幂等:内容未变时不产生假变化。可查看最近 20 份快照的差异链;旧快照明示「仅保留摘录」。

定时刷新与导出

关注源支持 15 分钟至 24 小时 的定时刷新;连续 3 次失败会自动停用并在界面说明原因(README 称已实测自动触发)。

机会池支持导出 Markdown:区分 事实 与 推测 分区,并附带证据链;来自公网的内容按不可信数据处理(转义等)。导出由浏览器侧保存(Blob + 下载),插件不写你的项目目录。采集、去重、差异与导出 不调用任何大模型。

持久化与发布形态

四个域的数据使用 DSH 官方领域存储(dsh-storage-domain,backend: json),文件位于 $DSH_HOME/storages/,文件名以 ai_product_radar_ 开头,跨重启持久化已实测。卸载插件 不会 自动删除这些文件;需彻底清理时请手动删除 $DSH_HOME/storages/ai_product_radar_*。

插件 零运行时 dependencies;npm run build 组装 lib/ 运行树,npm pack 产出可分发 tarball(README 示例为 34 个文件、无 src//demo//test/)。离线测试 335 项 node --test 全通过,测试不出网。

安装与启用

安装命令须按 README 原文使用,不要用仓库名自行拼接 github:owner/repo。

从本地目录安装(开发常用):

dsh plugin --profile <profile> add "<本仓库绝对路径>"

从打包产物安装(接近真实分发):

npm run build
npm pack
dsh plugin --profile <profile> add ./dsh-apradar-0.1.2.tgz

升级时 在拉取新代码后同样需要 npm run build 与 npm pack,再执行 add;若修改了客户端或 package.json 的 ./client 导出,或从 link: 改为 tarball,必须重启 Harness(Desktop 退出重开;Web 侧重新执行 dsh web --profile <profile>),右栏页签才会正确加载。

README 还提到技术验证用的 Spike 包(dsh-apradar-spike)可与本插件并存,日常只需安装 dsh-apradar 即可。

典型用法(工作流)

README 未给出虚构案例,可按产品定位复现下面流程:

  1. 在 关注源管理 中为关心的 GitHub Release、仓库、npm 包、RSS/Atom 或静态 HTML 页面添加来源(可选用预置模板)。
  2. 设置刷新间隔,等待 Host 通过 ctx.web.fetch() 拉取;在 变化收件箱 查看相对上一版的差异及原始证据、官方日期与发现时间。
  3. 对值得跟进的条目在 产品机会池 中记录(「关联项目」仅为自填文本,插件不读取你的代码库)。
  4. 需要归档或评审时,从机会池 导出 Markdown,区分事实区与推测区,自行保存文件。

开发或贡献者可本地跑测试:

node --test 'test/*.test.mjs'

适用场景与注意

适合谁:AI 产品经理、Agent Harness 重度用户、独立开发者——需要持续盯公开来源、要比对「这一版 vs 上一版」、且要把证据和机会结构化留档的人。

权限与安全:插件以 当前 DSH 进程权限 出网抓取;安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。本插件不读取项目代码、不访问需登录的页面、不自动改项目;真正网络边界在 DSH 抓取层,插件文档也不宣称完整 SSRF 防护。

生态说明:DSH 理念是「一切皆插件」;SkillHub 目录页 为社区站点,与 DeepSeek / 幻方无官方从属关系,不宜当作官方应用商店。

更细的产品与技术说明见仓库内 PRD.md、SDD.md、COMPATIBILITY.md 等文档。

结尾

若你的痛点是「变没变、证据在哪、要不要跟」,而不是「今天 AI 圈又有什么标题」,dsh-apradar 把这条链路收进 Harness 右栏,并与 DSH 存储、抓取策略对齐。可从 SkillHub 插件页 了解条目信息,从 GitHub:PolinniZhong/dsh-apradar 获取安装说明与源码。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye