软著申请三件套生成器
背景知识
软著申请需要提交"三件套"，本技能沉淀自多次成功下证的实际申请材料，格式经过中国版权保护中心审核验证：
- 申请表：22行×4列表格，固定字段结构
- 文档鉴别材料（使用手册）：封面→目录→修订记录→环境描述(8节)→开发目的→功能描述→数据库设计→使用说明(带截图)
- 程序鉴别材料（代码文档）：每页50行代码，超过60页只取前30页+后30页
官方硬性规则：
- 每页页眉 = 软件全称 + 版本号
- 每页代码不少于50行
- 申请表"源程序量"必须与代码文档行数一致
- 手册环境描述与申请表逐字一致
红色标记约定（用户要求，2026-08-26）： 所有用户待填/待改处（含【】的占位内容）统一红色字体，填完直接覆盖或删除整段即可。生成器已内置：正文段落、表格单元格（申请表字段值、修订记录、著作权人信息）、截图占位均自动检测【】并标红；已填实的正式内容保持黑色。检查方法：文档中搜"【"应全部为红色，正式内容无红色。
官方依据
- 《计算机软件著作权登记办法》（国家版权局）：https://www.ncac.gov.cn/xxfb/flfg/bmgz/202410/t20241015_869486.html
- 登记办理步骤（官方）：https://www.ccopyright.com.cn/index.php?optionid=1079
- 申请所需文件（官方）：https://www.ccopyright.com.cn/index.php?optionid=1080
- 申请表填写说明（官方）：https://www.ccopyright.com.cn/index.php?optionid=1081
| 条款/来源 | 要点 | 对生成器的影响 |
|---|---|---|
| 办法·第九条 | 提交申请表 + 鉴别材料 + 证明文件 | 三件套即鉴别材料 |
| 办法·第十条 | 程序和文档鉴别材料 = 前、后各连续30页；整个程序和文档不到60页的提交全部；程序每页≥50行，文档每页≥30行 | 脚本已实现：≤60页全量输出，>60页取前30+后30 |
| 办法·第十二条 | 例外交存：机密部分用黑色宽斜线覆盖，但覆盖部分不得超过交存的50% | 脱敏替换属于轻度覆盖；大面积机密可申请例外交存 |
| 办法·第十七条 | A4纸（297mm×210mm）、统一表格、中文填写 | docx模板已按A4设置 |
| 办法·第二十条 | 受理日起60日内审查完成 | 官方免费通道周期预期 |
| 办法·第二十一条 | 名称/权利人署名不一致、材料不规范 → 不予登记 | 一致性检查清单的官方出处 |
| 官方指南 | 补正须在30日内完成，逾期视为撤回申请 | 提醒用户盯紧补正通知（短信常进垃圾箱） |
官方申请表填写细则（ccopyright.com.cn 填写说明摘录）
- 软件全称：简短明确、针对性强；申请材料中全称必须一致；建议"品牌/识别性前缀 + 功能关键词 + 软件/系统/平台"。纯通用名（如"进销存软件""办公系统"）会被要求补正
- 简称：没有简称留空，不要填"无"；不要与全称完全相同
- 版本号：规范写 V1.0 或 1.0；登记证书版本号以申请表填报为准，鉴别材料页眉版本号须与申请表一致，"有无V"以申请表为准；首次登记强烈建议 V1.0，升级再走变更登记
- 开发完成日期：软件全部固定在有形载体（硬盘/CD-ROM）的日期；逻辑约束：≤ 首次发表日期、早于申请日（建议≥2个月）、企业申请时≥营业执照成立日期+3个月（成立不久即"完成开发"会被质疑）
- 发表状态：未发表就选"未发表"（销售/网上发布/为销售目的的展示都算已发表）
- 开发方式四种：单独开发（无需证明）/合作开发（协议）/委托开发（合同）/下达任务开发（任务书）——非单独开发须附权属证明扫描件
- 权利取得：原始取得须为独立开发；继受取得（受让/继承/承受）须附对应证明文件
- 硬件环境禁止填"无"：至少写"CPU≥1GHz，内存≥1GB"级别
- 签章：签章页须本人签名或鲜章（机构公章须为鲜章，不接受复印件章）
官方在线办理流程（全线上，免费）
- ccopyright.com.cn 注册账号 → 实名认证（个人人脸核验+身份证；企业营业执照+法人证件）
- 在线填报（R11 计算机软件著作权登记申请）→ 在线打印申请确认签章页（勿改格式/打印比例）→ 签章后上传扫描件（PDF）
- 上传鉴别材料（源程序 PDF + 文档 PDF）+ 身份证明文件
- 受理：材料齐全即受理；不齐 30 日内补正
- 审查：受理日起 60 日内完成
- 领证：电子证书 PDF 官网用户中心下载，与纸质同等效力；纸质证可另申请邮寄
身份证明文件按主体：个人=身份证正反面（签字）；企业=加载统一社会信用代码的营业执照副本（盖公章）；外国主体有护照+翻译件/附加证明书等特殊要求（详见官方指南 1080）。
> 2026 年动态（第三方机构信息，提交前以官网为准）：3 月起实行有限实质审查，新版申请表要求"主要功能"500-1300 字详述（研发背景/核心架构/技术实现），签章页含真实性承诺；名称重复审查趋严，重名需提交功能差异说明。
技能目录结构（自包含，可整体迁移）
ruanzhu-generator/
├── SKILL.md # 本文件：流程 + 官方规则 + 多语言适配
├── scripts/gen_ruanzhu.py # 核心生成器（三件套 + 脱敏引擎 + 红色标记 + 自动插图）
├── configs/
│ └── config-示例.json # 通用配置模板（含全部字段说明）
└── assets/
├── 材料收集清单.md # 第零步：向用户收集材料的清单与话术
├── 在线填报指南.md # 第五步：官网在线填报逐步陪跑指南
├── 1-申请表模板.docx # 手工微调用的空白底稿
├── 2-文档鉴别材料模板-使用手册.docx
├── 3-程序鉴别材料模板-代码文档.docx
└── 填写指南.md # 三件套全部规范 + 一致性检查表
优先用脚本生成（--config 或 --template），assets 里的 docx 仅在需要手工微调格式时作底稿。--template 模式会直接把空白三件套生成到指定目录。
环境依赖
- Python 3.10+ 与
python-docx（pip install python-docx）；插图功能无需 Pillow（内置 PNG/JPEG 尺寸嗅探） - Windows/macOS/Linux 通用；命令中的
python按本机环境替换
环境自检与降级（生成前必做）
运行前按以下顺序探测，避免直接报错吓到用户：
- 探测解释器：依次尝试
python --version、python3 --version、py -3 --version，取第一个可用的来执行脚本 - 缺 python-docx：脚本会打印中文提示（含安装命令）。AI 应直接替用户执行
pip install python-docx（装到隔离/用户环境，不污染系统）后重试；多版本混装时装不上时改用py -3 -m pip install python-docx - 完全没有 Python：若当前运行环境提供受管 Python/沙箱运行时，直接静默使用，不要让用户自己装；确实没有任何可用解释器时，才明确提醒用户：
> "生成软著文档需要 Python 3.10+，本机未检测到。请到 python.org 下载安装（Windows 也可用winget install Python.Python.3.13），装好后告诉我，我继续生成。" - 探测与安装过程无需用户参与，只在最终无解时才求助用户
页数规则提示（生成后必须向用户说明）
脚本会在控制台输出页数结论，AI 必须转述给用户，避免用户误以为必须凑满60页：
- 源码 >60 页：已按官方第十条截取前30页+后30页，代码文档 60 页整，无需人工处理
- 源码 ≤60 页：按官方第十条整体提交全部代码，属正常合规操作，无需凑页数
- 源码过薄（<1500 行）：脚本会给出
[!]警告——形式合规但材料偏薄、易被质疑程序量，建议用户扩大抓取范围（纳入更多业务源码），勿用纯配置文件/第三方库代码凑数
使用流程
第零步：向用户收集材料（按 assets/材料收集清单.md）
必须问用户的 5 项（缺一不可，一次性问全避免反复打断）：
1. 源码路径
2. 软件全称（识别性前缀+功能词+软件/系统/平台）+ 版本号（首次建议 V1.0）
3. 著作权人：个人还是企业？姓名/证件号/省市
4. 开发完成日期（逻辑约束见"官方申请表填写细则"）+ 发表状态
5. 系统截图文件夹路径（每模块1-2张、总量≥8张，用于自动插图）
不用问、由 AI 从代码推断：技术栈、编程语言、功能描述、模块划分、数据结构、源程序量。
材料不齐时明确告知用户缺什么，齐一项推进一项。
第一步：收集项目信息（补充确认）
向用户询问（或从项目源码推断）：
- 软件全称（以"软件/系统/平台"结尾）、版本号
- 技术栈（决定"编程语言/开发工具/运行环境"字段和代码抓取扩展名）
- 源码路径
- 著作权人信息（个人申请为常见情形）
参考 configs/config-示例.json 的字段结构填写配置。
第二步：生成三件套
SKILL_DIR=<本技能所在目录>
python "$SKILL_DIR/scripts/gen_ruanzhu.py" --config 配置.json --out 输出目录
# 只出空白模板（不接源码）：
python "$SKILL_DIR/scripts/gen_ruanzhu.py" --template --out 输出目录
# 自动插图（手册生成后，把截图目录里的图按占位符文件名插入）：
python "$SKILL_DIR/scripts/gen_ruanzhu.py" \
--insert-screenshots 输出目录/XX文档鉴别材料-使用手册.docx --shots 截图目录
依赖：python-docx（pip install python-docx）。
脚本自动完成：
- 代码行数统计（排除 node_modules/oh_modules/build 等，超120字符行截断）
- 敏感信息自动脱敏（详见下节，同时生成脱敏报告.txt）
- 源程序量自动统计（配置"源程序量": "auto"时生效，三处文档数字自动一致）
- ≤60页全量输出；>60页取前30页+后30页（官方第十条），严格输出60页整：前1500行+后1499行+末行"（代码结束）"标记，不加分隔空行、不加行数说明页
- 页眉、每页50行分页
- 行数与截取说明只写入脱敏报告.txt和控制台，不写入代码文档正文
- 页数结论三档提示（见"页数规则提示"），必须转述给用户
- 申请表 22×4 表格
- 使用手册完整骨架
生成完成后的交付提醒（AI 必须逐条转述给用户，缺一不可）
三件套生成后，向用户输出以下清单（可按实际情况裁剪，但红色替换、目录更新、PDF 三条永远要说）：
- 替换红色占位：文档中所有红色【】内容逐处覆盖为真实信息或整段删除。自查方法：全文搜索"【"，命中的必须全为红色且均为待填项；正式内容不应出现红色。重点核对：著作权人信息、开发完成日期、环境描述 8 节
- 确认截图：已自动插图则确认无红色"未命中"提示；有未命中的按占位符中的文件名手工插入（每模块至少 1 张、总量 ≥8 张）
- 更新目录：Word 中 Ctrl+A 全选 → F9（否则目录页码是错的）
- 一致性核对：三份文档软件全称/版本号完全一致；页眉 = 本项目名；申请表"源程序量" = 代码文档行数（auto 模式已自动一致，仍需目检）
- 脱敏抽查：脱敏报告命中 >0 时核对命中行上下文；0 命中也抽查代码文档前 3 页
- 敏感词终检：全文不得出现第三方品牌词（微信/支付宝/银行等）、网址、联系方式
- 转 PDF：定稿后用 Word/WPS"另存为 PDF"导出（勿用第三方截图转 PDF 工具，避免字体丢失）；不加密、不打水印；签章页签字/盖章后扫描上传
常见运行故障：生成失败提示"无法写入/文件被占用" = 输出目录里的同名 docx 正在 Word/WPS 中打开，关闭后重跑即可。
敏感信息脱敏（生成前必看）
先扫描、后脱敏、再交存。 脚本默认开启（配置"脱敏": true），在抓取代码时逐行处理，只替换值、不删行，源程序量统计不受影响：
- 关键字赋值：
password/apiKey/secret/token/credential等被赋字符串字面量 → 值替换为***REDACTED***（数字计数器如xxxToken = 0不会误报） - URL 内嵌凭据：
jdbc:mysql://user:pass@host、https://user:pass@host→ 凭据替换 - 私钥块：
-----BEGIN xxx PRIVATE KEY-----到 END 整块覆盖 - IP 地址（含端口）→
x.x.x.x；手机号、18位身份证号 → 掩码 - 占位符（
xxx、${...}、your_xxx等）不脱敏
每次生成输出 脱敏报告.txt：命中行数、占比（官方第十二条要求覆盖≤50%）、逐行位置清单。人工抽查建议：脱敏命中 > 0 时，打开代码文档核对命中位置上下文是否合理；报告显示 0 命中也应抽查前3页确认无关键信息（脚本规则不可能覆盖所有命名习惯）。
多语言项目适配速查
不管什么语言，抓取前确认两件事：代码扩展名、排除目录。常用组合：
| 技术栈 | 代码扩展名 | 额外排除目录 |
|---|---|---|
| Python | .py |
venv .venv __pycache__ site-packages |
| Java | .java |
target |
| C/C++ | .c .cpp .h .hpp |
build cmake-build-debug Debug Release |
| C# | .cs |
bin obj packages |
| Go | .go |
vendor |
| 鸿蒙 ArkTS | .ets .ts（勿含 .json 资源） |
oh_modules .hvigor build .preview resources |
| React/React Native | .jsx .tsx .ts .js |
node_modules dist coverage |
| Flutter/Dart | .dart |
build .dart_tool ios Pods android/.gradle |
| Vue | .vue .ts .js |
node_modules dist |
统计口径：只抓 src/entry/src/main 等业务源码目录，不抓测试（test/ohosTest）、资源、配置产物。行数即申请表"源程序量"。
填写口径：编程语言=实际语言（如 ArkTS）；开发工具=IDE（如 DevEco Studio 5.0）；运行平台=目标系统版本。
第三步：人工收尾（必须提醒用户）
- 插入系统截图：优先用
--insert-screenshots自动插图（占位符里标了文件名，脚本按文件名从截图目录插入，竖屏8.5cm/横屏13cm居中，未命中的保留红色提示手工插入）；手动插图时每模块至少1张、共10-20张（手册正文≥15页、截图≥8张为安全线） - 更新目录：Word 中 Ctrl+A 全选 → F9
- 一致性检查（真实踩坑案例：某项目代码文档页眉残留了上一个项目的软件名，复制文档时最易犯）：
- 三份文档软件全称/版本号一致；页眉 = 本项目名（"有无V"以申请表为准）
- 源程序量 = 代码文档行数
- 环境描述8节 = 申请表字段
- 手册截图中的菜单/按钮文字在代码里能搜到 - 敏感内容终检：手册/代码中不得出现未授权第三方字样（微信/支付宝/银行等品牌词、第三方 Logo、Copyright 开源协议头）、网址、联系方式
- 日期逻辑：开发完成 ≤ 首次发表 ≤ 申请日；开发完成建议早于申请日 2 个月以上
- 提交格式：转 PDF 上传，不加密、不打水印；签章页签好再扫描
第四步：申请渠道建议
- 官方免费通道（推荐）：www.ccopyright.com.cn 全程线上（注册→实名认证→填报→上传→受理→60日内审查→下载电子证书 PDF），实际 30-40 个工作日居多
- 付费加速：易版权等代理，300-1000元，适合急用（如鸿蒙上架等证）；加急最快 3-5 天（第三方报价）
- 收到补正通知须 30 日内响应，逾期视为撤回；短信通知常进垃圾箱，建议每周登录后台刷一次状态
- 鸿蒙 AppGallery 上架：版权信息栏上传软著证书即可
第五步：在线填报陪跑（按 assets/在线填报指南.md 逐步指导）
三件套 PDF 备好后，主动提出陪用户走完官网提交流程：
1. 引导注册账号 + 实名认证（提醒：实名主体 = 著作权人，先定个人还是企业）
2. 选择 R11 计算机软件著作权登记申请，逐字段指导填写——用户报当前页面字段，按指南"第 3 步字段表"给口径和避坑点
3. 指导上传材料（申请确认签章页扫描件、源程序 PDF、文档 PDF、身份证明；不加密不打水印）
4. 提交后提醒跟踪节奏（每周刷状态、30 日补正时限）
5. 拿到电子证书后提醒：华为 AGC 版权信息栏上传即可
用户每完成一步回来报告，再给下一步；遇到补正通知，按"常见驳回原因速查"对症处理。
鸿蒙/ArkTS 项目适配要点
- 代码扩展名：
.ets .ts .js .css .json - 排除目录加：
oh_modules、.hvigor、resources（纯资源目录） - 开发工具：DevEco Studio 5.0；运行平台：HarmonyOS 5.0及以上
- 无数据库的休闲游戏：手册"核心数据库设计"改为"核心数据结构设计"，粘贴 ArkTS interface/class
常见驳回/补正原因速查（按环节分类）
行业统计：约 90% 的退回集中在材料形式而非独创性；其中文档类占 60%+、代码类 30%+、申请表类约 10%。
文档类（驳回率最高）
| 原因 | 预防 |
|---|---|
| 手册"太简单"，未体现功能与技术特点 | 正文≥15页；截图≥8张且覆盖"主界面→三级菜单"完整路径；加系统架构图或流程图 |
| 手册与代码对不上（截图里的菜单/按钮/字段在代码中搜不到） | 全局搜索截图中的关键词，确保代码里出现≥1次；手册功能描述与代码实际模块一致 |
| 含敏感词（微信/支付宝/抖音/银行/证券/医院/北斗/GPS 等未授权字样） | 用"XX支付""XX地图"等替代表述；删截图里的第三方 Logo、标题栏 |
| 版本号打架（手册/申请表/代码/截图不一致） | 首次登记统一 V1.0；以申请表为准，页眉与之一致 |
| 手册出现网址、联系方式等违规内容 | 定稿前全文检查 |
| 截图模糊、无法识别功能 | 用高清原始截图，勿缩放失真 |
代码类
| 原因 | 预防 |
|---|---|
| 行数/页数不足 | 不足60页须整体提交；含注释空行可计入，但勿拿纯配置文件凑数 |
| 含第三方版权头（Copyright xxx / Apache/BSD/MIT 声明） | 抓取已排除常见库目录；抽查前3页；自写文件勿保留开源协议头 |
| 与已登记软著雷同（系统连续30行重复比对） | 同类项目注意变量/函数命名差异化 |
| 注释处理不当 | 留：版权声明（版权归XX所有）、核心功能说明；删：测试类（//测试用后续删除）、私人信息（姓名/修改日期）；末页标注"（代码结束）"避免被误判材料不全 |
| 代码与手册功能无关（手册讲算法，代码只有CRUD） | 关键算法文件保留在交存代码中，手册对应章节专门展示 |
| 鉴别材料加密/压缩/打水印 | PDF 不要加密、不要打"内部资料"类水印 |
申请表类
| 原因 | 预防 |
|---|---|
| 页眉与软件名/版本号不一致 | 用脚本生成而非复制旧文档；"有无V"以申请表为准 |
| 每页不足50行 | 脚本已按50行分页；勿手动编辑代码页 |
| 源程序量对不上 | 以脚本统计为准（auto模式自动回填） |
| 硬件环境填"无" | 至少"CPU≥1GHz，内存≥1GB" |
| 开发完成日期逻辑矛盾 | 完成≤发表；完成早于申请日（建议≥2个月）；企业申请完成日期≥成立日+3个月 |
| 软件名称过于通用 | 加识别性前缀/品牌词 |
| 身份证明问题（未盖章/公章与执照名不一致/证件过期） | 提交前核对；机构须鲜章 |
| 重复登记（同版本同功能同权利人，系统MD5比对） | 升级走变更登记，勿重复提交 |
| 签章页无签章/未上传 | 受理环节直接不予受理 |
代码泄露密码/密钥/IP等敏感信息
脱敏引擎自动处理 + 查看脱敏报告.txt + 人工抽查。
参考来源（2026-08 联网核实）
- 官方：中国版权保护中心登记指南三页（办理步骤/所需文件/申请表填写说明，optionid=1079/1080/1081）、国家版权局《计算机软件著作权登记办法》
- 实战经验：驳回原因统计与避坑来自多家知识产权服务机构公开资料（壹点壹线、咕咕狗、凯东等），属行业经验口径，具体以官方指南为准
