用途：为 WorkBuddy Electron 桌面应用创建运行时 CSS 皮肤，并支持检查、验证、预览、打包、发布、应用与还原。主题只通过注入样式生效，不修改 /Applications/WorkBuddy.app、app.asar、完整性元数据、代码签名、认证数据或用户对话。
主要能力：提供主题目录规范（theme.json、theme.css、可选 artwork、preview.html）；支持位图素材以 WORKBUDDY_THEME_ART 占位符嵌入；提供静态校验、dry-run、应用、状态检查、守卫校验与还原命令；附带跨主题切换器与可视化 Theme Manager。
使用方式：先阅读 references/workbuddy-contract.md；兼容性检查运行 node scripts/workbuddy-theme.mjs inspect 与 probe；验证运行 node scripts/validate-theme.mjs /absolute/theme-directory 和 node scripts/workbuddy-theme.mjs dry-run /absolute/theme-directory；应用需先获得明确许可，再运行 node scripts/workbuddy-theme.mjs apply /absolute/theme-directory --launch；状态与守卫用 status、verify-guard；还原用 restore。切换主题可用 node scripts/switch-theme.mjs --list、<theme-id>、--status、--restore。
适用场景：为 WorkBuddy 5.2.6 制作明暗主题、导入 ZIP 主题包、同步 GitHub 注册表、在 macOS/Windows 上切换与还原主题。
限制：应用主题需退出并重启 WorkBuddy 并开启仅回环的调试端口，可能中断进行中的任务；静态验证不代表真实应用兼容；深色主题不能只依赖 --vscode-* 变量；不要隐藏、移动或缩放原生控件；创建主题不授予提交、推送或开 PR 的权限；Windows 旧版命令行启动器不可用，需用 Theme Manager 的 Windows 适配器。