cinewave0-dsh-quick-panel

快捷面板 / Quick Panel

当前版本：1.0.4-beta.1（预发布）

DSH Desktop 的快捷面板插件：在 DSH 窗口内提供一个浮岛与面板，并附带一个可常驻桌面的独立小应用（Electron 伴生窗）。仓库已公开，通过 GitHub Releases 与 Discover 索引分发（npm 发布暂缓）。

• DSH 内：侧边栏入口 → 顶部浮岛 → 下拖面板；待办、提醒、实时消息、快速输入。
• 独立小应用：默认顶部浮岛（360×48，置顶、不占任务栏），点开为 440 宽面板；托盘常驻；关闭面板只收起为浮岛。

环境要求

• Windows（独立小应用依赖 Electron 与 Windows 窗口 API）。
• DSH Desktop（Host 半区需要 webServer 与 sessionController）。
• 独立小应用复用 %USERPROFILE%\.dsh\electron\electron.exe（通常由 dsh-pet 下载）。缺失时打开独立窗会提示失败。

安装

本插件目前走 GitHub 分发（npm 发布暂缓）。

方式一：DSH 插件市场（Discover）

插件 → 发现 → 添加索引源：

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

然后搜索 Quick Panel 安装 1.0.4-beta.1。索引固定到 v1.0.4-beta.1 的 Git commit。

索引当前指向预发布版。想留在稳定版，用下面的 Release 包安装 v1.0.3。

方式二：Release 包

从 Releases 下载 dsh-quick-panel-1.0.4-beta.1.tgz，用 SHA256SUMS 校验，然后：

dsh plugin --profile desktop add <下载目录>\dsh-quick-panel-1.0.4-beta.1.tgz

方式三：git commit

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

安装后：

• 修改 client.js、panel/ 资源：刷新 DSH 页面 / 重开独立窗；
• 修改 index.js（Host 半区）：需要重启 DSH；
• 修改 runtime/electron-helper/：托盘退出独立窗后重开。

开发目录仍可通过 plugin_manager install_bundle target = <项目目录> 以 link 方式挂载，详见「开发目录」。

使用

DSH 内

• 侧边栏底部的快捷面板按钮打开浮岛；
• 浮岛显示最新一句 / 时间 / 运行呼吸灯；
• 点浮岛展开面板：待办、提醒、实时消息、底部快速输入；
• 待办左侧勾选 = 填入 DSH 输入框（不自动发送）；↵ 在独立窗中填入输入框；
• 待办和提醒条目按当前显示顺序显示 1. 2. 数字序号；
• 提醒支持翻页时钟、重复、提示音；
• 实时消息支持用户 / 助手 / 推理 / 代码 / 工具 / 错误、流式光标、上滚加载更早；
• 用户消息里的图片显示缩略图（Host 通过当前对话的附件引用读取，不在实时消息里传 base64）。

独立小应用

• DSH 面板底部的「打开独立面板」启动；默认先出现顶部浮岛；
• 点浮岛文字或 ⌃ 展开面板；拖动浮岛左侧 ⠿ 移动；
• 面板 X = 收起到浮岛；托盘菜单可打开面板 / 收起到浮岛 / 退出；
• 拖入图片或文件到窗口（底部输入框上方会出现附件条），上传完成后随下一条消息发送；单条最多 20 个附件，可逐个移除；
• 面板宽度固定 440，高度默认 720、可拖上下边缘；保留原生标题栏拖动和边框，不添加双击贴右、自定义拖动或热区；
• 用户消息缩略图可点击，在独立窗内查看原图（Esc 或点遮罩关闭）；
• 权限请求：DSH 页面可见时由 DSH 内建卡处理；DSH 页面隐藏/最小化时由独立窗接管，回到 DSH 可见后自动交还；
• DSH 的 1/2/3 选项问题会镜像到独立窗，选择/填写后可直接提交；
• DSH 不在对话页时，实时消息由 Host 继续镜像最近事件，并支持上滚加载更早；
• 「实时消息」与「在线」之间的 1–5 数字是最近 5 个会话（不显示标题），点数字即在 DSH 中切换；当前会话高亮，请求发出后目标数字脉冲，等 DSH 页面轮询处理并回报；已归档会话不出现；
• 时钟右侧显示余额（与时钟同尺寸）和本次 token 总量、输出速度、最近 30 天 token 总量（日期字号）；
• 托盘退出才会真正结束小应用。

数据

• 共享存储：%USERPROFILE%\.dsh\quick-panel\state.json（待办、提醒、设置、当前会话 id）
• 窗口位置：%USERPROFILE%\.dsh\quick-panel\window.json
• 启动诊断：%USERPROFILE%\.dsh\quick-panel\helper.log
• DSH 面板的本地数据会在启动时迁移到 Host 存储；Host 不可用时回退 localStorage。

常见问题

打不开独立面板

• DSH 面板提示「Host 未连接」：Host 半区未加载，重启 DSH；
• 提示其他错误：查看 helper.log 的 spawn / exit 记录；
• 独立窗启动后立即消失：确认 Electron 路径存在，或查看 helper.log 的沙箱重试记录。

独立窗没有实时消息

• 独立窗优先使用 DSH 对话页的实时镜像；离开对话页 5 秒后改用 Host 镜像；
• Host 镜像保留最近事件，上滚可加载更早；流式 partial 仍依赖 DSH 对话页；
• 如果完全没有消息，确认当前 DSH 对话与独立窗的「对话」标签一致。

提醒不响

• 首次使用需与页面交互一次以解锁音频；
• 独立窗打开时，DSH 面板的提醒到点逻辑会暂停，由独立窗处理；
• 独立窗关闭后，DSH 面板恢复提醒。

已知限制

• 仅 Windows；独立小应用依赖 DSH 运行与 $DSH_HOME/electron；
• 独立窗实时消息：Host 能在 DSH 离开对话页后继续镜像新的已结算事件，并在上滚时从 Host 会话事件加载更早；流式 partial 仍依赖 DSH 对话页；
• 独立窗问题卡：当前会话的 pending 问题会镜像；多题用上一题/下一题，提交后等待 DSH 确认；
• 独立窗会话切换：数字按钮只负责发起请求，真正切换发生在 DSH 页面内的客户端插件（轮询间隔约 2.5 秒）；DSH 页面关闭或插件未加载时请求会在 30 秒后过期，界面不报错也不切换；
• 图片缩略图：DSH 面板覆盖已加载的历史消息；独立窗覆盖 Host 镜像的当前窗口；原图由 Host 按附件引用按需读取，超过 16 MiB 的附件不预览；
• 通知中心：面板时钟下方常驻通知条，记录审批请求、轮次结束、提醒到点；未读显示角标，点开查看最近 20 条，审批条目可跳回审批卡，支持一键清空。记录存在面板 localStorage（DSH 重启换端口会清空）。
• 权限批准卡：默认在 DSH 页面可见时显示 DSH 内建卡；DSH 页面隐藏、独立窗心跳在线且当前对话匹配时由外部面板接管。外部面板「实时消息」下方的审批锁定在外部面板勾选后，即使 DSH 可见也由外部面板接管；取消勾选恢复 DSH 内建审批。审批被接管时面板会响提示音并弹桌面通知（标题含工具名，回答后通知关闭）。关闭独立窗或心跳丢失时始终交还 DSH；不再有 120 秒超时兜底；
• 时间栏的“30 日”是本机 DSH 会话投影的近似总量（含缓存读取），不是平台账单；余额需要已登录 DeepSeek 账号，API Key 模式显示 —，余额缓存约 5 分钟；
• 多显示器/跨 DPI 场景未完整验证；
• 独立窗提醒与 DSH 面板的“单一负责人”协调仍在完善。

开发目录

index.js                     Host：共享存储、本地 API（含图片附件读取）、live、prompt/stop、静态资源
client.js                    DSH 客户端（构建产物；编辑 src/client/ 后重新构建）
src/client/main.js           DSH 客户端入口：apply 与槽位注册
src/client/dsh.js            DSH 服务适配层（能力检测 + 降级）
src/client/session.js        store/模式/待办/提醒/HostSync
src/client/overlay.js 等     组件与工具模块（overlay/sections/feed/input/panel/bridges）
src/client/runtime.js        React 绑定（DSH 的 require('react') 注入）
panel/                       独立窗页面（HTML/CSS/JS/icon）
runtime/electron-helper/     独立窗主进程与 preload
locale/                      插件标题/描述
scripts/                     构建、备份、GitHub 同步、市场索引生成
test/                        Host 回归、客户端 bundle/适配层/源码导入、Electron 面板测试

开发命令

node scripts/build-client.mjs                    # 由 src/client 生成 client.js
node test/host.test.mjs                          # Host 回归（11 项）
node test/client-bundle.test.mjs                 # 客户端 bundle 信封/工厂形状
node test/dsh-adapter.test.mjs                   # DSH 服务适配层与降级路径
node test/source-imports.test.mjs                # 源码模块导入完整性
node test/panel.test.mjs                         # Electron 面板集成测试（需 electron.exe）
npm run lint                                     # oxlint（0 warning 门槛）
node scripts/backup.mjs                          # 备份到 ../backups（zip + sha256 + manifest）
node scripts/sync-github.mjs --message "..."     # 提交 + 测试 + push
node scripts/sync-github.mjs --dry-run           # 只看计划，不提交不推送
node scripts/sync-github.mjs --proxy http://127.0.0.1:7897 --message "..."  # 直连被重置时走本机代理

client.js 是生成文件，直接改它会在下一次构建时被覆盖；CI 会用 git diff --exit-code client.js 检查源码与产物是否一致。

License

MIT