Presentation Speaker Notes 1.0.0
发布日期：2026-07-16
发布结论
Version 1.0.0 是首个稳定发布版。它将 PPTX 文件处理、整套演示理解、逐页讲稿生成、Speaker Style Engine、质量审查、Notes Slide 写入和重新打开验证收敛为一个可复用的 Codex Skill 与 Python CLI。
本版本的“稳定”指工程合同和安全边界稳定，不代表任何模型输出无需人工复核。真实语义质量仍取决于所选模型、输入页面可读性和用户给出的内容边界；医疗、法律、财务和合规材料仍需要领域人员审核。
1.0 稳定合同
- 永不覆盖输入 PPTX；每次运行创建独立项目和源文件副本。
- 先完成整套与章节分析，再生成逐页讲稿。
- 每页使用 Schema 校验的 Slide Brief，并保留证据、置信度和风险来源。
- PowerPoint 备注区默认严格等于最终
main_script，不写入时间、备用稿、提示、转场元数据、provider 状态、诊断或待复核信息。 - 正式交付默认使用
replace；merge仅作为显式编辑协作模式。 - offline provider 只能生成
engineering-preview/*_NON_DELIVERABLE.pptx。 - 正式
delivery必须通过真实语义审查、口语清洁度、时长和高风险事实门禁。 - 导出后重新打开 PPTX，验证源文件哈希、页数、页面顺序、Slide XML、关系、受保护部件、Notes 拓扑和备注正文。
核心能力
- 9 个 CLI 子命令：
inspect、render、analyze、generate、retry、inject、validate、style、run。 verbatim、outline、hybrid三种讲稿模式。- 主讲稿、可选扩展稿、压缩稿三层脚本。
- 10 个表达维度、10 个风格预设、可编辑的自然语言风格解析结果。
- 按页面类型、章节、单页和内容安全进行风格覆盖。
strict、explanatory、research_enhanced三种内容边界。- 指定页面和指定章节的局部重试，以及完整的缓存/恢复指纹。
- 对医疗、安全、疗效、适应证、剂量、禁忌和不可读证据的阻断式审查。
- 对目录页、章节页、数据页、流程页、风险页、总结页等页面类型进行差异化处理。
1.0 前的关键修正
- 修正了把内部工作台内容整体写入 PowerPoint 备注的问题。
- 修正了目录页被“风险提示”等目录项误分类为风险页的问题。
- 移除了
01、02等版式编号和重复模板连接词进入口语稿的路径。 - 增加跨页机械表达、内部脚手架和裸编号检测。
- 增加
delivery与engineering_test的不可混淆产物合同。 - 修正工程预览活动产物路径、恢复缓存和验证阶段的追踪边界。
- 修正合法 OPC Relationship 节点重排被误判为页面结构变化的问题。
- 改进东亚文字渲染降级的识别、语义辅助图和保守覆盖策略。
验证证据
- 自动化测试：170 项，覆盖单元、集成、端到端和发布包内容。
- Skill 结构：使用官方
quick_validate.py校验。 - 真实 ZEISS 25 页 PPTX：完成离线工程链路、Notes 精确投影和包级重新打开验证。
- 第 2 页：识别为
agenda/内容导览，分配 45 秒，不朗读导航编号，不生成默认互动。 - 25/25 Notes 与逐页
main_script精确一致，未发现内部字段或工程诊断泄漏。 - offline 正式交付门禁已在真实 PPTX 和自动化测试中验证会阻止导出。
当前环境没有用于发布验收的真实模型凭据，因此没有把 offline 文案质量描述为真实模型质量。1.0 的可信边界是：工程链路、数据合同、文件安全和交付门禁已验证；模型语义质量必须在实际凭据、实际演示材料和目标听众条件下继续验收。
安装与使用
安装 wheel：
python -m pip install presentation_speaker_notes-1.0.0-py3-none-any.whl
presentation-notes --version
presentation-notes --help安装 Skill 压缩包：
- 解压
presentation-speaker-notes-1.0.0-skill.zip。 - 将其中的
presentation-speaker-notes/放入 Codex Skills 目录。 - 在该目录安装 Python 包及依赖，或安装同时交付的 wheel。
- 在 Codex 中使用
$presentation-speaker-notes并附上.pptx。
完整中文说明见 USER-GUIDE.zh-CN.md。
已知边界
- 只支持
.pptx，不支持旧.ppt、加密或损坏文件。 - SmartArt、动画顺序、嵌入对象、视频、音频、公式和截图文字可能无法完整提取。
- LibreOffice 和本机字体会影响渲染，PowerPoint 演讲者模式仍应人工打开确认。
research_enhanced不代表自动联网检索；外部来源必须显式提供、允许并核验。- 风格匹配分数是工程指标，不是听众研究，也不代表自动学习到个人声音。
- 本项目没有附带开源许可证；分发和再授权范围由项目所有者另行决定。