moda-deck-pptx

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

moda-deck-pptx

PREREQUISITE — load
moda-core
once per session (step-0, write contract, free/metered map). Already loaded? Skip ahead. If you cannot load it, the non-negotiables: run

moda doctor --json

before anything;

moda brand list

before creating; every write carries the latest revision — on

stale_revision

, re-read and retry once (it heals); send the canvas link the moment it exists; stuck or failed?

moda ask "<question>"

— free and fast, never guess.

前提条件——每个会话只需加载一次
moda-core
（步骤0，编写合约，免费/按使用量计费映射）。已加载？直接跳过。如果无法加载，必须执行以下操作：先运行

moda doctor --json

；创建前先运行

moda brand list

；每次写入操作都会携带最新版本——遇到

stale_revision

时，重新读取并重试一次即可解决；画布链接一生成就发送；遇到卡顿或失败？使用

moda ask "<question>"

——免费且快速，切勿自行猜测。

Sizes and defaults

尺寸与默认设置

Thing	Value	Notes
Import	`moda canvas import-pptx [file.pptx]`	FREE, un-billed, async — the verb polls to completion
Result	one canvas, one page per slide	slide size is preserved from the file
Round trip	`moda export … --format pptx`	native shapes and text layers, not screenshots
Data law	every source string and number survives verbatim	a cleanup that loses data is a failure

Import takes a local path or a durable

file_…

ref. Nothing is generated and nothing is charged; the import is the cheapest useful thing you can do with a deck someone hands you.

事项	值	说明
导入	`moda canvas import-pptx [file.pptx]`	免费、不计费、异步操作——该命令会轮询直至完成
结果	一个画布，每张幻灯片对应一个页面	幻灯片尺寸与原文件保持一致
往返导出	`moda export … --format pptx`	原生形状和文本图层，而非截图
数据规则	所有源字符串和数字均完整保留	丢失数据的清理操作视为失败

导入支持本地路径或持久化的

file_…

引用。此操作不会生成额外内容，也不收取费用；是处理他人交付的演示文稿时性价比最高的操作。

Recipe — import, then fix

操作流程——导入后修复

```
moda canvas import-pptx [deck.pptx]
```
— free, async, polls itself to completion (
```
--no-wait
```
returns a job id; re-poll with
```
moda canvas import-pptx --job [JOB_ID]
```
). Send the canvas link the MOMENT it exists.
```
moda canvas read [CANVAS_REF] --summary
```
— the page index and what landed on each slide.
```
moda canvas screenshot [CANVAS_REF] --page [IDS]
```
in ≤3-page batches, worst slides first. Judge with your own eyes; list the fixes before making any.
Fix smallest-change-first, one slide at a time:
```
moda canvas edit [CANVAS_REF] --file fix.js
```
for targeted property changes (references/edit-code.md);
```
moda canvas markup [CANVAS_REF] --file - --page [PAGE_ID] --mode replace --revision [REV]
```
to rebuild a slide outright (grammar: references/markup.md);
```
moda canvas delete-items [CANVAS_REF] [NODE_IDS]
```
for cruft. Data preservation is non-negotiable — restate every source string and number verbatim.
Re-theming to the team's kit?
```
moda canvas brand [CANVAS_REF] [KIT]
```
records the kit; the tokens still have to be authored into the slides (kit creation itself is moda-brand's job).
```
moda canvas screenshot [CANVAS_REF]
```
again and compare against your fix list.
Deliver the live link; export back only on a format word or an accepted offer:
```
moda export [CANVAS_REF] --format pptx -o [deck]-clean.pptx
```
.
Read the export warnings —
```
pptx_shape_rasterized
```
(an image baked in rather than editable) and
```
pptx_content_dropped
```
(an element missing entirely) name exactly what did not survive. Repair or disclose; never hand over a silently degraded deck.

```
moda canvas import-pptx [deck.pptx]
```
——免费、异步，会自动轮询直至完成（
```
--no-wait
```
参数会返回任务ID；可通过
```
moda canvas import-pptx --job [JOB_ID]
```
重新轮询）。画布链接一生成就立即发送。
```
moda canvas read [CANVAS_REF] --summary
```
——查看页面索引及每张幻灯片的内容。
```
moda canvas screenshot [CANVAS_REF] --page [IDS]
```
——每次最多处理3页，优先处理问题最严重的幻灯片。自行判断问题，列出修复项后再开始操作。
优先进行最小改动的修复，逐页处理：使用
```
moda canvas edit [CANVAS_REF] --file fix.js
```
进行针对性属性修改（参考references/edit-code.md）；使用
```
moda canvas markup [CANVAS_REF] --file - --page [PAGE_ID] --mode replace --revision [REV]
```
彻底重建幻灯片（语法参考references/markup.md）；使用
```
moda canvas delete-items [CANVAS_REF] [NODE_IDS]
```
清理冗余内容。必须严格保留数据——所有源字符串和数字均需完整重现。
要重新应用团队的品牌套件？使用
```
moda canvas brand [CANVAS_REF] [KIT]
```
绑定套件；仍需将品牌标记添加到幻灯片中（套件创建由moda-brand负责）。
再次运行
```
moda canvas screenshot [CANVAS_REF]
```
，与修复清单进行对比。
交付实时链接；仅在明确要求格式或获得许可后再导出：
```
moda export [CANVAS_REF] --format pptx -o [deck]-clean.pptx
```
。
务必查看导出警告——
```
pptx_shape_rasterized
```
（转为图片而非可编辑元素）和
```
pptx_content_dropped
```
（元素完全丢失）会明确指出未保留的内容。进行修复或告知用户；绝不能交付存在隐性损坏的演示文稿。

Examples

示例

"clean up this PowerPoint" → import, screenshot the worst slides, fix, export.
"put our brand on this deck" → import, bind the kit, re-author the tokens.
"what's actually in this deck?" → import +
```
read --summary
```
; no edits unasked.
"fix slide 7's chart" → import, then the targeted-edit step on that page only.
"build a NEW deck from this content" → moda-deck owns authoring from scratch.

"清理这份PowerPoint" → 导入，截取问题最严重的幻灯片，修复，导出。
"将我们的品牌应用到这份演示文稿" → 导入，绑定品牌套件，添加品牌标记。
"这份演示文稿里到底有什么内容？" → 导入 +
```
read --summary
```
；未经请求请勿编辑。
"修复第7页的图表" → 导入，然后针对该页面执行针对性编辑步骤。
"基于这份内容创建新演示文稿" → 由moda-deck负责从头创作。

Errors

错误处理

Any typed error → load moda-core and read its recovery reference. An import that fails or returns an empty canvas is a file problem, not a retry problem: say what happened, then

moda ask "<question>"

with the task error.

任何输入错误 → 加载moda-core并查看其恢复参考文档。导入失败或返回空画布属于文件问题，无需重试：说明情况，然后使用

moda ask "<question>"

并附上任务错误信息。

Make it recurring

实现常态化

The cleaned deck is the team's canonical starting point — flag it with

moda canvas template [CANVAS_REF]

via moda-templates, so the next deck starts there instead of from another crufty .pptx.

See also: moda-deck — authoring a deck from a brief, doc, or notes · moda-core — the contract, recovery, everything Moda can do.

清理后的演示文稿作为团队的标准起始模板——通过moda-templates使用

moda canvas template [CANVAS_REF]

标记为模板，这样后续的演示文稿就可以基于此创建，而非使用其他冗余的.pptx文件。

另请参阅：moda-deck — 根据简报、文档或笔记创作演示文稿 · moda-core — 合约、恢复及Moda的所有功能。

References

参考文档

Doc	Load when
references/deck-design.md	judging and rebuilding an imported slide
references/edit-code.md	before any targeted fix program
references/export.md	the pptx round trip and its warnings

文档	加载时机
references/deck-design.md	判断和重建导入的幻灯片时
references/edit-code.md	执行任何针对性修复程序前
references/export.md	进行pptx往返导出及查看警告时