前言¶
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-smooth 的 proxy.enabled 和 port:
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.enabled 和 port,然后重启 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