在 WorkBuddy 里使用海报大师

下载并校验

从本站下载 Skill ZIP， 并用 SHA256SUMS.txt 核对。 校验不是可选步骤：本页公布的哈希是 fa4087b7a8766b8d60e25a41ce32dce3ba5eabc414625f8d523f984f110fb3c5， 对不上就不要安装。解压到一个你自己的目录，保持目录完整—— workbench/ 缺失时工作台起不来。

安装（首次）：上传技能

侧栏「专家·技能·连接器」→ 顶部「技能」→ 右上「添加技能」→「上传技能」→ 选刚下载的 ZIP。

这一步需要你手动点： 「上传技能」打开的是操作系统的原生文件面板，它要求 WorkBuddy 处于前台， 而把窗口切到前台会重置当前页面。自动化到不了这一步，我们不把它说成能一键装好。

装完在「我安装的」里应当能看到 poster-master，版本为 1.0.0。

升级已装的旧版本：上传路径走不通

这是实测结论，不是推测。 技能已经装过时，「上传技能」会提示已经安装、不能重复而拒绝， 它不提供"升级"这个动作。我们实测到客户端里停在 0.5.0（安装目录里的文件日期是两周前），而本站已是 1.0.0—— 所以别假设客户端里的版本是最新的，升级前先核对「我安装的」里那个版本号。

可走的升级路径有两条：

• 本地替换安装 —— 已在本版实测通过： 技能装在 ~/.workbuddy/skills/<slug>/（本技能的 slug 是 poster-master）。 先整目录备份，然后只替换技能包拥有的那几项—— SKILL.md、references/、runtime/、scripts/、 vision-pack.lock.json、workbench/—— 保留 _user_meta.json 不要动：那是客户端自己的记账文件 （记着安装时间与来源），不属于技能包，删掉可能让客户端认不出这个技能。 替换完退出并重启 WorkBuddy，客户端才会重读。

  实测升级后三处独立核对一致：磁盘上的 SKILL.md 报 1.0.0、该目录自己跑 doctor 也报 1.0.0、客户端「我安装的」里也变成了 1.0.0。 三处都看，因为界面标签和磁盘内容曾经就是不一致的—— 那正是我们发现上传路径拒绝升级的原因。

• 从 SkillHub 更新：本技能也发布在 SkillHub 上， 新版本通过安全审核后可从技能市场更新。这条我们尚未实测， 所以不保证它对你的客户端版本可用。

升级完仍以第 3 步 doctor 报出的 version 为准—— 那是技能自己报的，比界面上的标签可靠。

运行 doctor

在对话里让它在解压目录运行 node scripts/poster-master.mjs doctor。应当原样返回一行 JSON：

{"ok":true,"command":"doctor","skill":{"version":"1.0.0","workbench":true,
 "runtime":true,"references":true},"node":{...},"os":{...},
 "vision":{"installed":false,"packVersion":null,"lockOk":true},
 "network":{"used":false},"warnings":[]}

"network":{"used":false} 是这条命令自己报出来的：它不联网。 实测它跑在 WorkBuddy 自带的 Node v22.22.2 上，与在系统 Node 25 上的结果一致。

建工程，并知道冲突时会发生什么

init-project --input <海报路径> --output <输出目录>。 按 Skill 契约，它动手前会先告诉你将要写入哪个目录。

对同一个输出目录再跑一次，应当得到：

{"ok":false,"code":5,"message":"输出目录冲突或写入失败"}   退出码 5

此时它不会替你换目录、不会加时间戳、不会删掉原目录—— 这条约束写在 Skill 里，实测 WorkBuddy 守住了：磁盘上只有你指定的那一个目录， 没有任何替代路径。要继续，请你自己选择清理原目录或指定新路径。

打开本机工作台

在解压根目录运行 node scripts/serve-workbench.mjs，保持该进程不退出， 打开它输出的 url（只监听 127.0.0.1）。 在工作台里导入海报、加图层、导出 PNG / JSON / 项目 ZIP。

关闭：向启动 JSON 里的 pid 发 SIGTERM，或在终端按 Ctrl+C。 工程数据在浏览器与你导出的 ZIP 里，不依赖这个服务进程。