@dsh-external/dsh-ppt-studio — PPT 工作室（v1.0.0）

在 DeepSeek Harness 上做一个 PPT 的完整工作区：DSH 里说需求 → 插件做 PPT → 可验证地交付。配套 agent preset「PPT 工作室」（= standard 全量功能 + 本插件行），四类任务（从头 / 补完 / 修改 / 总结）共用同一个 PPTD 中间层，质量由「数字门禁 + 视觉审阅 + 真渲染复核」三轨保证。

新手不用读完本文档：进入 PPT 工作室后直接说需求（如"帮我做一个 10 页的年度总结 PPT"），工作流会引导你；语法细节问模型即可（模型内置本手册 skill —— 你可以直接问"expectedOverlaps 怎么写"、"怎么只改原稿的某一页"）。

安装与上手（新用户：从下载到可用）
快速开始
四类任务与工作流
工具面全表
PPTD 中间层（deck.yaml）
质量门禁体系（为什么不会元素打架）
保真与贴模板（三重通道）
内置模板库
常见问题 FAQ
环境与能力边界
开发与维护（给改插件的人）

0. 安装与上手（新用户：从下载到可用）

0.1 前提

DSH（DeepSeek Harness）web 实例已在本机运行（dsh web）；本插件是预设+插件形态，不改变 DSH 安装。
宿主版本基线：DSH 0.1.5-rc.2（2026-09 实测适配：tools / commands / systemPrompt / webServer / skills / session/event / system-prompt/assemble 契约逐项核对，并在真实进程里跑过挂载、内嵌技能注册与工作流提示注入）。更早的 0.1.x 未逐一验证；skills 服务缺失（极简装配）时插件仍完整可用，只是手册不以技能形式出现。
可选增强（没有也能用，自动降级）：本机 Microsoft Office（真渲染通道）、Edge/Chrome（截图与 M2 实测）、python + python-pptx（兜底引擎）。

0.2 方式 A：`dsh plugin add`（标准姿势 · 一条命令，推荐）

本插件声明了 dsh.bundle.patch（见仓库根 cordis.patch.yml），所以装完即挂载——不需要手工建 junction、不需要跑安装器、不需要 npm 账号：

# 资产 URL 从 Releases 页面复制（文件名带构建戳，原因见下方"为什么带戳"）
dsh plugin --profile web add https://github.com/zbsph/dsh-ppt-studio/releases/download/v1.0.0/dsh-external-dsh-ppt-studio-1.0.0-.tgz

# 升级：用 Releases 页面上**新的**资产 URL 再跑一次（URL 必变，见下）
# 卸载：dsh plugin --profile web remove @dsh-external/dsh-ppt-studio
# 装完 **重启 dsh web** 生效

dsh plugin 是薄 pnpm 转发器：在 /profiles/web/ 里跑 pnpm，然后按已安装状态核对 dsh.profile.bundles——声明了 dsh.bundle 的依赖会自动进入层栈（你不需要手改任何配置）。

为什么文件名带构建戳（2026-09-15 实测）：同一个 URL 用 --clobber 覆盖内容后， dsh plugin add 不会重新下载（pnpm 按 URL 规格复用旧副本，--force 也没绕过；独立 GET 该 URL 证明 URL 本身已是新字节 ⇒ 是包管理器侧的复用）。所以资产名若固定，用户重跑同一条命令 "升级"会拿到旧版本。改成把构建产物的 sha256 前 8 位写进文件名 ⇒ URL 必变 ⇒ 必然重取。代价：URL 每次构建都不同，请从 Releases 页面复制当前那条（或 gh release view v1.0.0 --json assets）。

装完怎么确认生效：dsh --profile web --dump-config 里应出现 ppt-studio 插件行。仓库自带这条路径的真机自证：npm run test:bundle（隔离 DSH_HOME + 真 dsh plugin add + dump-config 断言，不碰你的 profiles）。本包未发布到 npm registry（保持 private: true）；不想装 pnpm / 要离线时用方式 B（下载 tgz + install.mjs）。

0.3 方式 B：下载发布包（离线/无 pnpm 时）

在本仓库 Releases 页面下载 dsh-external-dsh-ppt-studio-.tgz（v1.0.0 起）。

解压到任意目录（如 D:\plugins\dsh-ppt-studio）：

tar -xzf dsh-external-dsh-ppt-studio-1.0.0.tgz -C D:\plugins
# 得到 D:\plugins\package\（内含 lib/ scripts/ agent-presets/ docs/ skills/ templates/）

一键安装（会做三件事：链包进 profile node_modules、保证 yaml 依赖、写入 PPT 工作室预设）：

node D:\plugins\package\scripts\install.mjs
# 自定义 DSH_HOME 时：node ...\install.mjs --prefix 
# 重装/强制：--force；只装包不写预设（配合注入器）：--no-preset

安装器是幂等的——重复运行自动跳过已存在项。

重启 dsh web → 会话左上角/预设切换器选择「PPT 工作室」→ 直接提需求。
验证安装成功：在 PPT 工作室里说"帮我做一个简单 PPT，用内置模板"——模型应开始走 PPT 工作流（工作流提示词自动注入）；或直接问模型"dsh-ppt-studio 怎么用"（内置 skill 手册会回答）。

手册 skill 由插件自己内嵌提供（ctx.skills.register，落 PPT 工作室预设层，随插件同生共死、升级即新）；安装器另外把它镜像到 /skills/，让不在 PPT 预设里的会话也能问到手册。想确认通道生效：让模型调一次 ppt_state，输出里的 manualSkill 会给出 registered/visible。

0.4 方式 C：git clone 源码（开发者/尝鲜）

git clone https://github.com/zbsph/dsh-ppt-studio.git
cd dsh-ppt-studio
npm install            # 仅需 yaml（本地开发依赖）
node scripts/build.mjs # 免 tsc：src → lib
node scripts/install.mjs
# 重启 dsh web → 进入「PPT 工作室」

0.5 方式 D：已有 dsh-super-injector（生态惯例）

在注入器环境内：dev_inject_plugin （或源码目录）→ 注入器负责 junction + 重启恢复；预设同上（仓库 agent-presets/ppt/agent.cordis.yml 复制到 ~/.dsh/.agent-presets/ppt/，或让安装器写：node scripts/install.mjs --prefix --no-preset 后手工放预设）。

0.6 安装后的自检（四句命令）

node scripts/smoke.mjs          # 209 断言（含全链路）
node scripts/preflight-1.0.mjs  # 11 断言（坏输入/边界/幂等/性能）
node scripts/check-preset.mjs   # 预设自检：本预设 vs 随包 standard 逐行比对（DSH 升级后必跑）
node scripts/e2e-1.0.mjs        # 13 断言（真浏览器测量 + 真 Office 渲染 + splice/slice 自证；约 2-3 分钟）

全部绿色 = 本机环境完整可用；无 Office/Edge 的机器 e2e 会自动降级标注（不是失败）。 check-preset 找不到 DSH 安装时跳过（不阻断）。

0.7 装法与冲突：bundle 行 vs 预设行（二选一）

本插件有两条都合法但互斥的挂载路径：

路径	由谁装	生效范围	附带
profile bundle 行（`cordis.patch.yml`）	`dsh plugin --profile web add`	该 profile 的所有会话（工作流仍按意图触发，不会误激活）	不含预设人格
agent preset 行	`node scripts/install.mjs`（写 `~/.dsh/.agent-presets/ppt/agent.cordis.yml`）	仅「PPT 工作室」预设会话	含预设人格 + 预设层技能镜像

两者都装会让同一个包在同进程被挂两次：插件里有装配防重（首个生效 + 明确告警，见 src/index.js），所以不会崩，但请二选一——已经用 dsh plugin 装了，就跑一次 dsh plugin --profile web remove 或删掉预设里的插件行。

0.8 卸载

删除 ~/.dsh/.agent-presets/ppt/ 与 ~/.dsh/profiles/web/node_modules/@dsh-external/dsh-ppt-studio（junction，删链接即可），重启 dsh web。若用 dsh plugin 装的：dsh plugin --profile web remove （会同时从 dsh.profile.bundles 层栈里退出）。

1. 快速开始

三步交付：

进入 PPT 工作室（agent 预设）——说需求。四类任务自动识别，也可 /ppt 命令面显式控制：

/ppt quick        # 快速模式：低 token 快交付（质量底线不变）
/ppt normal       # 完整模式：S0-S6 全流程（默认）
/ppt quality audit  # 从严档：禁一键声明 + 强制视觉审阅 + 导出回读断言 + 自动真渲染审核
/ppt template     # 记录本会话默认模板
/ppt help

跟着工作流走：S0 规格澄清 → S1 大纲 → S2 视觉定调（用内置模板或参考素材）→ S3 逐页制作 → S4 页审循环 → S5 整体审 → S6 导出交付。每页制作后自动跑 ppt_render → ppt_verify → ppt_shot。
交付：.pptx（默认 pptd 引擎）+ 中间层工程 + 交付说明；对话内可点 ppt_preview 链接直接看。如果要改"已有精美 PPT 的某一页"：见第 6 节 splice。

最快试跑：

ppt_new(dir=D:\demo)                 # 一键生成可跑通全链路的示例工程（3 页，含全部范本）
ppt_render(D:\demo) → ppt_verify(D:\demo) → ppt_export(D:\demo)

1.4 内置技能包（提问式手册 + 制作手册）

插件自带 4 本技能，随插件同生共死（内嵌注册 ctx.skills.register，落 PPT 工作室预设层；升级即新、卸载即净）：

技能	何时加载	内容
`ppt-studio-manual`	问"这个插件怎么用 / XX 怎么写 / 为什么报错"	提问式使用手册（四类任务、DSL 速查、声明制、splice 与贴模板、报错处置）
`ppt-studio-craft`	定纲/定版式；"这页怎么排 / 太挤 / 太像模板了"	叙事 spine、一页一论点、结论式标题、按内容量选构图、反模板自检
`ppt-studio-data`	页面要放数字或图表	图表选型、成品里图表只有几何（标签要自己补）、口径与来源标注、跨页数字一致
`ppt-studio-copy`	写标题与要点；"太 AI 了 / 像机器写的"	页面三类角色的写法、成组 AI 味信号清单、before → after 对照

三条承诺：

纯增量：技能只给启发式与反例——不改任何铁律、不定义任何门禁数值；工作流提示词只在标准档新增了一行"何时加载"的指引，且由机器断言保证旧行一行未改/未删（npm test 里的两条"★老用户不受影响"）。另有 13 条"手册 vs 源码"断言（npm test §37/§38）盯住手册的事实不许说错：工具名是否真实存在、门禁错误码清单与源码是否一致、警告标记是 [~] 而不是 [⚠]、density/near-align 属警告而非建议、chart 的 data 形状、预览截断阈值、/ppt 子命令、讲稿是否写明了"不导出备注"、缩字下限常量、SCHEMA_REF 自洽，以及文档里的"smoke N 断言"必须等于真实断言数（加断言忘同步文档会当场红）。
不加载也照常工作：部署里没有 dsh-skill（无 skills 服务）或技能文件缺失时，插件功能完整，只是技能不以目录形式出现。
不与用户自装技能打架：技能注册表跨层重名按"就近层优先"裁决——PPT 会话内命中插件内嵌版，用户自装那份在其它会话照旧可见。想整体退掉：删掉本机的 ~/.dsh/skills/ppt-studio-* 镜像即可（内嵌版仍在 PPT 会话内生效，反之亦然）。

想确认通道是否生效：让模型调一次 ppt_state，输出里的 manualSkill.skills 会逐个给出注册与可见状态。

2. 四类任务与工作流

类型	触发词	路径	交付
from-scratch 从头	"做一个 XX 主题的 PPT"	模板/定调 → 逐页制作	完整工程 + pptx
augment 补完	"补两页 / 加一个章节"	默认可复用模板工作区；新增页 = 复制母版去 `_` 前缀 + 注册 deck.pages	追加后的完整工程 + pptx（或 `ppt_splice` 进原稿）
edit 修改	"改第 15 页 / 美化这页"	`ppt_import` 读参考层真身 → 独立改该页 → `ppt_splice` 替换回原稿	整册只变一页 + 单页版（`ppt_slice`）
summarize 总结	"把这 50 页总结成 10 页"	`ppt_import` 全稿 → 提炼 → 重排	新工程 + pptx

任务识别是语义路由（明确 PPT 意图才进入工作流；只提一句无关话题不会误切）——非 PPT 需求行为与标准模式完全一致。

3. 工具面全表

创作链：

工具	用途
`ppt_schema`	语法速查（deck.yaml / 元素 / 主题 token / 声明 / 安全区）——不熟 DSL 先调它
`ppt_new`	一键生成示例工程（现成范本：主题 token / 色块衬底声明 / safeArea / line 无 bounds 写法）
`ppt_check`	结构校验（deck/页面 YAML、元素、主题引用 `$ref`、声明 id 防呆）
`ppt_render`	deck → `preview/*.html` + `layout.json`（数字审阅数据源）；`debug=true` 画安全区参考框
`ppt_verify`	数字审阅门禁：重叠/出界/溢出/对齐/密度。`autoDeclare=true` 一键声明；`measured=true` 交叉实测档；`pages="2,5-7"` 局部审阅
`ppt_shot`	Edge headless 截图 → PNG（视觉审阅；`index=N` 单页 / `overview=true` 整览）
`ppt_measure`	M2 实测档：浏览器真实排版测量（行盒/溢出/几何）→ `measured.json`；`ppt_verify measured=true` 交叉（实测=终审）
`ppt_crosscheck`	M3 数据连贯：跨页数字对账 + 数据来源核查表（交付说明用）
`ppt_preview`	对话内预览：同源链接（整览+单页），用户点击即看

输入链：

工具	用途
`ppt_import`	任意 .pptx → deck 工程（内容保真 + 参考层：`source.pptx` 真相 + Office 真渲染整页 + theme 聚合；备注读回 `notes:`）
`ppt_visual`	Office PPT COM 真渲染 → 逐页 PNG；`pages="15"` 只渲指定页（页号=源原页号）
`ppt_media`	图片元数据（尺寸/格式，估算 media 用量）

交付链：

工具	用途
`ppt_export`	导出 .pptx（`auto`=pptd 主引擎，硬失败自动回退 python-pptx 并醒目标注；`out` 支持绝对路径；有 `notes:` 的页生成备注页，parity 自证）
`ppt_patch`	手术模式：以模板 .pptx 为底版贴内容（只改文本/表格 ``，样式/几何/图片原样保留；未动页 sha256 验证）
`ppt_splice`	替换进原稿：工作区某页替换进源 .pptx（保留母版横幅/页脚/备注/媒体；其余页条目 SHA256 逐字节一致——自动自证）
`ppt_slice`	单页版：从 .pptx 修剪出"单页 + 完整母版/布局/主题"独立文件

状态链：ppt_status（工作流状态）/ ppt_state（会话状态）/ ppt_templates（模板清单）/ /ppt 命令面。

4. PPTD 中间层（deck.yaml）

唯一事实源：deck.yaml + pages/*.yaml + media/。导出/渲染/校验共用，1px = 1pt，原点左上，默认尺寸 960×540（约 10 英寸 × 5.63 英寸）。

version: 1
title: 我的演示
size: [960, 540]              # 或 {width, height}
theme:                        # 样式只在 theme 定义元素引用 token；新增风格先改这
  colors: {primary: "#2563EB", ink: "#1F2937"}
  textStyles: {title: {fontSize: 32, color: "$ink", bold: true}, body: {fontSize: 16, color: "$ink"}}
  safeArea: {top: 20, bottom: 20}   # 可选：模板背景非内容区（logo/页眉页脚带）
  minFontSize: 14             # 可选：用户给出字号下限时设置（如"不得小于14号"→14）；缺省无强制下限
pages:
  - pages/01_cover.yaml

页面元素（pages/01_cover.yaml）：

pageType: cover
background: "#F5F6F7"         # hex / $themeRef / {type: solid,color} / {type: image,src,fit}
notes: |                      # 可选：讲稿 → 导出为 **pptx 备注页**（PowerPoint"备注"区可见/可编辑）
  开场先给结论。
  第二行：再给证据。            # 单行也可写 notes: "一句话讲稿"
elements:
  - elementId: 页内唯一字符串   # 必须
    elementType: text|shape|line|image|table|chart
    bounds: [x, y, w, h]       # 必须（line 可省略：由 points 的 AABB 自动推导）
  # chart：
  - elementId: bar
    elementType: chart
    bounds: [60, 300, 400, 200]
    chart:
      type: bar                # bar|line|pie
      data: {cols: [分类, 值], rows: [[甲, 10], [乙, 20]]}   # 只认 {cols, rows}；多系列加 series: [{name,x,y}]
      colors: ["$primary"]     # 可选：$themeRef 在预览与成品两层都会解析；不写则用内置调色板（不在 theme.colors 里）
  # text：
  - elementId: t1
    elementType: text
    bounds: [60, 60, 400, 50]
    content:
      text: "正文，长句在语义断点显式 \n 换行"
      style: "$body"            # 引用 theme.textStyles；或直接写字段（**必须写在 content 内**！）
      # fontSize: 14 / color: "$ink" / bold / align / lineHeight / wrap
  # shape（常用 prst：rightArrow/leftArrow/upArrow/downArrow/leftRightArrow/pentagon/hexagon/
  #         chevron/parallelogram/diamond/octagon/star5/flowchartProcess|Decision|Data|Terminator
  #         + roundRect/ellipse/triangle/rect + custGeom 自定义路径）
  - elementId: card
    elementType: shape
    kind: roundRect
    bounds: [60, 60, 400, 200]
    fill: "$colors.primary"     # #hex | {color, alpha}（透明度）| {type: gradient, stops: [...], angle}
    line: {color: "#FFFFFF", width: 1}
    rotation: 0                 # 度

样式键必须在 content 内部（元素级 fontSize/color/… 无效——v1.0.0 起 ppt_check 直接报错）。
expectedOverlaps 流式/块式等价：[{pair: [a,b]}] 与 - pair: [a,b]，每对一行。
讲稿（notes:）：写进页面，ppt_export 为这些页生成标准备注页（notesSlide + notesMaster，ppt_export 报告的 parity 里 notesExp/notesOut 自证）； ppt_import 会把原稿备注读回 notes:；没有 notes: 的页不产生任何备注部件（不写讲稿的工程产物与旧版逐字节一致）。没有翻页/计时字段（放映设置不在本插件范围）。
完整速查永远可以问模型（ppt_schema）或直接看 examples/smoke 样例工程。

5. 质量门禁体系（为什么不会元素打架）

核心：重叠的合法性由"设计意图"决定，而非元素类型：设计时声明，审阅时对照。

5.1 重叠声明制（expectedOverlaps）

设计时把有意重叠对记入页面 expectedOverlaps: [{pair: [idA, idB]}, ...]（图片标注/色块衬底/箭头跨越/装饰叠加）。
审阅（ppt_verify）逐对对照：命中 → ✓ 预期重叠（确认）；未命中 → ERROR（修正布局，或确认有意 → 补声明重验）。
声明闭包：嵌套承载只需声明相邻层（面板→框→文字），隔层由包含关系传递自动通过（架构图声明省 1/3）。
内容互压（content-collision）永远 ERROR，不可声明（文字/表格/图表相互遮挡——真正要防的冲突）。
role: decoration 只豁免重叠，不豁免出界。
批量：ppt_verify autoDeclare=true（写入后附"声明清单 + 每对一句意图"；audit 档禁用）。

5.2 出界分级（与声明制同构）

超页面边界 = 永远 ERROR，不可声明（放映不可见）。
超安全区（模板 logo/页眉页脚带）= 声明制：expectedOutOfSafeArea: [idA, ...] 手工声明（id 必须存在）。

5.3 文本度量与"下限 = 用户指令"

保守估算（CJK 1em·加粗 ×1.06 / Latin 数字 0.6em / 空格 0.4em），宁可误报不可漏报；渲染/校验/导出同一度量（溢出 > 1px 才缩字）。
字号下限 = 用户指令（2026-09-06 用户拍板）：用户给出最小字号（如"不得小于 14 号"）→ 模型写入 theme.minFontSize 并严格执行（导出缩字不得低于它）；未给下限不设强制（auto-fit 仅 60% 原字号防荒谬保底，绝不升字）。插件不预设任何默认下限。
verify 通过 ⇒ 导出不缩字；到达下限仍溢出 → 报告 ✗（修复：扩大容器/精简文案；下限是用户的，不是插件的）。
M2 实测档（ppt_measure + ppt_verify measured=true）：浏览器真实排版测量——实测溢出且估算没报 = 新 error（估算漏报）；估算报但实测通过 = warning（字体差异，人工确认）。实测=终审、估算=预检。

5.4 主题一致性（统一基础样式）

theme-conformance strict（默认）：页面颜色必须 ∈ theme.colors 或中性灰，出板 = ERROR；新增颜色先加进 theme。
字号/字体为建议级（[·]），单页多处时聚合出一条。
图表配色是建议级（2026-09-14）：图表的默认调色板是内置的一套（不在 theme.colors 里，属既有行为、不报错也不提示）；你若显式写了 chart.colors 且其中有主题外颜色，会出一条 [·] aesthetic-theme 建议（可用 $ref 改成主题色）。刻意不把图表配色纳入门禁：那会给既有工程/模板凭空新增错误。
导入工程自动带原稿全量色板（c1-c7 高频 + 扩展），不再误报原稿色。

5.5 审阅节奏（三层校验）

ppt_render + ppt_verify   # ① 数字门禁：ERROR 清零（快）
ppt_shot + read_image     # ② 视觉审阅：构图失衡/断行/比重（慢但必要，数字门禁发现不了）
ppt_visual                # ③ Office 真渲染复核（有条件时；audit 档导出自动跑）

[·] 建议（美学/对比度/孤字/密度）永不作为门禁——但请逐条斟酌采纳。

6. 保真与贴模板（三重通道）

通道	工具	适用	保真度
参考双轨（想"像"）	`ppt_import` → `reference/previews/*.png` 真身 → 读 `audit.yaml` → 创作	按模板做/参考用户 PPT 做；导入改稿	风格级（新版式由你掌控）
手术模式（要"贴"）	`ppt_patch`	成品要"看起来就是模板原样"（只换文字/表格内容）	结构级（模板 XML 原样，只改文本槽）
替换/单页（要"保"）	`ppt_splice` / `ppt_slice`	编辑既有精美 PPT 的某一页——只换一页，其余逐字节不动，母版横幅/页脚/备注保留	逐字节级（其余页 SHA256 自证）

edit 任务的标准姿势（v1.0.0 起一键）：

ppt_import(, D:\work)        # 读参考层真身（先 read_image 看 reference/previews）
# 改 D:\work\pages\slide_15.yaml → ppt_render → ppt_verify（0 错误）
ppt_splice(dir=D:\work, source=, page=15)      # 整册副本，只变第 15 页
ppt_slice(source=, page=15)                 # 单页版（可选）
ppt_visual(pptx=, pages="15")               # 抽查该页真实观感（按页渲染）

7. 内置模板库

4 套版权自研风格（business-blue 商务蓝 / academic-white 学术会议 / tech-dark 科技深色 / pitch-bold 路演大字，各含 theme + 6 张版式母版）+ 外部模板（实用毕业设计/极简部门总结/深蓝质感答辩/简约商务等，双轨含真实模板 pptx + 真渲染预览）。

ppt_templates 看清单与预览；/ppt template 记默认。
ppt_new(dir, template=) 物化工作区：pages/_*.yaml 是参考母版（不进门禁）；01_opening.yaml 是正式副本（先 ppt_verify autoDeclare=true 声明模板固有叠层 → 剩余错误是模板原文案残留，替换后自然干净）。
你自己的模板：ppt_import（保留 source.pptx）→ ppt_template_add 永久进库 → 以后直接物化使用。

8. 常见问题 FAQ

Q：为什么 verify 报重叠但我的设计是有意的？ → 这是设计意图声明制：把这对元素加进页面 expectedOverlaps 再重验（命中即 ✓）。说明不清意图的对子请改布局；内容互压（文字×文字）永远不能声明。

Q：autoDeclare 为什么不声明全部？ → 只声明警告级（承载/装饰模式），内容互压不可声明（硬底线）；audit 档禁一键声明。写入后模型必须输出"每对一句意图"。

Q：样式写了但效果不对/按 18pt 计量？ → 样式键必须写在 content 内。元素级 fontSize 无效（v1.0.0 起 ppt_check 直接报错并指引）。

Q：预览链接打不开（404）？ → 路由由 PPT 工作室会话挂载时注册：请确认当前会话在 PPT 工作室；进入后链接即恢复。

Q：Office 渲染时窗口闪一下？ → 正常（PowerPoint COM 需要）；只读打开、结束自动释放。

Q：无 Edge/无 Office 还能用吗？ → 能。截图/实测/真渲染自动降级并标注（HTML 预览 + 结构断言仍在）；交付说明会标注"未经视觉审阅"。

Q：图表支持哪些？ → bar/line/pie（矢量拼绘，可编辑）；python-pptx 兜底引擎下降级为表格（报告醒目标注）；复杂图表建议作为图片或直接用 Shape 拼。

Q：讲稿/备注能进 pptx 吗？ → 能（2026-09-14 起）：页面写 notes:（多行用 | 块标量），导出即成 PowerPoint 备注页；ppt_import 会读回 notes:，可编辑。没有 notes: 的页不产生备注部件（老工程产物不变）。翻页/计时（放映设置）不在插件范围。 ppt_splice 替换某页时保留源文件该页既有的备注关系（不会把 deck 里新写的 notes 塞进被替换的源页）。

Q：从原稿导入后文字里的 & / < 是正常的吗？ → 不该出现（2026-09-14 修）：导入侧此前不做 XML 实体解码，会把 R&D 读成 R&D。现在文本节点会正确解码（&/</>/"/' 与数字实体）。如果你的导入工程是旧版本产物，重新 ppt_import 一次即可。

Q：如何只改原稿第 15 页？ → ppt_splice（第 6 节）。如何导出单页版？ → ppt_slice。

Q：dsh plugin add 装了，但插件好像没生效？ → 三步查：① dsh plugin --profile web list 看包装上没（装不上会直接报错）； ② dsh --profile web --dump-config 看组合树里有没有 ppt-studio

安装

说明文档