前言¶
在 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 窗口内¶
- 侧边栏底部按钮打开浮岛；浮岛展示最新一句、时间与运行呼吸灯。
- 点击浮岛展开面板：待办、提醒、实时消息、底部快速输入。
- 待办左侧勾选会把条目填入 DSH 输入框（不自动发送）；在独立窗中按
↵同样填入输入框。待办与提醒按当前显示顺序标1.2.序号。 - 提醒支持翻页时钟、重复与提示音。
- 实时消息区分用户 / 助手 / 推理 / 代码 / 工具 / 错误，支持流式光标与上滚加载更早记录；用户消息中的图片以缩略图显示（Host 按当前对话附件引用读取，不在实时消息里传 base64）。
- DSH 的选项式问题卡可镜像到独立窗，选择或填写后可直接提交。
- 通知中心在时钟下方常驻：记录审批请求、轮次结束、提醒到点；未读角标，最近 20 条，审批项可跳回审批卡。
独立小应用（Electron 伴生窗）¶
- 在 DSH 面板底部点「打开独立面板」启动；首次会触发 Electron 运行时安装（见下一节）。
- 点浮岛文字或
⌃展开；拖动浮岛左侧⠿移动；面板X收起到浮岛；托盘可打开 / 收起 / 退出。 - 拖入图片或文件到窗口（输入框上方出现附件条），上传完成后随下一条发送；单条最多 20 个附件。
- 面板宽 440，高度默认 720、可拖上下边缘；用户消息缩略图可点击查看原图。
- DSH 页面隐藏时，权限请求由独立窗接管；勾选「审批锁定在外部面板」后，即使 DSH 可见也由独立窗处理审批。
- 「实时消息」与「在线」之间的 1–5 数字对应最近 5 个会话，点击后在 DSH 内切换（轮询间隔约 2.5 秒）。
- 时钟旁可显示余额（需登录 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 内快速记待办并回填输入框
- 点侧边栏快捷面板，打开浮岛后下拖面板。
- 在快速输入或待办区维护条目；需要发送前，勾选待办左侧，内容进入主输入框，自行确认后发送。
桌面置顶跟进长对话
- 在面板底部点「打开独立面板」，等待首次 Electron 下载完成（界面会显示进度）。
- 浮岛置顶放着最新一句；展开后看实时消息流，上滚加载更早记录。
- 离开 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
