Word Flowchart Maker（制度/细则/办法 → 可编辑 Word 流程图）
Purpose
把管理制度、实施细则、办法、规定、操作规程等 Word 文档里描述的办事流程，自动
转成一份 Word 版、可直接编辑 的流程图。产出的 .docx 中，每个步骤框、判断菱形、
连线箭头都是 Word 原生绘图对象（不是图片），用户可以在 Word 里随意拖动、改字、换色。
When to use
- 用户上传
.docx，且文件内容是制度/细则/办法/规定/操作规程类文本； - 用户希望把这些文本描述的流程/程序/审批流画成流程图；
- 用户明确要求「可编辑的 Word 流程图」「导出成 Word 让我自己改」。
不适用：用户要的是 PPT、Visio、图片(PNG) 流程图，或要分析文档内容而非画图时，
告知可走的其它路线（如 workbuddy-pptx、图片生成），不要用本 skill 硬凑。
环境前提
需要 Python 3.8+（全部脚本为纯标准库，无需 pip 安装任何包）；生成图片预览版
另需本机 Word（Windows + PowerShell）。安装步骤、自检方法、常见问题见同目录
安装说明.txt —— 用户问「怎么装 / 另一台电脑能不能用 / 报错怎么办」时，直接把该
文件内容或相关段落告诉他。
Workflow
1. 提取文档文本
运行抽取脚本，把 Word 内容（含标题层级、列表、表格）转成可读文本：
python <skill>/scripts/extract_docx.py "<用户上传的.docx路径>"
（若想落盘便于核对，可加第二个参数输出到 .txt。）
2. 阅读并识别流程
读取上一步文本，按 references/extraction-guide.md 的规则识别文档中的每一个
独立流程（一份文档常含多个流程，如「请假审批」「采购付款」「合同评审」等），
并判断每个节点的类型（start / step / decision / end / io）与分支条件。
3. 产出流程 JSON
为识别出的每个流程，按指南中的 JSON 结构写出 nodes 与 edges。多个流程放进
顶层 diagrams 数组。可参考 references/example-flow.json（含请假审批、采购付款
两个示例）。把 JSON 写入一个临时文件，例如 <workspace>/flow_spec.json。
> 要点：节点标签 ≤ 12 字、分支边务必带 label（是/否、符合/不符合等）、忠于原文
> 不臆造步骤、同一流程粒度一致。
4. 生成可编辑 Word 流程图
python <skill>/scripts/build_flowchart_docx.py "<workspace>/flow_spec.json" "<输出.docx路径>"
脚本会自动完成分层自顶向下布局（最长路径分层 + 重心法减少交叉），每个流程尽量
占一页竖版 A4（210×297mm），并自动做以下事情：
- 单页优先：纵向空间按
FLOW_BOTTOM_MM上限自动压缩节点高度与行距，保证整张图
落在 A4 页面内、不越界、不产生空白页；当压缩会牺牲可读性时（压缩率 < 0.55）自动
拆分为续页——续页重复泳道头、跨页处画「接下页 / 接上页」引导箭头； - 字号自适应：
fit_font()按方框实际宽高估算（含中文全角宽度、6% 换行余量），逐级
缩小字号直到文字放得下（下限 6.5pt；分支标签下限 5.5pt）。文本框内使用精确行距
（1.3 倍字号），避免多行标签被裁剪； - 正交连线：同泳道内的前后节点用竖直直线箭头；跨泳道或需要换列时走三段式
弯线（下 → 横 → 下），箭头只画在最后一段；回退/循环分支从下方绕行再向上进箭头。
图形样式：圆角矩形=步骤、菱形=判断、绿色=起点、红色=终点；分支线型由边上的 style
控制（reject 红虚线、back/loop 蓝虚线，默认黑实线），条件文字自动标在弯线的横向
段中点。
泳道图（swimlane）模式：当某个 diagram 在顶层带 lanes 字段时，脚本自动切换为
纵向分栏泳道图。泳道按「从右到左 = 发起部门 → 有责任审核部门 → 最终审核部门」
排列：lanes[0]（发起部门）画在最右列，最后一个泳道（终审）画在最左列（详见
references/extraction-guide.md 第 4b/4c 节）。不写 lanes 时仍是普通竖向流程图。
样板元素（节点附属标注）：参照公司内控流程图样板，支持三类附属元素（节点字段）：
no：步骤编号（01、02…），显示在节点左上方；不写时按层自动编号（step/io 节点）；role：操作岗位/部门，黄色标签挂在节点右侧；form：业务表单，白色矩形挂在节点右下方。
风险点 / 风险控制点标注（F/K 编号）：节点带 risk / control 字段（值为 true
或描述文字）时，脚本在节点右上角画一个绿色三角形并在旁边标注编号：
- 风险点全文连续编号
F01, F02…；控制点全文连续编号K01, K02…； - 同一节点既是风险点又是控制点时，编号合并显示为
F01-K01； - 编号按 diagrams → nodes 的出现顺序分配（全文统一）；
- 文档末尾自动附一页「风险点及控制措施一览表」（编号 / 所属流程 / 节点 / 风险描述 /
控制措施），仅在存在 risk/control 节点时生成。 - 从 Word 自动识别：提取文本时注意查找「风险」「风险点」「控制措施」「控制活动」
等章节或表格列，把风险描述匹配到对应流程节点上（risk: "描述"），控制措施同理；
文档没有结构化风险章节时不要臆造，可先询问用户或留空。
关于编辑方式（重要，交付时要告知用户）：每个流程图的所有形状打包成一个 Word
组合（group）对象，一个流程图 = 一个组合 + 一个标题段落。这样 Word 分页稳定、不会
出现空白页。编辑方式：
- 双击组合 → 进入组内选中单个框/线，改字、换色、拖动；
- 右键 →「组合 → 取消组合」（或 Ctrl+Shift+G）→ 变回彼此独立的形状。
> 为什么必须组合：实测 Word 里若把几十个浮动形状各自锚定在独立段落，分页会漂移并
> 插入空白页；标题段落也不能用内置「标题 1」样式或超过 12pt 字号，否则同样会把整张
> 图挤到下一页。
5. 生成图片预览版（默认执行，必做）
腾讯文档网页预览、微信/QQ 内置预览等不渲染 Word 浮动图形——可编辑流程图在这些
预览器里显示为空白页，用户会误以为生成失败。因此交付时默认额外产出一份图片预览版
docx（流程图已渲染成嵌入图片，任何预览器都能显示，但不可编辑），并告知用户两个
文件的分工：
# ① 用本机 Word 把可编辑 docx 的每页流程图渲染成 PNG（需 Windows + Word）：
powershell -NoProfile -ExecutionPolicy Bypass -File <skill>/scripts/render_pages.ps1 -DocPath "<可编辑.docx>" -OutDir "<workspace>/render"
# 输出 PAGE|i|<png路径> 行，每个流程图一张 PNG
# ② 把 PNG 打包成图片版 docx（纯标准库，自动把透明背景合成白底）：
python <skill>/scripts/build_preview_docx.py "<输出名-图片预览版.docx>" <png1> <png2> ... --titles "流程1标题;流程2标题;..."
同时建议导出一份 PDF（Word COM ExportAsFixedFormat 或让用户在 Word 里另存），
作为排版效果的权威预览。
6. 交付与说明
- 用
present_files把 可编辑.docx+ 图片预览版.docx（+ PDF） 一起交给用户，
并简要说明：共识别了几个流程、分别叫什么、是否有文档中不明确、已做合理推断的地方
（请用户核对）；明确告知「可编辑版需用本机 Word/WPS 打开，网页预览请看图片版」。 - 若用户觉得某处布局/分支不对，直接修改
flow_spec.json后重跑第 4 步即可，无需
重抽文档。
Notes / 局限
- 预览器兼容性：可编辑版用 Word 浮动绘图对象（wpg 组合），本机 Word/WPS 正常显示，
但腾讯文档网页预览、微信/QQ 内置预览不渲染——必须按第 5 步配套图片预览版。 - 布局为自动分层，超长流程会自动拆分续页（泳道头重复 + 接上页/接下页引导箭头）；
所有图形均为原生可编辑对象，调整成本低。 - 文档中若存在跨流程引用（"按第十三条处理"），默认不在本流程内展开，以保持图的
可读性；如需展开请按用户要求处理。 - 所有脚本均为标准库实现（PowerShell 渲染脚本依赖本机 Word），无需
pip install。 - 部署/迁移到其它电脑、缺 Python 或 Word 时的表现与处理办法，见
安装说明.txt。
