# Issue#2 验收单:管理前端多标签导航 + 页签缓存(2026-11-16) > 工单:Gitea `Tory/go-sms-V2` Issue #2「优化:管理前端V1」(2026-11-16 11:07)。 > 需求原文:*增加菜单Tab页(可独立关闭,一次全部关闭),现状是每个菜单独立打开,且切换后没有缓存,对运营非常不友好。* ## 一、交付范围 | 组件 | 文件 | 说明 | |---|---|---| | 标签状态 | `web/src/stores/tabs.ts` | pinia:visited[](tab 身份=fullPath);addTab 去重/错误页与 redirect 过滤;close(右邻优先回退)/closeOthers/closeAll;cachedNames(include 锚,同名去重);home 固定不可关 | | 标签条 | `web/src/components/TagsBar.vue` | 纯原生元素(G2 断言语义:EP 导航壳不进布局壳);✕ 独立关闭+中键关闭(auxclick button===1;@click.middle 对中键永不触发)+关闭其他+全部关闭;aurora token 风格(primary-soft 激活/圆角 10px) | | 布局挂载 | `web/src/layouts/MainLayout.vue` | ``+``+``;watch fullPath→addTab(immediate);登出 `$reset()` 清标签防跨角色残留 | | 缓存命名 | 29 个业务视图 SFC | 各加 `defineOptions({ name: <路由名> })`(28 新增+stats/profit 原名 StatsProfitView 对齐 'stats-profit');**ComingSoon(11 路由共用)刻意豁免**:无本地状态可保,不缓存零副作用 | | 守门测试 | `web/tests/view-cache-name.spec.ts` | 遍历路由断言「组件名=路由名」——新增页面漏写 defineOptions 会**缓存静默失效**(页面照常、仅切 tab 丢状态),此类回归必须在测试红而非线上发现 | | 配套测试 | `web/tests/tabs-store.spec.ts`(7)+`web/tests/tags-bar.spec.ts`(6) | 状态机全链(去重/关闭导航语义/固定标签/缓存名去重)+组件渲染与交互 | | 断言扩展 | `web/scripts/verify-layout.mjs` | +5 项:tags-bar 唯一/登录即 home chip/固定无 ✕/点菜单 chip+1/独立关闭回退;凭据 env 化(SHOT_USER/SHOT_PASS,缺省 s2demo——内置 admin 原密码首启打印一次已不可知) | ## 二、验证证据(2026-11-16) | 门禁 | 结果 | |---|---| | eslint(max-warnings 0) | ✅ 0 | | vue-tsc --noEmit | ✅ 0 | | vitest | ✅ **165/165**(148→+17:tabs-store 7+view-cache-name 4+tags-bar 6) | | vite build | ✅ 9.99s(chunk 剖面不变,gzip 逐块<500KB 基线保持) | | verify-layout(实渲染) | ✅ **23/23**(原 18+新 5) | | Chrome 157 实机走查(:5173,s2demo,单 page 铁律) | ✅ **17/17**,两项**核心 keep-alive 状态保留实证**:①结算页内 Tab 切第 2 个→切走通道配置→切回**仍选中**;②筛选 账号ID=2→切走→切回**保留**;独立关后台不跳转/关当前回退相邻/全部关闭仅剩 home 回 /home;截图 /tmp/issue2-{settle-state,state-preserved,close-all}.png | ## 三、设计口径(评审可追溯) 1. **tab 身份=route.fullPath**:参数页(account/:id、channel/edit/:id?)每实例一 tab(标题带 `#id` 后缀);query 变体亦独立成 tab,与 keep-alive key 同口径。 2. **缓存身份=组件名=路由名**:keep-alive include 按组件名匹配,而 script setup 文件名推断名(15 个 index.vue 全叫 "index";PascalCase≠kebab 路由名)永不命中——守门测试固化此约定。 3. **同名多实例**(account/1 与 account/2):关闭其一缓存条目随名保留,最后一个同名 tab 关闭才真正释放(keep-alive 按名驱逐,有限驻留可接受)。 4. **刷新不持久化**:工单未要求;刷新后仅重开当前页 tab(watch immediate 兜底),增强项留待运营反馈。 ## 四、已知边界与挂账 - ComingSoon 占位页每次进入重挂载(无状态可丢,刻意不缓存)。 - 标签不随刷新恢复(挂账增强项,非工单范围)。 - 工单评论回贴:Gitea API 读已验免 token(http://192.168.5.27:24400),写需 token——待用户提供或自行回贴。