dsh-macos-widget
在终端中运行以下命令:
dsh plugin install LXD-8/dsh-macos-widget
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 `dsh plugin install LXD-8/dsh-macos-widget` 即可从开源仓库 https://github.com/LXD-8/dsh-macos-widget 安装该插件。
插件介绍
DSH 生态里许多插件都有自己的数据与业务逻辑,却没法自然出现在 macOS 桌面上。WidgetKit 扩展跑在系统小组件宿主里,既不能走 dsh-app://,也拿不到页面会话,单靠「每个插件各自做一套原生小组件」成本高、也不可持续。dsh-macos-widget 走的是基础设施路线:它自己不画任何专属小组件,而是提供注册表、本机桥接和通用 WidgetKit 外壳,让任意 Host 插件用约定的 style 字段登记外观与内容,由用户在设置里点选后,桌面上的「DSH 小组件」统一渲染当前选中的那一个。
核心能力集中在三部分。Host 侧通过 index.js 维护 macosWidgets 注册表,并在 127.0.0.1 固定端口提供只读 GET 桥接,以及选中小组件的 API;client.js 负责「设置 → macOS Widgets」里的桥接状态与已注册列表;macos/ 下的 SwiftUI 伴侣应用提供 small、medium、large 三种尺寸的通用 WidgetKit 种类,按时间线刷新读取当前 payload。样式由插件通过 layout、accent、background、showUpdated 等模板字段描述,原生侧不硬编码具体提供方,quota-windows 只是示例而非本插件依赖。
适合已经维护 DSH Profile、希望在 macOS 桌面一眼看到某个插件状态的用户,也适合插件作者:只需按契约注册 widget 并定义 style,不必为每个插件单独维护一套签名与分发的扩展。需要知悉的是:扩展需本地用 Xcode 构建伴侣应用,选型会写入 $DSH_HOME 并随 Host 重启恢复,刷新周期受 WidgetKit 时间线约束;若未来要完全自定义视图,仍可能需要在 Host 侧做 Web 渲染等更深集成。
截图预览
使用场景
- 希望在不打开 DSH 页面的情况下,在 macOS 桌面查看某个已安装插件的状态
- 为多个 DSH 插件统一提供 macOS 桌面展示入口,由用户在设置里切换显示哪一个
- 本地开发 DSH 插件并验证 widget 注册与 style 契约在 WidgetKit 中的呈现效果
适合人员
- 日常使用 DSH Profile 且使用 macOS 的桌面用户
- 正在为 DSH 编写 Host 插件、希望提供桌面小组件能力的开发者
- 负责 macOS 端 DSH 集成与本机伴侣应用构建的维护者

