skill-forge-hub 0.4.0 → 0.5.1

package/deck-stage/package-lock.json

@@ -0,0 +1,172 @@
+{
+  "name": "deck-stage",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "deck-stage",
+      "version": "1.0.0",
+      "license": "ISC",
+      "dependencies": {
+        "pptxgenjs": "^4.0.1"
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "22.20.5",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.20.5.tgz",
+      "integrity": "sha512-U2+DNr+wSjpsTS/wZGYHq7GcwfuSmKiKvoPvK22zwTlRhU91yOniN4qRR5KhIjvif7ysw/dz/hKmfDH0Ris4aA==",
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/core-util-is": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
+      "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
+      "license": "MIT"
+    },
+    "node_modules/https": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/https/-/https-1.0.0.tgz",
+      "integrity": "sha512-4EC57ddXrkaF0x83Oj8sM6SLQHAWXw90Skqu2M4AEWENZ3F02dFJE/GARA8igO79tcgYqGrD7ae4f5L3um2lgg==",
+      "license": "ISC"
+    },
+    "node_modules/image-size": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/image-size/-/image-size-1.2.1.tgz",
+      "integrity": "sha512-rH+46sQJ2dlwfjfhCyNx5thzrv+dtmBIhPHk0zgRUukHzZ/kRueTJXoYYsclBaKcSMBWuGbOFXtioLpzTb5euw==",
+      "license": "MIT",
+      "dependencies": {
+        "queue": "6.0.2"
+      },
+      "bin": {
+        "image-size": "bin/image-size.js"
+      },
+      "engines": {
+        "node": ">=16.x"
+      }
+    },
+    "node_modules/immediate": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz",
+      "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==",
+      "license": "MIT"
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/isarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
+      "license": "MIT"
+    },
+    "node_modules/jszip": {
+      "version": "3.10.2",
+      "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.2.tgz",
+      "integrity": "sha512-3l+rb15IOWtUhU0H5MFqES/T6Kh7abYwjosBey/vD6hDt8zoEffkSC5Ws5SGtgVw3gBx2NEbhTeSW1+kWkpyTQ==",
+      "license": "(MIT OR GPL-3.0-or-later)",
+      "dependencies": {
+        "lie": "~3.3.0",
+        "pako": "~1.0.2",
+        "readable-stream": "~2.3.6",
+        "setimmediate": "^1.0.5"
+      }
+    },
+    "node_modules/lie": {
+      "version": "3.3.0",
+      "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz",
+      "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==",
+      "license": "MIT",
+      "dependencies": {
+        "immediate": "~3.0.5"
+      }
+    },
+    "node_modules/pako": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz",
+      "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==",
+      "license": "(MIT AND Zlib)"
+    },
+    "node_modules/pptxgenjs": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/pptxgenjs/-/pptxgenjs-4.0.1.tgz",
+      "integrity": "sha512-TeJISr8wouAuXw4C1F/mC33xbZs/FuEG6nH9FG1Zj+nuPcGMP5YRHl6X+j3HSUnS1f3at6k75ZZXPMZlA5Lj9A==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "^22.8.1",
+        "https": "^1.0.0",
+        "image-size": "^1.2.1",
+        "jszip": "^3.10.1"
+      }
+    },
+    "node_modules/process-nextick-args": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
+      "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
+      "license": "MIT"
+    },
+    "node_modules/queue": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/queue/-/queue-6.0.2.tgz",
+      "integrity": "sha512-iHZWu+q3IdFZFX36ro/lKBkSvfkztY5Y7HMiPlOUjhupPcG2JMfst2KKEpu5XndviX/3UhFbRngUPNKtgvtZiA==",
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "~2.0.3"
+      }
+    },
+    "node_modules/readable-stream": {
+      "version": "2.3.8",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
+      "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
+      "license": "MIT",
+      "dependencies": {
+        "core-util-is": "~1.0.0",
+        "inherits": "~2.0.3",
+        "isarray": "~1.0.0",
+        "process-nextick-args": "~2.0.0",
+        "safe-buffer": "~5.1.1",
+        "string_decoder": "~1.1.1",
+        "util-deprecate": "~1.0.1"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
+      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+      "license": "MIT"
+    },
+    "node_modules/setimmediate": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
+      "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
+      "license": "MIT"
+    },
+    "node_modules/string_decoder": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
+      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.1.0"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "license": "MIT"
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "license": "MIT"
+    }
+  }
+}

package/deck-stage/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "deck-stage",
+  "version": "1.0.0",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "pptxgenjs": "^4.0.1"
+  }
+}

package/deck-stage/resources/cover-template.html

@@ -0,0 +1,139 @@
+<!DOCTYPE html>
+<html lang="zh-CN" data-theme="tech">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>PPT 封面底版</title>
+<style>
+  /* ⛔ 封面/亮点页截图模板（静态版式，无动画，保截图零风险）
+     视觉与报告深蓝面板体系同源；AI 执行时替换 <script> 内 COVER 数据后经 Chrome headless 截图。
+     四主题经 html[data-theme] 切换；截图窗口 1280x720（16:9）。 */
+  :root{
+    --bg:#0a1929; --panel:#0b1e37; --panel-line:#0f3350; --text:#e6f1ff; --muted:#8892b0;
+    --accent:#38bdf8; --accent2:#0ea5e9; --border:#1e3a5f; --glow:rgba(14,165,233,.25);
+    --title-mid:#ffffff;
+  }
+  html[data-theme="biz"]{ --bg:#ffffff; --panel:#f8fafc; --panel-line:#e2e8f0; --text:#0f172a; --muted:#64748b; --accent:#2563eb; --accent2:#1d4ed8; --border:#e2e8f0; --glow:rgba(37,99,235,.14); --title-mid:#1e40af; }
+  html[data-theme="mono"]{ --bg:#ffffff; --panel:#ffffff; --panel-line:#d4d4d4; --text:#111111; --muted:#666666; --accent:#000000; --accent2:#333333; --border:#cccccc; --glow:rgba(0,0,0,.08); --title-mid:#555555; }
+  html[data-theme="warm"]{ --bg:#1c0f0f; --panel:#2a1717; --panel-line:#4a2f1f; --text:#fff1e6; --muted:#c4a98f; --accent:#fdba74; --accent2:#f97316; --border:#4a2f1f; --glow:rgba(249,115,22,.22); --title-mid:#ffffff; }
+  *{ margin:0; padding:0; box-sizing:border-box; }
+  body{
+    width:1280px; height:720px; overflow:hidden; position:relative;
+    background:var(--bg); color:var(--text);
+    font-family:"PingFang SC","Microsoft YaHei","Source Han Sans SC",sans-serif;
+  }
+  /* 三层科技底纹（静态） */
+  .bg-grid{ position:absolute; inset:0;
+    background-image:linear-gradient(rgba(0,240,255,.03) 1px,transparent 1px),
+                     linear-gradient(90deg,rgba(0,240,255,.03) 1px,transparent 1px);
+    background-size:60px 60px; }
+  .bg-stars{ position:absolute; inset:0;
+    background-image:radial-gradient(1px 1px at 12% 18%,rgba(255,255,255,.9),transparent),
+                     radial-gradient(1.2px 1.2px at 88% 12%,rgba(0,240,255,.7),transparent),
+                     radial-gradient(1px 1px at 72% 82%,rgba(167,139,250,.8),transparent),
+                     radial-gradient(1.5px 1.5px at 8% 78%,rgba(94,234,212,.7),transparent),
+                     radial-gradient(1px 1px at 42% 32%,rgba(253,186,116,.7),transparent),
+                     radial-gradient(1.2px 1.2px at 62% 66%,rgba(244,114,182,.6),transparent),
+                     radial-gradient(1px 1px at 32% 92%,rgba(0,240,255,.6),transparent),
+                     radial-gradient(1px 1px at 94% 44%,rgba(255,255,255,.8),transparent); }
+  .bg-noise{ position:absolute; inset:0; opacity:.04;
+    background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='120' height='120'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='2'/%3E%3C/filter%3E%3Crect width='120' height='120' filter='url(%23n)'/%3E%3C/svg%3E"); }
+  /* 顶部光斑（静态） */
+  .card-glow{ position:absolute; top:0; left:50%; transform:translateX(-50%) scale(1.6); width:70%; height:55%;
+    background:radial-gradient(ellipse at 50% 10%,var(--glow),transparent 70%); pointer-events:none; }
+  /* 主体 */
+  .wrap{ position:relative; z-index:2; height:100%; display:flex; flex-direction:column; padding:56px 72px 40px; }
+  .badge{ align-self:flex-start; font-size:13px; letter-spacing:.22em; color:var(--muted);
+    border:1px solid var(--border); border-radius:999px; padding:7px 18px; }
+  .center{ flex:1; display:flex; flex-direction:column; justify-content:center; }
+  .title{ font-size:58px; font-weight:800; line-height:1.25; letter-spacing:.02em;
+    background:linear-gradient(120deg,var(--accent) 0%,var(--title-mid) 55%,var(--accent2) 100%);
+    -webkit-background-clip:text; background-clip:text; color:transparent;
+    filter:drop-shadow(0 0 18px var(--glow)) drop-shadow(0 0 6px var(--glow)); }
+  .subtitle{ margin-top:22px; font-size:20px; color:var(--muted); letter-spacing:.06em; }
+  .rule{ margin-top:30px; width:210px; height:3px; border-radius:2px;
+    background:linear-gradient(90deg,var(--accent),transparent); }
+  /* 数据卡横排 */
+  .stats{ display:flex; gap:22px; margin-top:46px; }
+  .stat{ flex:1; background:var(--panel); border:1px solid var(--panel-line); border-radius:8px;
+    padding:18px 22px; position:relative; overflow:hidden; }
+  .stat::before{ content:""; position:absolute; left:0; top:14px; bottom:14px; width:5px; border-radius:0 3px 3px 0;
+    background:linear-gradient(180deg,var(--accent),var(--accent2)); box-shadow:0 0 10px var(--glow); }
+  .stat .v{ font-size:34px; font-weight:800;
+    background:linear-gradient(120deg,var(--accent),var(--accent2));
+    -webkit-background-clip:text; background-clip:text; color:transparent; }
+  .stat .l{ margin-top:6px; font-size:13px; color:var(--muted); }
+  .stat .d{ margin-top:6px; font-size:11.5px; font-weight:700; }
+  .stat .d.up{ color:#34d399; } .stat .d.down{ color:#fb7185; }
+  /* 底栏 */
+  .foot{ display:flex; justify-content:space-between; align-items:center; margin-top:38px;
+    font-size:13px; color:var(--muted); }
+  .foot .info span{ margin-right:26px; }
+  .foot .brand{ letter-spacing:.18em; font-size:11px; }
+  /* 结尾版式 */
+  body.mode-closing .center{ align-items:center; text-align:center; }
+  body.mode-closing .badge{ align-self:center; }
+  body.mode-closing .rule{ margin-left:auto; margin-right:auto;
+    background:linear-gradient(90deg,transparent,var(--accent),transparent); }
+  body.mode-closing .foot{ justify-content:center; }
+  body.mode-closing .stats{ display:none; }
+  /* 浅色主题适配：标题渐变不发虚、网格星点换深色、白卡靠投影分层 */
+  html[data-theme="biz"] .title, html[data-theme="mono"] .title{ filter:none; }
+  html[data-theme="biz"] .bg-grid, html[data-theme="mono"] .bg-grid{
+    background-image:linear-gradient(rgba(15,23,42,.05) 1px,transparent 1px),
+                     linear-gradient(90deg,rgba(15,23,42,.05) 1px,transparent 1px); }
+  html[data-theme="biz"] .bg-stars, html[data-theme="mono"] .bg-stars{ opacity:.3; filter:grayscale(1) invert(1); }
+  html[data-theme="biz"] .stat, html[data-theme="mono"] .stat{ box-shadow:0 2px 10px rgba(0,0,0,.06); }
+</style>
+</head>
+<body class="mode-cover">
+  <div class="bg-noise"></div>
+  <div class="bg-grid"></div>
+  <div class="bg-stars"></div>
+  <div class="card-glow"></div>
+  <div class="wrap">
+    <div class="badge" id="badge">GENERATED BY SPECCORE TEAM</div>
+    <div class="center">
+      <div class="title" id="title">2026 研发年度总结</div>
+      <div class="subtitle" id="subtitle">资深研发工程师 · 全栈方向</div>
+      <div class="rule"></div>
+      <div class="stats" id="stats"></div>
+    </div>
+    <div class="foot">
+      <div class="info"><span id="info">2026-01-01 ~ 2026-12-31 · 生成于 2026-11-11</span></div>
+      <div class="brand">GENERATED BY SPECCORE TEAM</div>
+    </div>
+  </div>
+<script>
+/* ── COVER 数据（AI 执行时替换此对象内容） ─────────────────────── */
+var COVER = {
+  mode: "cover",                 // cover 封面 / closing 结尾
+  badge: "GENERATED BY SPECCORE TEAM",
+  title: "2026 研发年度总结",
+  subtitle: "资深研发工程师 · 全栈方向",
+  info: "2026-01-01 ~ 2026-12-31 · 生成于 2026-11-11",
+  stats: [                        // 3-4 张数据卡；closing 模式忽略
+    { value: "486", label: "全年提交", delta: "较去年 +18%", up: true },
+    { value: "12.6万", label: "增删代码行", delta: "核心模块重构", up: true },
+    { value: "9", label: "版本里程碑", delta: "4 次大版本", up: true }
+  ]
+};
+(function apply(){
+  document.body.className = COVER.mode === "closing" ? "mode-closing" : "mode-cover";
+  document.getElementById("badge").textContent = COVER.badge || "";
+  document.getElementById("title").textContent = COVER.title || "";
+  document.getElementById("subtitle").textContent = COVER.subtitle || "";
+  document.getElementById("info").textContent = COVER.info || "";
+  var box = document.getElementById("stats");
+  box.innerHTML = "";
+  (COVER.stats || []).slice(0, 4).forEach(function(s){
+    var d = document.createElement("div");
+    d.className = "stat";
+    d.innerHTML = '<div class="v">' + s.value + '</div><div class="l">' + s.label + '</div>' +
+      (s.delta ? '<div class="d ' + (s.up === false ? "down" : "up") + '">' + s.delta + "</div>" : "");
+    box.appendChild(d);
+  });
+})();
+</script>
+</body>
+</html>

package/deck-stage/resources/data-schema.md

@@ -0,0 +1,111 @@
+# data.json Schema 与转换规则
+
+`pptx-builder.js` 的输入是结构化 `data.json`。AI 执行时从报告（md/HTML/口述大纲）或散装素材提炼本结构后调用生成器。
+
+## 一、完整 Schema
+
+```json
+{
+  "meta": {
+    "title": "2026 研发年度总结",          // pptx 文档标题
+    "subtitle": "资深研发工程师 · 全栈方向",  // 封面副标题（可选）
+    "footer": "GENERATED BY SPECCORE TEAM · 2026"   // 每页页脚（可选，缺省 GENERATED BY SPECCORE TEAM）
+  },
+  "theme": "tech",                          // tech（默认）/ biz / mono / warm，与报告四主题同源
+  "pages": [
+    { "type": "cover-image",  "image": "/abs/path/cover.png",
+      "notes": "开场白：各位好，今天汇报本年度研发工作，先看总体数字……" },
+    { "type": "overview", "title": "年度概览", "color": "blue", "tlDr": "一句话结论",
+      "stats": [ { "value": "486", "label": "全年提交", "delta": "较去年 +18%", "deltaUp": true } ] },
+    { "type": "timeline", "title": "核心成果与里程碑", "color": "green",
+      "items": [ { "q": "Q1", "desc": "描述", "metric": "量化小字" } ] },
+    { "type": "bullets", "title": "经验与成长", "color": "purple",
+      "image": "/abs/path/photo.png",        // 可选：右侧配图（contain 等比内嵌，仅第一页带图）
+      "items": [ { "t": "条目标题", "d": "条目描述" } ] },
+    { "type": "chart", "title": "月度提交分布", "color": "orange",
+      "values": [12, 45, 67], "labels": ["1月", "2月", "3月"] },
+    { "type": "chart-pie", "title": "技术栈占比", "color": "green",
+      "items": [ { "label": "前端", "value": 45 }, { "label": "后端", "value": 38 } ],
+      "percent": true, "donut": false },     // percent=true 显示百分比；donut=true 空心环
+    { "type": "chart-line", "title": "提交趋势", "color": "blue",
+      "labels": ["1月", "2月", "3月"], "smooth": true,
+      "series": [ { "name": "提交数", "values": [32, 41, 38] }, { "name": "评审数", "values": [20, 30, 26] } ] },
+    { "type": "closing-image", "image": "/abs/path/closing.png",
+      "notes": "收尾：以上是本年度汇报，感谢聆听，欢迎指正。" }
+  ]
+}
+```
+
+## 二、页类型与版式说明
+
+| 类型 | 版式 | 分页规则 |
+|:---|:---|:---|
+| `cover-image` | 整页铺图（封面截图，无任何装饰元素） | 固定 1 页 |
+| `overview` | 节色竖线 + 标题 + TL;DR 一行 + 数据卡 3-6 张横排（大数字/标签/同比，左侧小色条） | 数据卡超 6 张自动截断 |
+| `timeline` | 节色竖线 + 时间线 + 季度节点圆 + 条目（描述 + 量化小字） | 每页 8 条自动续页，q 字段带入 |
+| `bullets` | 序号圆球徽章 + 标题 + 描述（可选右侧配图） | 每页 6 条自动续页 |
+| `chart` | 自绘圆角柱 + 柱顶数值 + 底部标签（基线细线） | 固定 1 页，柱数不限（自动算宽） |
+| `chart-pie` | 原生饼图（PPT 内可直接编辑数据），图例右侧 | 固定 1 页 |
+| `chart-line` | 原生折线（PPT 内可直接编辑数据），多系列可选 | 固定 1 页 |
+| `closing-image` | 整页铺图（结尾截图） | 固定 1 页 |
+
+**color 取值**（五段节色，与年报同款）：`blue` 概览 / `green` 成果 / `purple` 成长 / `rose` 反思 / `orange` 展望。
+
+**数值纪律（沿用三件套量化转型规范）**：业务结果指标优先（响应时间/转化率/成功率），git 统计兜底；数字凡有对比基准必带（同比/环比）；deltaUp=false 时同比红色。
+
+## 三、演讲备注（notes）
+
+- 每页可带 `notes` 字段（字符串），写入该页演讲者备注：开场白/数据解读/过渡句，不写正文照读
+- 自动续页页型（timeline/bullets）用 `notesList` 数组按分页逐页写（第 0 项写第一页，以此类推）；`notes` 字符串只写在该类型第一页
+- 话术按 user-config.md 的 AUDIENCE 画像调整语气与深度
+
+## 四、报告 → data.json 段落映射
+
+### 年报（五段式）
+
+| 报告段落 | 页类型 | color |
+|:---|:---|:---|
+| 年度概览（TL;DR + 数据卡） | `cover-image`（数据卡上封面）+ `overview`（TL;DR + 数据卡） | blue |
+| 核心成果与里程碑（Q1-Q4 时间线） | `timeline`（q=Q1..Q4，desc=成果描述，metric=量化小字） | green |
+| 经验与成长 | `bullets`（t=条目标题，d=描述） | purple |
+| 不足与反思 | `bullets` | rose |
+| 新年展望与规划 | `bullets`（t=目标，d=量化指标与行动节点） | orange |
+| 月度提交柱图 | `chart`（values=12 个月提交数，labels=1月..12月） | orange |
+| 技术栈占比/构成类数据 | `chart-pie`（items=构成项） | green |
+| 多期趋势对比（提交/工时双线等） | `chart-line`（series=多系列） | blue |
+| — | `closing-image`（谢谢观看 + 署名） | — |
+
+### 周报
+
+| 报告段落 | 页类型 | color |
+|:---|:---|:---|
+| 本周结论（三句卡） | `overview`（TL;DR=最重要结果，stats=结论三句或量化指标） | blue |
+| 本周任务进度 | `timeline`（q=周一..周五 或任务名，desc=任务+完成标准） | green |
+| 风险阻塞（四环） | `bullets`（t=问题，d=影响+建议+责任与时间） | rose |
+| 下周计划 | `bullets`（t=任务，d=完成标准） | orange |
+| 提交节奏柱图 | `chart`（values=每日提交数，labels=周一..周五） | orange |
+| 一周提交趋势 | `chart-line`（values=每日提交数，labels=周一..周五，smooth=true） | blue |
+
+### 日报
+
+| 报告段落 | 页类型 | color |
+|:---|:---|:---|
+| TL;DR | `overview`（tlDr + stats=量化指标 2-3 张） | blue |
+| 今日任务进度 | `bullets`（t=任务，d=进度与数据） | green |
+| 明日计划 | `bullets`（t=任务，d=完成标准） | orange |
+| 风险阻塞 | `bullets`（t=问题，d=影响+建议） | rose |
+
+### 通用规则
+
+- 素材入口四通道：指定目录（扫 md/txt/docx）/ 指定文件 / 贴文字 / 口述主题；无现成报告时按上述结构先提炼要点，写作规范沿用专业汇报 A/B/C 档（结论先行、量化优先、计划可验证）
+- 报告含截图/图表素材 → 按需复用（报告 HTML 头部截图可作封面；bullets 页配图用 page.image）
+- 无封面素材时一律用 `cover-template.html` 生成：AI 替换模板内 `COVER` 对象（mode/title/subtitle/info/stats）→ 临时 HTML → Chrome headless 截图 1280x720 → cover.png；`mode: closing` 生成结尾页
+- `image` 一律用绝对路径（builder 按路径嵌入）
+
+## 五、执行命令
+
+```bash
+cd <skill目录> && node resources/pptx-builder.js --data <data.json绝对路径> --out <输出pptx绝对路径>
+```
+
+输出 `PPTX_OK <绝对路径>` 即成功。生成后校验：文件存在 + 大小 > 20KB + `unzip -l` 含 `ppt/slides/slide*.xml` 且页数 = data.json pages 数（自动续页后以实际页数为准）。