dsh-github-digest:按需抓取你关注的仓库变化并生成日报

前言

DeepSeek Harness(DSH)是「一切皆插件」的智能体运行框架。你可以在 DSH 里跑会话、用插件扩展能力。插件生态由社区维护,与 DeepSeek 或幻方没有官方从属关系。

很多开发者会关注 GitHub 上的仓库和主题,但更新频率高、变化杂。常见的做法是刷热榜或订阅 RSS,这会带来大量不相关的内容,而且都是「列表+摘要」,缺少「对你有没有用」的判断。

dsh-github-digest 是一个 DSH 插件。它定时唤醒一个会话,去扫你指定的仓库和主题,判断哪些变化值得看、对你有什么影响,并生成一份日报。它不碰 GitHub 的写操作,只读。

插件定位

  • 名称:dsh-github-digest
  • 维护者:kx121
  • 分类:联网工具
  • 简介:到点叫醒 DSH 会话,翻你关注的 GitHub 仓库和主题,挑出值得跟的变化,写日报、记判重表。只读。

核心功能

  • 定时唤醒会话,扫描你关注的仓库和主题。
  • 先用一次 Search 请求粗筛,再对筛选出的仓库拉 releases/commits/README,细读判断。
  • 按插件自带的准则(prompts/digest.md)判断值不值得看,写日报并记判重表。
  • 侧边栏面板展示执行记录、成本、筛选与搜索等功能。
  • 支持主题发现模式:在「主题/关键词」中输入关键词,自动发现新项目。

安装与启用

从 GitHub 安装:

dsh plugin --profile desktop add github:kx121/dsh-github-digest

或直接安装 Release 里的 tarball:

dsh plugin --profile desktop add https://github.com/kx121/dsh-github-digest/releases/download/v0.2.2/dsh-github-digest-0.2.2.tgz

安装后重启 DSH,侧边栏会出现「GitHub 日报」,设置页会出现「GitHub 日报设置」。

30 秒配好

  1. 设置 → GitHub 日报设置 → 「关注仓库」填仓库全名,一行一个。
   deepseek-ai/deepseek-harness
   ollama/ollama

不想填仓库也行:在「主题 / 关键词」里填 dsh-plugin、mcp 之类,一行一个,插件会自动扫新项目。

下面还有个「我的背景」,一句话说清你在做什么(比如「做 DSH 插件和自动化脚本,关注成本、稳定性」)。判断「对你有没有用」时模型会先看它;不填就按主题和关注仓库推断。

  1. 「目标会话」留空 = 每轮自动新建或复用当天的日报会话;也可以指定一个固定会话。

  2. 「定时」选每天,时间填 12:30(谷时,模型便宜一半)。

  3. 点「保存」,再点「立即跑一轮」。结果在侧边栏「GitHub 日报」里看,日报写进 <工作区>/.github-digest/YYYY-MM-DD-N.md(N 是当天第几轮)。

不用配 token 也能跑。插件会自动从本机找已有的 GitHub 凭据,找不到就匿名跑。

限速与额度

不填 token 时:

  • 每小时 REST 额度:60
  • 每分钟搜索额度:10

填只读 token 时:

  • 每小时 REST 额度:5000
  • 每分钟搜索额度:30

一轮的请求次数(约 3–14 次):

  • 粗筛:1 次(一次 Search 批量拿全部关注仓库的元信息)
  • 细读:1–2 次/仓库(releases + commits,只对筛出来的仓库拉)
  • 有推送时才拉 releases(没推送的仓库直接跳过)

所以不填 token 的 60 次/小时,按默认 6 条算够跑 4–15 轮。填了 token 是 5000 次/小时,基本不用管这件事。

成本与开关

GitHub 数据量大,插件做了三件事:先粗筛再细读、按判重表只返回新版本、正文截断。

默认配置一轮(6 条以内、不读 README)的 token 增量约 8–12k,费用约 0.01–0.02 元。每天一轮、一个月约 300–400k token,费用约 0.3–0.5 元。

设置页有三个开关:

  • 读 README:默认关闭(一个 README 两三千字,是单轮最大的 token 来源)
  • release 正文截断:600 字符(够判断「改了什么」,不读完整个 changelog)
  • 每轮最多看几个仓库:40(粗筛本身不贵,贵在细读;收取上限才是成本的闸门)

侧边栏面板

点侧边栏「GitHub 日报」:

  • 消耗:本轮费用 / 日报累计 / 今日全部(含其他会话)/ 各项目体量
  • 日报记录:每轮一条,带项目编号、推荐程度、变化 / 影响 / 建议
  • 筛选:按推荐程度、按时间(今天 / 3 天 / 7 天)
  • 来源分栏:全部 / 发现 / 关注 / 热门。发现模式扫到的项目、关注仓库的记录、热门榜单,分开看
  • 历史搜索:按项目名和「是什么 / 变化 / 影响 / 建议」全文模糊搜,空格分隔多个词按「全部命中」算。搜的是整个 history.jsonl(最多 500 轮),不只是面板上的最近 20 轮。命中的词会高亮出来
  • 字号滑块:记录区文字 0.85×–1.6× 缩放。偏好存在本机浏览器里(localStorage),不进配置文件,不影响面板其它区域
  • 四栏标签是小气泡(是什么 / 变化 / 影响 / 建议各自一个低饱和配色),扫记录时一眼能分清是哪一栏
  • 关注按钮:每条项目右边点一下就加进关注列表,再点取消。只改本机配置,不对 GitHub 发写请求
  • GitHub 热门:来源分栏里的「热门」,今日 / 本周 / 本月三档榜单,切过去才拉,30 分钟缓存;右上角「刷新」跳过缓存重拉。榜单带「是什么 / 最近推送 / 话题标签」,中文简介由默认模型批量生成(一次调用,按仓库缓存,超时或失败回退英文;设置页可关)。数据走 api.github.com,不依赖 github.com 网页(后者在国内经常直连不通)
  • 关注视图顶部列出所有关注仓库和上次检查结果(未发现更新 / 有新推送 / 很久没动静 / 尚未检查),不用翻记录就知道哪些没动
  • 「立即跑一轮」直接触发

日报示例

# GitHub 日报 2026-10-22

额度:42/60|模式:定时|关注仓库 3 个|粗筛 3 个、细读 2 个

## 值得看

### 1. owner/repo ★1.2k
- **是什么**:一句话说清这东西是干嘛的(首次收录必写)
- **变了什么**:v2.1.0(10-20),新增 xxx,删掉了 yyy
- **为什么值得看**:具体一句,说清解决什么问题
- **要不要跟**:建议 + 成本

## 跳过的

- owner/another:只改了 CI 配置

## 异常

- 无

没有值得看的,就写「本轮没有值得看的」,不凑数。

数据存储

~/.dsh/github-digest/
  config.json          设置页存的值(含 token,权限只给当前用户)
  seen.md              判重表:仓库 / 处置 / 理由 / 首次看到
  runs.md              执行记录:时间 / 触发 / 结果 / 关注 / 收取 / 跳过 / 额度 / 备注
  history.jsonl        面板用的结构化记录(含成本、项目明细)
  watch-state.json     每个仓库上次检查时间、发现模式的主题游标
  pending-run.json     本轮临时数据(成本基线 / 粗筛缓存)
  apply-probe.json     插件加载探针(排障用)
<工作区>/.github-digest/
  YYYY-MM-DD-N.md      日报(N 是当天第几轮;必须落在工作区内,否则每轮弹权限审批)

安全边界

  • 只读:所有请求都是 GET。不发 issue、不点 star、不改仓库、不操作 PR。
  • token 只用于提高限速:不写入日志、设置页不回显明文,只显示来源和前后各 4 位。自动探测到的 token 只进内存(5 分钟重读一次)。
  • 投递的消息用官方 createUserMessage 构造,保证会话格式合法。
  • HTTP 路由有来源校验:只接受本机回环地址,跨站请求直接 403。

适用场景与注意

适合:需要每日跟进 GitHub 上多个仓库和主题更新,希望从大量变更中筛选出「值得看、对你有用」的内容的开发者与智能体开发者。

注意:插件以当前 DSH 进程权限运行。安装前建议检查源码与许可证。插件不依赖 github.com 网页,数据走 api.github.com,在国内直连不通的场景下可用。

短结尾

dsh-github-digest 把「看 GitHub」变成「看对你有用的变化」,在 DSH 侧边栏直接生成日报。适合希望用 DSH 做自动化与日报场景的开发者。

  • 目录页:https://www.skillhub.cn/plugins/kx121/dsh-github-digest
  • GitHub:https://github.com/kx121/dsh-github-digest
羽毛球分组比赛记分
小程序二维码

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

小夜