YAML DSL 升级指南¶

本目录按“变更批次”记录 YAML DSL 的 breaking changes、语义收敛点与迁移方式。

说明:

• 升级指南 SSOT 仅维护在 agentdev/skills/scalim-yaml-dsl/references/upgrades/。
• docs-site 不再生成升级页副本；本页仅提供到 SSOT 的链接索引(运行 just gen-docs 更新索引区块)。
• 非 breaking 的版本亮点（如 0.10 默认性能行为 / opt-in）不在本索引：见 版本亮点 / 0.10.0 重点特性。

升级清单:

• 2026-03-10: yaml-field-extract
• 2026-03-10: yaml-source-normalize
• 2026-03-11: yaml-params-template
• 2026-03-13: demand-dsl-breaking
• 2026-03-13: derived-outputs-set-aggregations
• 2026-03-13: yaml-dsl-outputs
• 2026-03-13: yaml-reuse-workflow
• 2026-03-13: yaml-source-normalize-shapes
• 2026-03-14: yaml-dsl-output-fields-alias
• 2026-03-16: yaml-dsl-outputs-aggregate-fields
• 2026-03-18: yaml-workflow-dag-ctx-resources
• 2026-04-07: yaml-dsl-import-roots-registry
• 2026-04-08: yaml-dsl-api-naming-alignment
• 2026-07-12: book-write-policy-python-ssot
• 2026-07-13: normalize-xlsx-book-ir-path-presence
• 2026-07-13: unified-xlsx-book-kind
• 2026-07-18 — ISink.discard 显式失败清理合约
• 2026-07-18 — tabular bus object + sink accept / opt-in precheck
• 2026-07-20: remove-deprecated-xlsx-file-memory-kinds
• 2026-07-24: remove-derived-outputs-cardinality-guardrails
• 2026-07-24: remove-score-by-rank-builtin
• 2026-07-28: remove-book-budget-policy
• 2026-07-28: remove-dedup-and-two-stage-derived
• 2026-08-09 — YAML lookup_chunk_size → Python LookupChunking（c40）
• Upgrade: OutputWriteLayout（Python 写出布局 SSOT）
• 2026-08-18 — 图边存 source_id，策略只住目录（c50）
• 2026-09-08 — Python floor 3.10 + YAML 去 vendor + scalim.vendor 退役（0.20.0 统一发布）