操作手册与设计说明书写作要点：结构、截图与一致性

两种文档怎么选

（行业实践）操作手册面向最终使用者，以界面操作流程为主线，适合有可视界面的产品；设计说明书面向技术审查，以架构与模块设计为主线，适合后端服务、算法库等无界面软件。官方只要求提交其中一种（《所需文件》：源程序和「任何一种文档」），「也可以都交」是平台与代理机构的说法。判断标准很简单：哪种文档更容易如实展现你的软件，就写哪种。

推荐的五要素结构

五要素不是官方模板，而是审查视角下「一份能自洽的软件文档」应具备的信息结构。每个功能点的描述都应能在软件里实际找到对应——这就是「与源程序事实一致」的通俗含义：文档的每一句功能声明，都应当有代码或界面证据可以支撑。

• 功能背景：软件解决什么问题、面向什么用户
• 总体结构：架构分层或功能模块划分总览
• 运行环境：硬件要求、操作系统、依赖的运行时/数据库
• 功能说明：逐模块/逐界面的功能与操作流程（文档主体）
• 其他说明：数据流程、接口约定、异常处理等（按需）

截图要求

• 操作手册应配界面截图，与文字描述的操作步骤一一对应
• 截图中出现的软件名称/标题栏须与登记名称一致
• 使用真实运行界面，不要用设计稿/原型图冒充
• 脱敏处理测试数据中的真实个人信息

版式与篇幅

文档同样需要页眉（软件全称 + 版本号）与连续页码，正文建议配目录。官方未规定篇幅下限，但过短的文档（如三五页）难以支撑一个「功能完整的软件」的印象；以能把主要功能讲清楚为准，通常几十页较为常见。

最容易失分的一致性细节

• 文档模块名与代码/界面实际名称不一致
• 文档描述了尚未实现的「规划功能」
• 运行环境写了实际不支持的平台
• 文档版本号与申请表版本号脱节