623e6393d5
遮罩底色被 Naive 写死在 css-render 里(Modal / Drawer 主题没有 mask token, themeOverrides 改不到),只能上 CSS;加 backdrop-filter 后遮罩后面的页面糊掉、 弹层本体仍是纯白,NModal / NDrawer / useDialog 共用 .n-modal-mask 一条规则覆盖。 折行的根因是格子宽度写死(半宽 264px / span 8 192px / 定宽 160px),与窗口宽度无关: 能压短的压短;「文件名预览」那处是 .n-form-item-blank 属于 flex 行、把提示挤成 3 行, 改成包一层块级容器;材料预览失败的占位在 108px 小格里曾折 3 行且被裁掉。 约定写进 frontend-pc/AGENTS.md 第 11 条与 code-css skill;实测与刻意不改的清单见 docs/交接摘要.md 的 §一·四十二。
.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/ |