前言¶

在 DSH Desktop 里長時間跑對話、審批和工具調用時，側邊欄和主輸入區往往要來回切換；待辦、提醒和實時輸出若散落在不同位置，很難一邊看流式回覆一邊記下「下一條要發的指令」。把常用能力收進一塊可展開的面板，並在需要時拉到桌面置頂，是不少開發者會自己疊腳本或外置記事本想做的事。

下面介紹社區客戶端插件 Quick Panel（倉庫 cinewave0/cinewave0-dsh-quick-panel，維護者 cinewave0，當前正式版 1.0.4）。它在 DSH 窗口內提供浮島與下拉麪板塊，並附帶可在 Windows 桌面常駐的 Electron 伴生窗；分發走 GitHub Releases 與 Discover 索引，npm 發佈暫緩。

這是什麼¶

Quick Panel 是 DSH Desktop 的客戶端插件：依賴 Host 半區的 webServer 與 sessionController，在 DSH 內注入側邊欄入口，並在用戶選擇時啓動獨立小應用。

一句話能力範圍（與倉庫簡介一致）：待辦、提醒、實時消息、問題卡與快速輸入。DSH 內爲「側邊欄 → 頂部浮島 → 下拖面板」；獨立應用默認爲頂部浮島（360×48，置頂、不佔任務欄），展開爲 440 像素寬麪板，托盤常駐，關閉面板僅收起到浮島。

環境約束需先看清：僅支持 Windows（獨立窗依賴 Electron 與 Windows 窗口 API）；DSH 引擎要求爲 >=0.2.2-rc.1 <0.3.0（見 package.json）。插件以當前 DSH 進程權限運行，安裝前建議在 GitHub 覈對源碼與 MIT 許可證。

核心功能¶

DSH 窗口內¶

1. 側邊欄底部按鈕打開浮島；浮島展示最新一句、時間與運行呼吸燈。
2. 點擊浮島展開面板：待辦、提醒、實時消息、底部快速輸入。
3. 待辦左側勾選會把條目填入 DSH 輸入框（不自動發送）；在獨立窗中按 ↵ 同樣填入輸入框。待辦與提醒按當前顯示順序標 1. 2. 序號。
4. 提醒支持翻頁時鐘、重複與提示音。
5. 實時消息區分用戶 / 助手 / 推理 / 代碼 / 工具 / 錯誤，支持流式光標與上滾加載更早記錄；用戶消息中的圖片以縮略圖顯示（Host 按當前對話附件引用讀取，不在實時消息裏傳 base64）。
6. DSH 的選項式問題卡可鏡像到獨立窗，選擇或填寫後可直接提交。
7. 通知中心在時鐘下方常駐：記錄審批請求、輪次結束、提醒到點；未讀角標，最近 20 條，審批項可跳回審批卡。

獨立小應用（Electron 伴生窗）¶

1. 在 DSH 面板底部點「打開獨立面板」啓動；首次會觸發 Electron 運行時安裝（見下一節）。
2. 點浮島文字或 ⌃ 展開；拖動浮島左側 ⠿ 移動；面板 X 收起到浮島；托盤可打開 / 收起 / 退出。
3. 拖入圖片或文件到窗口（輸入框上方出現附件條），上傳完成後隨下一條發送；單條最多 20 個附件。
4. 面板寬 440，高度默認 720、可拖上下邊緣；用戶消息縮略圖可點擊查看原圖。
5. DSH 頁面隱藏時，權限請求由獨立窗接管；勾選「審批鎖定在外部面板」後，即使 DSH 可見也由獨立窗處理審批。
6. 「實時消息」與「在線」之間的 1–5 數字對應最近 5 個會話，點擊後在 DSH 內切換（輪詢間隔約 2.5 秒）。
7. 時鐘旁可顯示餘額（需登錄 DeepSeek 賬號）、本次 token 與輸出速度、近 30 日本機會話投影總量（非平臺賬單）。

共享數據落在 %USERPROFILE%\.dsh\quick-panel\：state.json（待辦、提醒、設置、當前會話 id）、window.json（窗口位置）、helper.log（啓動診斷）。

環境與 Electron 運行時¶

獨立窗由 Host 拉起外部 Electron 進程，目標版本 43.x。首次點「打開獨立面板」時，Host 會自動下載、校驗並安裝 Electron 43.3.0（約 140 MB，win32 x64 / arm64）到 %USERPROFILE%\.dsh\electron，無需 dsh-pet，也無需手工解壓。默認先走 npmmirror CDN，失敗回退 GitHub Releases。

可按需設置環境變量（重啓 DSH 後生效，路徑類變量以 README 爲準）：

DSH_QUICK_PANEL_ELECTRON_MIRROR=https://your.mirror/electron
DSH_QUICK_PANEL_ELECTRON=<已有 electron.exe 路徑>
DSH_QUICK_PANEL_NO_RUNTIME_DOWNLOAD=1

離線或企業環境可設 DSH_QUICK_PANEL_NO_RUNTIME_DOWNLOAD=1，再手動解壓到 %USERPROFILE%\.dsh\electron；默認可執行文件路徑爲 %USERPROFILE%\.dsh\electron\electron.exe。

安裝與啓用¶

安裝或更新後必須完全退出 DSH 再打開（托盤 → 退出，或結束進程）。只關窗口或刷新頁面不會加載 Host 半區；首次安裝時若見「Host 未連接」，先完全重啓 DSH。Electron 在第一次打開獨立面板時纔會安裝。

方式一：DSH 插件市場（Discover）¶

插件 → 發現 → 添加索引源：

https://cinewave0.github.io/cinewave0-dsh-quick-panel/market/index.json

搜索 Quick Panel 安裝 1.0.4（索引固定到對應 Git commit）。上一穩定版 v1.0.3 仍可從 Releases 安裝。

方式二：Release 包¶

從 Releases 下載 dsh-quick-panel-1.0.4.tgz，用 SHA256SUMS 校驗後執行：

dsh plugin --profile desktop add <下載目錄>\dsh-quick-panel-1.0.4.tgz

方式三：固定 Git commit¶

dsh plugin --profile desktop add "git+https://github.com/cinewave0/cinewave0-dsh-quick-panel.git#fff04bbe3f9938cacade83f497d970b9bde9d19d"

安裝後若改動了 client.js 或 panel/ 資源，刷新 DSH 或重開獨立窗即可；改 index.js（Host）需重啓 DSH；改 runtime/electron-helper/ 需在托盤退出獨立窗後重開。

典型用法¶

在 DSH 內快速記待辦並回填輸入框

1. 點側邊欄快捷面板，打開浮島後下拖面板。
2. 在快速輸入或待辦區維護條目；需要發送前，勾選待辦左側，內容進入主輸入框，自行確認後發送。

桌面置頂跟進長對話

1. 在面板底部點「打開獨立面板」，等待首次 Electron 下載完成（界面會顯示進度）。
2. 浮島置頂放着最新一句；展開後看實時消息流，上滾加載更早記錄。
3. 離開 DSH 對話頁超過約 5 秒後，獨立窗改用 Host 鏡像；流式 partial 仍依賴 DSH 對話頁在前臺渲染。

拖附件發送

在獨立窗把圖片或文件拖到窗口，待底部附件條就緒後，在輸入框寫下一句說明併發送（最多 20 個附件）。

適用場景與注意¶

適合誰：主要在 Windows 上用 DSH Desktop 做長會話、多輪審批或需要桌面浮島看實時輸出的開發者。

務必注意的限制（摘自 README「已知限制」）

• 僅 Windows；首次獨立面板需要網絡下載約 140 MB Electron（除非手動部署並關閉自動下載）。
• 獨立窗會話切換由 DSH 頁面內客戶端輪詢完成；頁面關閉或插件未加載時，請求約 30 秒後過期且不報錯。
• 多顯示器 / 跨 DPI 未完整驗證；獨立窗與 DSH 面板的提醒「單一負責人」協調仍在完善。
• 面板 localStorage 中的通知記錄在 DSH 重啓換端口時會清空。

排障時可查 %USERPROFILE%\.dsh\quick-panel\helper.log：打不開獨立面板、Electron 啓動失敗、did-fail-load 等均有對應說明。提醒不響時，需先與頁面交互一次以解鎖音頻；獨立窗打開時由獨立窗處理到點提醒。

社區目錄 SkillHub 插件頁 與 GitHub 倉庫爲獨立索引，與 DeepSeek / 幻方無官方從屬關係；生態上 DSH 奉行「一切皆插件」，裝插件前自行評估權限與數據落盤路徑。

結尾¶

Quick Panel 把待辦、提醒、實時消息、問題卡與快速輸入收到同一套 UI 裏，並在 Windows 上補了一層可置頂、可托盤的獨立浮島；1.0.4 起首次打開獨立面板會自動安裝校驗好的 Electron 43.3.0，降低了手工配運行時的成本。

• 目錄頁：https://www.skillhub.cn/plugins/cinewave0/cinewave0-dsh-quick-panel
• 倉庫：https://github.com/cinewave0/cinewave0-dsh-quick-panel