# 版本变化

## 0.9.2

本地源码修订。对外部模板声明的 `slide-number` 占位符，按真实导出顺序初始化缓存，并验证每页均为原生 `slidenum` 字段、不是静态数字；复制版式的固定字段载体以兼容旧完整页面源，补齐字段唯一ID。可移动工程准备器同步携带该包装模块；上游280份编译器源保持。

目录行为与交接说明沿用0.9.1，不增加入口接口或改变展开逻辑。模板素材、数值与布局仍由外部模板维护，未修改结构Skill。发布与受管安装另行进行。

## 0.9.1

本地源码配套版，在制作交接中明确消费外部模板的章／小节目录接口：唯一目录全部展开或全部收起，逐节目录覆盖章与小节入口、仅展开当前章，以稳定父子ID高亮目标。沿用模板固定几何及容量错误，不隐式缩字、丢小节或分页；重合入口在报告真实页序中合并。具体组织素材、字号与渲染器保留在独立模板。

模板提供共享页眉工具时，带导航内容页统一经该入口生成，按模板容量区分目录全名与显式页眉短名。当前章／小节以稳定ID选择，导航上行保持原报告语义；短名不改变竖线或主标题位置，超长主标题显式选择双行版式，不自动缩字、调字距或截断。冻结页面库在消费副本中先适配当前页眉，原始source与preview保持；无导航版式不额外增加页眉。

仅修改制作说明及版本，不改编译器、数学或生产脚本，不改结构Skill。本版未打包、提交、推送或安装；既有0.9.0的发布及受管安装来源保持。

## 0.9.0

本地源码配套版，对接 `report-structure@0.4.0` 的轻格式逐页讲解 PDF、可编辑正文源和执行选择。制作从正文源接收文本、公式、必需图示与依赖，保留屏幕内容和讲者分析的区别；按稳定页 ID 对应，不要求反向解析 PDF，也不依赖安装结构 Skill。

审阅／复核分工、逐页或授权分块、ImageGen 范围／预算及替代方式一次确认后沿用；拒绝工具不自动选择另一 Agent 或沟通方式。启用 ImageGen 时以真实所选模板／theme 画面作参考，先沟通粗布局，再按反馈实现获准页；偏好在现有工程记录中注明确认和适用范围，不另建数据库。

明确所有文本与视觉服务报告、章节和页面目标。修改后按已确认配置进行独立复核，输入保留充分原始依据，排除作者自评、预期结论和引导说明；先独立判断再核对旧问题，实质再修改只复核受影响范围。主 Agent 自查或跳过保留实际标签。

本版只修订说明文档和新增执行／复核参考，不改变编译 schema、生产脚本、模板、固定间距、字体或数学实现；未安装、签名或推送。

## 0.8.0

本地源码交付版，与独立 `report-structure@0.2.0` 联动；未在本次源码打包中提交、推送或安装。内容交接接收最终信息、必要前提、页内推进、关键步骤及结论与依据的视觉对应，沿用普通方案和稳定页 ID，不引入新 schema、硬依赖或逐页时间必填项。

制作规则落实比较口径、实际关系、证据保真和修订后的内容同步。明确禁止 HTML／DOM／CSS 页面排版及截图、打印、转换绕行，HTML 仅可承载 JavaScript 可视化及必要运行容器。保留来源、范围、口径和引用小字，必要条件与解释进入相关主体；先修正正文，删除无助于理解的预防性辩解，具体警示适度保留。选图建议与七类原生图表的实际支持范围分开说明。

本版只调整说明文档；生产脚本、编译器、模板、字体、固定间距和数学实现沿用既有版本。公式兼容性排查的现有记录继续保留，不将本版联动说明作为新公式修复或应用验收。

## 0.8.0-preview.1

本地源码候选，尚未发布或安装。报告逻辑、章节关系、页序和逐页内容分配拆分至独立report-structure Skill；C01／C03改为接收内容方案与反馈内容问题，新增不依赖另一Skill的内容交接说明。结构实例及规则由新Skill维护，制作方保留内容真实性、必要解释可见性与独立制作能力。模板、编译器、原生对象接口、字体和固定间距保持。

## 0.7.4

为公式所在DrawingML段落的defRPr和endParaRPr补齐外部声明的数学字体、字号与颜色，并保持普通文字fallback的正确子元素次序。修复PowerPoint for Mac可能出现的根号过短、矩阵与嵌套分式括号在本地PDF中过小的问题。接口、公式语义、默认字体来源、原生类型与上游快照保持；数学验证文档增加段落默认属性及保存重开检查。

## 0.7.3

将C21／C22进一步固定：spacing属于外部template与共享recipe，内容调用者不提供数字、阈值、偏移或临时变体。`resolve_spacing`按role路径读取唯一数值；`check_spacing(...,style=...)`只接受role，精确核对间隔与四侧padding，过小／过大均拒绝。多段文字自动记录固定padding和paragraph关系；空白可用区不要求文字填满。旧template可按既有固定字段读取，不猜新数字。

包含preview.1／preview.2的文字角色、C20段落、共享多段文本与Office Math能力。运行库仍为既有9项，上游280个原文件保持；新增模块随源码工程复制。数学字体在外部template／工程声明，实际应用渲染、公式编辑、投影和其他设备验收分别报告。

## 0.7.3-preview.2

新增C21—C23：检查内容净距与内边距，使用适当而不特别宽的间距；独立控制段间距，保留语义段落；数学使用显式声明的专用字体并核对公式对象类型。`text_block.py`按完整段落数组、模板已有padding／paragraph_gap和文字角色共享排版，`layout_spacing.py`核对显式方向间隔与四侧内边距；不猜所有对象的语义关系，也不以几何无重叠替代视觉通过。

`math_component.py`新增结构化表达式到Office Math接口：分式、根式、上下标、定界、求和／积分及矩阵，原生包装器保留数学字体、字号与颜色。上游280文件保持原样，依赖仍为既有9项。源SVG与兼容分支是线性文字，不是复杂公式效果图；尚非通用LaTeX或段内混排解析器。可移动工程准备器同步包含数学、文字角色、段落和间距模块。字体与应用验收单独声明。

## 0.7.3-preview.1

本地候选，尚未发布。统一基本组件、分组表格与图表的文字角色解析，分别读取角色对应的字体、字号、字重和行高，避免只换字号而继续使用同一个字体。指标的数值与单位保留各自角色；RUC当前默认基本组件和表格几何不变。

按用户明确要求新增C20通用排版硬约束：段落遵守标点避头尾，任何一行（含末行）不得出现单字、单字加标点或标点包围单字成行。通过共享段落实现重排全部内容，不拆成独立行文本框，也不删字、添字、缩字或手动移动标点。新增可由实际字体测量驱动的纯文本换行与逐行检查助手；实际应用的再次换行仍需核对。

图表标题使用label与accent2，单位／轴／图例保留显式图表文字配置，来源使用辅助颜色dk2；按角色行高预留文字空间，容量不足时报错。原生Chart轴只支持常规字重，要求其他字重时拒绝；无轴的pie／doughnut独立文字可保留加粗。页面库文档明确设计参考可用性与共享排版实现是不同证据。

## 0.7.2

增加C16—C19文字与容器硬约束：段落优先单个原生文本框，必要拆分保持完整内容、整体边界和统一排版的逻辑文本块；小号灰字不得承载实质解释、关键条件／时机、结论或影响解释的限定；不同文字角色通过字号、字重和／或颜色区分；同类容器共用内部排版实现，禁止逐例手动摆放文字和图标。补齐SVG到PPTX的段落结构检查、组件使用、重建和按页协作的执行说明；不将导出成功视为语义或应用验收。

修复主题整理步骤按字体族默认字重覆盖已解析行内字重的问题，保留正文显式加粗和标题显式常规字重；按编译器语义补全实际run的常规字重，字体族默认仅补充缺失的默认文字样式，不再抹去作者声明的层级。上游编译器快照不变。

## 0.7.1

新增仓库根 README、安装与使用说明，以及标准库本地安装器。支持独立 Git 服务、显式目标、保留备份的升级、精确运行库检查和 Codex 嵌套署名入口排除。template 与 theme 继续独立提供；不预设组织或模板。

## 0.7.0

整合已审阅的图表与分组表格，以及 C01—C15 全流程生产规则。支持七类原生图表、简表和分组表格、指标、时间线与线性流程。所有来源的图标遵循整体或局部 palette／fixed／structural 上色规范。

## 0.6.0

增加外部模板页面库消费与按页协作接口。参考包含设计思路、实现方法、源码、素材和预览；兼容无页面库的旧模板，不自动扩大批量制作授权。

## 0.5.0

内置完整逐页设计、素材、重建、原生导出和 PowerPoint 审阅指导，以及未修改的 280 文件 MIT 编译器快照。独立提供运行库依赖和来源清单，无其他已安装 Skill 依赖。

## 0.4.0

增加 `ppt-project/v1`：分别锁定模板和作者输入，保存稳定页 ID、源码、数据、讲稿、素材、依赖、构建入口和源码包。