桌面端内置 macOS 小组件（WidgetKit）：插件自带样式，用户在设置里选择

[LXD-8]

背景

插件的数据适合放到 macOS 桌面常驻（小组件），但客户端插件跑在 dsh-app://app/ 的渲染进程里，无法变成系统小组件。macOS 小组件必须由 App 内置的原生 WidgetKit 扩展（.appex，Swift）提供，由系统的小组件宿主渲染；DSH 目前没有这个扩展。

目标

• 一个基础设施插件：只负责把「自带 macOS 小组件样式的其他插件」显示到桌面，自身不绑定任何具体插件。
• 其他插件在注册时自带样式，决定小组件长什么样。
• 用户在 DSH 设置里选择要显示哪个插件，选择持久化。

设计

1. 内置扩展：DeepSeek Harness.app/Contents/PlugIns/ 内置 DSHWidgets.appex，随 App 一起签名 / 公证；一个通用 widget kind。
2. 插件 API：Host 服务 ctx.macosWidgets.register({ id, title, subtitle, style, read })；read() 返回通用 payload（sections / rows）。
3. 插件自带样式：payload 的 style 契约（layout：list / single；accent；background；showUpdated），插件决定外观，核心只按契约渲染。
4. 设置选择：设置页列出所有已注册插件，点击选择并持久化；原生端读取选中的 payload。
5. 数据通道：Host 把选中快照写入 App Group 共享容器（或宿主管理的回环端点，端口写进 App Group），扩展读取；避免固定端口。
6. 刷新与隐私：跟随 WidgetKit 时间线预算；DSH 未运行时显示上次快照或占位；只写展示数据，不写凭据。
7. 完全自定义样式（可选进阶）：如果模板不够，宿主可以把插件提供的 Web 小组件视图离屏渲染成图片交给扩展，插件用 HTML/CSS 完全控制外观。

现状

第三方插件 dsh-macos-widget 已实现上述模型：注册服务、样式契约、设置页选择、固定回环桥接、通用 DSHWidget kind（small / medium / large）。quota-windows 是示例消费者，注册「额度窗口」并声明自己的样式；换成任何插件都可以。

已在 macOS 27.3 上验证：设置里选择插件后，桌面小组件显示该插件的样式与数据。

剩余差距需要宿主内置解决：伴生 App 需要用户自行构建安装（ad-hoc 签名），桥接端口固定。

开放问题

• 样式契约用模板（layout + tokens），还是直接支持插件自绘视图？
• App Group 还是宿主回环端点？
• 小组件是否支持 App Intents 交互（点按刷新 / 打开对应页面）？
• Windows / Linux 没有对应物，是否需要替代方案？

环境：DSH Desktop 0.2.2-rc.1、macOS 27.3、quota-windows 1.16.1（示例消费者）。