主题工具维护
工具链源码位于独立的 picloom-tooling 仓库。宿主默认主题仍在 picloom/themes/default/; 脚手架独立维护 tools/create-theme/template/,构建不再读取宿主默认主题。 预览、构建与 ZIP 打包由 @picloom/theme-tools 提供,公共纯规则由 @picloom/package-rules 维护并打入工具。 主题 SDK 仍为纯浏览器类型,不引入插件 SDK 或服务端运行时。
主程序和扩展默认安装 npm 精确版本。仅在验证工具链源码修改时,从工具链仓库临时同步本地依赖:
sh
cd ../picloom-tooling
bun install --frozen-lockfile
bun run dev:sync -- ../picloom ../picloom-extensions命令生成带内容哈希的压缩包,更新消费仓库的依赖与锁文件,不发布。 修改工具链后重新同步;也可指定生成的独立主题目录为目标。 模板源文件可以编辑,不手工修改 tools/create-theme/dist/template/。
从主仓库显式执行 bun run test:theme-tooling,验证真实 .tgz、仓库外创建、Bun-only 工具路径、 预览和宿主安装。默认使用相邻的工具链目录,也可通过 PICLOOM_TOOLING_DIR 指定。 此检查需要依赖下载网络和 Playwright Chromium,普通后端测试默认跳过。
发布需要明确授权。先确保 SDK 和工具已发布可下载,再发布引用这些版本的脚手架。 本地清单不可直接作为分发清单:发布完成后从 tooling 运行 bun run dev:registry -- ../picloom ../picloom-extensions, 再在消费仓库更新锁文件并验证干净安装。恢复 registry 版本命令本身不发布。