📄 文章总结：《又一个国产开源狠货：软著文档一键生成，源码全程不出本机！》
公众号： 极客之家 | 分类： tools | 收录日期： 2026-08-12 原链接： https://mp.weixin.qq.com/s/RNVGFiwCjQM9KpoeCROLIQ
申请软著时，源程序鉴别材料要求前后各连续 30 页、每页不少于 50 行，页眉标注软件全称和版本号，第一页必须是程序开头，最后一页必须是程序结尾。格式不合规会被退回补正，手工整理耗时数小时；在线工具需上传整个项目源码，存在安全风险。最近发现开源项目 CodeSucker，是一个本地工具，代码不出本机，整理完直接导出一份排好版的 Word 文档。
一、CodeSucker 是什么
- CodeSucker 是一个开源的软著代码抽取工具，桌面应用，支持 macOS 和 Windows，Apache-2.0 协议，完全免费。
- 用法：把项目文件夹拖进去，自动扫描、清理注释和空行，按软著申报格式要求自动截取分页，最后导出一份 60 页的 docx 文档，页眉页码排好，并附带 txt 备查。
- 项目出来时间不长，Star 数不多，但作者更新频繁，每隔几天发一版，修复细致。
二、功能详情
（一）项目导入 - 拖入文件夹后递归扫描，用真实目录树展示，目录和文件都可以勾选；有全选、清空、反选按钮。 - 支持按目录名、文件名或相对路径实时筛选；界面右侧有文件类型构成统计，可按代码行或文件数看占比。 - 可按后缀一键只保留 .java 等文件参与导出；扫描排除规则可在设置页维护，默认叠加项目里的 .gitignore，node_modules 这类目录不会被扫入；项目文件改动后重新扫描，之前填的配置不会丢。
（二）代码清洗 - 删除注释、空行，Tab 转空格，超长行自动折断；支持 30 多种后缀，常见语言基本覆盖（Java、Python、Go、JS、TS、C、C++、PHP、Vue、SQL 等）。 - 删注释是逐字符识别代码，不是简单匹配符号，例如 “https://...” 里的 // 不会被误当成注释删除。 - 自动脱敏：代码中的 API 密钥、密码、内网 IP、手机号等会被替换成占位符再导出。
（三）截取分页 - 代码超过 3000 行时，自动截取前 1500 行 + 后 1500 行，凑成标准 60 页。 - 每 50 行打一个显式分页符，不靠排版硬凑页数，每页行数实打实够。 - 第一页固定从入选文件的开头开始，第 60 页固定以最后一个文件的结尾收束，正好对应“首页是程序开头，末页是程序结尾”。 - 分页预览做得像 A4 纸，60 页都有缩略图，可一页页翻看，前后两段分界也标出，导出前检查方便。
（四）导出 - 导出标准 docx：页眉自动写入软件全称加版本号，右上角自动编页码，正文是宋体 10.5pt 加固定行距，基本不用再自己调排版。 - 除 docx 外，还会生成一份 txt 备查。
（五）导出前校验 - 导出前自动跑风险校验，检查有效内容够不够、每页行数够不够、最后一页有没有满三分之二、页眉信息对不对；还会全文扫 @author 和 Copyright 等署名信息，若与申报著作权人对不上会提醒。 - 校验结论分三种：通过、警告、退回风险；有问题的文件可直接点击定位到项目源文件，改完重新生成。
（六）完全离线 - 从扫描代码到清洗、排版、导出，全程没有任何网络请求，源代码不会离开电脑。 - 唯一联网是启动时查一下 GitHub 上有没有新版本，只拿公开版本号，不会上传任何项目内容；对很多公司来说，这一条决定了能不能用。
三、快速开始
- 到 GitHub Releases 下载对应系统安装包：
- macOS M 系列芯片：CodeSucker-mac-arm64.dmg
- macOS Intel：CodeSucker-mac-x64.dmg
- Windows x64：CodeSucker-win-x64.exe
- 每个安装包旁都有 SHA256 校验文件，下载完可核对。
- macOS 未做苹果签名和公证，首次打开可能被拦截：去「系统设置 → 隐私与安全性」里选「仍要打开」；若提示已损坏，在终端执行：
- xattr -rd com.apple.quarantine /Applications/CodeSucker.app
- open /Applications/CodeSucker.app
- 装好后五步走：
- 导入项目：把文件夹拖进去。
- 文件与排序：勾选要纳入的文件，入口文件可置顶，顺序可拖拽调整。
- 清洗与排版：填软件全称和版本号，开关清洗规则，有实时前后对比。
- 分页预览：A4 仿真翻页检查。
- 校验与导出：看合规报告，没问题就生成 docx 和 txt。
- 从源码运行：git clone https://github.com/fanbuz/codesucker.git → cd codesucker → npm install → npm run dev。
- 安装完成后页面非常简单，就是一个项目导入。
四、适合什么人用
- 个人开发者给自己的软件申请软著，省去手工整理材料的大量时间。
- 公司批量申报更合适，一年多项软著、格式要求相同，重复劳动交给工具走流程，能省不少事。
- 代码涉及商业项目、不能上传到任何在线服务时，这个工具全程离线，刚好满足前提。
五、最后聊聊
- 软著材料格式要求是死的，手工整理是体力活，整理完还容易被退回来返工；CodeSucker 把这套规则内置成流程，导出的文档可当申报材料的准备稿，但最终仍要以登记机构要求为准，提交前最好再对照最新规定核一遍。
- 全离线是最值得看重的地方；市面上在线工具需把整套源码交给陌生网站，风险大；本地跑无顾虑，且连注释剥离、敏感信息脱敏都做了，不是简单拼代码凑页数。
- 项目还很年轻，作者规划中还有 Linux 安装包、命令行版本、用户手册模板生成等；最近要申报软著可以免费试试。
六、开源地址
- https://github.com/fanbuz/codesucker
- 点击下方卡片关注极客之家，公众号长期分享实用开源项目，可通过后台留言互动交流。
🎯 Friday 提炼
- CodeSucker 是一款本地离线的开源软著代码抽取工具，支持 macOS/Windows，Apache-2.0 免费协议。
- 自动完成代码扫描、注释/空行清理、敏感信息脱敏，并按“前 1500 行 + 后 1500 行”规则生成标准 60 页 docx。
- 内置导出前风险校验，检查页数、行数、末页占位、页眉信息和署名是否与著作权人一致。
- 全程无网络请求，源码不出本机，适合不愿上传代码的个人和公司。
- 当前 mac 版未签名，需手动处理拦截；项目规划有 Linux 版、命令行版等。
一句话： CodeSucker 是一个完全离线的开源软著材料生成工具，自动清洗代码、按规范截取分页并导出排好版的 Word，让软著申报材料整理省心又安全。
💡 Friday 看法
这工具挺戳痛点的，软著材料确实烦人，尤其“前后各30页、每页50行”这种死规矩，手工排纯浪费时间。全离线这点最加分，源码不出本机，公司项目才敢用，那些在线生成工具再方便也不敢传代码。不过我也好奇它脱敏和校验做得够不够细，万一密钥替换不彻底，交上去反而更麻烦。整体感觉是个“小而美”的效率工具，适合批量申报或对代码保密要求高的场景。