我前前后后帮公司和自己的小项目报过5次软著,最头疼的环节永远是代码注释整理。第一次报的时候赶投标资质,其他材料三天就整完了,唯独3000多行的代码注释,前前后后改了三回被打回,差点错过了投标截止时间,最后熬了两个通宵才勉强过审,那时候我就盼着能有个工具能直接帮我搞定这破事。
很多没报过软著的人可能不知道,软著要求的代码注释和我们平时写代码随手加的注释完全不是一回事。平时写注释只要自己或者同组的开发能看懂就行,哪怕写个“这里有坑别碰”都没问题,但是软著要的注释有明确的审核规则:首先是密度,平均30行左右就得有一条功能性注释,不能太少也不能凑数堆一堆没用的;其次是内容,不能写技术实现细节,比如“定义变量存储用户手机号”这种是没用的,必须点明这段代码实现的是哪个业务功能,比如“实现用户注册环节手机号合法性校验功能”,而且还要和你提交的软著功能说明书里的表述对应上,但凡有出入,大概率就会被打回来补材料。
之前我也试过用普通的AI大模型生成注释,把代码贴进去让它加注释,结果生成的全是技术层面的解释,交上去直接被打回,说注释不符合要求。直到上次报两个个人项目的软著,做知识产权的朋友给我推了软著Pro,说他们家的AI生成软著代码注释功能是专门针对软著审核规则做的训练,生成的内容直接就能用,我本来半信半疑,想着反正试试也不花钱,就把代码导了进去。
操作比我想的简单很多,你只要把准备提交的前30页、后30页代码整理成纯文本,去掉里面原来乱七八糟的个人注释,再填两个信息:一个是你这个软著的全称,另一个是核心功能的关键词,比如是做电商的就填“商品浏览、订单支付、用户中心”,是做管理系统的就填“数据统计、权限分配、报表导出”,点一下生成,十来分钟就能拿到一套完全符合要求的带注释的代码。我当时生成完翻了一下,密度刚好是三十行左右一条,每条注释都是功能层面的表述,和我之前写的功能说明书里的内容几乎能对应上,我只改了两三个和我们独有功能相关的注释,就直接提交了,不到一周就下证了,连补材料的通知都没收到。
当然也不是说AI生成完你完全不用管就直接交,我也踩过一个小坑,上次帮朋友的项目生成注释,他的功能说明书里写了有“短视频一键剪同款”的功能,但是他填核心关键词的时候忘了写,生成的注释里就没有对应的内容,我提交前核对的时候发现了,赶紧补了关键词重新生成了对应模块的内容,才没出问题。所以生成完之后,你最好花十几分钟过一遍,重点看核心功能模块的注释有没有和你的说明书对应上,个别核心功能的注释可以自己稍微润色下,加一点你们产品独有的表述,会更真实,完全不用担心被认为是套模板。
还有很多人容易陷入的一个误区,就是觉得注释越多越好,为了凑注释每十行就加一条,我第一次报的时候就是这么干的,结果被打回来说注释冗余,反而拖了进度。用专门的AI工具生成的就不会有这个问题,它的注释密度是严格按照过审的样本调整的,不多不少刚好符合要求,甚至如果你代码量不够凑不齐60页的话,还能帮你合理调整空行的比例,不会显得刻意,又能刚好达到页数要求,省得你自己手动去调空行调半天。
现在我身边做开发的朋友只要报软著,我都会推荐他们去软著Pro用这个AI生成注释的功能,毕竟大家平时开发需求都排得满,谁也不想花好几天的时间去抠注释这种没什么技术含量的活,省下来的时间不管是摸鱼还是多写两个功能都香。而且现在很多人报软著都是赶时间,要么是要赶补贴申报的截止时间,要么是要赶上架应用市场的时间,卡到注释这个环节真的太不值当了,用工具能搞定的事,就没必要自己熬通宵。
对了,还有个小提醒,生成注释的时候,不要把整个项目的代码全部贴进去,就按要求贴前30页和后30页的代码就行,多余的不用给,一来生成速度更快,二来也不会泄露你整个项目的核心代码,毕竟软著审核本来就只要求提交前后各30页,完全没必要把全量代码导出来,这点工具里也有提示,还是挺贴心的。