v6.9.02026-11-08
本次更新围绕图转 PPTX、AI 生图与配音三块展开。图转新增 imageocr.py,可把页面 OCR 成可校对的文本块(行框、字号、墨色),再以原生文字叠加到去字底图上,并自动回检残留;imagelayers.py 支持图层配准、单色抠图与考虑遮挡的合并。整条流程不再绑定单一主机,任何支持参考图的视觉模型都能跑,去字默认走 OpenAI、图层默认走 Gemini,残留最多重试两次后转人工。image_gen.py 新增 --gif-frames,可基于 gpt-image-2.6 生成动图,同时修好了格式覆盖、限流退避与切图问题。配音接入 OpenAI Realtime。此外还有一轮安全修复:导出路径指向源文件会被直接拒绝,PDF/DOCX 转换保留更多版面细节,杜绝源文件被覆盖或静默改动。
v6.8.02026-10-30
图像
v6.7.32026-10-22
本次补丁版集中修复 PPTX 编辑与原生对象往返转换中的几处硬伤:平移端点落在未改动页面上的 Morph 配对不再抛出 KeyError,只补写所需的形状名;移动保留原始文本体的导入对象(如无法重建为公式的 Office Math)时,文本体会随位置一起恢复,不再被压成纯文本;图表与块公式在往返中重建后保留原 shape id,此前会因缺少动画目标而导出失败。原生图表与公式方面,新建或重建的图表不再与源包中恢复的图表撞名、静默覆盖数据;公式新增基于 SVG 预览的兜底,LibreOffice、WPS 等不支持 Office Math 的客户端也能正常显示,PowerPoint 仍走原生数学对象;主题色或半透明的 PPT Master 公式在导入时会被重建,而非降级成文本框。另修复了实时预览画布空白、保存写出 ns0: 前缀 SVG 的回归(仅 v6.7.2 之后的 main 分支)。图生 PPTX 的配置新增页面像素到 SVG 画布的几何映射,保证原生文字与形状和底图对齐。此外,pip install -r requirements.txt 在中文 Windows(GBK 环境)下不再报 UnicodeDecodeError;README 与定位文档明确列出会将数据发往本机之外的可选服务:图片生成、网络图片搜索、URL 导入与在线配音。
v6.7.22026-10-17
Patch release: fixes from an audit of the issue history. Most of them stop a tool from losing, overwriting or rewriting content while it reports success.
Installation and startup
- Skill-only installations create projects in your working folder again (703aa72f, #144). Since v6.3.0, project_manager.py init placed projects relative to the installed skill. For an npx skills or plugin installation, that meant .agents/projects/ or the plugin cache, where an update can replace them. Inside a repository checkout nothing changes.
- On Windows, a python3 that never starts (the WindowsApps stub exits 9009 with no output) is no longer treated as an integrity-guard failure; the agent retries with python first (e1b58732, follow-up on #142).
Source conversion and import
- PDF: removed four table rewrites that were written against one sample paper. They re-derived variable categories from hard-coded symbols, replaced headers, dropped rows and invented a correlation column. Extracted cells are now kept as extracted (3aa2ec62).
- HTML: pages are decoded by BOM and their charset declaration instead of forced UTF-8, so a <meta charset="gbk"> page no longer comes out as replacement characters. A guessed encoding is reported (34d88c1a).
- Web: pages with the same title in one batch get Report.md, Report_2.md instead of overwriting each other (e847939c). A raw .md URL whose code fence shows <body> stays Markdown instead of being reduced to the example (6a92c1fd).
- import-sources: .txt sources in GB18030 or other non-UTF-8 encodings are decoded instead of replaced (39b470fe). Markdown with the same text but different companion images (<stem>_files/) is no longer treated as a duplicate and deleted (104bc3c9).
- PPTX import: b="true" / i="true" now import as bold and italic, as "1" already did (8bdf440c). Page-type classification matches whole words, so "Qatar" or "Department" no longer reads as a Q&A or chapter page (c0ce2420).
Live preview editor
- Save All refuses to replay staged edits onto an SVG that changed after they were staged, keeping them staged with an error. Before, they landed on whichever element now sat at that position (05e627cb).
- User ids that start with edit are kept, and dy=".5"-style numbers are parsed correctly when a line is moved (264bd669).
Export, finalize and checker
- Proportional fonts such as Arial Unicode MS and Monotype Corsiva are no longer sized as monospace (c2668566).
- Icons and illustrations marked with single-quoted preserve-color or stroke='currentColor' keep their colors and style (05cf79cd, 0cdf8765).
- The checker no longer fails a slide whose visible text reads class=…, onload=… or @import …, or that carries a data-class attribute. Real class, event and CSS-import usage still fails (8f00128e, 923a5360).
Images, narration and video
- Manifest images named like hero.v2.png no longer overwrite hero.png (e9676c5a).
- Image search ranks by whole words: required "Iran" no longer accepts "Tirana", and the transit penalty no longer hits "business" or "trail" (d4ac79df, b827c5ce).
- Page subtitles and notes follow numeric slide order past slide 9 and slide 99 (1036fd53). Narration keeps lines such as #1 revenue grew and skips only real Markdown headings (06008e8e).
Docs
- The FAQ no longer promises pixel-identical charts in Keynote, LibreOffice and WPS; Microsoft PowerPoint is the validation target (ac16c041).
v6.7.12026-10-16
这是个补丁版本,重点堵住两类数据丢失,外加一轮全语言文案校对。
实时预览:未应用的标注和直接编辑此前只存在服务器内存,空闲超时、退出预览、--shutdown、进程被杀都会让它们无声消失;合盖休眠尤其危险,空闲计时照走,唤醒即退出。现在每次暂存改动都先落盘到 livepreview/draft.json,下次启动自动恢复并在界面列出,何时应用仍由你决定。期间被改动过的 SVG 不再重放,草稿转存为 livepreview/draftconflict<时间戳>.json 并在界面提示;退出预览改为保留草稿而非丢弃。应用改动时,若标注元素已不存在,该页保持暂存,不再直接丢掉标注。
源转换与导入:不带 -o 的批量转换不再让同名输入(budget.xlsx 与 budget.xlsm)互相覆盖 Markdown 却报成功;import-sources 会为同名源分配不同的归档名;笔记本输出图片改存 <output-stem>_files/,并排转换不再互踩图片。
文案方面,简中、繁中与日文界面的确认、规格审阅和实时预览页面修正了误译、过时字符串与术语不一致,并清理了无人读取的翻译键。
v6.7.02026-10-08
小版本更新:新增 design_spec.md 的浏览器审阅页,按章节与幻灯片分页,可直接改写单个 Markdown 块——以字节范围精确替换并校验哈希,批注另存旁挂文件、不污染规格本身,审核仍留在对话中完成。
图像生成默认模型换成 Google 的 Nano Banana 2.1(gemini-nano-banana-2.1),Gemini、OpenRouter、fal 三条后端同步生效;.env 里写死旧模型时仍以你的配置为准。该模型不支持 512px,请求发出前即被拒绝。OpenAI 侧 GPT Image 系列接受透明背景,gpt-image-2.5 各变体开放 xhigh|max 质量档。
转换器不再静默丢内容:DOCX、PPTX、Excel 与网页此前会无声吞掉嵌套表格、尾注、隐藏工作表、合并单元格等,现已修复;pdftomd 也不再把与页眉页脚重复的正文一并删去。PPTX 与 SVG 的文本往返改用共享字体度量,溢出文本按 DrawingML 默认行为保留每一行。
v6.6.02026-09-19
Minor release from three days of end-to-end runs since v6.5.0: every route was driven through real decks — same-deck hyperlink navigation, Beautify under Quick, Edit Native with pages dropped and with a foreign PPTX used as a template, Create Brand / Layout / Style followed by Generate, four of the bundled Layout templates, the visual-review stage, EPUB and RST sources, a bilingual deck, and decks in Chinese, English, German, Spanish, Portuguese and Vietnamese. Every change below is backed by a reproduced defect or a documented contract gap; no route was added or removed.
Bundled Layout templates
- editorialbleed fades now protect their own text slots.** The six text-over-image gradients reached only 0.12–0.35 alpha under the title, caption and body slots they exist to protect (the first visual-review run measured 1.2–2.5:1 contrast on a deck that moved no slot). Each gains a middle stop that holds at least 0.60 through its slot and falls away only past it (012a54f5).
- presentationcore, presentationcore43 and reportcore table and chart prototypes pass native parity. Each library shipped eight "blocks --native-charts-and-tables export" warnings that a deck copying the prototype metadata inherited; the payloads now carry the row heights, header alignment, band-row fills and bold-cell colour their fallbacks draw (7599c78e).
- A slot's bounds are capacity, not a whitespace quota: the structure interface now says what to do when content under-fills a slot, and that a Morph pair on a structured page is a Slide-local group decided before the first page — stated for template authors, planners and executors alike (b526e82e, b431e1b9, e1ab6661, 9ce704c6).
Edit Native PPTX
- Imported text matches what PowerPoint renders. a:normAutofit fontScale / lnSpcReduction now reach the emitted font size and line height — a 60 pt box shrunk to 25 % used to import at 80 px and fail the frame gate on any edit — and a run with no typeface anywhere in its chain takes the theme's minor Latin / East Asian pair instead of a bare sans-serif, which exported every edited run as Segoe UI (f4ab81fb).
- The round-trip checker admits an edit that reaches no further than the source text of its own slot, and refuses absolute-y rows inside a semantic shape, which previously passed the gate and then crashed export (f4ab81fb).
- Dropping pages from a deck with same-deck links: export lists every slide whose jumps leave the page plan in one pass instead of one per run, prints its receipt only after the package is written, and the workflow documents how to retarget a jump (92901494, 658ebf2d).
- New elements may be native-marked charts and tables; the boundary section now says so (29770a2b).
Export and checker
- --kiosk writes a looping, self-running kiosk show and names the export accordingly (067cb13c, 92901494).
- Hyperlinks: the checker compares each page's anchors with its design_spec §IX Hyperlinks line; a bare <a> around one top-level group is transparent for animation and grouping (b7d0114e, 48238f99, d4c59f1c).
- Icon references keep their fill local under compact authoring — embed_icons reads no inherited paint, so the canonical-authoring advisory contradicted the executor's hard rule (aa5cf55f).
- A stroked rect on a table's outer bounds counts as its frame in the border-topology check; the typed chart/table slot tip now says the standard export fails and names the Slide-local alternative (7599c78e).
- Structure-contract errors on a template page now say that fills, strokes and gradients may be repainted — only ids, order, geometry and data-pptx-* metadata are contract — and a text overflow inside a Layout slot no longer advises expanding the slot's bounds (4a28573c, ca15a6ad).
- --template-mode reports the roster contract beside a Brand or Style spec in a shared workspace (aa5cf55f); beautifyinventory --verify checks every frozen source string against an exported deck (7e0ea2bf); pptxintake reports grouped shapes in slide space (9e0c2468).
Text measurement
- The bundled advance table grows from five families to ten: Cambria, Trebuchet MS, Garamond and Tahoma join Arial, Times New Roman, Georgia, Verdana and Calibri; Segoe UI is measured from Selawik, Microsoft's OFL metric-compatible replacement (d874fb12, 3214e29a).
- Accented letters outside the table advance like their base letter. Vietnamese, Turkish, Polish and Czech precomposed letters used to fall into the 0.55 em default tier — Ổ 27 % narrow, Ị 83 % wide (c050b1fa).
- Unicode fixed-width spaces are sized by definition (70705ebf).
Sources, images and tools
- webtomd validates the host the client actually connects to and pins connections to the validated addresses (3b45af2c).
- slice_images --strict-alpha retries once with the measured tolerance when every finding is key noise (d475c0a7); several opaque photos for a multi-cell layout may share one generated sheet sliced by grid.
- import-sources removes a moved duplicate instead of announcing a move that never happened (7599c78e); animationconfig refuses a file path where a project directory is expected (df118dad); visualreview.py --pages takes comma lists (012a54f5); image_search keeps the caller's provider pin (1b57b01e).
Workflow and prompts
- Visual review may deepen a fade that already sits under the text, defers a soft hit that recurs deck-wide to one decision by the aggregating agent, and names the parallel-subagent host form (b431e1b9).
- Create Template: standard reads enough Slides to settle direction while fidelity reads all; a Layout carries one neutral Latin face; a brand manual's usage rules sit under the section they govern; a long PDF reference is sampled by page situation (9ce704c6, 5dd4c34a).
- Quick: template prototypes and the first-page deck language are read from the roster; a book-length source is read by heading index; the installed spec is the re-readable truth for a lockless run (05ad6264, adb9faf0, e1ab6661, 5dd4c34a).
- Number, quotation and unit conventions follow each content language; narration reads bilingual notes twice; delegation skips the confirmation page, not the three solution intents (7c4543b2, e2aff570, b431e1b9).
Examples
Five decks joined the examples site in this cycle, among them the first on the editorialbleed and storyvertical Layout templates, the first from an EPUB source, and the first with native same-deck hyperlinks.
v6.5.02026-09-16
Minor release from two focused rounds since v6.4.0: the Create Template / use-template flow was audited and reworked, and the Edit Native PPTX route was exercised on real government and university decks (multi-master, source animations, native charts, SmartArt, narration, revision rounds) and fixed wherever it broke. Every change is backed by a reproduced defect or a documented contract gap; no route was added or removed.
Edit Native PPTX (round-trip import → edit → export)
- Decks that could not be exported at all now export: a built-in layout no slide uses with a collapsed <a:ext cx="0" cy="0"/> placeholder no longer fails the native structure contract, and an untouched page holding a full-canvas picture no longer loses that picture to background promotion when narration forces a rebuild (65091298).
- Motion overlays diff against the import baseline field by field: a sidecar row that omits transition keeps the source transition even though the importer writes defaults.transition: none; animation.effect: none really removes the source timing; -t and effect-only rows keep the source advClick / advTm; a user-edited default is a deck-wide request (a7cb7767).
- Narration injects into a slide whose timing tree is a bare tmRoot, blocks on natively preserved click animations with the output stem, source slide and shape ids named, replaces its own earlier audio instead of stacking a second autoplay track, matches imported audio to output pages through the manifest, and reuses its media name across re-recordings (a7cb7767, b560f85b).
- Fidelity: same-deck links on rebuilt objects keep their source destination through text edits, page plans and adoption; Master/Layout refs refuse edits instead of vanishing while the original keeps rendering; ancestor transform / opacity / inherited style join the source-ref diff so a moved wrapper actually moves; a paint-only edit keeps the native text body (auto-numbering, autofit, fields, language); custom-show selections and actions close after a page plan; SmartArt, OLE and other unsupported graphic frames carry the atomic proxy marker the route always promised (57f76234).
- Notes: a new note for one page no longer overwrites another page's notes part; round-trip workspaces match notes by exact stem and print the real count; --no-notes removes every notes part, master, relationship and override; imports write notes/<stem>.md only (73bc51a3, b560f85b).
- Packages: replaced chart parts, workbooks and slide relationships the slide XML never used are pruned on edited round-trip pages and on every generated slide (structured export left the promoted master background registered on each slide); the delivery check counts slides, notes, masters and layouts by content type, reports dangling custom-show references as errors and unreferenced slide relationships as advisories (57f76234).
- Quality gate: svgqualitychecker.py --roundtrip --json writes to validation/ and shares its fingerprint with the exporter, so a round-trip export can report quality_gate=passed; the checker measures imported lines / paragraphs text row by row, stops re-estimating source text that only moved vertically, enforces the exporter's one-text semantic-shape contract early, and warns when an edited page rewrites a table the importer could not carry natively (73bc51a3, 65091298).
- Route documentation states the identity boundary, both imported text models, what skipping --native-charts-and-tables really ships, the notes consumer contract, the spid → shape-<id> mapping, retention of every Master/Layout under a page plan, --primary-language, and a revision-round paragraph (52a2801c, 5581c851).
Create Template and template consumption
- Installation is staged with rollback and a machine receipt (template_install.json); the Confirm UI freezes selected-root snapshots, accepts several explicit roots, binds stages by content and verifies the installation itself — the handoff sidecar and its two commands are gone (6de79399, f58f846b).
- Type A mirror is a pure tool path: zero-edit import → materialize → checker → preview with a factual spec skeleton; the Type B promise is withdrawn (f58f846b).
- Template mode checks carrier baselines against slot bounds, mirror text targets, and offers an advisory --slot-capacity-report; translucent full-canvas rects are not backgrounds; CJK literal font names never occupy the Latin slot; layout-fixed atoms leave the sparse display-size quota; three bundled deck templates gained taller chapter-number slots (be808929, f58f846b).
- Structured export keeps custom placeholder faces, re-skins master backgrounds from public pages, compiles typed chart/table slots natively in previews, rejects placeholder slots as Morph endpoints at validate, and compiles zero-padded page numbers to slide-number fields (6de79399, 6e3ce9c5).
- Prompts: Stage 1 keeps the goal rather than blacking out template facts; Create Template gains a prototype review round; slot fit is checked before the typography lock; Quick names the typed-slot export flag; import-sources --no-image-propagation keeps reference bitmaps out of images/ (6627d92b, f58f846b, 6e3ce9c5).
Tooling
- notestoaudio.py accepts --rate -5% (and --pitch / --volume, now passed to edge-tts) with a space or = (73bc51a3).
- Test subprocess output decodes as UTF-8 regardless of the parent locale; the first svg_output page is closed deterministically when its root language is read (7879bbc8, c6ae4896).
- .env.example documents sponsor relay shortcuts (b44cdfac).
Install
Load skills/ppt-master/ as a skill (the attached ppt-master-skill-v6.5.0.zip contains only that directory) or install the plugin from the repository's marketplace.
v6.4.02026-09-12
Minor release collecting a week of fixes found by running the pipeline end to end across languages, input types, deck lengths, and a revision round on a delivered deck. Every change is backed by a reproduced defect; no route, gate, or command was added or removed.
Converter (sourcetomd.py)
- PDF tables with partial ruling keep the columns drawn outside the ruled box (059119ab); spreadsheet notes above the header become a quote instead of a phantom row; a scanned PDF and an out-of-order Arabic text layer are warned about (6c372a29, b3073f8f).
- Web fetch keeps the declared charset under a lossy decode and warns when only a sliver of the page body was extracted (95e3c41b); web tables keep their links and land on a GFM grid (17d953ad, 0ae80b19); document URLs route to their converter and honour --no-images and meta refresh (0b593d6d, 25a9984e).
- DOCX charts, table footnotes, and absolute chart targets survive conversion (22da436d, 4bbf7b71); PPTX read-back keeps soft line breaks (c71d9e73).
- Safety: every redirect hop is validated before it is requested, and CGNAT and multicast targets are refused (4bbf7b71).
- -o on a single input names the Markdown file and says so; --json keeps stdout to JSON.
Text measurement and multilingual decks
- Width calibration runs per planned script (Thai, Devanagari, Arabic, …) and at bold weight; Indic vowel signs advance the estimator; wrapping keeps words whole in every space-delimited script and breaks Korean between words (8900e87c, e64a2b38, 88fb8221, 0ae80b19).
- Indic, Thai, Arabic, and Japanese faces are on the PPT-safe list; Japanese decks get EA faces and kinsoku; right-to-left decks get RTL defaults; explicit BCP-47 scripts pick the theme script slot (0609875d, 5771f4f0).
- Latin runs inside a non-Latin deck proof as English (f76d1ecb). Quick decks declare their language on the page root and the export derives theme fonts from the pages (0b06d190).
Native charts and tables
- Table parity compares runs by effective style and lets explicit run colour and weight override the cell default (451c6814, aee33e5a); parity reads inherited text-anchor and tspan colour (5771f4f0).
- series[].line_style is rejected with a clear error and passes only inside a combo; Cambria Math is accepted; JSON CDATA survives compaction; classic axes are refused on ChartEx charts; data-label points follow their show flags (4a7512ec, 83d8d00f, 25a9984e).
- Fallback stamping reports a malformed page instead of skipping the valid ones; preset atoms keep their paint through style compaction (7acddfb9, 6881d370).
Export and motion
- Morph candidates are planned and authored whether or not animation is enabled (1fb122b6); exported objects are named after their SVG id (a849c498); structured decks animate slot groups and re-skin master atoms (529403b3).
- MiniMax word timings that share one original-text span merge into one subtitle; written-out numbers stay whole (96742ffb, 7086c45c).
Quality gate
- The final gate compares the designspec §IX roster with svgoutput/, so a page dropped or left un-planned during a revision no longer passes silently (191f4629).
- The carrier receipt counts pages whose §IX Relationships line names a carried relation; the unresolved-geometry warning names the tspan rule; text picture fills count as image placements (95e3c41b, ed171577).
Workflow
- A delivered project's revision has a named entry: routing.md sends it to a Revision Round section in generate-pptx.md (Default) or a revision note in quick-generate.md (Quick), covering which layer owns each kind of change, what a roster change renumbers, and which commands rerun (77c27457, 4d551728).
- User-supplied images with licence terms register in image_sources.json so their credits are bound at the gate; research fetches pass --no-images (8e5e30a7).
- update_spec.py docs state what a colour change still edits by hand and when to re-stamp fallbacks.
Preview
- Preview URLs open in the Windows browser under WSL (#287, thanks @zhuoyi780-alt).
Install
The ppt-master-skill-v6.4.0.zip asset contains only skills/ppt-master/ for agents that load the skill directory directly.
v6.3.22026-09-10
v6.3.2 是 v6.3.1 安全报告的后续补丁,共修复五项,均由报告人 Zick Sun 复核确认。
预览消毒器收紧了规则:sanitizeSvg() 改为白名单机制,堵住空命名空间元素绕过、以及 SVG 元素伪装成 div/iframe 被 innerHTML 活化两个漏洞;href 值在做协议检查前先剥离制表符、回车、换行和前导控制字符,与浏览器解析行为对齐。此前 v6.3.1 带的 CSP 仍能挡住这两处,但该头依赖性更强,值得单独补上。本地预览与 Confirm UI 服务器新增 DNS 重绑定防护,Host 不是回环地址、或 Origin 存在且非回环的请求一律 403。
webtomd.py 默认开启 TLS 证书校验(自签名环境可用 --insecure),并拒绝抓取非公网地址——此前重定向可被导向内网或云元数据端点,现在请求与最终 URL 都必须解析到公网 IP,内网场景需显式加 --allow-private-hosts。
其余改动:文本排版按脚本分段预留宽度、中文分句加界;slice_images 的边缘噪点命名更明确;第 6 步检查点与 P05 早期闸门对齐;文档补充了 PyMuPDF 的 AGPL-3.0 许可与仅支持 PDF 的说明。安装包 ppt-master-skill-v6.3.2.zip 只含 skills/ppt-master/,供直接加载技能目录的 agent 使用。