前言¶
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 秒配好¶
- 设置 → GitHub 日报设置 → 「关注仓库」填仓库全名,一行一个。
deepseek-ai/deepseek-harness
ollama/ollama
不想填仓库也行:在「主题 / 关键词」里填 dsh-plugin、mcp 之类,一行一个,插件会自动扫新项目。
下面还有个「我的背景」,一句话说清你在做什么(比如「做 DSH 插件和自动化脚本,关注成本、稳定性」)。判断「对你有没有用」时模型会先看它;不填就按主题和关注仓库推断。
-
「目标会话」留空 = 每轮自动新建或复用当天的日报会话;也可以指定一个固定会话。
-
「定时」选每天,时间填
12:30(谷时,模型便宜一半)。 -
点「保存」,再点「立即跑一轮」。结果在侧边栏「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