Skip to content

v2.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 30 Sep 02:29
· 41 commits to main since this release
v2.0.0
94cbb04

v2.0.0 更新内容

2.0 大版本：引擎接口化 + 渲染管线三段式重构 + 技能拆分 + 编辑器操作 PowerPoint 化。四轮工程全部由回归守门（全量 23 套件、156 页黄金基线、契约测试、dep-graph 分层纪律），任何可见行为变化均逐页登记。

安装（2.0 起，推荐一键脚本）

Windows（PowerShell，无需管理员）：

irm https://raw.githubusercontent.com/Shingwha/open-pptd/main/install.ps1 | iex

Linux / macOS：

curl -fsSL https://raw.githubusercontent.com/Shingwha/open-pptd/main/install.sh | sh

装到 ~/.open-pptd 并写入用户级 PATH，open-pptd doctor 自检。AI 对话用法请配合技能仓 open-pptd-skill（纯 markdown，clone 到技能目录即可）。

破坏性变更

  • 仓库拆分：本仓不再是技能包——SKILL.md 与 references/ 迁至独立技能仓 open-pptd-skill；本仓 = 引擎 + 编辑器 + CLI。旧「clone 本仓到 skills 文件夹」用法请改按上面两步安装
  • 深路径降级：packages/model/... 等深路径 import 归入 ./internal/*（2.x 兼容、3.0 移除），对外请用 open-pptd/model 等包级入口与包根 contract.json
  • 渲染行为变更：文本不再因框小被裁剪（溢出由 check 几何告警暴露）；表格行高从 min 语义改为精确值；二者均已列入黄金基线白名单

新增

  • 一键安装：仓库根 install.ps1 / install.sh（SHA256 强制校验、幂等、--dry-run 干跑、-Version 锁版本），装到 ~/.open-pptd（OPEN_PPTD_HOME 可覆盖）
  • CLI 产品化：doctor / paths / assets list|sync|clean / ensure；serve --detach --json --stop --open（stdout 单行 JSON，agent 友好）；export 前置资源体检——自动按需补齐 deck 真正用到的字体（--offline / --strict / --json，软降级不阻断）
  • 可挂载编辑器：createEditor(rootEl, options)——可销毁、chrome 三档（full/minimal/shot）、dialogs 可注入、非交互装配供截图管线复用
  • 传输接缝：ProjectSource 契约（http / 目录句柄 / 内存三实现），读写不再硬编码端点；serve 模式能力标记注入，静态部署零失败请求
  • 主题注入：applyThemeTokens / defaultTokens(light|dark)，编辑器内置暗色板 + 宿主覆盖
  • 编辑器 PowerPoint 化：多选 / 框选 / Shift 加选 / Ctrl 切换 / Ctrl+A / Esc 分层 / Ctrl+拖动复制；键位重映射（Shift→多选、Alt→微调/等比）；对齐二义化（单选页面、多选选区）+ 分布 + 组合；右键上下文菜单三态；缩略条拖排序（可撤销）+ 页面多选；内部剪贴板；深浅色三态（含跟随系统）
  • 渲染管线三段式：measure（字体度量表纯函数排版度量）+ layout（LayoutTree 几何事实与越界/重叠检测）+ paintPage 纯绘制；156 页黄金基线 + 白名单机制守门
  • 图片导出统一：本地 headless 优先、foreignObject 逐元素体检回退——消灭静默白图
  • 发布资产五件套：runtime zip + 图标/字体资产包 + 安装脚本 + SHA256SUMS；技能仓独立发布并带 drift-guard 五项只读比对

改进

  • 接口化：8 个包级入口 + contract.json 双口径（契约测试守门）；editor 深路径清零；CONTRACT_VERSION = 2
  • 预览=导出再加固：writer 表格行高/行距与 measure 单源；颜色/主题一致性、公式 204 字节级对拍
  • 反补丁治理：设计令牌单一真相、选择/状态单一入口、DOM 访问统一、媒体单一接缝、headless 装配单源
  • 文档：中英双语 README、docs/embedding.md 下游契约、全仓注释英文化

修复

  • 单选选中框遮挡元素内容；拖动/旋转/缩放进行中选中框不实时跟随
  • scaleSvgPath Z 分支吞命令与 undefined 输出；httpSource.readMedia 潜在 404
  • group 类型注册告警与 check 误报；loader.js 撤销/重做 ReferenceError
  • 字体静默降级（导出结果如实转述 embedded/skipped）；图片导出静默白图（逐元素体检）
  • CI：measure 对拍在无字体环境自动 SKIP；公式产物等环境性失败澄清

Full Changelog: https://github.com/Shingwha/open-pptd/commits/v2.0.0

Assets 6
Loading