deepseekplugins

DeepSeek Harness plugin

dsh-upstream-watch

DSH 插件：监听 GitHub 上游仓库（freebuff/opencode/自定义）默认分支的所有新提交，设置页面板实时展示 + 日志记录。官方 bundle 插件，安装：dsh plugin --profile web add <repo-ref>

Tools & Capabilities
Jump to install

Source facts

Repository
t479842598/dsh-upstream-watch
Latest update
Aug 14, 2026
Category
Tools & Capabilities
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/t479842598/dsh-upstream-watch
Plugin: dsh-upstream-watch
Author: t479842598

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-upstream-watch

监听 GitHub 上游仓库（freebuff / opencode / 自定义）默认分支的所有新提交，设置页面板实时展示 + 日志记录。

---

⚡ 一键安装

dsh plugin --profile web add github:t479842598/dsh-upstream-watch#v0.1.0

装完重启 web，设置 → 「上游更新监听」出现即成功。

> 本地调试：cd dsh-upstream-watch && dsh plugin --profile web add .

---

✨ 功能

  • 上游监控：默认监听 freebuff@main 与 opencode@dev，任何默认分支 push 都会记录
  • 仓库管理：设置页添加/移除任意 GitHub 仓库（owner repo branch，留空即 main）
  • 实时面板：每个仓库状态徽章、head 提交、监听期间新增数（红色 +N）、检查时间
  • 新提交流：sha / 作者 / 相对时间，底部气泡一键切换只看某个仓库
  • ETag 条件缓存：无变更返回 304，不计 GitHub API 配额
  • 可选 Token：匿名配额仅 60 次/小时（共享出口 IP 易耗尽）；设置只读 PAT 后 5000 次/小时
  • 间隔可调：5 / 10 / 30 / 60 分钟，支持暂停/继续/立即检查
  • 日志落盘：工作区根目录 upstream-watch.log

🎛️ 使用

设置 → 上游更新监听：

1. 仓库卡片：看 head 提交、状态与新增数；点仓库名跳转 GitHub 2. 添加仓库：填 owner repo branch，添加后立即建基线开始监听 3. GitHub Token（可选）：填一个只读 PAT（权限 Contents: Read），免疫共享 IP 配额挤兑；token 只存内存、不落日志 4. 新提交列表：底部气泡 [全部] [freebuff] [opencode] … 切换仓库

> 基线语义：首次检查建立基线（不虚报），此后任何 push 都会作为「新提交」出现。

🔌 API

路由方法说明
/api/upstream-watch/stateGET完整状态快照（repos / recent / 定时信息）
/api/upstream-watch/poll-nowPOST立即轮询
/api/upstream-watch/toggle-pausedPOST暂停 / 继续
/api/upstream-watch/set-intervalPOST {minutes}调整检查间隔（1–120）
/api/upstream-watch/add-repoPOST {owner,repo,branch}添加仓库
/api/upstream-watch/remove-repoPOST {id}移除仓库
/api/upstream-watch/set-tokenPOST {token}设置 / 清除 Token

🛠️ 开发

npm run build    # 重建 lib/client.js（client/src/client.js → bundle 包装）
npm run check    # 校验产物新鲜度（发布前必须跑）

lib/client.js 是生成物，勿手改；改动 client 源码后需重新 build 并提交。

📁 结构

dsh-upstream-watch/
├── package.json        # main/exports + dsh.bundle.patch + dsh.client
├── cordis.patch.yml    # 组合层：insert 挂载自身
├── index.mjs           # Node half：轮询引擎 + webServer 路由（严格 inject）
├── client/src/client.js# browser half 源码
├── lib/client.js       # 构建产物（__ModuleLoader__.load 包装）
└── scripts/            # 构建 / 校验

📚 发布

1. 建 GitHub 公开仓库，仓库根 = 包根，提交全部文件（必须包含 lib/client.js 产物） 2. 仓库 description 与 topics：dsh dsh-bundle deepseek-harness + ui + monitoring 3. 打版本 tag：git tag v0.1.0 && git push origin v0.1.0 4. 自测：dsh plugin --profile web add github:t479842598/dsh-upstream-watch#v0.1.0 → 重启 web → /api/upstream-watch/state 返回 200 5. （可选）npm publish 走 npm 分发；或提交收录到 awesome-dsh-plugin / Oh-My-DSH / plugin-registry

📄 License

MIT

Back to searchOpen GitHub repository

More related plugins

View category