hikarioyama/Smart-DSH

Name: hikarioyama/Smart-DSH
Author: hikarioyama

Desktop桌面端 ⭐ 32 Clients & Launchers客户端与启动器 Notifications & Remote通知与远程

Unofficial DeepSeek Harness plugin: mobile-friendly UI, Web Push notifications, and Linux Tailscale setup guide

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

Smart-DSH is an unofficial plugin bundle and Linux setup guide for DeepSeek Harness, deliberately not a fork of upstream DSH. It ships two cordis-style bundles that follow the dsh.bundle.patch plus dsh.client three-layer pattern: dsh-notify-push prepends a user-questions/request waterfall listener and a root-session-only session/event listener, then fans events out to phones via Web Push using FCM or Mozilla autopush, while dsh-esc-stop adds a single ON/OFF toggle under Settings → General that binds Escape to the composer's existing stop button. Installation uses the upstream dsh plugin command (a thin pnpm forwarder) and requires keeping the original DSH 0.1.2-rc.1 installation untouched, with no file editing or restart needed to toggle the Esc gesture.

The intended workflow is to expose a DSH server over Tailscale Serve HTTPS to a phone, run /notify in the chat composer to grant Notification permission and create a Push subscription, then receive persistent notifications with reason-keyed titles (作業完了, token-cap, blocked, error, aborted) whenever the agent calls ask_user_question or finishes a top-level turn, even when no browser tab is connected. It targets developers and operators who leave DSH running on a desktop and want phone-side questions answered or running turns cancelled; subagent turns never notify, and tapping a notification focuses the app rather than opening a new window.

Dependencies include DSH 0.1.2-rc.1 with webServer.register, connection.requestRejection, and the { prepend: true } listener option present, Node ≥22.19 excluding 23, pnpm, and any Chromium-based or Firefox browser exposing PushManager — verified on Android Chrome and desktop Firefox, with iOS WebKit requiring an Add-to-Home-Screen PWA on 16.4+. State lives in $DSH_HOME/notify-push/ at 0600 mode and is intentionally not committed, with vapid.json surviving restarts and subscriptions.json auto-pruned on 404/410; mobile CSS selectors are version-specific, the default VAPID subject is the placeholder mailto:root@localhost, and regression checks run via Playwright against a live DSH page using a private login URL file that must never be committed. This bundle is community-maintained and not affiliated with DeepSeek.

Smart-DSH 是一个面向 DeepSeek Harness 的非官方插件包与 Linux 配置指南，并非 DSH 的分支。它由两个 cordis 风格的 bundle 组成：dsh-notify-push 通过 host: ctx.on 预置监听器，将 ask_user_question 与顶层会话 turn-end 事件以 Web Push 投递到手机；dsh-esc-stop 在设置面板提供一键开关，按 Esc 即可取消当前运行中的轮次。安装方式沿用 DSH 自带的 dsh plugin（底层为 pnpm 前向器），并需要保留原版 DSH 0.1.2-rc.1。

典型流程是：在远程手机上通过 Tailscale Serve HTTPS 访问 DSH，启用 /notify 命令授予通知与 Push 订阅权限；当代理在浏览器外提问或顶层会话结束时，手机会收到带标题原因（完成、token 上限、被拦截、错误、中止）的持久通知，点击即可聚焦到会话。该项目面向需要在桌面上长时间运行 DSH、又希望在手机上即时处理问题或中断轮次的开发者与运维人员；本地仅验证了 Arch Linux 与 Android Chrome、桌面 Firefox。

依赖方面要求 Node ≥22.19（不含 23）、pnpm 以及任意支持 PushManager 的 Chromium 或 Firefox 浏览器，iOS 需 16.4+ 的已添加到主屏幕 PWA；状态目录为 $DSH_HOME/notify-push/（默认 ~/.dsh，权限 0600），其中 vapid.json 跨重启必须保留；移动端 CSS 选择子针对 0.1.2-rc.1 版本，DSH 升级后需复核，VAPID subject 默认为 mailto:root@localhost 占位符，建议替换为真实联系方式。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：Smart-DSH（hikarioyama/Smart-DSH）
仓库：https://github.com/hikarioyama/Smart-DSH
本站详情页：https://www.yhbd.top/plugins/hikarioyama-smart-dsh/
本站登记：类型 client · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 32 · 最近提交 2026-09-29 · 主语言 JavaScript · 未检测到 DSH 插件清单

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意

No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」，商用或再分发前先问作者
32 stars - an early-stage project星标 32，属于早期项目
No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单：可能只是打了 dsh-plugin 话题，安装方式要现场确认

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:hikarioyama/Smart-DSH

把 hikarioyama/Smart-DSH 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

21.9 KB · 缓存于 2026-09-29 22:09:25 · 21.9 KB

Smart-DSH — Mobile UI, notifications, and Esc-to-stop for DeepSeek Harness

An unofficial DSH plugin bundle and Linux setup guide, not a fork of DSH. Keep upstream DSH installed; add Smart-DSH for:

Mobile UI: full-width chat and composer, logo opens the session list, no logo tooltip or tap tint.
Notifications: questions and top-level turn-end notifications through Web Push.
Esc to stop: press Escape to cancel the running turn, switchable from Settings → General.
Remote access guide: connect a phone using tailnet-only Tailscale Serve HTTPS.
Subagent task delegation: roles with one exclusive verb each (worker / explorer / hacker / reviewer), a sibling hub with durable logs, and a subagent conversation tab.
OpenCode Go model catalog: keep the llm-pi-ai OpenCode Go route current with every model the subscription actually serves (scripts + guide).
Multi-tab reliability: an optional, guarded shared-HMR workaround prevents upstream developer-update connections from exhausting Firefox's HTTP/1.1 connection slots.

This is an unofficial community extension; it is not affiliated with DeepSeek. Compatibility is tested against DSH 0.1.2-rc.1; mobile styles use version-specific selectors. Turn-end notifications describe agent turn termination, not independent verification that every requested task succeeded.

A self-contained DeepSeek Harness (DSH) bundle (dsh-notify-push) plus setup notes for the paired remote-access infrastructure (Tailscale Serve + phone). When the agent calls ask_user_question, your phone receives a Web Push notification with the question text — even when no browser is connected. When a turn ends, you get a completion notification whose title reflects the end reason (作業完了 / token-cap truncation / blocked / error / aborted); subagent turns do not notify — only top-level sessions. Tapping a notification focuses the app.

A second, dependency-free bundle (dsh-esc-stop) adds the keyboard gesture the composer's stop button already performs: Escape cancels the turn that is running now. Menus, dialogs, the queue-message editor, and IME composition keep their own Escape, and the whole gesture has one ON/OFF row in Settings → General — no file editing and no restart to toggle it. See Esc-to-stop.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 hikarioyama/Smart-DSH 的 README.md。在 GitHub 查看原文 →