Word 杂志化排版

触发条件

用户提到以下任一意图时调用：

• "Word 杂志化排版"

• "把文档排成杂志/报刊风格"

• "分栏 / 首字下沉 / 图文混排"

• "Word 排版美化，杂志感"

• "报纸风格 / 杂志风格 / 期刊风格"

边界与定位

• 输入：已有文字/图片内容的 .docx。

• 输出：重新排好版的 .docx，必要时顺带导出 PDF。

• 专长：杂志视觉风格（分栏、首字下沉、图文混排、引文框、侧边栏、刊头页码）。

• 不做：从零撰写长文、复杂手绘装饰、精确到像素的 DTP、印刷出血/Cmyk 转换。

• 与 tencent-docx 的关系：

• tencent-docx 做通用专业美化（研报/论文/公文/合同）。

• 本技能只做「杂志/报刊视觉风格」。如果用户只是泛泛说"美化 Word"，优先走 tencent-docx；如果明确要杂志感，再走本技能。

参考样式映射

用户给出的四类参考图，本 SKILL 用不同模板/参数逼近：

执行通道

使用 python-docx 程序化修改 .docx。分栏、首字下沉、图片环绕、段落底纹/边框等已封装进脚本，不用每次手写 OOXML。

依赖安装（必须隔离）：

# 在隔离 venv 中安装，禁止全局 pip
& "C:\Users\DELL\.workbuddy\binaries\python\versions\3.13.12\python.exe" -m venv "C:\Users\DELL\.workbuddy\binaries\python\envs\default"
& "C:\Users\DELL\.workbuddy\binaries\python\envs\default\Scripts\python.exe" -m pip install python-docx

用法流程

• 读源文档：用 Read 或 python-docx 解析，确认标题/正文结构。

• 选风格：

• 文艺/书籍/柔和 → assets/templates/literary_style.json

• 纯文字随笔（无占位图、引文降频）→ assets/templates/literary_essay_style.json

• 精品杂志感（封面页+大编号+指定金句+数字强调，深蓝金配色）→ assets/templates/premium_essay_style.json

• 商务/报纸/硬朗 → assets/templates/business_style.json

• 自定义 → 用户提供 JSON

• 执行脚本：

   & "C:\Users\DELL\.workbuddy\binaries\python\envs\default\Scripts\python.exe" `
     "C:\Users\DELL\.workbuddy\skills\hsf-word-magazine\scripts\magazine_typeset.py" `
     -i "C:\path\input.docx" `
     -s "C:\Users\DELL\.workbuddy\skills\hsf-word-magazine\assets\templates\literary_style.json" `
     -o "C:\path\output.docx"

• 看 QA 报告：脚本会在同级目录输出 output_qa.json。

• 交付：用 present_files 把 .docx（和 PDF，如已导出）交给用户。

内容类型判断规则（脚本内自动执行）

脚本按「字数 + 图片数」自动选择版式：

配色设计系统（抄自 gzh-design，勿自造）

两套预设的配色严格套用 gzh-design 已验证的设计系统（来源：~/.workbuddy/skills/gzh-design/references/theme-red-white.md、theme-olive-journal.md）。新增风格时照这套配对逻辑抄，不要自己琢磨色值。

五层色系统

每套风格定义五层色 + 墨色/正文色，全部写进 JSON colors（命名色键，经 resolve_color 解析）：

标题/正文配对铁律

• 标题一律近黑（ink），正文一律深灰（body）——主色不上标题文字，这是 gzh-design 三套主题共同的规矩。标题靠"近黑字 + 主色装饰线"建立层级，不靠彩字。

• 主色只出现在锚点：Title/H1 底部装饰线（3pt）、H2 左竖条（3pt）、金句框左竖条、关键词下划线。全文主色面积克制，红色加粗 ≤5 处。

• 装饰线归属：business 装饰线用主色（红白编辑风的"红线报头"语言）；literary 的 H1 用中性分隔线色（line），只有 H2 用主色竖条（橄榄手记的克制分节语言）。

• 关键词下划线（标记层）：正文加粗词自动加强调色单线下划线（emphasis_underline.color），对应 gzh-design"每段 1~3 处淡粉/橙色下划线"的扫读标记。

• 图注用 secondary，不用浅强调色（旧版 D4A574 压米白底对比不足的教训）。

样式级边框（脚本能力）

JSON 的 styles.* 支持 border_bottom/top/left_color + _width_pt（样式级，如 Title 红线）；JSON 未声明边框时脚本会清除 Word 模板默认边框（如 Title 自带蓝线）。

两套模板参数 → 五套预设

文艺风（literary，橄榄手记调）

商务风（business，红白编辑）

脚本 CLI 参数

magazine_typeset.py
  -i, --input      源 docx 路径（必填）
  -s, --style      风格 JSON 路径（必填）
  -o, --output     输出 docx 路径（必填）
  --layout         强制版式：short / medium / long
  --drop-cap       首字下沉行数，默认 3，0 表示关闭
  --pull-quotes    是否插入引文框，默认 true
  --page-numbers   是否加页码，默认 true
  --strict         校验 ERROR>0 时退出码为 1（CI/批量用）

风格 JSON 字段说明

{
  "name": "literary",
  "page": { "width_cm": 21.0, "height_cm": 29.7,
            "margin_top_cm": 2.0, "margin_bottom_cm": 2.0,
            "margin_left_cm": 2.5, "margin_right_cm": 2.5 },
  "columns": { "short": 1, "medium": 2, "long": 2, "long_sidebar": true },
  "colors": { "ink": "23251D", "body": "4D4F46", "secondary": "65675E",
              "primary": "ED7B2F", "primary_bg": "EEEFE9",
              "marker": "ED7B2F", "line": "BFC1B7" },
  "fonts": { "heading": "宋体", "heading_fallback": ["SimSun", "STSong", "Songti SC"],
             "body": "仿宋", "body_fallback": ["FangSong", "STFangsong", "Fangsong SC"] },
  "styles": {
…（完整代码见技能源码）

字段说明：

• placeholders[].after：在该文本片段首次出现的段落后插入；为空或匹配不到 → 追加到文末。填你文档里真实存在的标题/小标题文字。

• width_ratio：占位图占栏宽比例（默认取 image.ratio）。

• aspect：宽/高比（1.5 = 横向框，1.0 = 方形）。

• label：图注文字，自动套 Caption 样式。

• 占位图浮动环绕、宽度按栏宽自适应；需用户在 Word 里把灰块替换为真图。

v0.3.0 新增配置（杂志感增强层）

{
  "cover_page": {              // 封面页：1x1表格画布铺满首页，正文从第2页起
    "enabled": true,
    "title": "2022 赚钱建议",   // 超粗大标题
    "subtitle": "生财有术 × 逆熵增者",  // 细体副标题
    "quote": "赚钱是认知与人品的变现",   // 底部金句（衬线反差）
    "quote_author": "",
    "background": "1A365D",    // 封面底色（支持 colors key 或 HEX）
    "title_color": "FFFFFF", "subtitle_color": "A0AEC0",
    "quote_color": "F6E05E", "accent_line": "B7791F",  // 顶部装饰线颜色
    "title_size_pt": 44, "subtitle_size_pt": 13, "quote_size_pt": 15
  },
…（完整代码见技能源码）

v0.6.0 新增配置（结构化文档组件层）

{
  "tag_group": {               // 标签组 chips：Tag Group 样式段（"标签1｜标签2｜…"）
    "enabled": true,
    "label": "六模块",          // 金色小标签前缀
    "label_color": "B7791F", "tag_color": "1A365D", "tag_bg": "EDF2F7"
  },
  "checklist_cards": {         // 红绿判定卡：Checklist Item 样式段（"✗/✓ …"）
    "enabled": true,
    "fail_mark": "✗", "fail_color": "C53030", "fail_bg": "FFF5F5",
    "pass_mark": "✓", "pass_color": "2F855A", "pass_bg": "F0FFF4"
  },
  "flow_steps": {              // 步骤进度条：Flow Step 段（"STEP n｜标题"）+ Flow End 收尾
…（完整代码见技能源码）

内容层协作模式（v0.6.0 固化）：复杂版式锚点用两段式——① 转换脚本（一次性，随文档写在桌面）在重建内容时给特殊段落打样式名锚点（Tag Group / Checklist Item / Flow Step / Flow End / Section Divider），空文档需先 add_style 创建这些样式；② 排版层 magazine_typeset.py 按样式名识别，统一写入 OOXML 直接格式。转换脚本不含任何格式逻辑，排版层不含任何内容判断。

执行顺序注意：designated_quotes 在通用 pull_quotes 之前跑；要完全掌控引文位置时把 pull_quotes.enabled 设为 false。cover_page 在主流程最后插入（元素移到文档最前），不影响前面所有段落索引；封面页自动启用"首页不同"隐藏页码。

核心操作封装

脚本内部已封装：

• set_section_columns(section, n, space_cm, sidebar_ratio)：分栏 + 栏间距，可选双栏+侧边栏。

• apply_drop_cap(paragraph, lines=3, distance_cm=0.1)：首字下沉。

• rewrap_document_images(doc, wrap_type, max_width_cm, ratio)：遍历内联图片，先按栏宽等比缩放，再改成四周型/紧密型环绕。

• resize_inline_shape_to_width(inline_shape, max_width_cm, ratio)：把图片显示宽度限制为栏宽×ratio，等比缩放高度。

• apply_caption_style(doc, style)：给图注段落统一套样式（按样式名或文本正则识别）。

• apply_emphasis_underline(doc, marker_hex)：正文加粗词加强调色下划线（标记层）。

• set_style_borders(style, cfg, colors)：样式级段落边框（标题装饰线）；无声明时清除模板默认边框。

• ensure_paragraph_style(doc, name)：样式不存在时自动创建（修掉了 Pull Quote 样式静默丢失的 bug）。

• make_pull_quote / make_sidebar：引文框、侧边栏底纹边框。

• add_page_number_footer(section)：页脚加页码。

• make_placeholder_png(path, w, h, rgb)：用 zlib 写纯色占位 PNG（无第三方图像库依赖）。

• insert_placeholders(doc, style, body_col_w_cm, content_w_cm)：按 JSON placeholders 在指定段落后插灰色占位图 + 图注，浮动环绕、按栏宽自适应。

• ensure_section_type(section, type_val)：正文节显式声明 w:type=continuous（v0.3.1 修复：OOXML 缺省按 nextPage 处理，正文节不声明会从新页开始，标题区独占一页大片空白）。

• add_section_break_after(paragraph, section_type, template_sectPr)：分节符，提供 template 时复制 pgSz/pgMar（防新节按默认纸张渲染）。

• build_cover_page(doc, style)：封面页（v0.3.0）。1x1 表格当底色画布铺满首页，行高 90% 防溢出；超粗标题+细体副标题+衬线金句+装饰线；金句用撑杆空行下推到封面下部；分页用 pageBreakBefore 挂在文档原第一段（v0.3.1 修复：额外分页段落自身溢出会产生整页空白页）；末尾执行避免打乱段落索引；自动启用首页不同页脚。

• apply_heading_number_combo(doc, style)：H1 编号放大（v0.3.0）。行首编号拆成大号彩色 run + 标题 run。

• extract_designated_quotes(doc, style)：指定金句抽取（v0.3.0）。命中段落原地转 Pull Quote + 装饰引号。

• apply_number_emphasis(doc, style)：数字强调（v0.3.0）。正则命中数字拆 run 加粗上品牌色，每段限 max_per_paragraph 处。

• apply_list_marker(doc, style)：清单侧边条（v0.3.0）。①-⑤ 开头段落加左竖线+底色+加粗。

• apply_table_cards(doc, style)：表格卡片化（v0.4.0）。表头深底白字+隔行浅底+0.5pt 弱化边框+单元格呼吸边距；rows≥2 且 cols≥2 才算数据表。

• apply_template_cards(doc, style)：输出模板卡片（v0.4.0）。start_marker（默认 "## "）开头的 Code Block 段作标题条（深底白字），后续 Code Block 归入卡片体（浅底+侧框+底框），做成"报告单"式样。

• harden_heading_direct_format(doc, style)：标题直接格式硬化（v0.5.0）。把样式级标题格式（颜色/字号/边框/底纹）逐段落复制为直接格式——弱渲染器只认直接格式，不读 styles.xml，否则 H1 装饰线/H2 色块在预览里消失。

• make_list_cards(doc, style)：清单卡片化（v0.5.0）。①-⑤ 标记段落逐条独立卡片（浅底+左粗色条+段距），替代共享侧边条，方便逐一扫视比对。

• make_dialogue_bubbles(doc, style)：对话气泡（v0.5.0）。"用户：/AI："开头段落交替配色（用户灰底/AI 品牌色底+左色条+缩进错位），发言人标签加粗上色，适合对话实录/案例侧栏。

• add_end_mark(doc, style)：结束符（v0.5.0）。文末单段收口：居中符号（默认 ■■■）+段级顶边框细线，闭合阅读感。紧凑单段设计，防孤悬成空白页。

• make_tag_chips(doc, style)：标签组 chips（v0.6.0）。Tag Group 样式段落（"标签1｜标签2｜…"）重建为关键词组：金色标签前缀 + 逐词条加粗墨色 + 浅底左色条段落。用于"定义正文 vs 关键词组"两个视觉层次拆分。

• make_checklist_cards(doc, style)：判定卡（v0.6.0）。Checklist Item 样式段落（"✗/✓ …"）渲染成独立红绿判定卡：✗ 红（C53030/FFF5F5）、✓ 绿（2F855A/F0FFF4），同色左侧条。用于速查标准/红线清单。

• make_flow_steps(doc, style)：步骤进度条（v0.6.0）。Flow Step 段落（"STEP n｜标题"）渲染成金色 STEP 徽标 + 墨色标题 + 右制表位 ●○○○○ 进度刻度；Flow End 段落渲染为全满刻度收尾线。

• apply_section_dividers(doc, style)：章节分隔（v0.6.0）。Section Divider 空段渲染为居中弱化点线（默认 "· · · · ·"），章间统一装饰，与结束符同一家族。

• apply_table_cards 增强（v0.6.0）：narrow_columns 配置——表头含指定子串的列收窄为等宽字体（Consolas）+缩 1pt+弱化色，用于"诊断后接谁"这类路径/技术列。示例："narrow_columns": [{"header_contains": "诊断后接谁", "col": 2, "font": "Consolas", "color": "4A5568"}]。

• make_dialogue_bubbles 增强（v0.6.0）：对话内续行 Code Block 合并进气泡——跟随上一条底色+同色侧边条，AI 多行回复观感为一个气泡块（此前续行底色轮换错乱、无侧条）。

• 内容层协作模式（v0.6.0 固化）：复杂版式锚点用"转换脚本建样式名占位段落 → 排版层按样式名识别二次加工"的两段式。转换脚本只负责打样式锚点（Tag Group / Checklist Item / Flow Step / Flow End / Section Divider），所有 OOXML 格式由排版层统一写入。样式不存在时需在转换脚本先 add_style 创建（空文档默认没有自定义样式）。

• 样式级 shading（v0.4.0 修复）：styles.*.shading 现在真实生效（此前被静默丢弃）；atLeast 替代 exact 行高（exact 在部分预览器塌缩）；封面支持 version_line 收口行、top_spacer_lines/bottom_spacer_lines 撑杆（弱渲染器忽略行高时仍能撑起近整页封面）。

• Pull Quote 强化（v0.5.0）：指定金句重建为独立居中块——大字号（默认 17pt）+斜体+品牌色+四向留白+装饰边框，可保留短前缀做小字标签（keep_prefix_label）。

含图 Word 的自动处理（重点）

用户给一份已有图片的 .docx，脚本会自动：

• 计数：图片数参与版式判定（影响分栏数）。

• 按栏宽等比缩放：算出正文栏宽（cm）= (版心宽 − (栏数−1)×栏距) ÷ 栏数，图片显示宽度限制为 栏宽 × image.ratio（默认 0.96），等比缩放高度；原图本来就小则不动。这样三栏里 16cm 的图会自动收到 ~5cm，不再压字。

• 改环绕：嵌入型图转四周型环绕，可自由拖动、图文混排。已经是浮动图的跳过。

• 图注套样式：识别"样式名为 Caption"或"以 图/表/照片 开头、≤60字"的段落，套用 JSON 里 styles.Caption 的字号/颜色/对齐/段距。

QA 清单（脚本自动输出）

输出 *_qa.json，包含：

• [ ] 字数与图片数统计

• [ ] 自动判定的版式类型

• [ ] 应用的风格预设名

• [ ] 分栏数是否生效

• [ ] 首字下沉是否生效

• [ ] 图片环绕方式统计（resized / converted / failed）

• [ ] 按栏宽自动缩放后的图片是否落在栏宽内（栏宽见 body_column_width_cm）

• [ ] 图注套样式数量（captions_styled）

• [ ] 关键词下划线数量（emphasis_underlined）

• [ ] 字体种类数（应 ≤ 3）

• [ ] 页码是否已添加

• [ ] 占位图插入数量（placeholders_inserted，无图源文档才有）

• [ ] 校验门禁结果：validate_typeset 的 ERROR / WARNING 数（ERROR 必拦）

• [ ] 是否有孤立标题/段落（orphan）

• [ ] 分栏底部高差是否 ≤ 3 行（估算）

常见问题