docs: CODING_RULES 更名为 TOP_CODING_RULES 并补齐通用规则与踩坑清单

改名(对齐 pj0034 的 TOP_ 前缀):
- CODING_RULES.md → TOP_CODING_RULES.md,同步 5 处引用
  (CLAUDE.md 目录树与启动仪式、PROJECT_STATE.md 三处、DR03、DR04、文件内 G06 自引用)

补齐通用部分 G09–G18(承接 pj0034 同名文件的通用规则,按本项目
Go / Vue3 / SQLite / Ubuntu 技术栈改写):
- G09 登录态与接口必须无状态化
- G10 配置化优先,禁止写死环境细节
- G11 素材必须可追溯,不可静默修改
- G12 长耗时任务必须异步化
- G13 先跑通主线,再细化和优化
- G14 Git 不抢戏 — 收工时统一提示一次
- G15 禁止通用名启动入口文件,启动逻辑必须在 start_dev_10231_10232.sh
- G16 Windows 侧 .ps1 脚本统一 UTF-8 with BOM
- G17 脚本内禁止兼容式依赖回退,必须固定单一工具链
- G18 仓库应尽量支持拷贝后直接运行
不抄的(逐条判断本项目不适用):Python 虚拟环境、Playwright/clickflow E2E、
OSS 多租户、Amazon 平台规范检测;该判断已写进文件头说明。

G04 补第 6–10 条:全绿≠跑通、报告事实而非意图、读清用户的 bug 描述、
修 UI bug 追完整渲染链、跨区移动数据后验另一端完整性。

新增 P06 常见技术陷阱清单(11 条,全部来自本项目真实事故或核过代码的事实):
AutoMigrate 只加不删、探测脚本用完即删、worker_run.status 恒为 done、
seed 只补空字段、禁止按进程名模糊匹配杀进程、Element Plus persistent
留隐藏 DOM、动用户数据前先备份再列清单、hash 路由改 hash 不重载、
gofmt 不要整个目录 -w、git remote 禁嵌明文凭据、禁引第三方受限素材。

顺手修三处不一致:P01 索引名过时(培训平台→通用数字员工平台)、
DR03 引用的编号在重组后指向了错规则(第 6 条→G07)、第二部分标题层级。

版号 V1.0 → V1.1。

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
eaiadmin
2026-09-17 22:59:17 +08:00
co-authored by Claude Code
parent 16d63de4e1
commit 6194c4733e
6 changed files with 530 additions and 249 deletions
@@ -15,7 +15,7 @@
| 禁用态 | `el-button disabled` | 灰底 `#cbd5e1` + 灰字 `#64748b` | 不可点击状态 |
| 快捷按钮(AI 侧栏) | `el-button size="small"` | 默认样式 | 3 个快捷入口 |
**关键规则(CODING_RULES 第 6 条):**
**关键规则(TOP_CODING_RULES.md 的 G07):**
- 所有可点击的关键交互按钮必须使用蓝色底 `#1677ff`
- `disabled` 状态变化后,底色必须立即同步变化
- 不可用按钮保持 `cursor: not-allowed`
@@ -25,7 +25,7 @@
| 博昇内部培训平台 | 数字员工平台 / EAI Agent 平台 |
| 培训平台定位(知识库+考试+素材审批) | AI 数字员工平台定位 |
- 涉及范围:`CLAUDE.md`、`CODING_RULES.md`、全部 `views/**` 与共享组件中的标题/文案、`docs` 相关文档。
- 涉及范围:`CLAUDE.md`、`TOP_CODING_RULES.md`、全部 `views/**` 与共享组件中的标题/文案、`docs` 相关文档。
- `CHAT_UI_PREVIEW.html` 中的旧标题一并替换。
---