Deskclaw DOCX

DeskClaw DOCX v3.0

创建、编辑和排版 Word 文档。创建用 docx-js（JavaScript），编辑用 unpack/XML/repack 工具链。

第零步：Bootstrap

python bootstrap.py

幂等设计，已装跳过。Bootstrap 完成后会生成 runtime/env.json，包含当前环境的 Node.js 和 Python 路径。

检查是否就绪：

import json
env = json.load(open("<SKILL_DIR>/runtime/env.json"))
print(env["node"])  # Node.js 路径

如果 runtime/env.json 不存在 → 先运行 python bootstrap.py。

命令速查表（Agent 必读）

关键：先从 runtime/env.json 读取 node 和 node_modules 路径，不要硬编码。 运行 JS 脚本的模式：NODE_PATH="<node_modules路径>" <node路径> script.js

创建新文档：最小可用模板

写 JavaScript 脚本，用 DeskClaw 的 Node 执行。不要用 python-docx 创建新文档——docx-js 支持 TOC、脚注、精确列表控制等 python-docx 做不到的功能。

const fs = require("fs");
const os = require("os");
const path = require("path");
const { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell,
        Header, Footer, AlignmentType, LevelFormat, HeadingLevel,
        BorderStyle, WidthType, ShadingType, PageNumber, PageBreak,
        ImageRun } = require("docx");

const doc = new Document({
  styles: {
    default: { document: { run: { font: "Microsoft YaHei", size: 24 } } },
    paragraphStyles: [
      { id: "Heading1", name: "Heading 1", basedOn: "Normal", next: "Normal",
        quickFormat: true,
        run: { size: 32, bold: true, font: "Microsoft YaHei" },
        paragraph: { spacing: { before: 240, after: 240 }, outlineLevel: 0 } },
      { id: "Heading2", name: "Heading 2", basedOn: "Normal", next: "Normal",
        quickFormat: true,
        run: { size: 28, bold: true, font: "Microsoft YaHei" },
        paragraph: { spacing: { before: 180, after: 180 }, outlineLevel: 1 } },
    ]
  },
  sections: [{
    properties: {
      page: {
        size: { width: 11906, height: 16838 },
        margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 }
      }
    },
    children: [
      new Paragraph({ heading: HeadingLevel.HEADING_1,
        children: [new TextRun("文档标题")] }),
      new Paragraph({ children: [new TextRun("正文内容...")] }),
    ]
  }]
});

Packer.toBuffer(doc).then(buffer => {
  fs.writeFileSync(path.join(os.homedir(), "Desktop", "output.docx"), buffer);
  console.log("Saved");
});

运行方式（路径从 env.json 获取）：

# 先读路径
NODE=$(python -c "import json; print(json.load(open('<SKILL_DIR>/runtime/env.json'))['node'])")
NODE_MODULES=$(python -c "import json; print(json.load(open('<SKILL_DIR>/runtime/env.json'))['node_modules'])")
# 再执行
NODE_PATH="$NODE_MODULES" $NODE script.js

完整的 docx-js API 模式（列表、表格、图片、页眉页脚、超链接、脚注、多栏、TOC 等）见：

• creating_basics.md — 基础：Setup + 页面尺寸 + 样式 + 列表 + 表格
• creating_extras.md — 进阶：图片 + 超链接 + 脚注 + 多栏 + TOC + 硬规则

排版速查

中文文档默认值

设计决策 6 条原则

1. 留白 60-70% 覆盖率 2. 对比 标题与正文 ≥ 1.5:1 3. 亲近 相关内容间距小 4. 对齐 网格对齐 5. 重复 同级标题同样式 6. 层次 3 秒看出层级

中英混排时，中文和英文/数字之间加半角空格：中文 English 中文。

参考文档索引

按需读取，不要一次全读。