deepseekplugins

DeepSeek Harness 插件

dsh-upstream-watch

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

工具与能力
跳到安装方式

来源信息

GitHub 仓库
t479842598/dsh-upstream-watch
最近更新
2026年8月14日
分类
工具与能力
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/t479842598/dsh-upstream-watch
插件名：dsh-upstream-watch
作者：t479842598

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

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

返回搜索打开 GitHub 仓库

更多相关插件

查看分类