From 1536e241fceebccb159f125c054f8d1f04e8c3bc Mon Sep 17 00:00:00 2001
From: digua <i@digua.me>
Date: Mon, 18 May 2026 22:58:00 +0800
Subject: [PATCH] docs: add versioning and commit scope conventions to
 AGENTS.md

- All distribution targets share root package.json version (lock-step)
- Commit scope: free-form for shared changes, platform scope (electron/
  cli/web) only when the change is platform-specific
---
 AGENTS.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 780f507e..3f6e777f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,7 @@
 - 文档：开始开发前，请先查看 `./.docs/README.md`，并阅读与当前需求相关的文档
 - 目标：用最小改动快速交付正确、可维护、可回归的业务结果
+- 边界：只解决当前需求，不做与需求无关的重构和"顺手优化"
 - 每次完成任务后，对产生修改的文件进行类型检查、lint检查和format格式化，指定修改的文件路径去执行，确保代码质量
 - 在执行检查时，如果有其他与本次修改无关的报错，也需要一并修复
 - 多语言：代码中的日志、注释、AI 工具描述、错误消息等非 UI 文本默认使用英文。当有运行时 locale 可用时（如工具返回结果、AI 看到的文本），应通过 `isChineseLocale(locale)` 等机制支持中英双语。数据清洗中与聊天平台格式匹配的标签（如 `[分享]`、`[图片]`）保持原始语言不变。UI 文案的国际化遵循 `.docs/rules/i18n.md`
+- Commit 规范：使用 Conventional Commits。scope 规则——通用改动 scope 随意（如 `ai`、`import`、`sidebar` 等模块名）；仅当改动是**平台特有**时才使用平台 scope（`electron`、`cli`、`web`）。