v0.2.12

四项优化落地发版（当前推荐版本）。

① processon-harness 技能补强：TRACE 3.99 → 4.61。SKILL.md 全面重写（When to use/能力边界/Step 1-5 工作流/Rules/Gotchas×12/校验清单/渐进披露索引）+ 7 个 references（workflow/security/error-recovery/tool-routing/validation-checklist/anti-patterns/faq-deep）+ 3 个 examples（happy-path/failure-recovery/boundary-refusal）。
② hooks 测试补全：tests/test_hooks.py 表驱动 7 tests + 27 subtests，覆盖意图正则边界（含不命中用例）、斜杠命令跳过、坏输入容忍、环境检查双分支。
③ 启动机制宿主化：_launch_codex → _launch_agent，docstring 明示已验证宿主范围（当前仅 Codex，其他宿主手动重启 agent）；测试同步。
④ 发版工具修复：bump-plugin.mjs 补 README 全形态同步（徽章/tag 链接/--ref/Current candidate 构建戳）并对齐市场主本；sync-marketplaces 分类法分离（codexCategory）+ 插件侧 category 契约校验。本版本即由修复后的 bump 脚本一键产出（端到端实测）。

验证：105 tests + 42 subtests 全绿；validate_distribution 通过；sync scoped 三平台一致；README 零残留。

v0.2.11

版本一致性终章（当前推荐版本，取代 v0.2.6–v0.2.10）。

修复

• Status and version 表 Current candidate 行更新为 0.2.11+codex.20260923（此前长期停留在 0.2.0 时代构建戳，属 bump 盲区）

版本一致性终态（全仓宽形态扫描）

• manifest ×4 / marketplace ref / CDN 图标 @tag / README 徽章与 --ref / Current candidate 全部 0.2.11
• 合法历史锚点保留：0.1.0+codex 验收行、Codex CLI 0.154.0-alpha.6.2、协议 2025-06-18、PyYAML 6.0.3
• 回归 98 tests + 15 subtests 全绿；三平台 CI 矩阵（v0.2.9 起全绿）；线上冒烟双 VERIFIED

v0.2.10

版本一致性收尾发版（当前推荐版本）。

修复

• README 散文 4 处版本残留（bump 盲区）改为版本无关措辞：契约示例与证据表不再内嵌具体版本号，永不再漂移

验证

• 回归 98 tests + 15 subtests 全绿；validate_distribution + sync-marketplaces scoped 三平台一致
• 全仓版本一致性扫描：manifest/ref/CDN 图标 @tag/README 徽章与 --ref 全部 0.2.10
• 承接 v0.2.6–v0.2.9：线上冒烟双 VERIFIED、三平台 CI 矩阵全绿、跨平台修复、宿主中立文案、版本断言派生化

v0.2.9

Windows 测试矩阵收尾发版（当前推荐版本，取代 v0.2.6–v0.2.8）。

修复

• test_xdg_config_path_is_used_on_unix 补 skipIf(os.name == nt) 守卫（Unix 契约测试在 Windows 无法实例化 PosixPath；与同文件既有守卫同款惯例）

v0.2.8 起包含

• 跨平台：35 处 read_text 显式 UTF-8、.gitattributes 锁 LF、CI PYTHONUTF8=1
• CI 三平台测试矩阵 + PyYAML 依赖
• 线上冒烟双 VERIFIED（真实 ProcessOn MCP）
• 运行时文案宿主中立 + 版本断言派生化
• 本地回归 98 tests + 15 subtests 全绿

v0.2.8

跨平台修复发版：Windows 测试矩阵根因修复（取代 v0.2.6/v0.2.7）。

Windows CI 实测根因（两类）

• 35 处裸 read_text() 在 cp1252 下读中文内容 UnicodeDecodeError → 全部显式 UTF-8
• CRLF 检出破坏 SVG 精确哈希契约 → .gitattributes 锁 LF（*.png 等二进制豁免）
• CI tests job 启用 PYTHONUTF8=1

验证

• 本地回归 98 tests + 15 subtests 全绿（pytest + unittest 双跑）
• validate_distribution 通过；sync-marketplaces scoped 三平台一致
• 线上冒烟双 VERIFIED（真实 ProcessOn MCP：tools/list + generate_diagram_dsl 写路径）

v0.2.7

CI 修复发版：使三平台测试矩阵全绿（取代 v0.2.6）。

相对 v0.2.6

• 修复 tests job 缺依赖：补装 PyYAML==6.0.3（validate_distribution 需要 import yaml；v0.2.6 的 skills-check 三平台腿红因即此，本地因全局 PyYAML 未暴露）
• 版本同步 0.2.6 → 0.2.7（manifest / marketplace ref / CDN 图标 @tag / README）

v0.2.6 起包含的全部内容

• 线上冒烟双 VERIFIED（真实 ProcessOn MCP）：initialize + tools/list + generate_diagram_dsl 写路径
• CI 三平台测试矩阵（ubuntu/windows/macos）
• 运行时文案宿主中立 + 回归测试锁定
• 测试版本断言派生化（不再硬编码版本字面量）
• 本地回归 98 tests + 15 subtests 全绿；sync-marketplaces 三平台一致性校验通过

v0.2.6

生产就绪补强发版。

验证（2026-09-23）

• 线上冒烟双 VERIFIED（真实 ProcessOn MCP）：只读 initialize + tools/list（protocol 2025-06-18，3 工具在列）；写路径 generate_diagram_dsl 返回正确 DSL，isError=false
• 本地回归 98 tests + 15 subtests 全绿（pytest 与 unittest 双跑一致）
• validate_distribution 通过；sync-marketplaces 三平台（Codex/ZCode/Kimi）校验通过

改进

• CI 新增三平台测试矩阵（ubuntu/windows/macos tests job；Windows/macOS 腿以 CI 首飞为准）
• 运行时文案宿主中立（不再硬编码 Codex）+ 回归测试 test_hidden_setup_output_is_host_neutral
• 测试版本断言派生化（test_manifest / test_docs 不再硬编码版本字面量）
• README 徽章修正（version 0.2.6、tests 98 passing）
• 多清单版本同步 0.2.5 → 0.2.6（含 marketplace source.ref 与 CDN 图标 @tag）
• 附带：CI 同步令牌按来源组织选用（c291d18）

ProcessOn Design v0.2.5

Full Changelog: v0.2.4...v0.2.5

ProcessOn Design 0.2.4

Cross-host maintenance release for Codex, ZCode, and Kimi.\n\n- Uses the canonical public repository identity.\n- Pins repository-local marketplace installation to v0.2.4.\n- Preserves host-specific Codex contracts without using Codex as the public product prefix.\n- Includes validated OpenSpec documentation and current distribution checks.

ProcessOn Design v0.2.3

Highlights

• Synchronizes the checksummed external skill snapshot to processon-skills v1.0.1.
• Locks the source release to peeled commit dc554f9956884c85427026024ac9e035af524d90.
• Keeps plugin-local skills outside the managed lock boundary.
• Preserves immutable tag + digest verification for future upgrades.

Verification

• Local online and offline vendor checks passed.
• Repository test suite passed.
• GitHub Actions succeeded at commit bd2ac850ce77275f20eb06de2695a9bb484ad93c.