dsh-github-trending

dsh-github-trending

GitHub 趋势榜的 DeepSeek Harness 插件

简体中文 | English

GitHub 趋势榜的 DeepSeek Harness 插件：按日 / 周 / 月周期定时生成趋势日报，交给本地 [trendradar](https://github.com/morehao/trendradar) 核心抓取 Trending、写中文简介与周期总结，并自动提交到你自己的仓库、开 PR 合并。你在工作台里看状态、读榜单、管理订阅，不用盯命令行。

定位

• 它是入口，不是引擎。抓取、解析、模型总结、渲染、git 与 PR 全在本地 trendradar 核心一处实现；插件只负责配置、调度、spawn 核心、展示结果，避免两份实现漂移。
• 成品原样落地。内容按核心产出的 canonical 逐字节写入，插件不改写、不重排、不二次调用模型。
• 本地运行、无遥测。核心在你的机器上跑；插件没有云端账号，密钥只经运行时通道交给核心，不写配置文件、不进日志。

> 需要什么、配置项、错误码、订阅阶段、实现细节等深入内容见 [docs/reference.md](docs/reference.md)。

功能说明

工作台从侧栏「GitHub 趋势」或 设置 → GitHub 趋势 进入，分五个视图：

概览

一屏回答「下次什么时候跑、四项就绪检查是否齐、上次交付了什么」。顶部是插件身份条（版本 / 包名 / 检查更新 / GitHub，两个图标紧跟包名），点包名打开「关于」弹层；右侧常驻下次运行与就绪 N/4。

榜单

按周期（日榜 / 周榜 / 月榜）回看历史榜单，直接渲染 Markdown（标题、列表、表格、链接），也可切「原文」。只有保留了预览副本的期数能读；失败 / 无变更 / 试跑 / 旧记录各有空状态。

运行记录

最近 30 次运行，按成功 / 失败 / 试跑筛选；展开某条看交付物（提交、内容哈希、分支、PR 链接）与只读日志，页脚给累计 token。

设置

内容来源 / 模型 / 仓库 / 认证 / 榜单（含调度、摘要与用量）/ 订阅 六个分区，每个分区独立保存与校验；某分区有未保存改动时左侧对应项显示黄点。

摘要语言

「摘要与用量」里的摘要语言下拉决定生成的日报 / 订阅摘要用哪种语言：

• 跟随宿主（默认）：读宿主界面语言（zh → 中文、en → 英文）；中英之外的语言一律回落中文。
• 中文 / English：显式指定，优先级高于宿主语言。

语言的最终解析顺序是「显式设置 > 宿主语言 > 中文兜底」。该能力需要核心 ≥ 0.12.0；核心过旧时设置页会提示「需升级核心后生效」，但下拉仍可先选好，升级后自动按此产出。

GitHub 认证

认证分区支持三种方式（可随时切换）：

• 浏览器登录（推荐）：点「用 GitHub 登录」在浏览器完成授权，无需手工粘贴 token，token 由 DSH 凭据记录安全保存、不落 settings.json。插件内置了公开的 OAuth App client_id，开箱即用。GitHub 的 web flow 换 token 必须带 client_secret（客户端不能内置机密），所以走设备码：点一下打开 GitHub 验证页，把页面上的验证码（设置页可一键复制）输入并确认即可。
• 本机 gh：复用你终端里 gh auth login 的登录态。
• PAT：手工填 Personal Access Token（存到凭据引用 / 环境变量）。

> 浏览器登录需要核心提供 authorization 服务，并且 GitHub flow 注册成功才算可用；两者任一不满足时，设置页直接提示不可用并引导改用 gh / PAT，而不是给一个点了没反应的按钮。宿主启动时服务可能晚于插件就绪，插件会等服务就绪再注册，并在读状态时再兜底一次。

>

> 设备码 / 授权页默认尝试自动打开；若被浏览器的弹窗拦截，状态行里始终有可点的「打开授权页」链接、验证码与「复制链接」。

订阅

（可选）订阅一组仓库，每周把每个仓库当周新增的 Release 合成一段中文摘要，与榜单同分支、同 PR 一起提交；订阅列表随数据仓版本化，可审计、可复现。

安装

dsh plugin --profile  add @morehao/dsh-github-trending

装完重启宿主，从侧栏「GitHub 趋势」或 设置 → GitHub 趋势 进入。

三步上手

1. 选仓库：填本地 git 仓库的绝对路径（插件不替你 git init，不是仓库就报 REPO_NOT_GIT）。

2. 填模型：点「沿用 DSH 配置」从宿主 provider 目录里挑 provider 与模型；可导出密钥的直接传给核心，OAuth 类凭据走本机回环代理。

3. 试跑一次：「试跑（不提交）」只抓取与渲染，不写文件、不提交。

环境要求：DSH 0.2.1-rc.3 以上、Node.js ^22.20.0 || >=24.0.0、本地 git ≥ 2.30 与可写远端、git/GitHub 凭据（仅 push 与开 PR 需要）。核心二进制首次运行从 GitHub Release 下载并按 sha256 校验，之后离线复用。

> 网络代理：核心抓取 GitHub 需要联网。GUI 宿主（从 Finder 启动）通常不继承 shell 的 http(s)_proxy，在国内直连会超时——现象是趋势页抓取失败、回退到 GitHub 搜索 API（无「今日新增」增量、按总 star 排序）。此时在设置 → 核心 → 网络代理填 http://127.0.0.1:7890（你的代理地址）即可，插件会把它注入核心子进程的 HTTP(S)_PROXY/ALL_PROXY。留空则不使用代理。

开发与发版

npm install
npm run check            # typecheck + 契约校验 + 构建 + 全部测试
node scripts/ac/run.mjs  # AC-P 机械检查

发版走 tag 触发的 CI（Trusted Publishing / OIDC）：合并 PR → 在 main 打注记 tag vX.Y.Z → CI 发 npm 并用注记正文建 Release。细节见 [docs/publishing.md](docs/publishing.md)。

许可

MIT