refactor(pc): 从 Gi Admin Pro + Arco 重搭为纯 Vue 3 + Naive UI

旧模板的 193 个文件整体删除,换成纯 Vue 3.5 + Naive UI 2.42 的树。

- 去掉 auto-import(组件与 API 全显式 import)、v-hasPerm(改 user.has('码'),全库 8 处)、
  Stylelint;n-tag 的 type 统一过 utils/tag.ts 转换(Arco 色词直接透传会静默变灰)
- 图标改为构建期抽取:scripts/extract-pc-icons.py -> icons/icon-data.ts(37 个),
  内网离线部署不会白屏
- 重搭后修掉 6 类"编译 / lint / typecheck 全绿、界面上就是坏的"故障:
  ① NGrid 的 cols 写成像素值(不是断点名 -> 永远只 1 列,工作台因此错乱)
  ② n-tab-pane 用 tab 属性(只渲染空注释节点,整排 tab 一个字都不显示)
  ③ 漏 import 被当未知自定义元素(样式整块丢) ④ .n-card__content 类名不存在
  (高度链第一环失效,表格行在 DOM 里但屏幕上没有) ⑤ 填报单状态映射错位一格
  ⑥ 有标题的卡片没有上内边距(naive 的 padding-top 只给"内容区是长子"的卡片)
- 卡片式版面提成全局基线:styles/index.scss 的 xt-* 令牌 + .page-card / .toolbar /
  .section-title,页面只引用、不再各写一套
- 品牌:改名「深学在线」,文字标换成几何标(方 = 卷宗 / 环 = 在线,不用文字字形);
  index.html 的页签图标从 404 的 /favicon.ico 改指真实存在的 /favicon.svg
This commit is contained in:
2026-10-10 16:48:46 +08:00
parent 0bbac7d228
commit 5b877451eb
270 changed files with 12964 additions and 25889 deletions
+14 -11
View File
@@ -2,20 +2,25 @@
本目录为 AI 编码助手规范的**唯一来源**(Single Source of Truth),适用于 Cursor、OpenCode、Codex 等工具。
> ⚠️ **2026-10 已整体重写**:PC 端从 **Gi Admin Pro + Arco Design Vue** 换成 **纯 Vue 3 + Naive UI**。
> 上一版 skills 里的 Arco 组件名(`a-table` / `a-form` / `a-modal`)、`v-hasPerm`、auto-import、
> Stylelint、Gi 的 `useTable/usePagination` **全部不再适用** —— 照着写会编译不过或静默失效。
> 唯一保留原样的是 `git-commit`(与框架无关)。
## 结构
```
.agents/
├── rules/
│ └── agent.md # 唯一常驻规则(Cursor 经 AGENTS.md 内联注入)
│ └── agent.md # 唯一常驻规则(AGENTS.md 内联注入)
└── skills/ # 按需加载
├── code-ts/SKILL.md
├── code-vue/SKILL.md
├── code-css/SKILL.md
├── project-guide/SKILL.md
├── project-crud/SKILL.md
├── project-api/SKILL.md
└── git-commit/SKILL.md
├── code-ts/SKILL.md # TS 命名 / 导入 / 显式 import
├── code-vue/SKILL.md # SFC 写法与模板约定
├── code-css/SKILL.md # SCSS 与样式边界
├── project-guide/SKILL.md # 技术栈 / 目录 / 七条最容易写错的约定
├── project-crud/SKILL.md # 列表 + 表单的标准写法
├── project-api/SKILL.md # 接口调用(没有 Mock)
└── git-commit/SKILL.md # 提交规范(与框架无关)
```
## 工具适配
@@ -23,7 +28,5 @@
| 工具 | 适配方式 |
|------|----------|
| Cursor | `AGENTS.md`(内联 behavior 规则 + 技能索引)+ `.agents/skills/`(按需) |
| OpenCode | `AGENTS.md` + `opencode.json` + `.agents/rules/` + `.agents/skills/` |
| OpenCode | `AGENTS.md` + `.agents/rules/` + `.agents/skills/` |
| Codex | `AGENTS.md` + `.agents/skills/` |
修改 `agent.md` 后请同步 `AGENTS.md` 的「常驻规则」一节;编码规范改对应 skill,不要重复写入 `AGENTS.md`。