gh-watch
GitHub PR/issue 变更监视插件：检测变更并自动拉起对话通知 AI（多 AI 独立配置，插件自身不审查、不回帖）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:psenY/gh-watch#f213010a103c0a43434e889f73f8101372f7751fGh Watch 以 gh-watch 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness (DSH) 的 GitHub PR / issue 变更监视插件。 检测 PR 与 issue 的变更并自动拉起对话通知 AI —— 插件自身不做审查、不回帖，只负责「发现并通知」，把判断权留给 AI 与用户。
在多 AI 独立协作的场景里，经常需要让某个 AI 关注某些 GitHub 仓库的 PR 与 issue 是否有新动态（新建、新 push、新评论 / review、合并、关闭、重开等）。gh-watch 在后台轮询这些仓库，一旦检测到变更，就把一条变更通知注入对应 AI 的对话，让 AI 知道并决定下一步——而不需要人工反复去刷 GitHub。
设计上刻意保持了「监视与行动」的分离：
current）或新开对话（new）。pull_request 项，GR 与 issue 不会互相污染）。新建 / 新push / 新评论 / 评论变化 / 已合并 / 已关闭 / 重新打开 / 有更新 / 主动查询。2x→4x→8x 指数退避推后下一次轮询，直至某次轮询完全成功后清零，降低撞 GitHub 限流的风险。$DSH_HOME/gh-watch/state.json，重启后恢复游标。[AI 调用 gh_watch_configure] → 注册监视器 (repos / interval / mode / target)
│
每个会话独立 watcher
│ timer 每 60s 触发 tick()
▼
pollWatcher：对每个 repo 拉 pulls + issues
│
首次？──────是──→ 建立基线游标，不推送
│
否
▼
diff 快照 → 检测到变更 → dispatch → 注入对话
├─ current：回到调用方对话
└─ new：新开对话
timer.interval(tick, 60_000) 全局 60 秒驱动一次调度；每个 watcher 按自己的 nextPollAt（= 上次轮询 + intervalMin 分钟）判断是否到期。min(2^failCount, 8) 倍间隔，仅在某次轮询完全成功（所有分仓都拉取成功）后才清零 failCount。作为 DSH 用户插件，通过 cordis.patch.yml 把插件插入 profile 的 layer 栈：
# cordis.patch.yml
- insert:
- id: gh-watch
name: 'gh-watch'
config: {}
安装依赖：
npm install
# 或 pnpm install
需要网络访问 api.github.com。推荐配置只读 PAT（GH_TOKEN），否则匿名访问限流 60 次 / 小时。Token 可通过环境变量 GH_TOKEN / GITHUB_TOKEN，或 DSH credentials 中 GH_TOKEN。
插件向会话上下文注册 4 个工具：
| 工具 | 作用 |
|---|---|
gh_watch_configure | 配置本会话监视器：repos、intervalMin、notifyMode、pushTarget |
gh_watch_status | 查询本会话监视器当前配置与跟踪状态（只读） |
gh_watch_act | 主动拉取某个 PR/issue 的最新状态并注入通知 |
gh_watch_stop | 停止本会话监视器，删除配置 |
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
repos | string[] | 必填 | 仓库列表，格式 owner/repo |
intervalMin | number | 10 | 轮询间隔（分钟），钳制 ≥1 |
notifyMode | inform | auto | inform | inform=只告知更新；auto=通知并请 AI 自动检查 |
pushTarget | current | new | current | current=回调用方对话（推荐）；new=新开一个对话 |
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
repo | string | 必填 | 仓库 owner/repo |
id | number | 必填 | PR 或 issue 编号 |
kind | pull | issue | pull | 类型 |
target | current | new | current | 通知目标 |
gh-watch/
├── lib/index.js # 插件主入口：export { name, inject, apply }
├── package.json # 包定义：main = lib/index.js, type = module
├── cordis.patch.yml # DSH bundle patch：把插件插入 profile layer 栈
├── README.md # 本文档
├── LICENSE # MIT
└── .gitignore
插件入口约定为 CommonJS-style Cordis 插件对象导出 { name, inject, apply }：
// lib/index.js
export const name = 'gh-watch'
export const inject = ['tools', 'timer', 'agents', 'credentials']
export function apply(ctx, config) { /* ... */ }
冒烟测试（确认可导入且导出约定成员）：
node --input-type=module -e "
import { name, inject, apply } from './lib/index.js';
if (name !== 'gh-watch') throw new Error('name mismatch');
if (!Array.isArray(inject) || !('apply' in { apply })) throw new Error('export mismatch');
console.log('smoke ok', { name, inject });
"
依赖
@deepseek-ai/dsh-tools与@deepseek-ai/dsh-credentials需在安装后可用，否则lib/index.js无法导入。
运行时状态（不入库）：
$DSH_HOME/gh-watch/state.json —— watchers 配置与每仓库游标快照。$DSH_HOME/gh-watch/undelivered.log —— 通知派发失败时记录的未送达文本。$DSH_HOME/gh-watch/diag.log —— 基线异常诊断（v0.1.1 起）：陈旧条目被判为「新建」、或持久化时从磁盘补回丢失的 key 时留痕。$DSH_HOME/gh-watch/state.json.bak-YYYYMMDD —— 每日一份状态备份（v0.1.1 起），便于事后 diff 基线改动。diag.log 诊断与每日状态备份。同版并入此前仅在本地运行版存在的两处补丁：批量合并通知（buildBatchNotification）与取消 cursor 窗口淘汰（消除条目在 50 条窗口边界反复进出导致的重复推送）。