前两年我帮公司报了十七八份软著,最头疼的材料从来不是源代码或者功能说明书,是看起来没啥存在感的代码说明。之前为了凑够要求的页数,我熬了好几个大夜逐行写注释,后来试着用AI生成,踩了三次打回的坑才摸透门路,现在整理一份材料最快半天就能搞定,还能一次过审。
先给没怎么接触过的人讲清楚,软著要求的代码说明,不是随便找几段代码加个注释就行的。它要求你对应提交的前30页、后30页源代码里的核心功能模块,逐段说明每部分代码实现的具体业务逻辑,要和你提交的源代码完全对应,还要和功能说明书里写的核心功能匹配,不然审核员扫一眼就知道你是凑数的,直接打回。
最开始我用AI生成的时候图省事,直接把软件名扔给AI,让它生成30页代码说明,拿到手看起来像模像样的,交上去半个月就被驳回,说代码说明和提交的源代码匹配度不足30%,属于无效材料。后来我才摸清楚正确的生成步骤,第一步绝对不是直接让AI瞎写,你得先把自己手里的源代码理清楚,把核心功能对应的代码片段摘出来,比如你做的是生鲜配送系统,就把下单核销、库存预警、路线规划这几个核心功能对应的代码,每段摘个20到30行,整理成一个文档,不要直接把整包源代码扔给AI,它根本抓不住你软件的核心特点,生成的全是通用模板。
整理好核心代码片段之后,你给AI的prompt要写得足够细,要说明软件的全称、版本号、用到的开发语言、核心功能有哪几个,每一段代码对应的是哪个功能模块,要求生成的说明只对应给出的代码内容,不要额外补充不存在的代码逻辑,也不要写空泛的架构优势之类的内容。我最开始不知道怎么写prompt的时候,还在软著申报材料整理的网站上找过现成的prompt模板,改改软件名和核心功能就能用,省了好多自己琢磨的时间。
生成完第一版内容之后,绝对不能直接用,这一步是最容易踩坑的。AI会不自觉补很多通用的代码逻辑,比如你没给它异常处理的代码,它可能自己瞎编一段对应的说明,和你提交的源代码完全对不上,这种内容一定要全部删掉。我之前试过直接交AI生成的原内容,三次打回全是因为匹配度不够,后来我每次生成完都会逐段核对,每一段说明对应的代码,必须是我已经整理好、要提交到版权局的源代码里有的,哪怕凑不够30页也没关系,只要所有内容都能对应上,就比凑一堆无效内容强。
还有个很多人容易忽略的点,不要让AI写太多空泛的技术描述,比如什么“本系统采用分布式架构,具备高可用高并发特性”,这种内容写了等于没写,审核员要的是具体的功能实现,你就直接写“第13-19行代码实现了生鲜商品临期校验功能,当商品保质期不足72小时时自动标记为折扣商品,同步推送提醒给运营人员”,越具体越容易过审,不会被打回补材料。
核对完内容之后还要调格式,很多人觉得格式不重要,我之前就吃过这个亏,把一段28行的代码拆到了两页里,对应的说明也分在了两页,审核员说逻辑不连贯,让我重新整理,来回折腾了快一个月才提交成功。现在我调格式的时候都会注意,每页至少放50行代码,对应的说明紧跟在代码段后面,字体用小四号宋体,行距1.5,不要留大段的空白,也不要把同一个功能的代码拆分到不同的页面。后来我嫌逐段核对匹配度太麻烦,就用了朋友推的软著Pro,它能自动比对生成的代码说明和你要提交的源代码的匹配度,低于70%的部分直接标红,我改起来快多了,最近三次申报都是一次过,半个月就拿证了。
要是你对代码说明的格式要求拿不准,也可以去软著材料模板板块下载官方要求的格式模板,直接把生成调整好的内容套进去就行,不用自己反复试格式合不合要求。
我之前有个同事不重视代码说明,自己随便凑了几十页交上去,前后被打回三次,本来要拿软著申报高新企业的,结果错过了申报截止时间,公司损失了二十多万的补贴,后悔得不行。其实用AI生成代码说明真的能省好多事,只要你按要求调整核对,基本不会出问题,总比熬好几个大夜自己逐行写注释强得多。要是你第一次申报没经验,也可以多找几份过审的样例看看,摸清楚审核的尺度,就不会踩那些没必要的坑了。