前两年帮公司对接软著申报,最头疼的环节永远是代码注释整理。每次找开发要注释,要么是拖到截止日前一天才随便写两句,要么全是“定义变量”“调用接口”这种没营养的内容,提交上去三次有两次被版权局打回,说注释无法体现软件独创性,去年有个项目卡了快三周,差点耽误了高新认定的申报窗口期。
最开始我也以为这活只能靠开发磨,直到后来和同行交流,才知道早就有人用AI做这个了,我自己试了小半年,现在整理一个软著的3000行代码注释,小半天就能搞定,通过率基本是100%。
刚开始用AI写注释的时候我也踩过不少坑,最蠢的一次是直接把完整的项目代码扔给GPT,让它随便写注释,结果生成的内容全是语法层面的解释,甚至还有不少和代码功能对不上的胡编内容,拿去提交直接被打回,还被审核标记了“材料真实性存疑”,后面两个申报的项目都被重点抽查,折腾了好久才过。
千万不要直接把未处理的原始代码扔给AI生成注释,敏感信息泄露的风险不说,生成的内容大概率不符合要求。我现在的固定流程是,先给代码做一轮预处理,把里面的内部接口地址、密钥、公司私有配置全部删掉,还有脚手架自动生成的冗余配置代码、第三方依赖的引用代码也都清掉,只留自己写的业务逻辑代码,这样AI生成的内容才不会跑偏。
预处理完之后,要先给AI明确软著的注释规则,我一般会提前查好软著代码注释的官方要求,核心要求其实就两点:一是注释要对应具体的业务功能,不能只写语法解释,比如一段判断逻辑,不能只写“判断参数是否为空”,要写“判断用户上传的企业资质文件格式是否为PDF,大小是否超过10M,不符合则返回对应报错提示”,这样才能体现你这个软件的独有功能;二是注释占比要控制在15%到25%之间,不用每行都写,也不能几十行代码连一个注释都没有。
给AI的提示词也不用写得太复杂,我常用的版本是:“你现在是软著申报材料整理专员,要给以下代码写符合中国版权局软著申报要求的注释,我这个软件是面向电商商家的订单管理系统,核心功能是多平台订单同步和自动对账,以下代码是订单自动对账模块的内容,注释要说明每段代码实现的具体业务功能,不要写语法层面的解释,注释占比控制在20%左右。”每次喂个500行左右的代码就行,不要一次喂太多,AI容易记混前面的要求,生成的内容会跑偏。
生成完之后一定要抽十几分钟核对一遍,尤其是核心功能模块的注释,要确保和实际功能对得上,我之前就碰到过AI瞎编注释的情况,把订单对账的代码注释写成了用户登录的,要是没检查就提交肯定又要被打回。要是你嫌自己调提示词麻烦,也可以用软著Pro,我最近几个项目都是用它搞的,内置了官方的注释规范模板,上传预处理好的代码之后自动就能生成符合要求的注释,不用自己反复调参数,省下来的时间摸鱼都香。
还有个很多人容易忽略的点,就是3000行代码是要摘前后各1500行的,前面的1500行尽量放核心功能模块的代码,注释也写得稍微详细一点,审核员一般看前面的内容比较多,只要前面的注释合规,后面的不出大问题基本都能过。如果不知道注释的密度怎么控制,可以去软著申报材料页面看官方的示例,照着那个比例来就没问题,一般一页A4纸的代码放4到6条注释就刚好。
去年下半年开始软著的审核明显严了很多,我身边有好几个同行都因为注释太敷衍、和代码功能不匹配被打回,重新整理又要花大半个月,要是刚好赶项目补贴、高新认定的截止日,损失真的不小。之前还有个朋友图省事,直接买了网上现成的带注释的代码,结果和别人提交的代码重复率太高,直接被驳回不算,还进入了重点审核名单,后面半年申报的所有软著都被卡,得不偿失。
我现在给公司整理软著材料,注释部分基本不用找开发帮忙,自己用AI搞定就行,开发也不用额外抽时间做这种没技术含量的活,两边都省心。上个月帮朋友的小公司整理三个软著的材料,全部加起来也就花了一天不到的时间,比之前的效率高太多了。