docs(changelog): clarify platform-specific entries

This commit is contained in:
digua
2026-05-21 22:50:03 +08:00
parent 3a2d4e753a
commit 1171fec7d0
2 changed files with 15 additions and 0 deletions
+13
View File
@@ -61,6 +61,19 @@ git show -s --format='%B' <commit>
3. 忽略纯发布噪音提交(如仅版本号、仅锁文件且无业务影响的提交),除非用户明确要求保留。
4. 将每条 item 改写为简洁中文短句,避免直接照搬英文标题。
端标记规则:
1. 只有某个端或某个集成入口专属的变更,才在 item 前加中文全角前缀。
2. 跨端共享、用户感知一致或底层统一能力的变更不加前缀,保持自然描述。
3. 推荐前缀:
- `【桌面端】`:仅 Electron 桌面端可见或仅影响桌面端。
- `【CLI Web】`:仅通过 CLI 启动的 Web UI 可见或仅影响 Web 模式。
- `【CLI】`:仅命令行、npm 包、CLI 启动/发布链路相关。
- `【MCP】`:仅 MCP Server、MCP 设置或 MCP 工具集相关。
4. 如果同一能力在多端都有入口,但实现或体验不同,可拆成多条专属 item;如果重点是统一后的共享能力,则写成不带前缀的跨端 item。
5. `summary` 可概括提及端名,但不使用前缀格式。
6. 同一个 `type` 下的 `items` 排序:先放不带端前缀的通用/跨端变更,再放带端前缀的专属变更;专属变更内部按影响范围和用户可感知程度排序。
## 4. 生成 summary
为本版本生成 1 句中文 summary:
@@ -26,3 +26,5 @@
- `summary` 聚焦用户可感知变化。
- `items` 使用短句,尽量一条表达一个改动。
- 若某分类无条目,不写该分类。
- 仅端特有或入口特有的 item 加前缀,如 `【桌面端】``【CLI Web】``【CLI】``【MCP】`;跨端共享或统一能力不加前缀。
- 同一分类下先写通用/跨端变更,再写带端前缀的专属变更。