【GitHub每周热点解析】第2期：last30days-skill

qq_52949075

317人浏览 · 2026-06-15 22:50:51

qq_52949075 · 2026-06-15 22:50:51 发布

文章目录

0. 栏目介绍

这是我新开的一个栏目——GitHub 每周热点项目深度解析。

预计每周一篇。挑 GitHub Trending 周榜上数据最值得看的项目，做一次比"30 秒 README 速读"更深的拆解：从项目历史、作者背景、到具体怎么用、为什么值得用、有没有同类项目可以横向对比。

第二期，挑了 mvanhorn/last30days-skill。

1. 本期选品 + 选品理由

2026 年 6 月 14 日单日新增 3,558 Stars，位列 GitHub Trending 日榜第一（数据截至 2026-06-14）
14 类社区数据源聚合——Reddit、X、YouTube、TikTok、HN、Polymarket、GitHub 等。GitHub 上能同时接入这么多 walled garden 的项目不多
v3.3.0 跑了 1,012 项自动化测试通过——截至 2026-05-17 累计 14 个 release，属于持续迭代型维护
Polymarket 真实押注赔率作为评分信号——把"真金白银"纳入评分体系是产品方法论上的差异化
截至 2026 年 6 月 14 日，以项目名检索暂未发现相关 CSDN 文章——首发窗口期

2. 项目历史

维护者：mvanhorn。

时间线：

v1：简单多平台搜索聚合器，关键词驱动——痛点是搜出来的内容跟实际想要的 entity 经常对不上
v2：引入多平台 worker agent 并发抓取，按 upvotes / likes / Polymarket 押注赔率排序
2026-05-17：v3.3.0 发布
2026-06-14：41,708 stars、3,389 forks；CHANGELOG 显示累计 14 个 release

v3 架构质变：v3 之前先用 Python pre-research brain 把 topic 解析成 entity graph，再开始抓取。这是 v3 整个架构的最大质变点——v2 没有这一步，搜出来的内容跟实际想要的 entity 经常对不上；v3 搜"Cursor"自动展开成 @cursor_ai、r/cursor、相关 GitHub repos、相关 YouTube channels。

贡献者归属：项目由 mvanhorn 维护，README 将 v3 engine architecture 归功于 @j-sperling。社区里 @itsjasonai、@itswilsoncharles 等 KOL 的 X 真实使用反馈也推动了项目迭代。

3. 项目速览

一句话定位：把 Reddit、X、YouTube、Polymarket 等 14 类社区数据源并行检索、汇总成结构化调研报告的 AI Agent Skill（根据 API key、查询类型和配置启用其中可用的数据源）。

基础数据（截至 2026-06-14）：

维度	数据
Stars	41,708
Forks	3,389
语言	Python 98.3%（Shell 1.1%，HTML 0.6%）
最新版本	v3.3.0（2026-05-17 发布）
累计 Release	14 个
协议	MIT
自动化测试	1,012 项通过

三大核心亮点：

多平台并行抓取：支持 14 类主要数据源，根据 API key、查询类型和配置并行启用其中可用的数据源
真实行为评分：Reddit upvotes、X likes、YouTube views、Polymarket 真实押注赔率——采用不同的排序信号，更重视互动量、相关性和新鲜度
自备 API key 模式：Reddit、Hacker News、Polymarket 无需额外配置；其他平台需自备 key

14 类数据源清单：

数据源	类型	入门门槛
Reddit（+ comments）	社区	无需额外配置
Hacker News	社区	无需额外配置
Polymarket	押注	无需额外配置
GitHub	代码	需要 GitHub Token 或 gh CLI 登录
Digg	AI 1000 leaderboard	需系统中存在 digg-pp-cli
X / Twitter	社交	浏览器登录
YouTube（+ transcripts）	视频	`brew install yt-dlp`
Bluesky	社交	App password
TikTok	视频	ScrapeCreators key
Instagram Reels	视频	ScrapeCreators key
Threads	社交	ScrapeCreators key
Pinterest	图片	ScrapeCreators key（按需）
Perplexity Sonar	AI 搜索	OpenRouter key（按需）
Web (Brave)	网页	Brave API key（2,000 免费/月）

它跟传统搜索的差异：传统搜索引擎（Google、Perplexity、Brave 等）主要覆盖网页内容；last30days-skill 主要覆盖社区信号——Reddit 评论、X 推文、TikTok 字幕、Polymarket 押注这类传统搜索覆盖较少的内容。两者覆盖场景不同，适合搭配使用：传统搜索适合查文档、找教程、定位资源；last30days-skill 适合查"人在想什么、社区怎么看、市场怎么押注"。

4. 深度解析

4.1 整体 Pipeline（5 步）

用户输入 topic
   ↓
[Step 0] Entity resolution（pre-research brain）
   ↓ 把"Cursor"映射成 @cursor_ai + r/cursor + GitHub repos + YouTube channels
[Step 0.5] 可选：competitor discovery（`--competitors` 自动找 2 个 peer entity）
   ↓
[Step 1] 已配置的数据源 worker agent 并发抓取
   ↓
[Step 2] 行为评分（relevance + humor 双 judge）
   ↓
[Step 3] Cross-source cluster merging（同一故事合并）
   ↓
[Step 4] AI judge 综合成 markdown / HTML 简报

第一步 entity resolution 是 v3 整个架构的最大质变点。工程上要做双向解析：person → company、product → founder、name → GitHub profile。README 将 v3 engine 核心架构归功于 @j-sperling。

4.2 Cross-source Cluster Merging

传统搜索的常见现象：同一事件在 Reddit 一帖、X 一推、YouTube 一视频，被算成 3 条独立结果。

v3 的解法是 entity-based overlap detection——不靠标题相似度（标题经常用不同词），靠底层 entity 是不是同一个。

4.3 对比查询的实现方式

对比查询会为每个 entity 分别执行完整检索 pipeline，并行运行以控制总耗时，最后合并为对比报告。--competitors 会先发现两个同类对象，再为每个对象生成独立检索计划。

README 给出的多对象对比示例约需 3 分钟。

4.4 GitHub Person-mode

当 topic 是人时，pipeline 切换到 author-scoped queries——直接查 PR 速度、release notes、最近一个月的项目动态，不再泛搜"谁在某 issue 里提到了这个名字"。

4.5 自动化测试

v3.3.0 跑了 1,012 项自动化测试通过，CI 全过。仓库包含针对 entity resolution、Polymarket noise filtering、per-author cap 等机制的相关测试。

5. 重点任务展开

本节拆解 last30days-skill 最核心的 3 个机制——评分维度、Polymarket 应用、双 judge 模型。理解了这 3 个机制，就理解了这个项目的方法论根基。

5.1 评分维度（方法论根基）

last30days-skill 的评分维度表是整套方法论的核心证据：

平台	主要互动信号
Reddit	帖子分数、评论数、upvote ratio、热门评论
X	likes、reposts、replies、quotes
YouTube	views、likes、comments、热门评论
TikTok	views、likes、comments、热门评论
HN	points、comments
Polymarket	内部参考 volume、liquidity；报告展示 odds
GitHub	issue/PR 互动；person-mode 另外汇总 PR、Stars、Release

核心思路：采用不同的排序信号，更重视每个平台自己的"用户行为信号"，编辑权重不是主要排序依据。

使用场景示例（具体输出取决于 query）：可以用于检索"DeepSeek 最新模型的海外接受度"——GitHub 上 deepseek-ai/DeepSeek-V3 的 PR 节奏、X 上 @deepseek_ai 的 likes/retweets、Reddit r/LocalLLaMA 上的测评帖 upvotes 都可作为评分输入。

5.2 Polymarket 真实押注赔率

README 原话：“Not opinions. Odds. Backed by real money.”

Polymarket 是预测市场，每个事件都有真实押注赔率（% 概率），背后是真金白银。这种信号比单纯的"专家分析"更难反驳——因为有人愿意为这个判断付钱。

输出 vs 内部排序：Polymarket 在内部排序中仍会参考 volume 和 liquidity（如源码所示的 engagement score 大致是 volume 60% + liquidity 40% 之类权重），但最终报告主要展示市场赔率，避免交易金额干扰阅读。

Polymarket noise filtering：common-word disambiguation 防止 “Apple” 匹配 “Will Apple release a car?”——这是 entity disambiguation 的具体应用。

注意点：预测市场同样受流动性、参与者结构和市场规则影响。Polymarket 信号是参考维度之一，不是唯一信号源。

5.3 双 Judge 模型

v3 引入的双 judge 模型是产品决策上的小创新——传统搜索只评 relevance，Reddit 和 X 上经常有一种情况：一句话 relevance 极低但幽默度极高，是那种让人想截图分享的金句。

v3 用两个 judge 并行打分：

Relevance judge：决定内容能不能进主报告
Humor judge：单独打 “funny score”，最高的 quote 进报告末尾的 Best Takes 段

fun score 不仅高亮，还会混入正文叙事——最妙的一句会在最相关的段落里被引用。

附加机制：

Per-author Cap：项目默认限制为每位作者最多 3 条，防止单一作者刷屏
Entity Disambiguation：引擎解析 handles 时做 entity 消歧——不会把同名 entity 误匹配成无关内容

6. 3 个使用场景

last30days-skill 的核心价值在"调研"——但具体怎么用取决于调研对象和读者能接触到的数据源。下面 3 个场景都是从国内开发者日常工作里抽出来的。

6.1 调研一个海外开源项目

最近想选型一个新工具，但网上中文资料滞后，英文社区评价才是最新参考。

/last30days Rust async runtime 2026

可以用于检索 Reddit r/rust 上关于 tokio 1.40 的讨论、X 上 Rust 核心开发者的公开观点、Hacker News 上相关 PR 的争议点。具体输出结构见 §8.4。

6.2 调研一个国内 AI 公司的海外表现

DeepSeek 在国内热度高，但海外市场反馈才是它真正的验证场。

/last30days DeepSeek 深度求索

可以用于检索 Reddit r/LocalLLaMA 上的模型测评对比、X 上 @deepseek_ai 的发声节奏、Hacker News 上关于 V3 模型发布的讨论。国内外信号交叉验证——比单看中文媒体评价更立体。

6.3 跟进热点话题

最近某个 AI 公司发布新产品，想快速看社区反应。

/last30days Anthropic Claude 4 eli5 on

ELI5 模式让 AI 把所有内容翻译成大白话输出——技术报告变成"小明能听懂"版本。同一份数据，技术受众和非技术受众都覆盖。

7. 局限与适配场景

7.1 局限

这套工具有几个天然边界——

覆盖的社区主要是英文圈（Reddit/X/TikTok/HN/Polymarket 都是英文世界）。国内社区信号（知乎、CSDN、掘金、微博）不在它的数据源里
完整调研通常需要数分钟，不适合秒级监控和突发事件告警
付费墙内容抓不到（Reddit 评论抓得到，付费文章抓不到）

7.2 适配场景

last30days-skill 最擅长的是"英文社区信号聚合"。以下场景下它的价值较大：

需要快速了解海外开源项目 / 工具 / 公司的真实社区反馈（技术选型、竞品分析、出海调研）
需要跟踪海外技术话题热度变化（趋势监控、海外市场预判）
需要多源交叉验证（投资参考、海外政策风险评估）

如果需求是中文社区舆情监控、学术文献调研、付费墙内容抓取，更合适的方向是专门的国内舆情工具 / Google Scholar / 学术数据库 / 自建爬虫——last30days-skill 不是为这类场景设计的。

7.3 一点个人观察

跑了几次之后，几个被低估的细节：

Polymarket 真实押注赔率作为评分信号是产品方法论上的差异化——其他类似工具大多停留在 upvotes/likes 层面
ELI5 mode让一份数据能切换两种表达，不用重跑两次
Best Takes 双 judge把"幽默度"作为评分维度之一，Reddit 和 X 上那些让人想截图分享的金句不再被埋在长报告末尾

8. 快速上手

8.1 准备工作

Python 3.12+（v3 要求 3.12+）
一个 Claude Code / Cursor / Codex / Gemini CLI 客户端
可选 API key：X 浏览器登录、YouTube 装 yt-dlp、ScrapeCreators key、OpenRouter key

首次安装不需要配任何 key，Reddit、Hacker News、Polymarket 三个数据源无需额外配置，GitHub 需 Token 或 gh CLI 登录。

8.2 5 种安装方式

# 方式一：Claude Code（推荐）
/plugin marketplace add mvanhorn/last30days-skill
/plugin install last30days

# 方式二：通用 Agent Skills hosts
npx skills add mvanhorn/last30days-skill -g

# 方式三：claude.ai 网页版
# 下载 last30days.skill → Settings > Capabilities > Skills > 上传

# 方式四：OpenClaw
clawhub install last30days-official

# 方式五：开发者手动调试
git clone https://github.com/mvanhorn/last30days-skill.git
ln -s "$(pwd)/last30days-skill/skills/last30days" ~/.claude/skills/last30days

8.3 第一次运行

/last30days Rust async 2026              # 调研一个技术话题
/last30days DeepSeek 深度求索             # 调研一家 AI 公司的海外反馈
/last30days Anthropic Claude 4 eli5 on   # 调研话题 + ELI5 模式
/last30days Cursor IDE --emit=html       # 调研产品 + 输出 HTML 简报
/last30days 英伟达 H100 现货价格 2026     # 调研一个投资方向
/last30days OpenAI --competitors         # 自动发现竞品 + 3-way 对比

8.4 输出结构

报告默认是结构化 markdown，包含 4 段：

这个对象最近在做什么（30 天动态时间线）
最近关注什么
社区怎么看（带具体 engagement 指标）
Best Takes（妙句高亮）

8.5 输出成可分享 HTML

/last30days Cursor IDE --emit=html

产出文件：~/Documents/Last30Days/cursor-ide-brief.html。

HTML 是 inline CSS、system-font fallback、no JavaScript、可打印、可离线打开。可以直接拖进微信群、邮件附件、Notion。

附录

项目链接

仓库：mvanhorn/last30days-skill
v3 engine architecture 由社区贡献者 @j-sperling 设计

同类项目对比（供横向参考）

Perplexity：通用 AI 搜索产品，以网页检索和摘要为主，不直接抓取 Reddit 评论 / X 推文等强社区信号
传统 awesome-xxx 合集：策展型项目（如第一期 build-your-own-x），以"教程链接集合"形式组织内容，last30days-skill 是"AI 主动调研 + 结构化报告"形态，跟合集型项目不同
Hacker News / Reddit 站内搜索：单平台搜索，last30days-skill 跨 14 类数据源聚合