u

code/g3soft-erp/CODEBUDDY.md

@@ -124,6 +124,17 @@ pnpm test:e2e:ui       # 带 UI 的调试模式
 账号密码不用去查库。库里没有的账号靠 `sql/` 下的脚本建（执行顺序见 `sql/README.md`）；
 要给 `demo_*` 放开更多菜单，用 `sql/README.md` 里「可选：给普通账号授权」那段。
 
+## UI 文案
+
+**不写解释性 / 引导性文案。** 这是内部系统，用的人就是配系统的人，不需要教他下一步点哪。
+
+- 别写「创建后会自动新增一条页签，请继续填写页签名称和 SQL 条件」这种"接下来你要干什么"的说明。
+- 表单下面不挂说明段落；也别用文字解释控件本身（禁用态、必填标记、示例 placeholder 就够了）。
+- 别写「改动即时生效」「留空表示不带默认条件」这类系统本该自明的话。
+
+仍然要写的：**空态提示、校验报错、图标按钮的 `title`**——它们承载的是「页面没坏 / 哪儿错了 /
+这个图标是什么」，不是教操作。
+
 ## 踩坑备忘
 
 - **同一账号重复登录会互踢**：每次登录都刷新服务端 session（`ActiveSessionRegistry.activate`），