DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

thiscp /

thiscp/dsh-push

Topic repository only

This plugin has no description yet.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@5f4e5de2

dsh-push

DSH(DeepSeek Harness)跑长任务,人走了怎么办?—— 一台没有 Google 推送的国产手机,也能收到任务完成通知、在通知栏直接回答 DSH 的提问。

A self-hosted push bridge between DeepSeek Harness (DSH) and Android: task-complete notifications, native quick-answers from the notification shade, and a themed in-app browser for DSH Web — no Google Play Services required.

🤖 这个仓库是写给 AI 看的

本项目按 "AI agent 能自己读完并部署" 的标准组织文档:把仓库丢给你的 AI 助手(DSH / Claude Code / Codex 等),说一句"帮我把这套推送部署起来",它应该能自己读文档完成全部工作——起 ntfy 服务器、装 APP、装 DSH 插件(host-plugin/)、跑验收流水线。为此仓库里备齐了:

  • deploy/README.md:每个服务端脚本的部署位置、凭据文件、下发命令(命令级,可直接执行)
  • verify/README.md:AI 作业手册——一键验收流水线 + 几十条"踩过坑换来的硬事实"(PowerShell 5.1 陷阱、Android 16 行为、模拟器生命周期……),就是给 agent 的避坑清单
  • openspec/:规格驱动开发全记录(基线规格 + 每个变更的提案/设计/任务),AI 改功能前先读这里
  • verify/config.example.ps1:所有环境相关值的模板,部署方只需填这一个文件

人类照做当然也行——只是文档的颗粒度是按"执行者没有常识、只会照做和验证"来写的。😉

截图

主界面 · 日间晴海 主界面 · 深夜深海 浏览器 · 星空玻璃 浏览器 · 深夜玻璃
日间 深夜 星空 深夜浏览器

六套主题(日间/深夜/樱花/抹茶/星空/焦糖),每套独立场景壁纸 + 全身立绘;应用内浏览器把 DSH Web 整个玻璃化,壁纸从界面后透出。

它解决什么问题

  • DSH Web 跑长任务,人离开电脑后只能反复刷新网页;任务中途 ask_user_question 提问会阻塞等待。
  • 目标手机是 iQOO 13(Android 16,无 GMS,vivo 后台管控严)——FCM 系推送全部不可用,通用推送 App 也做不到"通知栏原生渲染问题 + 一键作答、任务当场继续"。

架构

DSH 宿主进程
  └─ 插件 dsh-push-host(host-plugin/,进程内;不需要 hooks.json,也不需要外部作答桥)
       ├─ 推送:user-questions/request(+ tools/pre-execute 竞位兜底)、agent/turn-stopping
       ├─ 回收:每 3s 轮询 relay 队列 → 手机答案折回会话(claimForeground 默认开,手机与网页 UI 赛跑)
       └─ 配对:面板一键开通(POST /enroll 免密钥)→ 出二维码 → App 扫码即配
                    │ POST(写令牌)
                    ▼
     ntfy 中继(自建 TLS:ntfy 推送 + provd 发号 + answer relay 队列)
                    │ WebSocket 长连接
                    ▼
     安卓 APP(前台服务 + 开机自启 + 断线重连,可同时挂多台 DSH)
     ├─ 通知渲染(正文/问题/进度)、点通知直达来源会话
     ├─ 通知栏一键作答 → 公网作答页 → relay 队列 → 插件折回会话 → 任务继续
     └─ 「打开 DSH」内置浏览器(主题壁纸 + 全界面玻璃化)
  • 推送通道:ntfy 自建实例(deploy/aliyun/edge-http.conf 是边缘 nginx 反代配置;发号服务是 relay/dsh-provd.py)
  • 作答回桥:relay 的 /answer/pending + /answer/ack 队列(服务端 deploy/aliyun/answer-relay.py),由插件自己轮询回收,DSH 侧不再有独立进程
  • 历史链路(已退役,别再配):hooks.json 的 Stop/PreToolUse → deploy/{work|windows}/dsh-ntfy-push,作答走 deploy/work/dsh-answer-bridge.mjs。旧 hook 必须保持退役(现在是 {"hooks":{}}),否则双推
  • 全部凭据走外部文件,不入库(见 deploy/README.md)

APP 功能一览(v1.34.12)

  • 推送接收:前台服务 + BOOT_COMPLETED 自启(Android 16 适配)+ WS 断线自动重连
  • 通知即答:问题在通知栏原生渲染(单选/多选/自填),提交后 DSH 任务当场继续;应用内快答浮窗 + ComfyUI 生成的六套立绘成功动画(透明背景 webp)
  • 内置浏览器:打开 DSH Web;主题壁纸 + 立绘 + 全界面毛玻璃(注入式,不改 DSH 本体);文件上传/APK 下载直装
  • 手机屏利用:原生顶栏瘦身 + 下滑收起/上滑唤回(Quick Return,带无内容页看门狗自动复位);网页侧栏收起为可拖动悬浮鲸鱼钮(边缘吸附、半隐入边框、位置持久化)
  • 六套小清新主题:矢量场景 + 立绘构图(52% 屏高、跨分辨率一致)、按钮半透明、深色主题网页自动暗化
  • 杂项:崩溃自报告、未读角标、已读回执、密度/DPI 切换自适应;凭证管理(点头像开/关凭证卡片,长按开卡片替换、不会误触清空,清空需卡片内按钮 + 确认框)
  • 多设备订阅(v1.34.0 起):一台手机同时挂多台 DSH,每台一条 WS 长连接;设备清单收进头像弹窗(v1.34.2),已吊销的不显示,可单独吊销、重扫恢复
  • 扫码配对:插件面板出二维码 → App「扫码配对」(相机扫或从相册选图)即配;载荷 dshpush://v1?base=&topic=&token=&web=&name=
  • 机器名跟随:#name 热改名(v1.34.9);改名后重扫不再出现重复设备行(v1.34.10:upsert() 按 id → 名字 → web 的 host:port 归并);网页顶栏标签取设备清单里的名字(v1.34.11 Devices.nameForWeb()),入口也从「DSH 入口」胶囊改成点状态卡(v1.34.11)
  • 链接自动续期:吃插件的 #syslink / #sysmove(v1.34.8),网页 token 变了或 topic 漂移都不用重扫
  • 适配 DSH 0.2.2 侧栏改版(v1.34.12):不再用 transform:none 覆盖宿主的收起位移——收起侧边栏后「工作区」那一行不再浮在正文上;改用后代选择器隐藏被自绘图标顶替的原生 svg,窄屏抽屉里「插件市场」「专家」不再各显示两个图标;鲸鱼浮钮改按几何判定展开/收起

插件功能一览(dsh-push-host 0.7.38)

  • 三个触发点全在插件进程内:提问推送(user-questions/request + tools/pre-execute 竞位兜底)、轮次结束推送(agent/turn-stopping)、作答回声(#ans)——外部 hook 与外部作答桥都已退役
  • 推送与作答解耦(0.7.19/0.7.20):没配 hostToken 也照样收通知;claimForeground 默认开(0.7.24),手机答案与网页 UI 赛跑、谁先到谁生效,mode: legacy 的问题也能被手机答
  • 一键开通免 provisionToken(0.7.0–0.7.2):POST /enroll 按 IP 限流 2/h、6/d,边缘 nginx 走 PROXY protocol 透传真 IP;缺 hostToken 时经 regToken 自愈补发(0.7.21)
  • 通行证按 topic 隔离(0.7.36):GET /list?topic=、POST /revoke {name, topic},每台机器只看到自己签的通行证;机器名可填,且由插件 persistName() 用 ctx.configEditor.edit() 落盘(0.7.38)
  • 链接自动续期(0.7.30–0.7.34):每次上线推一条静默 #syslink 刷新设备网页链接,两条换 topic 的路径都发 #sysmove,手机不用重扫
  • 远程访问:cloudflared 公网隧道(0.4.0/0.5.0)+ 上游内容指纹判活(0.7.17,不再只看状态码)+ 隧道失败回写设置行(0.7.11)
  • 不再重复推送:两个入口(pq-<uuid> / call_…:ptc:1)10s 内按内容去重(0.7.21);设置面板多一行「作答通道」自证当前能不能手机作答
  • 点推送直达来源会话(0.2.2,#session-<uuid> hash)、插件页展示 App 下载二维码

构建

cd android-app
./gradlew assembleDebug        # JDK 17 + Android SDK 34(AGP 自动下载依赖)
# 产物 app/build/outputs/apk/debug/app-debug.apk(debug 签名,自用即可)

APP 上手两条路:推荐——插件装好后在「设置 → 通用」点一键开通,面板出二维码,App「扫码配对」即配(相机扫或相册选图);手工——安装 → 填 ntfy 服务器地址 + 读令牌 + topic → 订阅(老路径仍支持:一串 tk_… 通行证会退回内置中继 + topic dsh)。

仓库结构

目录 内容
android-app/ 安卓 APP 源码(Kotlin,无第三方 UI 库,全手写 View,约 14 个 .kt)+ 素材源文件与授权
deploy/ 服务端脚本权威副本:ntfy 推送钩子、作答 relay/桥、边缘 nginx(见其 README)
host-plugin/ DSH 宿主插件(进程内,npm dsh-push-host):提问/结束推送 + relay 队列回收手机作答 + 通行证发号与一键开通 + 扫码配对 + 公网隧道,替代"外部通知器 + 外部作答桥"(见其 README)
verify/ 一键验收流水线(编译→装机→推送断言→截图)+ AI 作业手册 verify/README.md;本机配置放 verify/config.local.ps1(模板见 config.example.ps1)
openspec/ 规格驱动开发记录:基线规格 + 全部已归档变更提案
docs/ 截图与开发日志

AI 开发工作流硬事实(踩过的坑,别再踩)

  1. openspec 归档:MODIFIED 块会整块替换基线里的同名需求,所以必须把该需求在基线里的 全部既有场景原样带上(改标题也算删除)。自检:基线里该需求的每个 #### Scenario: 标题 都要在 delta 里出现,否则 openspec archive 直接拒绝并点名漏了哪个。
  2. 发布一条命令:verify/dsh-app-verify.ps1 -Deploy -DeployNote "更新说明" —— 自动构建、 装机验收、上架 aliyun 下载链接、并推更新通知(带 App 内下载按钮 + 点通知直达下载)。 只想静默上架加 -NoNotify。版本号只有一处真值:android-app/app/build.gradle.kts 的 versionCode + versionName 两个字段一起 bump。App 内显示的版本自 v1.32.17 起运行时从 PackageInfo.versionName 派生(PushService.APP_VER 那个编译期常量已删——它曾让状态卡片 显示旧版本号),所以不存在「第三处要同步」,也不会再对不上。
  3. ntfy 推送格式:要带 title/优先级/click 的 JSON body 必须 POST 到根路径 https://ntfy.cpyh.xyz 并把 topic 写进 body;POST 到 /dsh 会把整坨 JSON 当正文存 (阿里云边缘 nginx 的解析差异,实测)。纯文本 + X-Title/X-Priority 头则照常走 /dsh。
  4. Windows 脚本编码:verify/*.ps1 刻意保持纯 ASCII(PowerShell 5.1 会把无 BOM 的 UTF-8 当 ANSI 读,中文变乱码进而炸引号);确需中文的脚本必须带 UTF-8 BOM。
  5. 双胞胎主机:验收机(跑 DSH 与流水线)与模拟器宿主是两台同名同用户的 Windows (台式机 vs 笔记本)。verify/config.local.ps1 里的 $EmuIp 指向模拟器宿主;ssh 现场取证 时先单独 echo %COMPUTERNAME% 确认是哪台。
  6. 外部 exe 写不进工作区:这台 Windows 上 python/ffmpeg 等外部进程被 AppContainer 限制, 对 F: 工作区只读(NTFS ACL 本身没问题,icacls 查不出来);产物一律写到 %LOCALAPPDATA%\Temp 再由 PowerShell Copy-Item 拷进仓库。素材生成走 tools/gen_pose_anim.py --out <Temp> 就是这个原因。
  7. 成功页动画取证姿势:模拟器上 screenrecord 只出 1 帧(废)、exec-out screencap 单次 ~1.5-2s——2.6s 的动画窗口根本抢不到。用 QA 钩子 am start -n xyz.cpyh.dshpush/.SuccessPoseActivity --ei holdMs 9000 延长停留后连拍三张,再 diff 立绘区(发梢/裙摆动、头不动 = 动画在播)。
  8. 手机作答(host-plugin/)与 tool-ask-user 的 timed 模式:ctx.userQuestions.answer() 只认投影里 state=continued 的问题,只有 wait.timed === true(mode: timed)的问题才会 被 fold。但默认配置下 legacy 也能被手机答:0.2.1 起设置页有「手机作答模式」开关(只升不降), 0.7.24 起 claimForeground 默认 true(插件持有前台),0.7.25 起判据是 phoneAnswerable = timed !== false || holdsForeground()。别再看 profile 的默认 mode 下结论。 另两条实测坑(宿主 fetch 会把同一 URL 的响应喂回第一次的、投影 state 是 {questions:{active,settled}} 嵌套结构)写在 host-plugin/README.md,改轮询代码前先读。
  9. 浏览器注入段(WebActivity.kt 的 evaluateJavascript 长串)三条铁律: ① 新增代码必须合并成 ≤2 个长字符串字面量——那条 "…"+"…" 拼接链已两次把 Kotlin 编译器 栈炸穿(psi2ir generateBinaryExpression 无限递归、Internal compiler error),拆分操作数=加链深=炸。 ② 改完必跑语法闸:node verify/extract-injected-js.mjs > 临时.js && node --check 临时.js。 ③ 滚动驱动的原生 UI(顶栏收起/悬浮钮)必须用真 touch 事件验收——程序化 scrollTop 步进复现不出「布局回声」(栏切换改 WebView 高度,聊天页钉底补偿产生 ~490ms 的孤立单跳自振, 用户看到的是果冻)。回归模板:verify/jelly-test.mjs、verify/qr-bar-test.mjs、 verify/newchat-test.mjs、verify/fab-drag-test.mjs(CDP 连 WebView,adb 路径见 config.local.ps1)。

素材授权

代码为 MIT(见 LICENSE)。角色立绘为第三方二创,CC BY-NC-SA 4.0(非商用),署名表见 android-app/assets-src/galgame/NOTICE.md;商用请替换立绘素材。

免责声明

本项目是个人自研工具,非 DeepSeek 官方产品;按"现状"开源,无维护承诺。

—/ 5

No ratings yet

Manifest verification required

Commit 5f4e5de240c0

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout