用户提供资料或报告目标，Agent 负责整理内容，DocxKit 负责把最终内容导出为排版稳定、可编辑、可交付的 Word .docx 报告。

用户可以提供任意可被 Agent 读取和理解的资料，例如：

• 文档、表格、网页、截图或已有报告。
• 项目材料、调研资料、会议纪要或数据摘要。
• 一个明确的报告主题，由 Agent 自行检索和整理资料。

效果预览

以下截图展示 6 份不同业务场景的完整 6 页 Word 报告。

| | | | |:---:|:---:|:---:| | 董事会预算决策 | 客户访谈研究 | 技术交付复盘 | | | | | | 现金流风险简报 | 运营执行手册 | 市场进入评估 | | | | |

安装

1. 安装 CLI

npm install -g @dztabel/docxkit
docx-kit --version

出现类似输出代表 CLI 安装成功：

docx-kit 0.1.55 (cli-contract 0.2)

2. 安装 Agent skill（二选一）

2.1 Codex

node -e "const fs=require('fs'),os=require('os'),path=require('path'),cp=require('child_process');const root=cp.execSync('npm root -g',{encoding:'utf8'}).trim();const src=path.join(root,'@dztabel','docxkit','skills','docxkit');const dest=path.join(os.homedir(),'.agents','skills','docxkit');fs.rmSync(dest,{recursive:true,force:true});fs.mkdirSync(path.dirname(dest),{recursive:true});fs.cpSync(src,dest,{recursive:true});console.log('Codex skill installed');"

检查 Codex skill 是否安装成功，在终端中输入：

node -e "const fs=require('fs'),os=require('os'),path=require('path');const p=path.join(os.homedir(),'.agents','skills','docxkit','SKILL.md');if(!fs.existsSync(p))process.exit(1);console.log('Codex skill installed');"

出现以下输出代表成功：

Codex skill installed

打开 Codex 后输入 $docxkit。能按 Tab 选中该 skill，代表可用。若未出现，按 Cmd+K / Ctrl+K 选择 Force Reload Skills，或重新打开 Codex。

2.2 Claude Code

node -e "const fs=require('fs'),os=require('os'),path=require('path'),cp=require('child_process');const root=cp.execSync('npm root -g',{encoding:'utf8'}).trim();const src=path.join(root,'@dztabel','docxkit','skills','docxkit');const dest=path.join(os.homedir(),'.claude','skills','docxkit');fs.rmSync(dest,{recursive:true,force:true});fs.mkdirSync(path.dirname(dest),{recursive:true});fs.cpSync(src,dest,{recursive:true});console.log('Claude Code skill installed');"

检查 Claude Code skill 是否安装成功，在终端中输入：

node -e "const fs=require('fs'),os=require('os'),path=require('path');const p=path.join(os.homedir(),'.claude','skills','docxkit','SKILL.md');if(!fs.existsSync(p))process.exit(1);console.log('Claude Code skill installed');"

出现以下输出代表成功：

Claude Code skill installed

打开 Claude Code 后输入 /docxkit。能选中该 skill，代表可用。若未出现，输入 /reload-skills 后重试；旧版本 Claude Code 可重新打开窗口。

快速开始

1. 用户带资料生成 Word 报告

$docxkit 请读取我上传的 Excel、PDF 和会议纪要，整理成一份正式项目复盘报告并导出 Word。
/docxkit 请读取我上传的 Excel、PDF 和会议纪要，整理成一份正式项目复盘报告并导出 Word。

2. 用户只给目标，Agent 自行调研

$docxkit 请调研国内储能行业最新进展，整理成行业研究报告并导出 Word。
/docxkit 请调研国内储能行业最新进展，整理成行业研究报告并导出 Word。

3. 用户已有草稿，Agent 重写成可交付报告

$docxkit 请把这份散乱的草稿改写成结构清晰的正式分析报告并导出 Word。
/docxkit 请把这份散乱的草稿改写成结构清晰的正式分析报告并导出 Word。

4. 用户基于反馈迭代报告

$docxkit 请把刚才生成的报告压缩到 8 页，第二章改成更适合管理层阅读的版本，并重新导出 Word。
/docxkit 请把刚才生成的报告压缩到 8 页，第二章改成更适合管理层阅读的版本，并重新导出 Word。

Agent 会完成资料读取、调研、正文组织、格式约束和 Word 导出。

技术细节

Agent 会自动把资料整理成 DocxKit 可处理的中间内容，并调用：

docx-kit build prepared-report.md --out ./report
docx-kit qa ./report/report.docx --report-json ./report/report.json --out ./report/qa

DocxKit 输出：

report/report.docx
report/report.json
report/build-result.json
report/qa/qa-result.json

生成的 .docx 默认不内嵌字体：模版使用楷体 + Times New Roman，并在 fontTable 里声明跨平台字体别名链（楷体 ↔ KaiTi ↔ Kaiti SC ↔ STKaiti），Windows/macOS 的 Word/WPS 都能稳定显示和编辑，文件体积也更小。若收件人环境可能缺少中文字体（如海外非中文系统），用 --embed-fonts 显式嵌入字体子集。

默认模版为 executive-cn-docx（楷体正文与标题）。可在 Markdown frontmatter 中用 template: executive-cn-song-docx 切换到宋体模版（宋体正文 + 黑体加粗标题，GB/T 9704 经典搭配，题注加粗），版式两者一致。

支持公式（LaTeX 块级与行内，Word 原生可编辑）、表/图/公式/来源四类可点击交叉引用、图目录与表目录；构建内置内容质量门禁（悬空引用等 error 级问题会使构建失败，详见输出 JSON 的 checks 字段）。

排障

当前公开测试版支持 macOS Apple Silicon 与 Windows x64。

如果全局 npm 安装跳过了 optional dependencies，显式安装对应平台包：

npm install -g @dztabel/docxkit @dztabel/docxkit-darwin-arm64

构建失败时，提交 issue 请附：

• docx-kit --version
• report/build-result.json
• 可复现问题的最小 content.md

仓库范围

本公开仓库包含 npm wrapper 元数据、命令 shim、公开 skills、文档和轻量预览资产。

渲染器源码、私有模板、schemas、视觉回归样例和平台二进制不包含在本仓库中。平台二进制通过 npm 平台包分发。

许可

DocxKit 以专有 CLI 二进制形式通过 npm 分发。本仓库提供用于安装和使用 CLI 的公开 wrapper、skills 和文档。