Generates a complete Chinese software-copyright (软著) registration package from a
source tree: a page-exact source-code PDF, a manual PDF, and a copy-paste checklist
for the online form. Plain Node, zero dependencies. Works as a Claude Code / Agent SDK skill.

[!TIP]
如果它帮你省下了一次「页数不对、整份重做」，点一下右上角的 ⭐ Star——
让下一个被软著折腾的开发者也能搜到它。

$ ruanzhu source
已生成 ruanzhu/out/①程序鉴别材料_源程序前30页后30页_示例项目.pdf

核验
  ✓ 页数                 实际 62 页，期望 62 页
  ✓ 封面                 示例项目管理系统V1.0源程序软件名称：示例项目管理系统V1.0版本号：V1.0
  ✓ 说明页在第 32 页     说明本软件源程序共103145行，按每页50行排版，共2132页。依据《计算机软件著作权登记办法》第
  ✓ 末页非空             region.setCenter(cp); } } }

10 万行代码、2132 页排版，交上去的是 62 页：封面 + 前 30 页 + 说明页 + 后 30 页。

_{真实产出（拿 npm CLI 的公开源码跑的）：封面 → 正文页眉带软件名称和版本号、右上角页码 1–60 连续 → 自动写的说明页 → 末页}

💡 为什么要有它

软著材料最麻烦的地方不是写，是页数。源程序超过 60 页只能交前连续 30 页 + 后连续 30 页，
而 Word 排版导出的 PDF 页数会随版本、字体、打印机驱动漂——同一份稿子在两台机器上能差出十几页，
一漂整份材料重做。这个工具在渲染之前就把每页装哪些行算死，出完再回读 PDF 数一遍页码。

🚀 三分钟跑通

需要 Node 18+ 和 Chrome / Chromium / Edge 任一，版本 131 以上（页眉页码要用）；CHROME_PATH 可指定路径。

cd 你的项目
npx github:CatCatUncle/ruanzhu-kit init   # 生成 ruanzhu.config.json 和说明书骨架

嫌 npx 长就 clone 下来，后面用 node 路径/bin/ruanzhu.mjs，或者 npm link 之后直接叫 ruanzhu：

git clone https://github.com/CatCatUncle/ruanzhu-kit.git && cd ruanzhu-kit && npm link

打开 ruanzhu.config.json，把软件全称、著作权人、开发完成日期填准，然后：

ruanzhu count      # 先看清点到哪些文件、多少行、排版几页
ruanzhu all --doc  # 两份 PDF + 表单清单 + 可编辑的 .doc 留存件

count 这一步别跳。它会把收进材料的文件按行数列出来，node_modules 之外的脏东西
（构建产物、评测数据、运行期生成的文件）基本都在前十行里现形——行数虚高是驳回的高频原因。
看到不该进的，加进配置的 exclude / excludeFiles 再跑一次。

📦 它出的东西

营业执照、权属证明这些「其他证明文件」得你自己准备。

⌨️ 命令

选项：--doc 同时出 Word 留存件，--lines-per-page 60 排密一点（默认 50，上限 66），
--out <dir> 换输出目录。

🧮 分页是怎么算的

一行 300 字符的代码在 A4 上会折成 4 行。按「行数」切页，超长行必然把页面撑破；
所以这里算的是折行之后占几个行高单位：

A4 纵向 210mm，左右各 2cm 边距  → 正文宽 481pt
Courier New 9pt，字符宽 0.6em   → 每行 89 个字符（中文算 2 个）
正文高 728pt ÷ 行高 11pt        → 每页最多 66 行，默认排 50 行

每一行先算出占几个单位，累加到 50 就换页，分页点用 page-break-after 钉死，
再交给 Chrome 无头模式渲染。页数在生成之前就是确定的。

页眉（软件名称 + 版本号）和右上角页码放在 CSS @page 的页边距里，不占正文高度，
所以加了页眉也不影响每页行数。封面和说明页不出页眉、不计页码，正文页码是连续的 1–60。

超过 60 页的项目取整份源程序的前 30 页和最后 30 页，中间插一页说明页写清略去多少行——
注意不是「把源码对半分再各凑 30 页」，那样代码量一大每页会被撑到几百行。
成品是 62 页：封面 1 + 前 30 + 说明页 1 + 后 30。

核心实现在 lib/paginate.mjs，七十来行，可以单独拿走用。

🤖 当 AI 技能用

仓库根目录的 SKILL.md 是给 AI agent 读的版本，用的是通用技能包格式
（Claude Code / Claude Agent SDK 都认）。clone 到技能目录即可：

git clone https://github.com/CatCatUncle/ruanzhu-kit.git ~/.claude/skills/ruanzhu-kit

也可以放进 OpenWorkBuddy（一个跑在自己电脑上的
AI 办公助理）的 skills/ 目录，让它来跑：

git clone https://github.com/CatCatUncle/ruanzhu-kit.git <OpenWorkBuddy 目录>/skills/ruanzhu-kit

装完直接说「帮我准备这个项目的软著材料」，它会自己清点源码、出两份 PDF、核页数、算表单字数。
不用 agent，直接敲命令行产出的材料完全一样。

⚠️ 别踩的坑

字段逐项怎么措辞见 docs/form-fields.md，
大型项目的配置怎么写见 examples/large-project/。

📌 说明

这是个排版和清点工具，不是法律意见。材料能不能过审取决于你项目本身和审查员，
提交前请自己核对一遍著作权人、源程序量和证明文件。规则以
中国版权保护中心公布的为准。

🛠️ 开发

node test/run.mjs   # 19 项自测，最后两项会真的出一份 PDF，回读页数、页眉和页码

欢迎提 Issue 和 PR。材料被驳回或要求补正了，请用「被驳回 / 补正了」模板把原因贴上来——每一条都会变成下一版的自检项。表单字段有变化、某种语言的源码统计不准，也直接开 Issue。

⭐ Star History

如果这个项目对你有用，一个 Star 就是最好的支持。

👋 关于作者 · 合作

前大厂 Agent 工程师，有丰富的 Agent 落地实践经验。

• ✔️ 服务过跨境电商、制造业、AI 初创、私募金融机构、消费品巨头、国央企等客户的 AI 解决方案
• ✔️ 企业 AI 内训 ｜ 企业私有化部署 ｜ 行业智能体 ｜ AI 数字化全案 ｜ AI 搜索优化 ｜ Agent 项目落地

常驻深圳，欢迎前来交流和考察。

FDE（驻场工程）、Agent 项目落地及其他企业 AI 业务合作，请直接邮件联系：[email protected]

📄 License

MIT