dsh-meow-smooth:面向手机端的 DSH 前端体验插件

前言

DSH 的插件生态强调可插拔扩展:不少能力可以通过客户端插件加入,而不改 dsh 本体。对于需要在手机上查看和推进任务的开发者来说,dsh 的网页端默认体验更接近桌面:输入、侧边栏、按钮和长会话加载都不一定适合手机。

dsh-meow-smooth 是 DSH 前端体验增强插件,定位是「零 dsh 本体改动,纯客户端自包含」。它由 Phant0Meow 维护,许可证为 MIT。

插件定位

一句话

dsh-meow-smooth 是 DSH 客户端插件,用于增强手机端 UI 交互,并提供页面内提醒卡片、系统通知、webhook 通知,以及可选的手机访问压缩代理。

解决什么问题

下面介绍它覆盖的主要场景:

  • 手机端 dsh 页面的输入、侧边栏、按钮、顶部栏不适配
  • 手机上输入时容易误触、误发,或键盘弹出时布局拥挤
  • 多会话运行时需要及时知道完成、权限、提问或失败
  • 手机访问 dsh 时需要响应加速

核心功能

手机端 UI 交互

dsh-meow-smooth 提供以下手机端 UI 能力:

1、输入框失焦自动折叠。

2、手机上回车键用于换行。

3、打字时顶部栏自动让位。

4、窄屏下侧边栏自动收起。

5、边缘手势抽屉。

6、按钮只留图标。

7、顶部栏可以横滑。

8、回答信息行可以横滑。

9、禁止意外缩放。

10、表格触摸滚动修复。

11、禁用橡皮筋回弹。

12、设置页手机适配。

这些功能共同目标是让 dsh 在手机端更接近可日常操作的界面。

提醒与通知

dsh-meow-smooth 的提醒包括:

  • 页面内提醒卡片
  • 系统通知,支持 Web Push / webhook
  • 多会话同时跑提醒
  • 运行失败提醒

使用上可以分为两层。页面内提醒卡片用于在 dsh 页面中提示需要处理的状态;系统通知用于在页面之外提醒。多会话场景下,即使当前不在某个会话里,也能收到该会话的提醒。

系统通知需要以下条件:

  • HTTPS 入口
  • VAPID keys
  • iOS 需 16.4+,并从主屏幕打开 PWA 完成授权

VAPID keys 首次启动自动生成,持久化路径为:

$DSH_HOME/.meow-smooth/

webhook 兜底可配置 webhookUrl,例如 Bark 等 webhook 地址。

需要注意:

  • 电脑端 dsh 页面正聚焦时不弹系统通知
  • iOS 18.x 上 PWA 通知权限弹窗偶尔不出现,APNs 偶尔投递不到;Bark 可作稳定兜底
  • 多实例时,每个 dsh 实例各自配置通知

手机访问加速

手机访问加速是可选压缩代理,默认关闭。它的用途是改善手机访问 dsh 时的响应体验。

启用时,在 profile 的 cordis.patch.yml 中配置 meow-smoothproxy.enabledport

proxy:
  enabled: true
  port: <代理端口>

配置后重启 dsh 生效。多实例场景下,每个 dsh 实例需要各自配置通知和代理端口。

安装与启用

前置要求

安装前确认环境满足:

  • dsh 0.x
  • Node.js ≥ 22

许可证为 MIT。构建零 dsh 本体依赖,不需要安装任何 @deepseek-ai/* 包。

安装 npm 包

如果已有 npm pack 产出的 tgz,可在目标 dsh profile 中执行:

npm install <tgz>

装配

安装后需要让 dsh 加载插件,二选一:

1、把 cordis.patch.yml 的 insert 条目加进目标 profile 的 cordis.patch.yml

2、把本包加入 profile 的 bundles 列表。

完成后重启 dsh 生效。

典型配置

webhook 通知

如果需要 webhook 兜底,可配置 webhookUrl

webhookUrl: <Bark 等 webhook 地址>

配置后,相关提醒事件会发送到该 webhook 地址。

系统通知

系统通知需要 HTTPS 入口、VAPID keys,以及 PWA 通知授权。iOS 需要从主屏幕打开 PWA 完成授权,版本要求为 16.4+。

压缩代理

压缩代理默认关闭,不配置 proxy.enabled 就不启动。启用时在 cordis.patch.yml 中配置 proxy.enabledport,然后重启 dsh。

适用场景与注意

适合以下使用者:

  • 经常在手机上查看 dsh 任务状态
  • 需要接收任务完成、权限请求、提问和运行失败提醒
  • 多会话并行运行,希望减少切回页面查看的成本
  • 多个 dsh 实例分别运行,需要各自配置通知和代理端口

使用前注意:

  • dsh-meow-smooth 会作为 DSH 插件加载,并以当前 dsh 进程权限运行
  • 安装前建议检查源码、依赖和许可证
  • 系统通知依赖 HTTPS、VAPID keys 和浏览器通知授权
  • 手机访问加速默认关闭,不会自动改变现有访问方式

链接

  • GitHub:https://github.com/Phant0Meow/dsh-meow-smooth
  • 社区目录线索(独立社区站点,非官方应用商店):https://www.skillhub.cn/plugins/Phant0Meow/dsh-meow-smooth
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜