前言¶

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