dsh-ppt-flashmade

dsh plugin --profile web add dsh-ppt-flashmade

dsh-ppt-fusion

DeepSeek Harness（DSH）插件：把 pptwise 的 DSH 原生前端（IR v5、24 套主题、审计、预览）与 ppt-master 的深度引擎（SVG→DrawingML、原生图表/表格/公式、动画/旁白）融合成一条 dsh-ppt 命令链。

• 上游：@liustack/pptwise@0.35.0（npm，MIT）· ppt-master==0.1.128（PyPI，MIT）
• 本包：dsh-ppt-flashmade，MIT，Node >= 22.19，bin dsh-ppt
• 下载：npm dsh-ppt-flashmade@0.7.1 · GitHub Release v0.3.1（附件 dsh-ppt-flashmade-0.6.0.tgz 与 npm 包字节一致）
• 交付物：out/<name>.pptx —— 原生可编辑 PPTX（原生形状/图表/表格）。preview --html 与卡片里的

HTML 只是评审查看器，不代表交付物形态。

状态：CI 双平台全绿（ADR-055）；v0.7.1 已按 §8 双渠道发布（npm + GitHub Release，ADR-056…092）；0.2.0 线为第一支持线（CI 三腿 + 四场景实测 + 沙箱矩阵，ADR-089/090/091/092）：渲染快照与渲染门禁 + dsh_ppt_review 看图自评；DSH 0.1.2-rc.1 / 0.1.5-rc.2 / 0.1.7-rc.2 / 0.2.0-rc.2 四线可安装（v0.6.1 起，ADR-079 更新）：design profile 提取/套用（ADR-061/066）、素材三通道与 svg/flat 背景（ADR-067）、audit --profile 符合性审计（ADR-062）、设计施加 pass 与 reference-quality 基准（ADR-069）、可选图像生成（ADR-064）。 v0.2 的 storyboard/role→layout/内容预算（ADR-059）、旁白自动翻页（ADR-060）、Q4 模型评估 3/3（docs/v02-model-eval.md）仍有效。 V11（0.2.0 线）进行中：CI 已加 0.2.0-rc.2 腿（ADR-089），支持线 = 0.1.2-rc.1 / 0.1.5-rc.2 / 0.1.7-rc.2 / 0.2.0-rc.2。

---

架构（S2：Node 驱动 Python，无 FFI、无共享内存）

DSH 会话（模型）
  │  遵循 skills/dsh-ppt-fusion/SKILL.md（M6 落地）
  ▼
dsh-ppt CLI                        Node >= 22.19
  │  src/cli.ts → src/commands/*
  ├── src/frontend.ts ─────────────► node node_modules/@liustack/pptwise/dist/cli.js
  │      IR v5 进，pptx 出                npm 依赖 0.35.0（JS API 已封，只走 CLI）
  │
  └── src/engine/master.ts ────────► <venv>/Scripts/ppt-master.exe
         SVG 进，pptx 出                  PyPI 依赖 0.1.128（uv venv，无 pip）
             ▲
             └── src/engine/venv.ts      建/查/修 venv；uv 解析不走 PATH

render 主链（已落地）：pptwise render --draft（deep 页=占位）→ deep render（ppt-master 四步门控流水线）→ slide 级合并（layout 重映射到 base 母版 + 闭包导入）→ OPC/delivery 门 → 原子发布 out/<name>.pptx + out/manifest.json。

deck/
├── deck.fusion.json    页级路由表 + post 配置（schema v1）
├── deck.ir.json        标准页 IR v5；deep 页 placeholder:true
├── theme.json/tokens.json/master-design.json   主题桥产物
├── deep/pNN-*/         每 deep 页一目录：page.svg（七条作者契约见 contracts.md）
├── out/                产物 + manifest（sha256、slide 数、导出回执、merge 报告）
└── .dsh-ppt/           缓存、临时 master 项目、诊断日志、render 中间产物

层与职责

模块 · 职责 · 不得

dsh/index.js（M7） · DSH 插件注册、skill 注册、preview 工具/路由 · 含生成逻辑

src/cli.ts + src/commands/ · argv、退出码、接线 · 渲染

src/frontend.ts · 定位并驱动 pptwise CLI、解析 JSON、其失败分类 · import pptwise 内部

src/bridge/theme.ts · ThemeFile v2（style.*）→ tokens → master 调色板 · 改上游主题

src/bridge/merge.ts · slide 级合并：内容感知复用、layout remap、单一母版、creationId 去重 · 解析 shape 语义

src/bridge/post.ts（M4 第 2 部分 ✅） · 合并后统一施加动画/切换/旁白 · 在合并前运行

src/bridge/compat.ts（M4 第 2 部分 ✅） · 兼容 pass：scan/transform/stamp/lint，对照 src/compat/registry.json · 注册表之外的隐式改写

src/commands/audit.ts（M4 第 2 部分 ✅） · 八源统一审计门：validate / pptwise / 引擎门 / OPC+P1 / compat / ΔE · 吞失败门、缺产物静默跳过

src/engine/contracts.ts · 引擎命令白名单 + 参数枚举 + 输出文件契约 · 放行未登记命令

src/engine/venv.ts · venv 生命周期、uv 解析、锁文件安装/修复 · 启动路径联网

src/engine/master.ts · 唯一 Python spawn 点；超时、错误分类、路径白名单 · 接受白名单外命令

src/engine/runner.ts · 子进程原语 + 默认拒绝的 env 白名单 · 默认继承凭据

src/logging.ts · <deck>/.dsh-ppt/logs/<ts>-<cmd>.log · 删改 deck 数据

src/audit.ts · 多来源审计聚合（随 M4/M5 扩展） · 吞失败门

不变式

• P1 单一母版：merged deck 恰好 1 个 slideMaster，所有 layout 指向它；scripts/opc-invariants.mjs --single-master 硬门（M0/M4 均已验证）。
• deep 页绝对定位：deep 页走 --pptx-structure flat，layout remap 不动内容。
• 确定性三级：T1 语义确定性 = 硬门（tests/support/canonicalize.ts 递归进 ppt/embeddings/*，pnpm fixtures:verify 在 CI 执行）；T2 本包字节稳定 = 目标（merge 步骤已达成，且每个 zip entry 含目录项都钉死在固定时间戳，ADR-041）；T3 全链字节一致 = 非 v1 门（master 输出时间戳不稳定）。
• 兼容性被声明、不靠假设：src/compat/registry.json 登记每个版本敏感标记的最低 Office/WPS 支持与降级规则；render --compat safe|standard|max 覆盖 manifest 的 compat 字段，默认 standard（Office 2016+/WPS 2019+）；报告写 out/compat-report.json，哈希进 out/manifest.json（ADR-034）。
• 失败分类：每个错误是 src/engine/errors.ts 的封闭枚举，CLI 打印 dsh-ppt: <code> <message>。
• 交付门：dsh-ppt audit 聚合八源（validate、pptwise、引擎门、OPC+P1、delivery、compat、可选 ΔE）；缺产物是 error 并把跳过的源记入 skipped（ADR-035）。
• 渲染级 QA（v0.5.0 起）：dsh-ppt renderpages 把发布包渲染成逐页 PNG（PowerPoint COM / LibreOffice Kit 双引擎、哈希缓存、页数与像素限额），供 audit --rendered 与模型看图自评使用（ADR-081）。
• 素材署名：images search 的每个下载项都进 assets/image_sources.json，缺许可或缺署名文本即失败；--strict-no-attribution 直接拒绝需署名的许可（ADR-040）。
• 动效单一 owner：post/animations.json 的 entrance/emphasis/path 由 bridge/post.ts 写；emphasis/路径必须按 PowerPoint 自己的包装结构书写，否则 COM 读回 behaviours=0（ADR-042）。
• 非目标不可达：image-gen、video-*、gemini-watermark-remove 不在 contracts 白名单（ADR-013）。

已实现的命令

version · doctor [--repair --no-self-test] · init · plan [--from --confirm] · resume [--write] · validate · audit [--strict --pixels --file] · preview [--html] · theme ensure|list|new|fork|try · tokens export [--master] · brand extract [--bind] · source <input...> · images search · deep render [--page] · deep template create|apply|register · deep native roundtrip · post animate · narrate [--sync --list-voices] · render [-o] [--compat <level>] · compat lint <file> · skill audit（全部命令支持 --json）

• doctor 八项：Node / uv / Python / engine venv / ppt-master / png-renderer（本机红=设计使然，B7 用 Node sharp 兜底）/ pptwise / PowerPoint COM / self-test。
• render 的动画/切换由 bridge/post.ts 在合并后单一施加（ADR-032）；选择器匹配不到时是硬失败 ContractViolation，不静默忽略。
• 完整命令面与 Planned 表见 [docs/cli.md](docs/cli.md)。

开发

pnpm install                    # pnpm 8.15.9 + npmmirror（本机纪律）
pnpm typecheck && pnpm lint && pnpm test
pnpm build                      # tsup → dist/cli.js
node dist/cli.js doctor         # 八项体检 + self-test
pnpm themes:verify              # 24 主题快照

…(truncated)