用户进入 BenszAPI 里，对应的API开启智能路由模式。然后，在Codex里输入更新 bensz skills即可更新。这个入口之所以值得再提一次，是因为 Bensz Channel 其实已经连续追过这套 skills 的几段成长：5 月先聊了 v4.0.1 → v4.0.4 的 awesome-code 重构与 auto-test-code；随后是 v4.1.0 → v4.1.1 把 BAC 贡献追踪和按需安装接进日常流程；6 月又见证 auto-draw-plot 让技能库第一次真正“会画图”，以及 v4.1.3 → v4.2.0 把散落的工作文件收进 .bensz-api。把这些文章连起来看，会发现它不是不停加几个新名字，而是在把一次 AI 协作从“跑得起来”慢慢磨成“出问题也能看懂、重跑也不容易乱”的过程。今天这篇，接着聊上次工作区迁移之后，直到 7 月 19 日 v4.3.1 的这一段。

1 概览

• 从 v4.2.1 到 v4.3.0，.bensz-api 不再只是若干技能各自的隐藏目录，而成为按任务归档、按 skill 分边界的统一工作区；正式交付与临时产物终于有了清楚的分界。
• v4.2.3 → v4.2.6 把安装/更新链路连续打磨了一遍：权威 legacy 清单、选择性下载、持久缓存、失败重试和旧缓存告警，目标很朴素——网络不稳时，宁可明确告诉你“没更新到最新”，也不假装成功。
• v4.3.0 与刚刚提交的 v4.3.1，把 auto-draw-plot 的图片任务推向更严格的交付契约：计费错误不盲目回退、异步提交不重复扣费、格式与 MIME 要一致、参考图也留下可追溯指纹。
• 对日常使用者来说，升级后的最大变化不是多记几条命令，而是 AI 产生的计划、图片、测试和日志不再到处散落；对维护者来说，则是每一层失败都更有证据可查。

2 这次到底更新了什么

2.1 从“各自收拾”到一件任务一个抽屉

上次 v4.2.0 的文章，重点是把 .draw-plot、.parallel-vibe、tmp/、tests/ 这些会越用越多的中间目录，统一迁到 .bensz-api 名下。当时它解决的是“别污染项目根目录”；v4.2.1 继续补上三类测试、并行协作、PR 审查和镜像优化的路径迁移与兼容验证，说明这并不是一条只改文档的规则。

真正的下一步在 v4.3.0：目录从“按技能放”变成“按任务放”。新任务会落在类似 .bensz-api/task-20260719-近期-skills-文章/ 的根目录；一个任务调用多个 skill 时，公共资料在 shared/，每个实际调用的 skill 各自拥有 input/、output/、log/。计划草稿、参数来源、临时图片、测试记录和验证结果终于可以沿着同一条线回看。与此同时，真正要交给用户的文章、代码、报告不会默认被塞进这个隐藏目录——这一点很重要，临时工作区不该悄悄变成交付目录。

看起来只是换了路径，实际改变的是协作时的秩序。过去一个复杂任务跑完，目录里经常混着“用户本来就有的文件”“AI 新生成的正式结果”和“只为这次推理存在的日志”；一旦要复盘、清理或交给下一个人，就容易分不清。现在每次任务都像有了一个抽屉：东西能找回来，垃圾也能集中清掉，多个 skill 之间的来路去向也有位置可放。对于喜欢让 Codex 多跑几步的朋友，这个改动比表面上大得多。

2.2 更新不只求快，也要在失败时说实话

“在 Codex 里输入 更新 bensz skills”听起来像一句很轻的自然语言指令，背后却是最容易被网络、远程仓库和本地残留绊住的一段链路。v4.2.3 到 v4.2.6，仓库连续围绕这件事做了四次收口。

v4.2.3 先处理了一个很工程化、但很真实的问题：远程一键安装器需要清理哪些历史 skill，不能靠复制一份名单各自维护。现在它优先读取 install-bensz-skills/config.yaml 里的权威 legacy_skill_names；下载失败或 skills 根目录识别失败时，也会返回非零退出码。换句话说，安装器不会因为“脚本没崩”就把失败包装成成功。

接着 v4.2.4 把远程下载做得更克制。仓库很大、你却只想装一个 skill 时，Git 安装会优先用 sparse checkout 拉目标子树；无 Git 的 @install 入口也会按 skills_path 与 --skill 选择性解压 GitHub archive。它不是为了追一个漂亮的跑分，而是少下载无关内容、少扫描无关文件，也少给不稳定网络制造机会。

v4.2.5 再往前走一步：远程源缓存到 ~/.bensz-skills/installation/cache/remote-sources/，重复更新时用浅层 git fetch 增量刷新，而不是每次重新 clone。到了 v4.2.6，传输重试、低速阈值、sparse checkout 兜底、.part 临时文件和 last-known-good 缓存复用一起补齐。尤其值得注意的是：如果只能复用旧缓存，流程会给出非零退出码。它仍然尽量让你可用，但不会把“我拿到的是旧版本”伪装成“已经更新”。这类保守，平时未必显眼，真正断网、卡顿或自动化批量安装时，反而最能救人。

2.3 画图这件事，开始有了可核对的交付标准

6 月的 v4.1.2，我们把 auto-draw-plot 当作“skills 第一次会画图”的新能力介绍；后来 v4.2.2 做的是中文标签的正常字宽与字重护栏，专门避免路线图、示意图里常见的瘦长压缩字体。它关心的是：图能不能看，中文像不像中文。

v4.3.0 和 v4.3.1 则把问题换成：图交到用户手上时，究竟能不能放心用。v4.3.0 先分清了 provider 预检和真实图片提交——前者只验证配置、连通性与鉴权，只有真正 submit 才判断是否具备生图资格；计费、订阅、余额、权限及客户端策略错误不会盲目切换到另一个 provider，临时平台错误也只在同一个 provider 内重试。这个细节很像我们日常排错的常识：不要因为一次付款被拒，就把同一笔订单悄悄再刷给另一家。

刚刚打上的 v4.3.1 更进一步。对 gpt-image-2，默认明确使用 quality=low、size=1024x1024、JPEG 和压缩质量 85，把成本控制变成可见默认值，同时允许按任务覆盖；输出文件还会校验扩展名、magic bytes 和 MIME 是否一致。也就是说，一个后缀叫 .jpg 的文件，不能只是“看上去像 JPEG”。带参考图编辑时，工作流会记录 SHA-256 和稳定来源，并把主体、构图、背景保真写进约束；异步 generation/edit 在服务端没有持久幂等语义时固定只提交一次，遇到明确不可重试的计费错误立即停下，避免重复扣费或无意义地等待。

这部分更新很有意思，因为它没有把“画图”理解成一次模型调用。真正能交付的图像任务，至少还包含成本、格式、来源、参考图约束和失败时如何不重复收费。你可能不会每天查看 SHA-256，但当一张图需要复现、替换、留档或用于正式材料时，这些看似较真的规定会让人少掉很多说不清的麻烦。(～￣▽￣)～

2.4 并行协作也开始强调边界

这里再补一条和前文互相呼应的变化。v4.1.3 已经把 parallel-vibe 的智能模式设为默认，并增加了配套协议；v4.3.0 则让 runner 直接在任务根里创建自己的专用目录，原有计划、线程工作区和日志都保留，只是换到统一契约下。它意味着“并行”不再等于多开几个窗口然后希望它们互不干扰，而是每个参与者都知道自己的输入从哪里来、输出该放到哪里。

这也是我觉得这轮版本最值得升级的地方：skills 仓库没有把复杂协作的成本假装不存在，而是不断为它补上命名、目录、缓存、状态码与校验。AI 工具越强，越不能只依赖“这次它应该会处理好”；能让人复核、让下一次运行不猜测，才是稳定感真正的来源。

3 怎么用，才最省心

小伙伴们其实不需要把上面所有版本号背下来。按开头那条路径，在 BenszAPI 打开对应 API 的智能路由模式后，直接在 Codex 输入 更新 bensz skills 即可。更新完成后，如果任务中调用了会产生中间材料的 skill，项目里看到 .bensz-api/ 是正常的：先看本次 task-* 目录里的 README.md、output/ 与 log/，再决定哪些正式成果要带走或提交。

如果网络有波动，也别急着反复触发安装。新安装器会尽力使用缓存并明确报告是否真的拉到最新版本；比起重复下载留下半截文件，先让状态说清楚，反而是更可靠的工作方式。是不是感觉这次更新没有一个特别花哨的“按钮”？但目录干净、失败可见、图片可验、安装可追溯，往往才是一个技能库真正开始耐用的标志。

4 小结

把 Bensz Channel 上此前的几篇文章与这次 v4.2.1 → v4.3.1 连起来看，huangwb8/skills 的重心已经很清楚：从 v4.0 的安装器与质量闭环、v4.1 的贡献追踪和新能力，到 v4.2、v4.3 对任务边界、远程更新和图像交付的持续收口，项目正在把 AI 协作里最容易“说不清”的部分变成可观察、可回查的事实。.bensz-api 让任务产物归位，安装器让缓存与失败不再含糊，auto-draw-plot 则开始对格式、成本和参考图负责。对于使用者，开智能路由后让 Codex 执行一次更新就够了；对于真正需要长期依赖这套工具的人，这些不显山露水的工程细节，恰恰比再多一个炫目的 skill 更值得在意。

项目地址：https://github.com/huangwb8/skills