智能 Word 排版（薄客户端）

中文 Word 文档的排版与格式治理工具。排版引擎部署在云端，本包只做「读文件 → 发请求 → 落盘」三件事，所以本机零依赖、装完即用。

日常使用只需一条命令：

python scripts/process.py smart 输入.docx 输出.docx --preset official

架构：薄壳 + 云端引擎

本机（薄客户端）                          云端引擎
┌────────────────────────┐          ┌──────────────────────────┐
│ scripts/process.py     │  HTTPS   │ api.chengpay.com.cn      │
│  · 读 .docx → base64   │ ───────▶ │ /wordfmt/v1/smart        │
│  · 打包参数             │          │  标点归一 → 套预设        │
│  · 落盘 + 打印日志      │ ◀─────── │  → 内容兜底 → 返回 docx   │
└────────────────────────┘  base64  └──────────────────────────┘

• 本地不含任何排版算法：没有 python-docx，没有本地引擎代码，requirements.txt 空依赖。
• 算法只在服务端：改规则、加预设、修 bug 只需更新服务端，所有客户端即时生效，不用重新分发技能包。
• 可离线判断：health 一条命令即可确认云端是否可达，不通时立刻给明确原因，不会静默失败。

功能一览

核心优势

1. 内容零丢失兜底：写盘前把输入与输出逐字比对——数字、URL、邮箱、路径、标准号、表格数、图片数、段落与单元格数全部核对。只要发现丢一个字/一个表/一张图，直接拒绝返回文件（退出码 3），绝不出"看着没问题、其实少了内容"的稿子。这是"只改格式、不改内容"纪律的机器级担保。
2. 只动格式，不动内容：所有转换都基于"归一化后等价"判断，标点宽度/空格差异不误判为内容变更。
3. 中文语境标点：URL / 邮箱 / 文件路径 / 时间 / 标准号 / 十六进制先掩码保护，再按中文语境转换半角↔全角；...→……、--→——、引号开闭配对、重复标点折叠。
4. 真·修订留痕：旧内容写 w:del、新内容写 w:ins，Word 里是真正的修订模式，可逐条接受/拒绝，不是简单标红。
5. 一套命令覆盖三类文书：公文（GB/T 9704-2012 版式）、学术论文、法律文书，一个 --preset 切换。
6. 薄壳轻量：本机零第三方依赖，Python 3.8+ 即可运行；云端出错不影响本机环境。
7. 服务端结果缓存：相同文件 + 相同参数二次请求直接命中缓存，实测从 430ms 降到 70ms。
8. 独立实现，无外部许可负担：算法为本项目自研，不引入第三方排版库的许可义务。

快速使用（怎么用）

# 0) 自检：确认云端可达（建议首次使用先跑一次）
python scripts/process.py health

# 1) 一键规范（公文预设，最常用）
python scripts/process.py smart 输入.docx 输出.docx --preset official

# 2) 先体检、不改文件
python scripts/process.py analyze 输入.docx
python scripts/process.py analyze 输入.docx --json

# 3) 只修标点（保留中英边界一个空格）
python scripts/process.py punctuation 输入.docx 输出.docx

# 4) 只套格式 + 输出修订留痕（交审阅用）
python scripts/process.py format 输入.docx 输出.docx --preset academic --revision

# 5) Markdown 转规范 DOCX
python scripts/process.py md2docx 方案.md 方案.docx --title "工作方案"

# 6) 查看云端三套预设的实际参数
python scripts/process.py presets

触发方式

触发词：Word排版、公文排版、论文排版、法律文书排版、文档规范化、格式美化、排版规范、红头文件排版、docx排版、md转docx、Word文档格式治理。

示例话术（直接说，我会调用本技能）：

• "把这份 docx 排成公文格式，套 GB/T 9704。"
• "先帮我体检这份报告，看格式有什么问题。"
• "这稿标点中英混用，帮我把半角标点全改成中文标点。"
• "只改版式不动文字，输出带修订留痕的版本给我核对。"
• "把这个 Markdown 转成规范的 Word 文档。"
• "排版前先确认没丢字，给我一份兜底凭证。"

执行路径：识别到上述意图 → 调 scripts/process.py 对应子命令 → 云端排版 → 落盘 → 回报输出路径、字节数、兜底结论。

配置

config.json（同包根目录）：

{
  "api_base": "https://api.chengpay.com.cn/wordfmt",
  "api_key": "",
  "timeout": 300
}

环境变量可覆盖同名配置：WF_API_BASE / WF_API_KEY / WF_TIMEOUT。

退出码

边界

• 薄客户端只输出 .docx；.doc / .wps 需先另存为 .docx（本地不做 COM 转换）。
• 单文件上限 45MB（base64 后约 60MB）。超大文档请拆分后处理。
• 文档内容会上传到 api_base 指定的云端服务处理；如需完全本地处理，请使用本地算法版。
• 只改格式与标点，不改写文字、不增删段落、不调整表格数据。

版本与变更记录

当前版本：2.0.0。客户端与云端引擎同号发布——本包 version 与云端 engine.py 的 VERSION 保持一致，health 返回的版本号应与本包相同。

升级方式：替换本包目录即可，无需安装任何依赖。服务端升级不影响已分发客户端（算法在云端），仅当客户端新增命令或参数时才需重新分发本包。