dsh-ppt-studio 1.1.0

package/examples/smoke/preview/layout.json

@@ -0,0 +1,378 @@
+{
+  "size": {
+    "width": 960,
+    "height": 540
+  },
+  "theme": {
+    "colors": {
+      "primary": "#2563EB",
+      "accent": "#F59E0B",
+      "text": "#1F2937",
+      "bg": "#F8FAFC"
+    },
+    "textStyles": {
+      "title": {
+        "fontSize": 40,
+        "color": "$text",
+        "bold": true
+      },
+      "body": {
+        "fontSize": 18,
+        "color": "$text",
+        "lineHeight": 1.5
+      },
+      "caption": {
+        "fontSize": 12,
+        "color": "#64748B"
+      }
+    },
+    "grid": {
+      "base": 8
+    },
+    "safeArea": null,
+    "minFontSize": null,
+    "themeConformance": "strict"
+  },
+  "pages": [
+    {
+      "index": 0,
+      "pageNo": 1,
+      "file": "pages/01_cover.yaml",
+      "name": "pages/01_cover",
+      "background": {
+        "type": "solid",
+        "color": "#F8FAFC"
+      },
+      "safeArea": {
+        "top": 0,
+        "bottom": 0,
+        "left": 0,
+        "right": 0
+      },
+      "expectedOverlaps": [],
+      "expectedOutOfSafeArea": [],
+      "contrastExempt": [],
+      "overlapMode": "declared",
+      "elements": [
+        {
+          "id": "hero-rect",
+          "kind": "shape",
+          "bounds": {
+            "x": 0,
+            "y": 0,
+            "w": 960,
+            "h": 120
+          },
+          "shape": "rect",
+          "fill": "#2563EB",
+          "rotation": 0
+        },
+        {
+          "id": "title",
+          "kind": "text",
+          "bounds": {
+            "x": 80,
+            "y": 180,
+            "w": 700,
+            "h": 90
+          },
+          "style": {
+            "fontSize": 40,
+            "color": "#1F2937",
+            "bold": true,
+            "lineHeight": 1.2,
+            "wrap": true
+          },
+          "metrics": {
+            "textW": 508.79999999999995,
+            "textH": 48,
+            "lines": 1,
+            "lineWidths": [
+              508.79999999999995
+            ],
+            "overflowY": 0,
+            "overflowX": 0
+          },
+          "text": "季度复盘：增长引擎与风险"
+        },
+        {
+          "id": "subtitle",
+          "kind": "text",
+          "bounds": {
+            "x": 80,
+            "y": 290,
+            "w": 600,
+            "h": 60
+          },
+          "style": {
+            "fontSize": 18,
+            "color": "#F59E0B",
+            "lineHeight": 1.5,
+            "wrap": true
+          },
+          "metrics": {
+            "textW": 170.10000000000002,
+            "textH": 27,
+            "lines": 1,
+            "lineWidths": [
+              148.5
+            ],
+            "overflowY": 0,
+            "overflowX": 0
+          },
+          "text": "2026 Q3 · 内部汇报"
+        },
+        {
+          "id": "deco",
+          "kind": "shape",
+          "bounds": {
+            "x": 780,
+            "y": 360,
+            "w": 120,
+            "h": 120
+          },
+          "shape": "ellipse",
+          "fill": "#F59E0B",
+          "rotation": 0
+        }
+      ]
+    },
+    {
+      "index": 1,
+      "pageNo": 2,
+      "file": "pages/02_content.yaml",
+      "name": "pages/02_content",
+      "background": {
+        "type": "solid",
+        "color": "#F8FAFC"
+      },
+      "safeArea": {
+        "top": 0,
+        "bottom": 0,
+        "left": 0,
+        "right": 0
+      },
+      "expectedOverlaps": [
+        {
+          "pair": [
+            "metric-rect",
+            "metric"
+          ]
+        }
+      ],
+      "expectedOutOfSafeArea": [],
+      "contrastExempt": [],
+      "overlapMode": "declared",
+      "elements": [
+        {
+          "id": "page-title",
+          "kind": "text",
+          "bounds": {
+            "x": 60,
+            "y": 40,
+            "w": 840,
+            "h": 50
+          },
+          "style": {
+            "fontSize": 28,
+            "color": "#1F2937",
+            "bold": true,
+            "lineHeight": 1.2,
+            "wrap": true
+          },
+          "metrics": {
+            "textW": 118.72,
+            "textH": 33.6,
+            "lines": 1,
+            "lineWidths": [
+              118.72
+            ],
+            "overflowY": 0,
+            "overflowX": 0
+          },
+          "text": "关键进展"
+        },
+        {
+          "id": "body-a",
+          "kind": "text",
+          "bounds": {
+            "x": 60,
+            "y": 130,
+            "w": 420,
+            "h": 200
+          },
+          "style": {
+            "fontSize": 18,
+            "color": "#1F2937",
+            "lineHeight": 1.5,
+            "wrap": true
+          },
+          "metrics": {
+            "textW": 816.3000000000001,
+            "textH": 54,
+            "lines": 2,
+            "lineWidths": [
+              429.3,
+              343.8
+            ],
+            "overflowY": 0,
+            "overflowX": 396
+          },
+          "text": "线上增长 34%，主要来自新渠道投放；NPS 提升 12 分；复购率升至 41%。供应链成本环比下降 8%。"
+        },
+        {
+          "id": "metric-rect",
+          "kind": "shape",
+          "bounds": {
+            "x": 540,
+            "y": 130,
+            "w": 360,
+            "h": 80
+          },
+          "shape": "rect",
+          "fill": "#2563EB",
+          "rotation": 0
+        },
+        {
+          "id": "metric",
+          "kind": "text",
+          "bounds": {
+            "x": 540,
+            "y": 150,
+            "w": 360,
+            "h": 40
+          },
+          "style": {
+            "fontSize": 22,
+            "color": "#FFFFFF",
+            "bold": true,
+            "align": "center",
+            "lineHeight": 1.2,
+            "wrap": true
+          },
+          "metrics": {
+            "textW": 112.19999999999999,
+            "textH": 26.4,
+            "lines": 1,
+            "lineWidths": [
+              103.4
+            ],
+            "overflowY": 0,
+            "overflowX": 0
+          },
+          "text": "+34% 增长"
+        },
+        {
+          "id": "table-b",
+          "kind": "table",
+          "bounds": {
+            "x": 60,
+            "y": 380,
+            "w": 840,
+            "h": 120
+          },
+          "cols": 4,
+          "rows": 3,
+          "fontPt": 11,
+          "metrics": {
+            "overflowY": -52.8,
+            "lines": 4,
+            "textH": 67
+          }
+        }
+      ]
+    },
+    {
+      "index": 2,
+      "pageNo": 3,
+      "file": "pages/03_chart.yaml",
+      "name": "pages/03_chart",
+      "background": {
+        "type": "solid",
+        "color": "#F8FAFC"
+      },
+      "safeArea": {
+        "top": 0,
+        "bottom": 0,
+        "left": 0,
+        "right": 0
+      },
+      "expectedOverlaps": [],
+      "expectedOutOfSafeArea": [],
+      "contrastExempt": [],
+      "overlapMode": "declared",
+      "elements": [
+        {
+          "id": "page-title",
+          "kind": "text",
+          "bounds": {
+            "x": 60,
+            "y": 40,
+            "w": 840,
+            "h": 50
+          },
+          "style": {
+            "fontSize": 28,
+            "color": "#1F2937",
+            "bold": true,
+            "lineHeight": 1.2,
+            "wrap": true
+          },
+          "metrics": {
+            "textW": 194.04000000000002,
+            "textH": 33.6,
+            "lines": 1,
+            "lineWidths": [
+              171.64000000000001
+            ],
+            "overflowY": 0,
+            "overflowX": 0
+          },
+          "text": "渠道 GMV 走势"
+        },
+        {
+          "id": "chart-c",
+          "kind": "chart",
+          "bounds": {
+            "x": 60,
+            "y": 130,
+            "w": 840,
+            "h": 330
+          },
+          "chartType": "bar",
+          "colors": [
+            "#2563EB",
+            "#F59E0B"
+          ]
+        },
+        {
+          "id": "caption",
+          "kind": "text",
+          "bounds": {
+            "x": 60,
+            "y": 480,
+            "w": 840,
+            "h": 30
+          },
+          "style": {
+            "fontSize": 12,
+            "color": "#64748B",
+            "lineHeight": 1.2,
+            "wrap": true
+          },
+          "metrics": {
+            "textW": 235.79999999999995,
+            "textH": 14.399999999999999,
+            "lines": 1,
+            "lineWidths": [
+              231
+            ],
+            "overflowY": 0,
+            "overflowX": 0
+          },
+          "text": "数据来源：内部经营报表（2026-09 月报）"
+        }
+      ]
+    }
+  ]
+}

package/lib/autodeclare.js

@@ -0,0 +1,40 @@
+/**
+ * 一键声明（反馈 D2 ★★）：把警告级未声明重叠对写入页面 expectedOverlaps。
+ * - 保留源文件注释（parseDocument + setIn，不重排全文件）。
+ * - 内容互压（content-collision）不会出现在 collectDeclarable 中，必须手工修复。
+ */
+import { readFile, writeFile } from 'node:fs/promises'
+import YAML from 'yaml'
+import { collectDeclarable } from './verify.js'
+
+/**
+ * @param ctx    resolveDeck 结果（pages[].file 为页面 yaml 绝对路径）
+ * @param layout renderDeck 的 layout（pages[] 含 elements/expectedOverlaps/size）
+ * @returns [{ page, added }]
+ */
+export async function applyAutoDeclare(ctx, layout) {
+  const added = []
+  for (const pageL of layout.pages) {
+    const pairs = collectDeclarable(pageL, layout.size)
+    if (!pairs.length) continue
+    const file = ctx.pages[pageL.index].file
+    const text = await readFile(file, 'utf8')
+    const doc = YAML.parseDocument(text)
+    // yaml@2 的 doc.get() 返回 AST 节点（YAMLSeq，无 .map）；其 toJS() 裸调用还会抛
+    // "A document argument is required"（需要 doc 上下文）→ 统一走 doc.toJS()（Document 级，纯 JS 值）
+    const data = doc.toJS() ?? {}
+    const list = Array.isArray(data.expectedOverlaps) ? data.expectedOverlaps : []
+    const existing = list.map((p) => ({
+      pair: [String(p?.pair?.[0]), String(p?.pair?.[1])],
+    }))
+    const exSet = new Set(existing.map((p) => [p.pair[0], p.pair[1]].sort().join('×')))
+    const add = pairs
+      .filter(([a, b]) => !exSet.has([a, b].sort().join('×')))
+      .map(([a, b]) => ({ pair: [a, b] }))
+    if (!add.length) continue
+    doc.setIn(['expectedOverlaps'], doc.createNode([...existing, ...add], { keepScalarTypes: true }))
+    await writeFile(file, String(doc))
+    added.push({ page: pageL.index + 1, added: add.length, file })
+  }
+  return added
+}

package/lib/commands.js

@@ -0,0 +1,161 @@
+/**
+ * /ppt 斜杠命令面（命令 > 语义；命令写入会话/项目状态）。
+ * /ppt                                    → 状态查询
+ * /ppt on|off                             → 强制进入/退出工作流
+ * /ppt free|mid|strict                    → 强制协作模式
+ * /ppt fidelity strict|auto|free [--page N / --dir D]
+ * /ppt review none|points|every
+ * /ppt engine pptd|python-pptx|pptxgenjs
+ * /ppt quality quick|standard|audit
+ * /ppt pause-after outline|layout|pages|overall [--dir D]
+ * /ppt help
+ */
+import { loadSession, saveSession, loadProject, saveProject } from './state.js'
+
+export function registerCommands(ctx) {
+  ctx.commands.register({
+    name: 'ppt',
+    description: 'PPT 工作流控制：进入/退出、快速模式、协作模式、引擎、质量、暂停点',
+    input: { hint: '[on|off|quick|normal|free|mid|strict|fidelity <v>|review <v>|engine <v>|quality <v>|pause-after <v>|help]' },
+    handler: (invocation) => handle(invocation),
+  })
+}
+
+async function handle(invocation) {
+  const sessionId = invocation.agent.session?.id ?? 'default'
+  const input = invocation.rawInput.trim()
+  const state = await loadSession(sessionId)
+  const [cmdRaw, ...rest] = input.split(/\s+/)
+  const cmd = (cmdRaw ?? '').toLowerCase()
+  const args = rest.join(' ').trim()
+  const dir = argValue(args, '--dir')
+
+  try {
+    if (cmd === '' || cmd === 'status') return textStatus(state, dir, await projectSummary(dir))
+    if (cmd === 'help') {
+      return ok('PPT 工作流命令：/ppt [on|off|free|mid|strict|fidelity <v>|review <v>|engine <v>|quality <v>|pause-after <v>|help]。语义检测自动进入；命令强制优先。')
+    }
+    if (cmd === 'on') { state.routing = 'on'; state.workflowActive = true; await save(); return ok('✓ PPT 工作流已强制进入（语义退出已屏蔽）') }
+    if (cmd === 'off') {
+      state.routing = 'off'; state.workflowActive = false
+      await save()
+      return ok('✓ PPT 工作流已退出（PPT 任务将按标准模式能力处理）')
+    }
+    if (cmd === 'free' || cmd === 'mid' || cmd === 'strict') {
+      state.mode = cmd
+      await save()
+      return ok(`✓ 协作模式=${cmd}（下次任务生效；free 可跳过询问环节）`)
+    }
+    if (cmd === 'quick') {
+      state.quick = true
+      await save()
+      return ok('✓ 快速模式已开启：低 token 快交付——跳过视觉定调/素材搜索/视觉审阅迭代；数字门禁照跑；回完整模式用 /ppt normal')
+    }
+    if (cmd === 'normal') {
+      state.quick = false
+      await save()
+      return ok('✓ 已回到完整模式（视觉定调/素材/审阅迭代恢复）')
+    }
+    if (cmd === 'fidelity') {
+      const v = (args.split(' ')[0] ?? '').toLowerCase()
+      if (!['strict', 'auto', 'free'].includes(v)) return err('fidelity 取值 strict|auto|free')
+      state.fidelity = v
+      await save()
+      const pageN = argValue(args, '--page')
+      if (pageN && dir) {
+        const proj = await loadProject(dir)
+        proj.spec = proj.spec ?? {}
+        const idx = Number(pageN) - 1
+        for (const p of (proj.spec.pages ?? [])) { void p }
+        await saveProject(dir, proj)
+        return ok(`✓ 会话忠实度=${v}${pageN ? `（--page ${pageN} 已记录，页面级 fidelity 由模型写入 spec.pages）` : ''}`)
+      }
+      return ok(`✓ 内容忠实度=${v}`)
+    }
+    if (cmd === 'review') {
+      const v = (args.split(' ')[0] ?? '').toLowerCase()
+      if (!['none', 'points', 'every'].includes(v)) return err('review 取值 none|points|every')
+      state.review = v
+      await save()
+      return ok(`✓ 审阅频率=${v}`)
+    }
+    if (cmd === 'engine') {
+      const v = (args.split(' ')[0] ?? '').toLowerCase()
+      // pptxgenjs **未实现**（v1.0 前按计划不动）。旧实现把它收下、回执"已记录（待接入）"并写进会话状态，
+      // 而导出侧根本不认它 ⇒ 用户以为选了引擎，实际静默按 pptd 跑。未实现就明确拒绝，不装作成功。
+      if (v === 'pptxgenjs') return err('pptxgenjs 第三引擎**未实现**（v1.0 前按计划不动，见 docs/04）——不会静默切到 pptd。可用：auto|pptd|python-pptx')
+      if (!['auto', 'pptd', 'python-pptx'].includes(v)) return err('engine 取值 auto|pptd|python-pptx')
+      state.engine = v
+      await save()
+      return ok(`✓ 引擎=${v}（auto = pptd 主引擎 + 硬失败时兜底 python-pptx；此设置会被 ppt_export 采纳）`)
+    }
+    if (cmd === 'quality') {
+      const v = (args.split(' ')[0] ?? '').toLowerCase()
+      if (!['quick', 'standard', 'audit'].includes(v)) return err('quality 取值 quick|standard|audit')
+      state.quality = v
+      await save()
+      if (dir) { const proj = await loadProject(dir); proj.quality = v; await saveProject(dir, proj) }
+      return ok(`✓ 质量模式=${v}`)
+    }
+    if (cmd === 'template') {
+      const v = (args.split(' ')[0] ?? '').trim()
+      if (!v) {
+        const { listTemplates } = await import('./templates.js')
+        const list = await listTemplates()
+        if (!list.length) return err('模板库为空（templates/ 缺失）')
+        state.template = undefined
+        await save()
+        return ok(`可用模板（${list.length} 套）：${list.map((t) => `${t.id}=${t.name}`).join('、')}\n用法：/ppt template <id>（记录本会话默认模板；用 ppt_templates 看完整清单与预览图）`)
+      }
+      const { templateWorkspace } = await import('./templates.js')
+      try {
+        const t = await templateWorkspace(v)
+        state.template = v
+        await save()
+        return ok(`✓ 本会话默认模板=${t.meta.name ?? v}（${v}）——S0/S2 优先使用；新建工作区：ppt_new dir=<目录> template=${v}`)
+      } catch (e) {
+        return err(String(e?.message ?? e))
+      }
+    }
+    if (cmd === 'pause-after') {
+      const v = (args.split(' ')[0] ?? '').toLowerCase()
+      if (!['outline', 'layout', 'pages', 'overall', 'none'].includes(v)) return err('pause-after 取值 outline|layout|pages|overall|none')
+      if (v === 'none') state.pauseAfter = []
+      else state.pauseAfter = [...new Set([...state.pauseAfter, v])]
+      await save()
+      if (dir) { const proj = await loadProject(dir); proj.pauseAfter = state.pauseAfter; await saveProject(dir, proj) }
+      return ok(`✓ 暂停点=${state.pauseAfter.join('、') || '无'}`)
+    }
+    return err(`未知子命令 "${cmd}"；/ppt help 查看用法`)
+  } catch (error) {
+    return { kind: 'error', text: `ppt 命令失败：${error?.message ?? error}` }
+  }
+
+  async function save() { await saveSession(sessionId, state) }
+}
+
+async function projectSummary(dir) {
+  if (!dir) return []
+  const proj = await loadProject(dir)
+  return [`项目(${dir}): 任务 ${proj.taskType ?? '—'}｜阶段 ${proj.stage ?? '—'}｜质量 ${proj.quality}`]
+}
+
+function textStatus(state, dir, extra) {
+  const lines = [
+    `PPT 工作流：${state.workflowActive ? '✓ 激活中' : '未激活'}（routing=${state.routing}，语义自动/命令强制）`,
+    `快速模式=${state.quick ? 'on（跳过定调/素材/视觉审阅迭代）' : 'off'}｜协作模式=${state.mode}｜忠实度=${state.fidelity}｜审阅=${state.review}｜质量=${state.quality}｜引擎=${state.engine}（auto=pptd）`,
+    `暂停点=${state.pauseAfter.length ? state.pauseAfter.join('、') : '无'}${state.template ? `｜模板=${state.template}` : ''}`,
+    ...extra,
+    '',
+    '/ppt [on|off|quick|normal|free|mid|strict|fidelity <v>|review <v>|engine <v>|quality <v>|template <id>|pause-after <v>|help]',
+  ]
+  return ok(lines.join('\n'))
+}
+
+function argValue(input, name) {
+  const m = input.match(new RegExp(`${name}\\s+(\"[^\"]+\"|'[^']+'|\\S+)`))
+  return m ? m[1].replace(/^["']|["']$/g, '') : null
+}
+
+function ok(text) { return { kind: 'success', text } }
+function err(text) { return { kind: 'error', text } }