Skip to content

About

DSH 会话级 superagent:盯一个 GitHub 仓库,有变化就唤醒会话。凭证不进模型,返回统一脱敏。

Topics

Resources

Contributing

Security policy

Stars

49 stars

Watchers

1 watching

Forks

Repository files navigation

主理鱼

dsh-session-superagent

给 DSH 会话装一条主理鱼:仓库有动静时叫醒你,
醒来后按仓库规则把事办了。

version npm license

一条大肥鱼的自述

老板把老家的 dsh-superagent-prototype 丢给我,说:给 DSH 做个会话级 superagent,自己建仓库、自己维护,你就是这个仓库的主理人了。

可我明明是条鱼,所以叫主理鱼。

我只做两件事:

  • 盯:轮询仓库的 issue/PR,按规则决定要不要叫醒当前会话;
  • 办:会话空闲时把任务书塞进来,我读仓库的 AGENTS.md,修 bug、回评论、开 PR、关单。

我不占独立实例,不用 PTC,也不另建 agent 预设。我就是你当前会话多出来的一双眼睛和一只手。

能做什么

  • 盯 GitHub / Gitee — 一条会话可以守多个仓库,各自配置间隔、过滤和时段。
  • 叫醒会话 — 只在空闲时注入,不污染正在输入的内容。
  • 带规则办事 — 唤醒消息带仓库、条目、目标和你配置的过滤条件。
  • 收口 — watch_ack 打「已处理」标签,同一条不会反复叫醒。
  • 隔离干活 — 可选一次性 git worktree,改副本、开 PR,不碰主工作区。
  • 看得见 — 状态栏卫星环 + 面板:为什么叫醒、为什么没叫醒、上次错误。

和 DSH 自带能力一起用

  • goal:读写宿主 goals 服务,和 /goal、create_goal 是同一份目标;唤醒消息会把它带上,不需要另建一套目标。
  • 自动化任务:定时/自动化仍交给 DSH 调度,插件只负责“仓库有动静时叫醒会话”;两边可以同时开,不抢调度器。
  • 多会话:同一个仓库可以被多个会话守,各自独立过滤和 ack 标签,互不共享上下文。

默认值

项 默认
轮询间隔 30–3600 秒
冷却期 3 分钟
单守上限 6 次/小时
会话上限 12 次/小时
隔离区 最多 5 个,超 3 天回收

冷却期 3 分钟:同一个条目刚处理过,短时间内不再叫醒。

状态文件:~/.dsh/state/session-superagent/watchers.json。

安装

DSH 插件要装进 profile,npm i 不会让它生效:

dsh plugin --profile desktop add dsh-session-superagent

# 锁定版本
dsh plugin --profile desktop add dsh-session-superagent@0.10.2

装完重载宿主。开发时用 file: 安装,新增文件后要跑 pnpm run sync:profile,否则插件会整体不挂载。

快速开始

在会话里让 agent 调用:

watch_start({ repo: "owner/name", goal: "处理这个仓库的 issue" })

activeHours 支持逗号或分号分隔的多段 HH:MM-HH:MM,任一段命中就会唤醒,每段都可以跨夜;留空仍是全天:

watch_start({ repo: "owner/name", activeHours: "09:00-12:00,14:00-23:00" })
watch_pr_start({ repo: "owner/name", activeHours: "22:00-02:00;09:00-10:00" })

普通 Issue/PR 守如果只想被新评论叫醒,开启 filters.onlyNewComments:

watch_start({ repo: "owner/name", onlyNewComments: true })

开启后,push、改标签等非评论更新不会唤醒。GitHub 与 Gitee 都会同时检查 discussion 和 PR review comments,取两类里的最新时间推进水位;评论查询失败不会当成「无评论」,也不会推进水位,下一轮会重试。priority.comments 仍然只调整批内排序,不过滤条目。面板对应「只看新评论」Switch,可用 watch_status 或 /state 的 filters.onlyNewComments 自查。

之后它会轮询;有动静时你会收到一条 【主理鱼】owner/name 有 N 条新动态。处理完:

watch_ack({ repo: "owner/name", number: 12, note: "已修复,见 PR #13" })

查看状态:

watch_status()

界面

  • 输入框下方最左端:卫星环,一眼看到所有会话级 superagent 的运行、暂停、异常。
  • 中间栏「主理鱼」:总览 / 判定 / 触发 / 设置。尽量使用 DSH 原生结构树、素材和设计语言。

配置

插件行支持三项,默认值就是原来的行为:

config:
  brandName: 主理鱼
  defaultAckLabel: '主理鱼:已处理'
  defaultAckLabelGitee: 主理鱼-已处理
  • brandName:唤醒抬头、面板标题和关键空态;
  • 两个 ack 标签:只影响没有显式配置 ackLabel 的守;
  • Gitee 标签不能带半角冒号,非法值会回落到默认。

页签名称:中间栏那个页签默认跟随 brandName(不配置就是「主理鱼」)。想单独换个名字, 在「设置 → 来源 → 页签名称」里改,保存后当前界面立即生效。这个覆盖存在本浏览器的 localStorage 里(同一浏览器的所有会话共用,不同步服务端或其他设备),只改页签文案 —— 会话标题、插件包名和 ack 标签都不动; 留空即恢复默认。存储不可用时会提示「本次会话内有效,刷新后回到默认」。

Gitee

owner/name                    # GitHub
gitee:owner/name              # Gitee
https://gitee.com/owner/name  # 直接粘地址

Gitee 没有 ETag,每轮会真读一次列表;私有仓库需要在面板里填私人令牌。

安全与限制

  • 凭证不出插件:通过已登录的 gh / Gitee token 调用,返回统一脱敏。
  • 写操作要确认:POST/PATCH/PUT/DELETE 必须显式传 confirm: true。
  • 只在空闲时注入:会话忙时只排队,不打断你。
  • 轮询有延迟:延迟等于轮询间隔,不是 webhook。
  • 服务端改动要重载宿主:客户端热重载只覆盖界面。
  • 真实读屏 / 触摸 / 长驻:还没有全部在真机验完。

相关项目

文档

验证

1160 项单测、43 项 preflight(贡献归属仅 PR CI 执行,本地 / main push 为 SKIP)、11 项 UI 全绿(0.11.0)。

贡献归属门禁

PR CI 默认运行 scripts/check-pr-attribution.mjs:维护者 PR 若与客户原 PR 携带同一批外部非 merge 提交,会失败并指回原 PR;提交声明修复某条 issue 时,若采用了外部评论中的代码,则必须有对应的 Co-authored-by。仅引用现状源码的复现块不误报;未采用某段代码可显式写 Attribution-Skip: @login #N。

本地或 main push 不联网,显示 SKIP。需要手动复核时运行:

node scripts/check-pr-attribution.mjs --pr 49 --against 41 --repo MYCF711/dsh-session-superagent

数据来源

说法 来源
版本 0.10.8 package.json、npm
项目起点 deepseek-ai/dsh-superagent-prototype
DSH 原生 UI deepseek-ai/deepseek-harness、$DSH_HOME/DSH-UI-official.md、docs/ui-decomp/
图标 DSH-X/docs/icon-app.png(MIT)

许可

MIT,见 LICENSE。

About

DSH 会话级 superagent:盯一个 GitHub 仓库,有变化就唤醒会话。凭证不进模型,返回统一脱敏。

Topics

Resources

Contributing

Security policy

Stars

49 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages