docx-cnlisted
Install: claude install-skill ssssliug/claude-skill-docx-cn
# Word 文档生成(Node · 中文 · 研究向)
面向 Node-only 环境(**无 Python / LibreOffice / pandoc**,在 Windows + Node v24 上验证过;macOS / Linux 同理)。`.docx` 用 [`docx`](https://github.com/dolanmiu/docx)(npm 包名 `docx`,即 docx-js)。**只做创建**——转 PDF / 缩略图 / schema 校验等 QA 本机跑不了(要视觉预览需另装 LibreOffice)。
官方 `~/.claude/skills/docx`(默认停用,文件仍在)有更全的踩坑表与 Python 脚本(校验 / 缩略图 / 模板编辑 / tracked changes / comments)。遇到复杂或排错场景,可手动 `cat ~/.claude/skills/docx/SKILL.md` 当字典查——它不自动加载,但内容在。配套 PPT 技能见 `pptx-cn`。
## 运行(两种方式任选)
**方式 A · 本仓库装依赖(推荐,跨平台)**:仓库根 `package.json` 已列好依赖,`npm install` 后直接跑:
```bash
npm install
node templates/results_docx.js out.docx # 输出路径可中文
```
**方式 B · 共享依赖 + NODE_PATH(Windows / Git Bash 特有技巧)**:把所有 skill 的 node_modules 集中放一处(如 `~/.claude/skills-deps/node_modules`,含 `docx`),脚本里直接 `require()`、不必每个仓库各装一份。node 是原生 Windows 程序、**不认 MSYS 的 `~` / `/tmp` 路径**,必须 cygpath + NODE_PATH:
```bash
NODE_PATH=$(cygpath -w ~/.claude/skills-deps/node_modules) node 脚本.js
```
输出用完整 Windows 路径 `C:/.../名.docx`,中文路径 OK。
---
## Word (docx-js)
```js
const {Document,Packer,Paragraph,TextRun,HeadingLevel,Table,TableRow,TableCell,WidthType,ShadingType,AlignmentType,PageOrientation,PositionalTab,PositionalTabAlignment,PositionalTabLeader} = require('docx');
```
- 页面默认 A4;US Letter:`page:{size:{width:12240,height:15840}}`(DXA,1440=1″);横屏传纵向尺寸 + `orientation:PageOrientation.LANDSCAPE`。
- **中文**:每个 `TextRun` 都带 `font:'Microsoft YaHei'`,否则默认 Calibri 掉中文;省事可在 `styles.default.document.run.font` 设一次默认字体、单处再覆盖。
- 标题用 `HeadingLev