Preface¶
The DSH plugin ecosystem emphasizes pluggable extension: many capabilities can be added via client plugins without modifying the DSH core itself. For developers who need to view and advance tasks on mobile devices, DSH’s default web experience is more desktop-oriented: inputs, sidebars, buttons, and long session loading are not necessarily mobile-friendly.
dsh-meow-smooth is a DSH frontend experience enhancement plugin, positioned as “zero changes to the DSH core, purely client-side self-contained.” It is maintained by Phant0Meow and licensed under MIT.
Plugin Positioning¶
In One Sentence¶
dsh-meow-smooth is a DSH client plugin designed to enhance mobile UI interactions, providing in-page reminder cards, system notifications, webhook notifications, and an optional compression proxy for mobile access.
Problems It Solves¶
The main scenarios it addresses are listed below:
- Mobile DSH page inputs, sidebars, buttons, and top bar are not well-adapted.
- Mobile typing often leads to accidental touches, unintended submissions, or cramped layouts when the keyboard pops up.
- During multi-session runs, timely notifications for completion, permissions, questions, or failures are needed.
- Mobile access to DSH requires response acceleration.
Core Features¶
Mobile UI Interactions¶
dsh-meow-smooth provides the following mobile UI capabilities:
- Auto-collapse input field on blur.
- Enter key for line breaks on mobile.
- Top bar automatically makes way while typing.
- Sidebar auto-collapses on narrow screens.
- Edge gesture drawer.
- Buttons show icons only.
- Top bar supports horizontal scrolling.
- Answer information lines support horizontal scrolling.
- Prevent accidental zooming.
- Fix table touch scrolling.
- Disable rubber-band bounce effect.
- Settings page mobile adaptation.
These features collectively aim to make DSH closer to a daily-usable interface on mobile devices.
Reminders and Notifications¶
dsh-meow-smooth’s reminders include:
- In-page reminder cards
- System notifications with support for Web Push / webhooks
- Multi-session concurrent run reminders
- Run failure reminders
Usage can be divided into two layers. In-page reminder cards prompt within the DSH page for states that need attention; system notifications alert outside the page. In multi-session scenarios, you can receive reminders for a session even when you’re not currently viewing it.
System notifications require the following conditions:
- HTTPS entry point
- VAPID keys
- iOS 16.4+ and PWA opened from the home screen to complete authorization
VAPID keys are auto-generated on first startup and persisted at:
$DSH_HOME/.meow-smooth/
For webhook fallback, you can configure webhookUrl, such as a Bark webhook address.
Notes:
- System notifications will not pop up when the DSH page on a computer is focused.
- On iOS 18.x, PWA notification permission pop-ups may occasionally not appear, and APNs may occasionally fail to deliver; Bark can serve as a stable fallback.
- For multiple instances, each DSH instance configures notifications separately.
Mobile Access Acceleration¶
Mobile access acceleration is an optional compression proxy, disabled by default. Its purpose is to improve the response experience when accessing DSH from mobile devices.
When enabled, configure proxy.enabled and port for meow-smooth in the profile’s cordis.patch.yml:
proxy:
enabled: true
port: <proxy port>
After configuration, restart DSH to apply. In multi-instance scenarios, each DSH instance needs its own notification and proxy port settings.
Installation and Enabling¶
Prerequisites¶
Before installation, ensure the environment meets:
- DSH 0.x
- Node.js ≥ 22
Licensed under MIT. It has zero dependencies on the DSH core and does not require installing any @deepseek-ai/* packages.
Install the npm Package¶
If you have the tgz from npm pack, run the following in the target DSH profile:
npm install <tgz>
Assembly¶
After installation, you need to load the plugin into DSH—choose one of two methods:
-
Add the insert entry from
cordis.patch.ymlto the target profile’scordis.patch.yml. -
Add this package to the profile’s
bundleslist.
Restart DSH after completion to apply.
Typical Configuration¶
Webhook Notifications¶
For webhook fallback, you can configure webhookUrl:
webhookUrl: <webhook address such as Bark>
After configuration, relevant reminder events will be sent to this webhook address.
System Notifications¶
System notifications require an HTTPS entry point, VAPID keys, and PWA notification authorization. For iOS, the PWA must be opened from the home screen to complete authorization, with a version requirement of 16.4+.
Compression Proxy¶
The compression proxy is disabled by default and will not start unless proxy.enabled is configured. When enabled, configure proxy.enabled and port in cordis.patch.yml, then restart DSH.
Applicable Scenarios and Notes¶
Suitable for the following users:
- Frequently check DSH task status on mobile devices.
- Need to receive reminders for task completion, permission requests, questions, and run failures.
- Run multiple sessions concurrently and want to reduce the cost of switching back to the page to check.
- Run multiple DSH instances separately and need to configure notifications and proxy ports for each.
Before use, note:
- dsh-meow-smooth will load as a DSH plugin and run with the permissions of the current DSH process.
- It is recommended to check the source code, dependencies, and license before installation.
- System notifications rely on HTTPS, VAPID keys, and browser notification authorization.
- Mobile access acceleration is disabled by default and will not automatically change existing access methods.
Links¶
- GitHub:
https://github.com/Phant0Meow/dsh-meow-smooth - Community directory clue (independent community site, not an official app store):
https://www.skillhub.cn/plugins/Phant0Meow/dsh-meow-smooth