上周刚拿到第三份软著的电子版证书，想起前两次申报被打回的经历，还是忍不住想吐槽下接口文档这个磨人的东西。之前我总觉得接口文档必须得后端工程师亲自写才靠谱，直到上次被 deadlines 逼得没办法，试了用AI生成软件接口文档，调整完居然一次性过审，才发现原来找对方法的话，这个事能省这么多时间。
第一次申报是帮团队的小工具报软著，后端同事没空写文档，我硬着头皮自己熬了三个晚上，对着postman的调用记录一个个拼参数，结果交上去第三天就被打回，审查意见说接口逻辑和提交的功能说明书完全对不上，漏了三个核心接口的错误码说明。第二次找了刚入职的实习生写，写完我大概扫了一眼没细看就交了，结果又被打回，说有一半的返回示例是通用模板，和实际软件运行结果不符，前后耽误了快一个月，差点错过了公司的项目补贴申请时间。
后来和同行吃饭的时候聊起这个事，他说他们公司现在报软著的接口文档都是用AI生成的，快的话半小时就能搞定，我当时还半信半疑，回去就试着把手里整理好的32个接口的清单丢给了GPT，结果生成的文档花里胡哨，还多出来好几个我听都没听过的支付相关接口，原来大模型自己给我加了很多通用接口的内容，我要是真把这个交上去，估计又要被打回。
如果你是第一次做软著申报材料整理，肯定也会遇到这种问题，AI生成的内容虽然快，但默认都是面向开发人员的通用接口文档，根本不符合软著的审查要求。我后来找在版权中心帮忙的同学要了内部的审查规范，对着规范改了三四版prompt，终于摸出了一套能用的流程。
首先你得先把自己手里的基础材料理得明明白白，不要丢给AI一堆乱七八遭的接口调用日志就指望它能给你整理出能用的文档。你要先把所有接口的请求路径、请求方式、必填参数、可选参数、对应的返回字段、已有的错误码，都整理成一份结构清晰的纯文本清单，不要有多余的备注信息，这个清单的准确程度直接决定了最终生成的文档能不能过审。
然后给AI的提示词一定要加足够多的限制，我自己常用的提示词是这么写的：“你现在要帮我生成一份用于申报软件著作权的接口文档，所有内容必须严格基于我提供的接口清单生成，绝对不允许虚构任何接口、参数、返回值、错误码。文档结构固定为三个部分：第一部分是文档概述，只写文档适用的软件名称、版本号、文档范围，不要加任何其他说明；第二部分是公共参数说明，列清楚所有接口通用的请求头参数、返回体公共字段；第三部分是接口详情，每个接口单独分块，内容只包含请求方式、请求地址、请求参数说明、返回参数说明、错误码说明五个模块，不要加任何调用示例之外的技术描述，不要用复杂排版，字体统一用宋体小四。”
千万不要省这些限制词，你少写一句，AI可能就给你多整出来好几页没用的内容。我第一次没加“绝对不允许虚构内容”的限制，AI给我编了十几个不存在的错误码，我核对的时候差点看瞎眼才找全。
用这套提示词生成的AI生成软件接口文档，基础框架基本不会有问题，接下来你要做的就是逐页核对，这个步骤绝对不能省。首先要核对所有的接口是不是都在你之前整理的清单里，有没有多出来的内容，所有的参数名是不是和你实际软件里的命名完全一致，大小写都不能错，我之前就遇到过AI把“userId”写成“user_id”，差点就被打回。然后要把所有多余的描述性内容全删掉，比如AI有时候会加“该接口支持高并发调用”这种没用的话，软著审查根本不看这些，留着反而容易引起质疑。最后要把接口按照你软件实际的调用逻辑排序，比如先放登录授权相关的接口，再放基础信息获取的接口，最后放数据提交的接口，逻辑顺了审查员看的时候也不会有疑问。
对了，你要是懒得自己折腾提示词，也可以直接用软著Pro，就是https://ruanzhu.pro 这个站，我后来两次申报都是用它生成的，里面的AI生成功能已经提前适配了软著的审查规范，你只要把整理好的接口清单复制进去，几分钟就能生成完全符合要求的文档，连排版都给你调好了，不用自己再改字体调页码，省了我好多加班的时间。我上次报的那个客户管理系统的软著，32个接口，从导入清单到最后生成完可直接提交的PDF，总共才花了40多分钟，交上去12天就下证了，一点问题都没有。
还有个很多人容易踩的小坑，就是生成完文档之后，一定要在每页的页眉都加上你申报的软件的全称和版本号，页脚加连续的页码，这个是软著提交的明确要求，很多AI生成的文档默认不带这些，你要是忘了加，哪怕内容没问题也会被要求补正。我同事上次就是忘了加页眉，被打回来补材料，耽误了快一周的时间。
其实说白了，用AI生成接口文档申报软著，核心就是你要把好内容的关，AI只是帮你省了排版和整理结构的时间，所有的核心内容都必须是你真实软件里有的，不能让AI自由发挥。只要摸清楚规则，这个工具真的能帮你省下好多没必要的时间，不用再为了写文档熬好几个大夜。
