安装 belt CLI 技能：
npx skills add belt-sh/cli
产品变更日志
编写用户会阅读和关心的变更日志和发布说明，通过 inference.sh CLI。
快速入门
需要 inference.sh CLI (
belt)。安装说明
belt login
# 生成一个功能公告图片
belt app run falai/flux-dev-lora --input '{
"prompt": "clean product UI screenshot mockup, modern dashboard interface showing a new analytics chart feature, light mode, minimal design, professional SaaS product",
"width": 1248,
"height": 832
}'
条目格式
好条目的结构
### 新增：报表批量导出 📊
你现在可以从任何报表视图一次性导出多达 10,000 行数据。
选择你的行，点击导出，选择 CSV 或 Excel 格式。
此前每次导出限制为 500 行。
结构： 分类标签 -> 面向用户的标题 -> 你现在能做什么 -> 具体如何操作 -> 什么发生了变化 -> 视觉元素
面向用户的语言
❌ 内部语言：
"实现了导出服务的批处理队列"
"重构了 ReportExporter 类以支持分页"
"修复了 CSV 序列化的 Bug (PR #4521)"
✅ 面向用户的语言：
"你现在可以从任何报表一次性导出多达 10,000 行数据"
"处理大型数据集时，报表加载速度提升 3 倍"
"修复了导出的 CSV 文件缺少列的问题"
规则：
- 写出用户能做什么，而不是你构建了什么
- 以“你现在可以…”、“报表现在…”、“修复了…的问题”开头
- 包含好处，而不仅仅是机制
- 使用现在时态
分类
标准分类
| 分类 | 颜色 | 图标 | 用途 |
|---|---|---|---|
| 新增 | 绿色 | ✨ 或 🆕 | 全新的功能或能力 |
| 改进 | 蓝色 | ⚡ 或 🔧 | 对现有功能的增强 |
| 修复 | 黄色/橙色 | 🐛 或 🔨 | 错误修复 |
| 移除 | 红色 | 🗑️ 或 ⚠️ | 弃用或移除的功能 |
| 安全 | 紫色 | 🔒 | 安全补丁 |
分类规则
- 新增 = 用户以前完全无法做的事情
- 改进 = 用户以前能做，现在更好、更快、更容易了
- 修复 = 以前有问题，现在可以正常使用了
- 不要使用“更新”——它毫无意义。是改进了还是修复了？
版本编号
语义化版本控制 (SemVer)
MAJOR.MINOR.PATCH
3 . 2 . 1
| 组件 | 何时增加 | 示例 |
|---|---|---|
| MAJOR | 破坏性更改，重大重新设计 | 2.0.0 -> 3.0.0 |
| MINOR | 新功能，向后兼容 | 3.1.0 -> 3.2.0 |
| PATCH | 错误修复，小改进 | 3.2.0 -> 3.2.1 |
基于日期的版本控制
2026-02-08 或 2026.02.08 或 2026年2月8日
最适合持续部署的 SaaS 产品。
变更日志页面结构
# 变更日志
## 2026年2月8日
### 新增
- **报表批量导出** — 一次性导出多达 10,000 行数据。[了解更多 →](link)
- **深色模式** — 从“设置 > 外观”中切换深色模式。
### 改进
- **仪表盘加载** — 处理大数据集时，仪表盘加载速度提升3倍。
- **搜索** — 搜索结果现在包含已归档项目。
### 修复
- 修复了导出的 CSV 文件缺少列标题的问题。
- 修复了日期选择器显示错误时区的 Bug。
---
## 2026年2月1日
### 新增
- **API Webhooks** — 当你的账户发生事件时获得通知。
### 修复
- 修复了电子邮件通知延迟最多 2 小时的问题。
可视化变更日志
何时添加视觉元素
| 变更类型 | 视觉元素 |
|---|---|
| 新的 UI 功能 | 新功能的截图 |
| UI 重新设计 | 前后对比图 |
| 新工作流程 | 分步截图或短视频 |
| 性能改进 | 展示改进的图表 |
| 复杂功能 | 动画 GIF 或视频演示 |
生成视觉元素
# 功能截图（如果应用正在运行，使用代理浏览器）
belt app run infsh/agent-browser --input '{
"url": "https://your-app.com/new-feature",
"action": "screenshot"
}'
# 前后对比图
belt app run infsh/stitch-images --input '{
"images": ["before-screenshot.png", "after-screenshot.png"],
"direction": "horizontal"
}'
# 带有标注的注释截图
belt app run bytedance/seededit-3-0-i2i --input '{
"prompt": "add a red circle highlight around the export button in the top right area",
"image": "screenshot.png"
}'
# 功能公告横幅
belt app run falai/flux-dev-lora --input '{
"prompt": "clean modern product announcement banner, gradient blue to purple background, abstract geometric shapes, professional SaaS aesthetic, wide format",
"width": 1248,
"height": 832
}'
重大变更
重大变更需要特殊处理：
### ⚠️ 重大变更：API v2 端点已弃用
**变更内容：** API v1 端点将于 2026 年 3 月 15 日停止工作。
**你需要做什么：**
1. 更新你的 API 调用以使用 v2 端点（[迁移指南 →](link)）
2. 更新认证方式，使用 Bearer 令牌代替 API 密钥
3. 在 3 月 15 日之前测试你的集成
**时间轴：**
- 现在：v2 端点可用，v1 仍然有效
- 3 月 1 日：v1 返回弃用警告
- 3 月 15 日：v1 停止工作
如果你需要迁移帮助，请联系 [email protected]。
分发渠道
| 渠道 | 格式 | 时机 |
|---|---|---|
| 变更日志页面 | 完整详情，所有条目 | 每次发布 |
| 应用内通知 | 1-2 行摘要 | 新功能，重大变更 |
| 电子邮件 | 精心策划的亮点，视觉元素 | 主要发布（每月/每季度） |
| 博客文章 | 深入解析，提供背景 | 重大发布 |
| 社交媒体 | 单个功能亮点 | 值得注意的功能 |
| Slack/Discord | 简要公告 | 如果你有社区 |
社交媒体片段格式
🆕 [产品] 新功能：[功能名称]
[1-2 句话描述你现在能做什么]
[截图或演示视频]
立即尝试 → [链接]
写作技巧
要做什么
- 将相关变更分组在一起
- 以最大/最受请求的变更开头
- 为复杂功能链接到文档
- 包括谁请求了（"应广泛要求："）
- 为重大变更显示迁移路径
- 为每个条目注明日期
不要做什么
- 不要说“各种错误修复”——列出具体修复或跳过它们
- 不要包含内部引用（PR 编号、工单 ID、分支名称）
- 不要使用“更新了[功能]”而不说明如何更新
- 不要列出没人关心的变更（依赖版本升级、内部重构）
- 不要直接复制提交记录 —— 一个变更日志条目可能代表多个提交
变更日志频率
| 产品类型 | 频率 | 备注 |
|---|---|---|
| SaaS（持续部署） | 每周汇总 | 汇总一周的变更 |
| SaaS（主要功能） | 每次功能发布 | 配合博客文章 |
| 版本化软件 | 每次版本发布 | 与语义化版本控制关联 |
| API | 每次版本发布 + 弃用通知 | 包含迁移指南 |
| 移动应用 | 每次应用商店发布 | 匹配商店列表中的“新内容” |
常见错误
| 错误 | 问题 | 修正 |
|---|---|---|
| 开发语言 | 用户看不懂 | 写出用户能做什么 |
| “错误修复和改进” | 零信息 | 列出具体修复 |
| 没有日期 | 无法判断更新内容 | 为每个条目注明日期 |
| 没有视觉元素 | 用户跳过文字 | 截取主要功能的截图 |
| 重大变更被埋没 | 用户发现太晚 | 突出警告和时间线 |
| 提交日志作为变更日志 | 嘈杂，无帮助 | 策划和重写 |
相关技能
npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering
浏览所有应用：belt app list