Docx 自定义排版助手

用户想要调整 .docx 文档的排版格式。本技能提供完整的可视化配置窗口，让用户选择内置模板或自定义模板参数，一键应用到文档。

开局问候

触发技能后，首先向用户展示以下选项：

> Boo哥AI智写 — Docx排版助手 已就绪

>

> 请选择使用模式：

> - A. 在线使用 — 在浏览器中打开可视化配置窗口（需要 Claude Code 运行环境）

> - B. 打包为 EXE — 将本工具打包为 Windows 独立可执行程序（带注册码验证，无需 Claude Code）

根据用户选择：

• 选择 A → 继续下面的工作流程
• 选择 B → 执行打包脚本，生成 Windows .exe 独立程序

cd <skill-dir>/scripts/exe_build
pip install pyinstaller
python build_exe.py

• 输出：dist/Docx排版助手.exe
• 免费版，无需注册码，双击即可运行
• 内置 Flask 服务 + 浏览器自动打开，体验与在线版一致
• 需要 Python 3.10+ 和 PyInstaller

工作流程

第1步：确认输入文件

检查当前会话上下文中是否存在 .docx 文件路径。如果找不到，提示用户提供文件路径或上传文件。

确认后，记录文件路径。

第2步：询问是否打开 Web 界面

向用户确认：

> 已准备就绪。是否在浏览器中打开可视化配置窗口？

根据用户回复：

• 同意/是/打开 → 执行第2a步（自动打开浏览器）
• 拒绝/否/不用 → 执行第2b步（仅启动服务）

第2a步：启动服务并自动打开浏览器

python <skill-dir>/scripts/web_ui.py --port 5080

浏览器自动打开 http://127.0.0.1:5080

第2b步：仅启动服务（不打开浏览器）

python <skill-dir>/scripts/web_ui.py --port 5080 --no-browser

告知用户手动访问：http://127.0.0.1:5080

用户在 Web UI 中：

• 左栏：浏览 5 种内置模板 + 自定义模板，或点击「+ 新建」
• 右栏：预览模板参数，或切换到「自定义编辑」调整每个参数
• 底部：选择文件（点击按钮或拖拽） → 预览文档信息 → 应用并生成

第3步：等待用户操作

用户在 Web UI 中完成以下操作：

1. 在左侧选择一个内置模板或自定义模板
2. 在右侧查看/调整参数
3. 点击底部「📂 选择文件」选择要处理的 .docx
4. （可选）点击「🔍 预览文档信息」查看文档概况
5. （可选）将自定义参数「💾 保存为我的模板」以便下次使用
6. 点击「🚀 应用并生成」

第4步：展示处理结果

处理完成后，Web UI 会弹出处理报告。同时在对话中也输出以下格式的报告：

> docx-format --input "输入文件.docx" --template "模板名称" --output "输出文件.docx"
[✓] 页面设置: ...
[✓] 正文样式: ...
[✓] 标题样式: ...
[✓] 表格样式: ...
[✓] 共处理 N 个段落, M 个表格
新版本已输出至: /path/to/输出文件.docx

指引用户打开输出文件查看效果。如果不满意，用户可以回到配置窗口调整参数后重新生成。

技能结构

docx-format-assistant/
├── SKILL.md                          # 本文件
├── scripts/
│   ├── web_ui.py                     # Flask Web 服务 (启动入口)
│   ├── format_engine.py              # docx 排版处理引擎
│   ├── built_in_templates.py         # 5 种内置模板定义
│   └── template_manager.py           # 自定义模板 CRUD 管理
├── assets/web/
│   ├── index.html                    # 配置窗口前端
│   ├── style.css                     # 样式表
│   └── app.js                        # 前端交互逻辑
├── templates/
│   └── my_templates.json             # 用户自定义模板存储
└── references/
    └── formatting_guide.md           # 中文排版参考标准

内置模板一览

依赖

需要 Python 包：python-docx, flask, flask-cors

注意事项

• 处理后会生成新文件（命名规则：原文件名_模板名.docx），原文件不会被修改
• 默认会清理段落直接格式（保留手动加粗和斜体），确保样式驱动排版
• 自定义模板保存在 templates/my_templates.json，可通过 UI 管理/导出/导入

• 品牌: Boo哥AI智写
• 联系方式: QQ邮箱 409966830@qq.com
• 座右铭: 智写万象，标定未来