WorkBuddy-FreeSkin
macOS 新版 0.7.0。本 SkillHub 更新包仅支持 Mac，Windows 用户使用历史 0.6 体验版。四套内置主题：哆啦A梦、黑魔导、山治、怪盗基德。不修改 WorkBuddy 安装包，不上传聊天或凭据，不需下载外部项目或 npm 安装。
先检查
使用本文件所在技能目录的实际绝对路径，正确引用空格；不要假定当前工作目录就是技能目录。先找可用 Node，再执行：
node "<技能目录>/scripts/skin.mjs" list
node "<技能目录>/scripts/skin.mjs" check
node "<技能目录>/scripts/skin.mjs" status
Mac 需要 Node 22.4+（22 系列）或 Node 24 LTS，以及 WorkBuddy 5.6.2；不要使用 Node 26。Node 缺失时说明用途，引导从官方渠道安装，不默默下载或执行安装器。Node 路径必须稳定可用，自动恢复依赖它；更新或移动 Node 后重新启用本技能。
Mac 默认查找 /Applications/WorkBuddy.app；其他位置设置 WORKBUDDY_APP_PATH 指向 WorkBuddy.app。版本、身份或系统查询失败时停止，不伪装兼容、不强制结束进程。
macOS 首次启用
先说明：换肤通过仅本机 127.0.0.1:19223 的调试连接工作，该端口具备控制应用界面的能力。自动恢复会安装可移除的本机登录组件，并为原 WorkBuddy 图标设置启动环境；它不自动打开 WorkBuddy。遵循当前 Agent 的授权规则，用户已明确同意时不重复索取。
用户希望以后照常点原图标时，执行：
node "<技能目录>/scripts/skin.mjs" install kaito-kid
主题标识可换成 doraemon、dark-magician、sanji 或 kaito-kid。未指定角色时使用 install，保留最后保存的选择；全新安装默认哆啦A梦。显式主题会在连接建立后应用。启用登录组件不等于当前页面已经换肤。
- 若普通模式的 WorkBuddy 正在运行，提示用户保存任务，正常退出，再点击原来的应用图标打开。不要要求每天运行启动命令。
- 在 WorkBuddy 自己的对话里，不能退出或杀死宿主应用，也不要自动重启它。 只完成安装并交给用户正常退出。
- 应用本来未运行且当前 Agent 不依赖它时，可启动原应用。返回后执行
status，确认 automatic=true、connection=true、health.connected=true、health.themesApplied=true、active 为预期主题；有界面读取能力时检查首页。 - 自动恢复组件复制到独立的本地目录；移动技能目录不会丢失已安装组件和主题。但只卸载 Skill 不会删除该组件，见下方卸载流程。
用户不希望安装登录组件时：说明仅本次启用不会随原图标重开恢复。应用未运行时用 start；在宿主应用内用 prepare 生成启动文件，让用户保存退出后双击。此启动文件包含本机路径，不作为公开发布素材。Mac 使用 prepare 不指定主题能保留最后选择：
node "<技能目录>/scripts/skin.mjs" prepare "" "<用户输出目录>"
日常操作
已有连接时，切换内置主题无需重启：
node "<技能目录>/scripts/skin.mjs" apply sanji
明确提示：apply <标识> 会将这套内置主题恢复为随技能附带的新版默认效果。要保留已微调的同一套主题，使用外观页面的主题卡片，不重复 apply。
打开“设置 → 外观 → 自定义皮肤 → 管理”。入口仅在外观页显示。选择主题即保存选择；改名称、明暗、背景、透明人物、装饰或参数后，点击“保存并使用”。未保存预览只作用于当前设置窗口；主窗口在保存后同步。高级调整默认折叠。
支持复制/删除主题、恢复示例、撤销未保存调整、撤销上次保存、完整备份与导入（文件夹逐张传输原图，不受单个 JSON 的总大小限制）。删除主题移入工具回收区，图片保留；至少保留一套主题。原图 PNG/JPEG/WebP 每张最多 16 MB、5000 万像素，不缩图；主题库最多 100 套。
用户要求其他角色或自己的图片时，按 自定义壁纸指南 操作；不要擅自替换成四套内置主题，也不要承诺技能自带生图模型。
完整备份与换电脑
在外观管理页点“导出完整备份”，工具创建一个新文件夹并在 Finder 打开。整体复制这个文件夹；要发送给别人可用 Finder“压缩”，对方先解压。不要只拷贝 library.json，也不要分享含私人图片的整库备份。
在另一台已启用工具的 Mac 的外观管理页点“导入完整备份”，选择解压后的整个文件夹并确认。图片逐张校验并保留原始字节；同标识更新，新标识加入，恢复备份中的主题选择，旧状态可撤销。成功标志：提示完整备份已导入，主题卡片与主窗口效果正确，退出重开后保持。
也可根据用户明确提供的备份文件夹执行：
node "<技能目录>/scripts/skin.mjs" backup "<新的备份文件夹>"
node "<技能目录>/scripts/skin.mjs" import-backup "<完整备份文件夹>"
backup 不覆盖已有文件夹；import-backup 合并主题并恢复备份中的选择。旧版 JSON 可通过“导入旧版 JSON”继续导入，最多 300 MB。目录备份没有这个总大小限制，仍遵守单张图片 16 MB 和库内 100 套主题限制。
关闭与卸载
node "<技能目录>/scripts/skin.mjs" restore
node "<技能目录>/scripts/skin.mjs" disable-auto
node "<技能目录>/scripts/skin.mjs" uninstall
三者意义不同：
- restore：保存“官方外观”的选择，移除皮肤效果，保留主题库。重开后继续原生外观。
- disable-auto：移除登录配置并恢复启动环境，本次仍可换肤；正常退出后普通启动不再自动加载。
- uninstall：恢复官方外观，卸载本地组件、启动配置与连接监听，主题图片和配置保留。运行中的本机调试端口需要用户正常退出并重开才能关闭。之后再在技能列表移除 Skill。
也可通过外观页同名按钮操作。用户数据不随卸载删除；不要擅自清空备份或图片。完整存储范围、冲突与错误处理见 操作说明。
发布包素材说明
SkillHub 不接受二进制图片资源，因此附带图片以 JSON 中的 base64 保存；初次启用时校验 SHA-256 并还原原图到独立本地素材库，不缩图，不下载远程素材。用户自己的导入图片仍独立落盘。
