培训工坊 (Training Workshop)

概述

将一个培训主题或一份业务素材，转化为专业、可直接使用的培训材料。支持两种输出形态，并可将成果导出为 Word / Excel / PPT / PDF / 图片多种格式：

• 形态 A：互动脑图培训文档（HTML 单文件）——用户提到 HTML / 互动脑图 / 穿透式 / 脑图时的默认形态，详见第三步 A
• 形态 B：成套培训材料——大纲 + PPT + 讲师手册 + 学员讲义 + 考核题，详见第三步 B
• 多格式导出——用户要求 Word / Excel / PPT / PDF / 图片时，按第三步 C 执行

工作流程

严格按以下五步执行，不得跳步。

第一步：收集培训需求（必须）

在生成任何内容之前，先确认六要素：

1. 培训对象：岗位、背景、已有基础（如"零基础新客服"）
2. 培训目标 / 素材：培训后学员能做到什么；或用户直接提供的业务素材文档
3. 形式：HTML 互动脑图 / 成套材料 / 时长 / 线上线下
4. 已有素材：用户是否提供文档、PPT、制度文件等参考资料
5. 目标格式：HTML（默认）/ Word / Excel / PPT / PDF / 图片，可多选
6. 是否提供模板：用户是否提供了 Word/Excel/PPT 等格式的模板文件（.docx/.xlsx/.pptx）。若有，收集模板文件路径，导出时走"模板继承模式"（见第三步 C 第 4 点），严格套用模板的样式、页眉页脚、LOGO、版式

• 若信息不全，一次性列出所缺关键问题询问用户（最多 4 个），不得分多次追问。
• 若用户已提供完整素材并说"先出一版看看"，直接按素材生成，不追问。
• 用户上传了模板文件但没说要导出对应格式时，主动确认："检测到您提供了 X 模板，是否需要按此模板格式生成 X 文档？"

第二步：确定输出形态（必须）

• 用户提到 HTML / 互动脑图 / 穿透式 / 脑图 任一关键词 → 走形态 A
• 用户明确要成套材料（课件、讲义、考题等多个组件）→ 走形态 B
• 用户提到 Word / Excel / PPT / PDF / 图片 / 导出 / 转格式 → 先完成形态 A 或 B 的内容生成，再走第三步 C 多格式导出（多格式导出必须以 HTML 母版内容为数据源）
• 无法判断 → 询问一次；若素材是一份结构化业务说明（如系统上线操作说明、业务规则文档），默认走形态 A

第三步 A：互动脑图培训文档（HTML 单文件）

生成前必须先读取 assets/interactive-mindmap-template.html（黄金模板），严格遵循其架构、交互与视觉规范，只替换内容。核心规范：

1. 整体架构：双视图单文件
- 脑图视图（首页）：全屏 SVG 脑图，根节点居左、分支向右展开，用正交圆角折线连接；顶栏含标题徽标 + "点击节点穿透查看"提示（带脉冲圆点动画）；底部一行操作提示（悬停高亮、点击进入详情、ESC 返回）
- 详情视图：点击任意节点后整页切换（带滑动过渡动画），顶部含"← 返回脑图"按钮、面包屑路径、上一页/下一页导航（叶子节点按业务顺序编号显示如"1 / 7"，根/分支节点显示"总览"）；按 ESC 键返回脑图
- 所有 CSS/JS 内联，无任何外部依赖，双击即可离线打开

2. 脑图布局与视觉规范（E 商务简约风，用户已确认）
- 【数据驱动布局，强制】脑图节点的 x/y 坐标必须由 references/build_map.py 算法生成，禁止手写坐标。已知踩坑：模型手写 SVG 时逐个 y++ 排节点，导致分支与叶子不在同列对齐、不同分支的叶子交错重叠、连接线长距离斜跳难看。正确流程：①按素材整理 branches: [{name, sub, icon, leaves: [{name, sub, icon, id}]}] 数据结构 → ②调用 python references/build_map.py --data data.json --out map.html 由算法计算坐标并渲染 → ③嵌入母版。算法已内建：组内 14px 等距、组间 30px 间隔、分支 Y = 叶子组中心、根 Y = 第一与最末分支中心中点、三列严格对齐（X_ROOT=20 / X_BR=270 / X_LEAF=530）、正交圆角折线（10px Q 曲线过渡）。所有手写 SVG 的历史文件也可用 python references/relayout_map.py input.html -o output.html 一键重排
- 布局规整：连接线用正交圆角折线（横-竖-横走线，拐角用 10px 圆弧 Q 曲线过渡，禁止直角尖角和贝塞尔曲线）；三列严格对齐（根节点列 / 分支列 / 叶子列，各列 x 坐标统一）；叶子节点统一尺寸、等间距垂直排列；分支节点垂直居中于其子节点块；根节点垂直居中于两分支中心连线的中点
- 节点样式：根节点=深墨色块（#24292F）白字；分支节点=彩色浅底+彩边+emoji图标+两行文字；叶子节点=白底细边+左缘 4px 彩色竖条+emoji 图标+两行文字（15px 加粗深色主标题 + 12px 灰色副标题）
- 节点两级文字：主标题 + 副标题。副标题用一句话概括核心结论（如"已入库未收票 → 确认应付"），让学员不点开也能看懂全貌
- 节点文字长度硬约束（排版质量硬底线，任何节点文字超出此约束都会溢出节点边界，必须在生成时把控）：

• 副标题紧凑箭头规范：流程链副标题用紧凑箭头 "→"（箭头两侧无空格），如 "合同→订单→入库→结算"；禁止写成 "合同 → 订单 → 入库 → 结算"（带空格会使文字长度增加约 30%，直接撑爆 220px 节点）
• "业务状态 → 处理结果"格式：状态部分用紧凑短词（4-6 字），处理结果用动词+宾语（4-6 字），整体不超过 12 字。如 "未收票→确认应付"（4+4）而非 "未收票未付款 → 财务部门请款"（超长）
• 绝对禁止在 sub 字段前自动追加 "X 节 ·" 前缀（如 "10节·合同→订单→入库→结算"）——节点本身已通过 emoji 与色条区分，节数信息会放到模块分隔页 .mpg-pill 列表中独立展示。这是已知踩坑：模型常自作聪明拼前缀导致文字溢出
• 超长怎么办：宁可拆成两个叶子节点，也不要硬塞长文字进一个节点；宁可精简表述，也不要保留冗余修饰（如"信息化系统中的..."、"在业务流程里我们需要..."）
• 配色体系（严格沿用）：双分支 蓝 #2563EB / 青 #0E9488，分支浅底 #EFF4FE / #EBF7F4；连接线中性灰 #C7CEDA；页面背景纯白偏冷 #FBFCFD + 极淡点阵网格（24px 间距）；底部提示条琥珀色（#FFFBEB 底 / #E8C86E 边 / #92600A 字）；强调/悬停用分支本色
• 交互：悬停节点上浮 2px + 边框变分支色 + 柔和投影；点击穿透详情页
• 全局性口径信息（如"数据基准：2026年8月结账后数据为准"）以琥珀色提示条（带 📌）置于脑图底部，不做成普通节点

3. 详情页内容模块（根据素材内容按需选用，忠实呈现）
- 场景说明（scenario 框）：该业务是什么、适用什么场景，用左侧色条引用样式
- 核心字段：字段网格卡片（chip），关键字段橙色高亮；若存在编码/编号规则，用"规则框"呈现：规则标签 + 大号公式（如"批号 = QC + 仓库编码 + 0001"）+ 等宽字体示例（如"仓库编码 HL01 → 批号 QCHL010001"）+ 递增说明
- 操作步骤：带编号圆圈标记的步骤列表
- 业务流转：流程链（chips + 橙色箭头），如"已入库 → 未收票 → 纳入系统 → 确认应付"
- 关联业务：绿色关系卡片，说明与其他单据/业务的闭环关系（如适用）
- 重点提醒：三色提示框——success（绿色✔）/ warning（橙色⚠）/ info（蓝色ℹ），按信息性质选用
- 分支节点与根节点也要有总览详情页（汇总该分支的要点清单）
- 每个详情页带分类徽标（含 emoji 图标，如"📦 库存初始化 · 单据 2/5"）

4. 内容忠实原则（最高优先级）
- 以用户提供的素材为准，只做结构化与表述优化，不臆造素材之外的规则、数字、流程
- 禁止擅自添加用户未要求的模块：考核题、培训目标、名词解释、行动清单等一律不加——除非用户明确要求
- 素材中的专业术语若目标学员是零基础，可在场景说明中用一句话自然解释，不单独设"名词课堂"模块

第三步 B：成套培训材料

按用户指定生成；未指定时默认生成 PPT 课件 + 考核题。各材料规范（课程结构、时间分配、页面类型、题量难度等）依据 references/training-design-guide.md：

• PPT 课件：逐页输出，每页一个信息点；页面序列、要点条数、备注规范见指南
• 讲师手册 / 学员讲义 / 考核题：模板与出题规则（题型比例、布鲁姆难度梯度、干扰项设计）见指南

第三步 C：多格式导出（Word / Excel / PPT / PDF / 图片）

执行前必须先读取 references/format-export-guide.md。核心原则与路由：

1. 格式服务于内容（最高原则）
- 每种格式按其载体特性重组内容，不是简单转文件：HTML=互动脑图、PDF=可打印文档、Word=线性讲义、PPT=幻灯片、Excel=结构化表格、图片=高清快照
- 多格式导出以已生成的 HTML 母版（脑图节点结构 + 详情数据）为唯一数据源，确保各格式内容一致

2. 格式路由表
| 目标格式 | 内容重组方式 | 技术路线 |
|---------|-------------|---------|
| PDF | 封面 + 脑图全景整页 + 逐节点详情页线性排版 | 打印版 HTML → html-to-pdf skill |
| Word (.docx) | 培训讲义式：脑图层级→章节标题，详情模块→正文小节 | 语义化 HTML → html-to-docx skill |
| PPT (.pptx) | 封面 + 总览 + 每叶子节点 1 页 + 结尾页 | tencent-pptx skill（配色沿用蓝 #2563EB / 青 #0E9488） |
| Excel (.xlsx) | 节点清单表 / 字段明细表 / 单据对照表 / 考题库 | sheetagent（tencent-docs-sheet-generation）或 openpyxl |
| 图片 (PNG) | 脑图全景图 + 每节点详情卡片图 | html-pages-to-images skill 截图（≥1920px 宽） |

3. 执行要求
- 优先调用 Skill 工具加载上述对应技能，按其工作流执行；技能不可用时降级为本地脚本方案（Puppeteer / python-docx / openpyxl / python-pptx）
- 用户要求的格式可能不止一种：逐个生成、逐个校验、最后一次性交付
- 文件命名：主题-格式.扩展名（如"供应链初始化-讲义.docx"）；图片按节点顺序编号

4. 模板继承模式（用户提供模板时启用）
- 触发：用户提供了 .docx / .xlsx / .pptx 模板文件，或明确说"按这个模板格式生成"
- 最高原则：忠实复用模板——严格继承模板的页眉页脚、LOGO、字体字号、段落间距、配色、表格样式、幻灯片版式，只把内容填入模板既有的占位结构，禁止用技能默认样式覆盖模板样式
- 各格式技术路线（详见 references/format-export-guide.md 第五节）：
- Word 模板：tencent-local-office-edit skill 本地实时编辑，或 python-docx 打开模板复用 styles.xml；保留模板的标题样式、正文样式、页眉页脚
- Excel 模板：openpyxl load_workbook(template, keep_vba=True) 加载，向模板既有 sheet/cell 填充数据，保留模板格式与宏
- PPT 模板：ppt-win32com-editor skill（专做"在原文件基础上编辑，保留所有原始布局、图片、形状、渐变背景和特效"）或 python-pptx Presentation(template) 复用 slide layouts
- PDF 模板：用户提供的 PDF 多作背景水印，用 reportlab 叠加内容；或用户提供设计稿 PDF → 先提取视觉规范转 HTML 母版
- 填充策略：先识别模板中可填充的内容区域（占位符、标题位、正文区、表格区），再按脑图节点顺序映射到这些区域；无对应占位时追加到末尾，仍沿用模板样式
- 模板继承模式下，"格式服务于内容"原则依然成立（Word 仍是线性讲义、PPT 仍每页一信息点、Excel 仍是表格），只是视觉外壳换成用户模板

第四步：质量自检（生成后必须执行，必须实际校验而非心理打勾）

校验执行要求（强制）：
- 必须实际打开/校验每个生成文件，不能只凭清单"心理打勾"就交付
- 乱码检查：用脚本实际读取文件内容确认编码与结构（Python 读取确认 utf-8、python-docx/python-pptx/openpyxl 实际加载验证不报错、不丢内容）；HTML 用浏览器实际预览确认中文正常、布局未错位
- 格式检查：确认每个文件能被目标软件正常打开——Word/PPT/Excel 不损坏、PDF 无空白页/无乱码、图片清晰不模糊、表格未变形、字体正常显示
- 内容核对：将生成内容与用户素材逐项比对，确认无遗漏、无臆造、无错位、无显示异常
- 发现任何问题必须当场修复后重新校验，不得交付带病文件；修复后重新跑校验直至全绿

形态 A（互动脑图）自检清单：
- [ ] 素材中的每一个知识点都有对应节点，无遗漏、无臆造
- [ ] 每个叶子节点都有副标题（一句话结论）
- [ ] 节点文字长度在硬约束内（根主标题 ≤14、根副标题 ≤14、模块名 ≤6、分支副标题 ≤14/推荐 ≤10、叶子标题 ≤8、叶子副标题 ≤16）——未通过则必须精简或拆节点
- [ ] 分支副标题未私自追加"X 节·"前缀（节数信息统一放模块分隔页 pill 列表）
- [ ] 副标题箭头用紧凑 → 而非 → 带空格
- [ ] 全局口径信息已放入底部提示条
- [ ] 每个节点（含根/分支节点）点击都能进入详情页；叶子节点可上下页连续导航
- [ ] ESC 可返回脑图；返回按钮可用
- [ ] 分支配色清晰区分；单文件无外部依赖
- [ ] 未添加用户没要求的模块（考核题、目标、行动清单等）
- [ ] SVG 缩放不变形：容器用 overflow:auto + margin:0 auto（非 flex 居中），SVG 无 width="100%" 属性、有 preserveAspectRatio="xMidYMid meet"，缩放窗口时脑图等比缩放、不压扁
- [ ] 右侧滚动条存在：内容高于视口时 .map-container 出现垂直滚动条，可拖动查看底部节点；窗口极窄时出现水平滚动条（min-width:720px 兜底）

形态 B（成套材料）自检清单：
- [ ] 大纲每章是否直接支撑至少一个培训目标（目标覆盖）
- [ ] 语言难度是否匹配学员基础（零基础材料不出现未解释的专业术语）
- [ ] 各章时长合计是否等于总时长（误差 ±5 分钟内）
- [ ] 考核题是否覆盖全部章节
- [ ] 是否包含至少 2 处互动/练习环节（超过 40 分钟的培训）

多格式导出（第三步 C）自检清单：
- [ ] 文件可正常打开，中文无乱码，图片/表格不丢失
- [ ] 内容与 HTML 母版一致，无知识点遗漏
- [ ] 格式符合载体特性（Word 是讲义而非截图堆砌、Excel 是表格而非长文本、PPT 每页一个信息点）
- [ ] 各格式文件命名规范，一次性交付并全部 present_files 展示
- [ ] 模板继承模式（若启用）：页眉页脚/LOGO/字体/配色/版式与用户模板一致；模板既有样式未被默认样式覆盖；宏/公式未被破坏

第五步：输出格式确认与交付

5.1 输出格式确认（交付前必须执行）
- 若用户在第一步未明确指定目标格式，交付前必须主动询问一次："请问需要导出哪些格式的文档？可多选：① 互动脑图 HTML（默认）② Word 讲义 ③ Excel 数据表 ④ PPT 课件 ⑤ PDF ⑥ 图片"
- 不得自作主张生成用户没要求的格式，也不得漏掉用户明确要求的格式
- 用户已明确说要哪些格式时，直接执行，不再追问

5.2 交付
- 形态 A：保存为单个 HTML 文件（文件名含主题，如"XX业务-互动脑图.html"），保存到工作区，交付前必须使用 present_files 展示。
- 形态 B：默认以 Markdown 在对话中呈现；用户要求文件时按需生成 HTML / DOCX / PPTX。
- 多格式导出（第三步 C）：所有目标格式文件经第四步实际校验通过后，一次性 present_files 交付全部文件。
- 交付时附一份自检结果摘要（每个文件一行，如"✅ 供应链-讲义.docx：已校验，中文正常/表格完整/字体显示正常"或"❌ xxx：发现问题已修复"），让用户明确知道每个文件都过了实际校验。
- 输出末尾附一行提示："如需调整节点结构、配色或补充案例，请直接告知。"

边界（禁止事项）

• 禁止臆造公司内部数据、行业统计数字、法规条款原文；涉及法规、医疗、安全等专业内容时，在详情页提示"请以最新官方文件为准，建议专业人士审核"。
• 禁止在形态 A 中添加用户未要求的考核题、培训目标等扩展模块。
• 禁止在生成形态 A 之前不读取黄金模板 assets/interactive-mindmap-template.html。
• 禁止照抄用户提供的参考素材之外编造"根据贵司制度"类表述。
• 禁止手写 SVG 节点坐标（x/y/width/height/path d）。所有脑图节点布局由 references/build_map.py 算法生成；老手写文件用 references/relayout_map.py 一键重排。这是已知系统性问题：模型手写坐标会导致分支与叶子错位、节点重叠、连接线斜跳，已在多个历史文件（金蝶星瀚、北大荒费用报销等）反复出现
• 禁止让叶子节点跨分支穿插。叶子必须聚簇在父分支的 Y 范围内，禁止"分支1的叶子流向分支2区域"
• 禁止让不同分支的叶子在同一 Y 上或交错排布。同一 Y 仅允许出现一个分支的一个叶子，其他分支的叶子必须错开
• 禁止在副标题里擅自加 "X节·"、"步骤X·" 等前缀；禁止在副标题的 → 箭头两侧加空格（详见下方"副标题紧凑箭头规范"）
• 禁止在节点副标题 sub 字段前自动追加 X 节· 前缀——这是已确认的踩坑，会直接撑爆节点边界；节数统一在模块分隔页用 pill 列表展示。
• 禁止把副标题箭头写成带空格形式 "合同 → 订单 → 入库"——必须用紧凑箭头 "合同→订单→入库"，否则会因字数增加 30% 溢出节点。
• 禁止在节点文字超出长度硬约束时仍强行保留——必须精简表述或拆分为多个节点；任何超长节点都会撑爆节点边框，破坏整体排版。
• 禁止用 display:flex + align-items:center 居中 SVG 脑图。已知 bug：flex 居中 + overflow:hidden 会在内容超出视口时把 SVG 顶部/底部直接裁掉，用户看不到也滚不动。.map-container 必须用 overflow:auto + margin:0 auto（详见黄金模板）
• 禁止给 SVG 加 width="100%" 属性 + max-height 压缩。已知问题：width="100%" 强制宽度撑满 + max-height 限制高度，会让 SVG 被压进变形的盒子，内容缩成一团、两侧大片空白。正确做法：去掉 width 属性，改用 CSS width:100% + max-width + min-width:720px + height:auto，并显式加 preserveAspectRatio="xMidYMid meet" 保证等比缩放不变形
• 禁止全局禁滚却不给容器滚动条。body { overflow:hidden } 时，.map-container 必须显式设 overflow:auto，否则内容超出视口时直接被裁掉，右侧进度条不出现

参考资源

• assets/interactive-mindmap-template.html：互动脑图黄金模板（用户确认的理想形态）。生成形态 A 前必须读取，严格复用其双视图架构、SVG 脑图画法、详情页模块与配色体系。
• references/training-design-guide.md：成套培训材料的课程结构模板、时间分配规范、各材料详细模板与考题设计规则。生成形态 B 前必须读取。
• references/format-export-guide.md：多格式导出指南（Word / Excel / PPT / PDF / 图片）。执行第三步 C 前必须读取，含各格式的内容重组规范、技术路线与降级方案。