乐于分享
好东西不私藏

CodeSucker,一键生成软著代码文档,源码全程不出本机

CodeSucker,一键生成软著代码文档,源码全程不出本机

申请过软著的兄弟,应该都被“源程序鉴别材料”折腾过。

前后各 30 页、每页至少 50 行,页眉得有软件名和版本号,第一页还必须从程序开头开始,最后一页得收在程序结尾。代码本身没啥问题,最后经常卡在 Word 排版上,挺离谱。

最近东哥刷到一个国产开源项目 CodeSucker,就是专门收拾这摊活的。

最省事的地方是:把项目文件夹拖进去,它扫描、清洗、截取、分页,最后直接吐一份 60 页 docx。整个过程在本机完成,源码不用上传。

这个我会多瞅一眼。公司项目最麻烦的往往不是“工具能不能生成”,而是源码敢不敢丢给一个陌生网站。CodeSucker 除了启动时检查 GitHub 新版本,处理代码本身不走网络。

它会递归扫目录,也吃 .gitignore,node_modules 这种东西不用自己费劲巴拉排除。文件还能按目录、路径、后缀筛,比如项目里前后端混着,只交 Java,就直接留下 .java

代码清洗也不是简单正则糊一下。注释、空行能删,Tab 能转空格,长行会折行;像字符串里的 https://,不会因为里面有 // 就被误删。API Key、密码、内网 IP、手机号还能做脱敏。

超过 3000 行时,它会取前 1500 行 + 后 1500 行,每 50 行硬分页。页眉、页码、字体这些也一起生成。

东哥这种老开发看到自动生成文档,第一反应一般是:出错前能不能先告诉我。 它这里还真做了导出前校验,页数、每页行数、末页内容、页眉,甚至 @author、Copyright 署名都会扫一遍,有问题能定位回源文件。

目前支持 macOS 和 Windows,Apache-2.0,免费开源。macOS 安装包暂时没苹果签名,第一次打开可能得去隐私与安全性里放行,这个小坑提前说一下。

项目还挺年轻,但这种工具我觉得不需要整太花。能把源码留在本机,把那几十页材料老老实实排出来,就已经省掉一堆重复劳动了。

Github地址:fanbuz/codesucker