开场:产品变了,客户不一定知道
早期 SaaS 更新很快。今天改导入,明天加报表,后天修权限。
但如果客户不知道变化,他就不会使用新能力;如果变化影响旧流程却没有说明,客户会觉得产品不稳定。
发布说明的价值,是让客户知道什么变了、为什么变、是否需要行动。
发布说明不是开发日志
不要写:
优化接口性能,修复若干问题。
客户更需要:
导入订单时,现在会在上传前检查缺失字段,并标出具体行号。这样可以减少导入失败后反复修改文件的次数。
发布说明要从客户场景出发。
每次发布分四类
| 类别 | 示例 |
|---|---|
| 新能力 | 新增批量导入预检查 |
| 改进 | 报表生成速度提升 |
| 修复 | 修复成员被移除后仍收到通知 |
| 行为变化 | 默认导出字段顺序调整 |
行为变化尤其要说明,因为它可能影响客户现有习惯。
写清客户需要做什么
有些更新只是告知,有些需要客户行动。
例如:
- 管理员需要重新授权。
- 老模板需要下载新版。
- 旧链接将在 30 天后失效。
- 新权限默认关闭,需要手动开启。
如果客户需要行动,不要藏在长段落里。
发布说明要有固定位置
可以放在:
- 产品内更新中心。
- 邮件列表。
- 客户群公告。
- 帮助文档 changelog。
- 客户成功月报。
渠道可以简单,但要固定。客户不能每次都靠群消息找更新。
不要每个小改动都打扰客户
可以按影响程度分发。
| 影响 | 沟通方式 |
|---|---|
| 高风险行为变化 | 邮件或单独通知 |
| 常规功能上线 | 月度或周度更新 |
| 小修复 | 更新日志 |
| 内部优化 | 不一定通知 |
沟通太少客户不知道,沟通太多客户会忽略。
用发布说明反推产品价值
如果你写不清“这个更新给客户带来什么价值”,说明功能可能只是内部认为重要。
每条发布说明都问:
- 解决了哪个客户问题。
- 哪类客户会受益。
- 是否需要客户行动。
- 有没有限制或边界。
这会倒逼产品表达更清楚。
发布说明的标准模板
高效的发布说明应遵循固定结构,降低客户的阅读门槛:
## v2.3.0 (2025-06-21) — 批量导入预检查
### 新能力
- **导入预检查**:上传 CSV 前自动校验字段完整性,标出缺失行号,减少反复修改。
- **适用客户**:所有使用数据导入功能的团队管理员。
### 改进
- **报表生成速度**:大数据量报表生成时间从 45 秒缩短到 8 秒。
### 行为变化 ⚠️
- **默认导出字段**:导出 Excel 时字段顺序调整为"名称→状态→时间"(原为"时间→名称→状态")。
- **影响**:依赖固定列位置的自动化脚本需更新映射。旧顺序可在"设置→导出偏好"中临时恢复。
### 修复
- 成员被移除后仍收到通知的问题(Ticket #2847)。
### 您需要做什么?
| 行动 | 适用客户 | 截止时间 |
|------|---------|---------|
| 更新自动化脚本 | 使用导出 API 的团队 | 2025-07-05 |
| 体验导入预检查 | 所有管理员 | 无 |
这个模板的优势:客户 10 秒内定位与自己相关的变化,行为变化用 ⚠️ 醒目标识,行动项用表格清晰呈现。
版本号策略(SemVer)
SaaS 产品采用语义化版本(Semantic Versioning)帮助客户理解更新力度:
| 版本段 | 变化类型 | 用户预期 | 示例 |
|---|---|---|---|
| MAJOR (X.0.0) | 破坏性变更 | 必须阅读迁移指南 | API v2 废弃 v1,旧 Token 失效 |
| MINOR (x.Y.0) | 新功能 | 想了解但不一定马用 | 新增报表类型、新集成 |
| PATCH (x.y.Z) | Bug 修复 | 可选阅读 | 修复通知重复发送 |
对早期 SaaS 的实用建议:
- MAJOR 升级控制:在公有云上频繁发 Major 版本会撕裂客户体验。建议将破坏性变更打包为"功能开关"逐步灰度,而非一次性 Major 版本发布。
- 版本别名:为 SaaS 提供"稳定版/快速版"双轨道,让保守客户留在稳定版,先锋客户提前体验新功能。
稳定版 (Stable):每季度发布,只有 PATCH + 精选 MINOR
快速版 (Early Access):每周发布,包含最新 MINOR + 实验性功能
多渠道分发策略
不同客户群体习惯不同的信息渠道,发布说明应做渠道适配:
| 渠道 | 内容形式 | 适合信息类型 | 发送时机 |
|---|---|---|---|
| 产品内更新弹窗 | 1~3 条核心变化 + CTA | 行为变化、需行动 | 登录时触发 |
| 邮件通知 | 完整模板 | MAJOR/MINOR + 行为变化 | 发布后 24h 内 |
| Slack/钉钉群 | 精简卡片 + 链接 | 所有更新 | 发布后即时 |
| 帮助中心 Changelog | 完整历史归档 | 全量 | 实时更新 |
| 客户成功月报 | 汇总 1 个月变化 | 月度回顾 | 每月初 |
| API 文档 | 接口变更详情 | 开发者关注 | 与代码同步更新 |
关键原则:同一信息不要出现在所有渠道。产品内弹窗只放"必须知道"的,完整详情引导到帮助中心。信息过载会导致客户习惯性忽略所有发布说明。
产品迭代节奏与发布说明的协同
发布说明的频率反映了产品团队的迭代节奏:
| 节奏 | 说明长度 | 适合阶段 | 风险 |
|---|---|---|---|
| 日更 | 1~2 条修复 | 早期 MVP,快速迭代 | 客户疲劳,忽视重要变更 |
| 周更 | 3~5 条混合 | 增长期,功能快速扩展 | 需严格区分影响等级 |
| 双周/月更 | 5~10 条完整模板 | 成熟期,稳定性优先 | 小问题堆积,客户觉得"没进步" |
周屿(前例中的独立开发者)在动作游戏 Demo 阶段是"每轮测试后更新"——对应 SaaS,建议早期采用周更 + 聚合,每周五发布本周所有变更的汇总,而非每次 Push 都发通知。
客户反馈闭环
发布说明不应是单向广播。建立"发布→反馈→改进"的闭环能持续提升客户满意度:
发布 v2.3.0
└── 产品内弹窗:"这个新功能对您有帮助吗?👍/👎"
├── 👍 → 记录成功案例,潜在推荐素材
└── 👎 → 触发简短问卷:"哪里不满意?"
└── 反馈汇总 → 下周产品评审会讨论
对于行为变化,强制加一句:“如果您对这项调整有顾虑,请回复此邮件或联系客户成功。” 给不满的客户一个低成本的表达渠道,比他们在社交媒体上公开吐槽好一百倍。
反模式:发布说明的常见错误
| 错误 | 示例 | 后果 | 修正 |
|---|---|---|---|
| 技术黑话 | “重构订单服务的数据访问层” | 客户完全不知道与自己有什么关系 | 改为"订单页面加载速度提升 40%” |
| 过度堆砌 | 一次发布 20 条变更 | 客户一条都不会看 | 聚合为 3~5 个主题包 |
| 隐藏坏消息 | 把价格调整埋在第 17 条 | 客户发现后信任崩塌 | 价格/权限变更单独邮件,标题明示 |
| 无行动指引 | 只说"默认设置已更改" | 客户不知所措 | 明确"如需恢复旧设置,请执行 X" |
| 发布后失联 | 发完说明没有反馈通道 | 错过改进机会 | 每条说明附"有反馈?点击这里" |
落地建议
从下次发布开始,写一份 5 到 8 行的客户版发布说明,包含变化、价值、影响范围和客户是否需要行动。
本周行动项:
- 确定你们产品的版本号策略(SemVer 还是日期版本如 2025.06.21)。
- 选一个固定渠道作为发布说明的"官方源"(推荐帮助中心 + 邮件)。
- 为下一次 MINOR 版本准备模板,包含"新能力/改进/行为变化/行动项"四段。
- 在行为变化项后加一个反馈入口(至少留一个邮箱或客服链接)。
SaaS 从 0 开始,发布说明不是形式主义。它让客户看到产品在进步,也减少变化带来的误会。写得好的发布说明,本身就是产品价值的二次呈现。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。