5b877451eb
旧模板的 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
1.5 KiB
1.5 KiB
.agents/
本目录为 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 # 唯一常驻规则(AGENTS.md 内联注入)
└── skills/ # 按需加载
├── 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 # 提交规范(与框架无关)
工具适配
| 工具 | 适配方式 |
|---|---|
| Cursor | AGENTS.md(内联 behavior 规则 + 技能索引)+ .agents/skills/(按需) |
| OpenCode | AGENTS.md + .agents/rules/ + .agents/skills/ |
| Codex | AGENTS.md + .agents/skills/ |