AI 研究雷达 fomalhaut1998/dsh-ai-research

dsh-ai-research

AI 研究三件套 —— 三套零依赖的 Node 工具 + 三份技能 + 一个 DSH 宿主插件：

| 工具 | 回答什么问题 | 数据面 |
| ai-model-radar | 「最近发了哪些新模型？」 | 发布追踪站 / OpenRouter 上架记录 / 官方博客 RSS / GitHub release / arXiv / Hacker News |
| model-report | 「某模型实测、口碑怎么样？A 和 B 哪个强？」 | 13 路结构化跑分（Artificial Analysis、Vals AI 50 基准、SWE-bench、SWE-rebench、ARC Prize、LMArena 人类盲测、llm-stats、benchlm…）+ 英文社区（HN / X / Reddit）+ 中文社区（B站 / CSDN / 微信公众号 / 掘金 / 知乎 / 小红书）+ 2~4 模型重合基准逐项横评 |
| ai-news-radar | 「AI 圈最近发生了什么？」 | 46 个 RSS/HTML 源 + 22 个官方 X 账号（按天轮转）+ Google/Bing 新闻检索 + HN / Reddit / 微信公众号，按 8 个主题分类去重 |

产物都是带来源链接的 Markdown（一份文档一个 H1 → 元信息引用块 → 目录 → 自动编号章节），可直接给人读，也可喂给模型做二次解读。所有数据都来自公开网页 / 公开接口，无 API key 依赖。

研究用途。抓到的是当时网页上写的东西，不是事实核验；引用时请连同数据截止时间与数据缺口一起引用。

目录结构

dsh-ai-research/
tools/ # 工具源码（单一事实来源，零依赖纯 Node ESM） ai-model-radar/ # collect / summarize / renderMarkdown / run.mjs 命令行 model-report/ # 13 路结构化源 + 中文社区 + X/Reddit + LMArena(parquet) + 渲染 ai-news-radar/ # 源清单 + 采集 + 分类去重 + 渲染 + cli.mjs skills/ # 三份技能正文（Markdown + frontmatter） packages/dsh-ai-research/ # 可发布的 DSH 插件包（宿主半，注册 4 工具 + 3 技能） index.js # 注册与参数校验；工具实现在运行时 import cordis.patch.yml # profile 插入点 sync-tools.mjs # tools/ → 包内 tools/（发布前 --check） sync-skills.mjs # skills/ → 包内 skills/（发布前 --check） tools/ skills/ # 生成物：包内自包含副本（勿手改） PUBLISHING.md # 发布与投稿清单（npm / 插件目录 / Discussions）

快速开始（不需要 DSH）

需要 Node ≥ 18（用到内置 fetch；建议 20+）。无需 npm install，仓库零依赖。

最近 7 天有哪些新模型
node tools/ai-model-radar/run.mjs --days 7 --out ./digests

某模型体检（--brief 只出一页素材包，快得多）
node tools/model-report/cli.mjs "Gemini 4 Argon" --out ./results
node tools/model-report/cli.mjs "Gemini 4 Argon" --brief --fast

2~4 个模型横评（--auto 3 = 自动挑 3 个段位相近的对手）
node tools/model-report/cli.mjs --vs "Gemini 4 Argon,Claude Opus 5.5" --auto 3 --out ./results

AI 圈新闻日报
node tools/ai-news-radar/cli.mjs --days 1 --out ./digests
node tools/ai-news-radar/cli.mjs --list-sources # 列源清单

常用开关：--fast / --no-x / --no-reddit / --no-lmarena / --no-cn / --per-source 5 / --json。
想看模块化调用（自己写脚本）见 skills/.md —— 它们同时是给 agent 的操作手册，把每个源怎么解析、有哪些坑都写在里面。

装成 DSH 插件

插件让这三个工具在任何会话 / 工作区都能直接调（4 个工具：ai_model_radar / model_report / ai_news_radar / ai_fetch_article）。

A. 从 npm 装（推荐）

dsh plugin add dsh-ai-research # 或：node "<DSH app>/lib/plugin-cli.js" desktop add dsh-ai-research

装完重启 DSH（宿主启动时组装 bundle 图），这三个技能与四个工具在任何会话里都能调。
B. 本机 link（开发用） —— 见 packages/dsh-ai-research/README.md 的「本机安装」。

C. 手工三步（等价于官方命令行）：profile 的 package.json 里 dependencies 加一条、dsh.profile.bundles 末尾加一条、node_modules 下建软链，然后重启 DSH（宿主插件在启动时组装 bundle 图）。

工具实现在插件里是运行时 import：包内 tools/（由 sync-tools.mjs 同步进来，自包含）；包内没有 tools/ 时回退到「本文件上两级」的源码布局；两者都可用插件配置的 root 覆盖。

环境变量

一切运行期状态都在用户主目录，不在仓库里 —— 所以仓库可以放心公开，工具也不会因为升级包而丢缓存。

| 变量 | 作用 | 默认 |
| DSH_AI_RESEARCH_HOME | 状态根目录（缓存 / cookie / 限流状态） | ~/.dsh-ai-research |
| DSH_AI_RESEARCH_PROXY · MODEL_REPORT_PROXY · MR_PROXY · HTTPS_PROXY · HTTP_PROXY | 出网代理（按此顺序取第一个非空；off/0/none = 关闭） | 未设 = 直连 |
| NO_PROXY / no_proxy | 免代理主机（支持 、example.com、.example.com） | — |
| DSH_AI_RESEARCH_COOKIES · MODEL_REPORT_COOKIES | cookie 文件路径 | <home>/cookies.json |
| DSH_AI_RESEARCH_CHROME · CHROME_PATH · CHROME_BIN | 浏览器可执行文件（小红书走无头 Chrome） | 按平台常见安装位置 + PATH 自动探测 |
| DSH_AI_RESEARCH_CHROME_PROFILE | 无头浏览器 profile 目录 | 系统临时目录 dsh-chrome-xhs |
| DSH_AI_RESEARCH_OUT | ai-news-radar 的默认落盘目录 | ./digests |

国内网络环境常常需要代理才能访问 HF / Google News / Reddit / X，例如：

DSH_AI_RESEARCH_PROXY=http://127.0.0.1:7890 node tools/model-report/cli.mjs "某模型"

需要自备的凭据（可选）

只有两个源要登录态，没有也能跑（会在报告的「数据缺口」里显式声明，绝不静默返空）：

- 知乎、小红书 —— cookie 放进 <home>/cookies.json，字段名 zhihu / xiaohongshu。
导入方式见 skills/model-report.md：node tools/model-report/set-cookie.mjs zhihu ["<关键词>"] --test。
- cookie 文件等同登录凭据：不要提交、不要外发（.gitignore 已挡）。

已知边界（都写在技能文件里，这里只列结论）

- 抓取是有礼貌的：串行 + 间隔的请求节奏、磁盘缓存，以及真被限流时的熔断与 gaps 声明。
X 的 syndication 是硬配额（30 次 / 15 分钟）；小红书走无头浏览器且每天新开页面上限 4 次，命中风控即 24h 冷却。
- 有些站就是拿不到（Cloudflare / 登录墙 / 客户端渲染），技能里逐条记了「试过但拿不到，别再重复探」，例如 lmarena.ai 站点本体、HuggingFace 模型卡正文、Bloomberg / FT / Reuters 正文。
- 不同源的分数不可混算：AA 智能指数、benchlm 综合分、LMArena Elo 是三套刻度，只能各自内部比；横评里只对同名基准做逐项对比（同名 harness 也可能不同，只能当方向参考）。
- 命令示例以 Windows / PowerShell 为准（源码作者在 Windows 上开发）；macOS / Linux 把 $env:X=... 换成 X=... 命令 即可，路径与浏览器探测都已按平台分支。

开发

改完 tools/ 或 skills/ 后同步进包（发布前用 --check 卡住漂移）
node packages/dsh-ai-research/sync-tools.mjs
node packages/dsh-ai-research/sync-skills.mjs
node packages/dsh-ai-research/sync-tools.mjs --check
node packages/dsh-ai-research/sync-skills.mjs --check

语法自检
node --check tools/model-report/lib.mjs

改插件本体（packages/dsh-ai-research/index.js）后要重启 DSH 才生效。

发布

见 PUBLISHING.md：GitHub 建仓（dsh-plugin topic + 满 1 天）→ npm 发布 → 两个插件目录 PR → 官方 Discussions「Show Your Plugins!」。

License

MIT —— 见 LICENSE。