DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-quick-panel-mac

c

dsh-quick-panel-mac

Identified

DSH Quick Panel for macOS: Floating Island, To-Do, Reminders, Real-Time Messages, Approval Takeover

快捷面板 · macOS / Quick Panel for macOS

当前版本:1.0.4-beta.4(预发布)

CI Release

Quick Panel

DSH Desktop 的快捷面板插件,macOS 版:在 DSH 窗口内提供一个浮岛与面板,并附带一个可常驻桌面的独立小应用(Electron 伴生窗)。

  • 包名:dsh-quick-panel-mac,组合包声明 dsh.bundle.platforms: ["darwin"],Windows 上不会出现也不会被启用。
  • Windows 版在另一个仓库:cinewave0/cinewave0-dsh-quick-panel。两个仓库独立发布,互不影响。
  • 分发:GitHub Releases + 本仓库自己的 Discover 索引(不发布 npm)。

改代码前先读 AGENTS.md:本仓库只发布 macOS 版;平台差异只能走 runtime/electron-helper/platform.cjs,Windows 路径保持与上游一致、不要在这里改。

  • DSH 内:侧边栏入口 → 顶部浮岛 → 下拖面板;待办、提醒、实时消息、快速输入。
  • 独立小应用:默认顶部浮岛(360×48,置顶、不占 Dock),点开为 440 宽面板;菜单栏图标常驻;关闭面板只收起为浮岛。

环境要求

  • macOS 12+(独立小应用依赖 Electron 的窗口 API)。

  • DSH Desktop(Host 半区需要 webServer 与 sessionController)。

  • Electron:~/.dsh/electron/Electron.app/Contents/MacOS/Electron(通常由 dsh-pet 下载,缺失时可运行 dsh-pet 的 scripts/ensure-electron.mjs)。

    路径缺失时打开独立窗会提示 electron-missing;指向别处的 Electron 可设 DSH_QUICK_PANEL_ELECTRON。

安装

本项目不发布 npm,只有三个渠道:DSH 插件页(Discover 索引)、Release 包、git commit。

方式一:DSH 插件市场(Discover)

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

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

然后搜索 Quick Panel 安装。索引固定到某个 commit,装完即用。

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

方式二:Release 包

从 Releases 下载 dsh-quick-panel-mac-1.0.4-beta.4.tgz,先用 SHA256SUMS 校验:

shasum -a 256 -c SHA256SUMS          # macOS / Linux
certutil -hashfile <tgz> SHA256      # Windows,与 SHA256SUMS 里的值比对

然后在 DSH 插件页的安装入口填 tgz 的绝对路径;装了 dsh CLI 的环境也可以直接用命令行:

dsh plugin --profile desktop add /绝对路径/dsh-quick-panel-mac-1.0.4-beta.4.tgz

桌面版 App 不一定把 dsh 命令装进 PATH,没有 CLI 时用插件页安装即可。

方式三:git commit

dsh plugin --profile desktop add "git+https://github.com/cinewave0/dsh-quick-panel-mac.git#<commit>"

安装后:

  • 修改 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 总量(日期字号);
  • 托盘退出才会真正结束小应用。

macOS 上是同一套面板(浮岛 / 面板 / 托盘 / Dock 隐藏 / 底部拖动改高度):

macOS 浮岛

macOS 面板

数据

路径以 $DSH_HOME(Windows %USERPROFILE%\.dsh,macOS ~/.dsh)为根:

  • 共享存储:$DSH_HOME/quick-panel/state.json(待办、提醒、设置、当前会话 id)
  • 窗口位置:$DSH_HOME/quick-panel/window.json
  • 启动诊断:$DSH_HOME/quick-panel/helper.log
  • 独立窗 Chromium profile(仅 macOS):$DSH_HOME/quick-panel/user-data(macOS 默认 userData 会被所有裸跑 Electron 的脚本共用,单实例锁也落在里面;Windows 位置不变)
  • 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 与 macOS;独立小应用依赖 DSH 运行与 $DSH_HOME/electron;
  • macOS 差异:浮岛不占 Dock(app.dock.hide())、无边框窗没有系统缩放边(面板高度由底部自绘 grip 拖动)、菜单栏图标用模板图(随深浅色自动反色)、通知以 Electron 身份出现(未做 .app 签名打包);
  • 独立窗实时消息: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/platform.test.mjs                      # 平台规则(托盘/Dock/置顶/菜单)
node test/panel.test.mjs                         # Electron 面板集成测试(需 $DSH_HOME/electron)
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

Versions

Latest versionPublishedSize
1.0.4——

Comments

Loading…

Similar plugins

dsh-niao-message

by dsh-niao

macOS 系统通知插件:在「异常终止 / 需要你操作 / 正常完成」三大场景弹通知中心横幅,点击横幅直达指定应用。

Workflow & AutomationNotifications & IntegrationsTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Aug 19, 2026

dsh plugin --profile web add dsh-niao-message

by zhaoxuejie

DSH 桌面通知插件:任务完成 / 等待输入 / 失败时,右下角弹窗 + 音效 + 手机推送(Windows / macOS / Linux)

Development & InfrastructureManifest valid

★ 0

MIT

JavaScript

Sep 7, 2026

dsh plugin --profile web add dsh-plugin-desktop-notice

macOS desktop shell for the DSH web UI: a plugin plus a small Tauri/WKWebView window over the loopback web surface — real macOS fullscreen, single instance, external links delegated to the system brow

UI & ExperienceManifest valid

★ 0

dsh plugin --profile web add dsh-desktop-kit

为模型展示交付成果和下达精细微调指示的dsh desktop面板

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-plugin-middle-panel

by realDGD

Native interactive macOS notifications, approvals and full question forms for DeepSeek Harness Desktop

Manifest valid

★ 0

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add dsh-macos-notify

by CarbeneLee

Native macOS notifications for DSH: task completion, failures, approval requests, questions and plan reviews. A small bundled helper app lets banners use the DSH icon and opens DSH on click; the notif

Notifications & IntegrationsManifest valid

★ 0

MIT

JavaScript

Nov 16, 2026

dsh plugin --profile web add dsh-mac-notify