提示条撤掉只对超管成立的那几句:谁能进这一页谁就看得到

后台「当前页面操作提示」按 menuKey 取、不分支角色,而文案里塞了三族只描述
超管观感的句子(公司 tab 切换后行数会变/本页全平台共享不按公司区分/店铺归
哪家由负责人决定),普通账号进同一页就被摊到脸上。19 页共撤 21 句,各页回到
旧版 admin-interactions.js 原文;tab 本身与它的接线、取数口径一律没动。

护栏跟着反向:align-operation-guide 原先逐页要求"必须带上这句",现在钉"不得
回流"。禁句用 git show HEAD: 从提交里那一版取回、不手抄,另设一把纯 ASCII 的
tab 尺子——中文串被工具链插一个字就永远匹配不上,而负向断言照样绿。

验:变异自证(把原句塞回视频任务记录页判红、按内存里的原始字节还原 sha256
等值、干净态复跑绿);node --test 全量 1819 例 0 失败;vue-tsc --noEmit rc=0;
出包产物正反对照(4 句撤掉的 0 命中、2 句保留的各 1 命中)。
This commit is contained in:
2026-10-14 09:21:32 +08:00
parent 975e053d2c
commit e119abba1f
4 changed files with 59 additions and 125 deletions
@@ -49,7 +49,7 @@ export const COMPANY_SCOPED_PAGES: readonly CompanyScopedPage[] = [
// 批次 5(控制方 2026-10-06 点名「店铺密钥管理的数据按照公司区分」)。biz_shop_key 原先零归属列,
// 拿到这一页菜单的任意管理员读的是同一池全平台紫鸟令牌,而列表 VO 把令牌原文整列下发(悬停即得全文)。
// V150 加 company_id;后端读门是 readCompanyIdOrOwn ⇒ 非超管连 company_id 都不带也一律锁本公司,
// 这一页的 tab 只对超管改变行数(与其余页同形,见 COMPANY_TAB_GUIDE_NOTE 开头那句「超级管理员」)。
// 这一页的 tab 只对超管改变行数(非超管恒锁本公司,与其余页同形)。
{ menuKey: 'admin_shop_keys', apiFiles: ['src/pages/shop/shop-key-api.ts'], pageFiles: ['src/pages/shop/ShopKeysPage.vue'] },
// 批次 6(控制方 2026-10-06 点名「菜单权限也加字段来区分」,并选了「每家公司一套菜单树」那一档)。
// V149 给 columns 加 company_id 并把 52 行复制成每家一套 ⇒ 同一 column_key 在别家有另一份 id:
@@ -1,7 +1,7 @@
<script setup lang="ts">
/** 页面上方的公司 tab(spec §4、§9.3):只有超管看得到,而且只画在**注册表里真的按公司取数的那些页**上——
* 选中哪家由哪一枚 tab 带 is-active 表达,这里不再挂第二处"这家是谁"的文案(§12 第 5 条把页头提示条算未批的界面暴露),
* 观感说明走 operation-guides 的引导文案。 */
* 提示条只讲这一页怎么办,不讲 tab(2026-10-14 公司观感那句已从引导文案撤掉,见 operation-guides 文件头)。 */
import { computed, watch } from 'vue'
import { useRoute } from 'vue-router'
import { COMPANY_STATUS_ACTIVE } from '@/api/companies-dto'
@@ -1,8 +1,10 @@
/**
* 每菜单页的操作提示(guides)文案,对齐旧版 backend/static/admin-interactions.js 的 guides 表原文
* (duplicate-check 为例外页不展示)。key = 路由 meta.menuKey。
* 2026-10-05 公司 tab 起有**两处故意偏离**「原文」:group-manage 由通用 fallback 改为自带文案,
* 参与 tab 的 8 页与不参与 tab 的 C 类 2 页在原文之后各追加一句——见下方三个 *_NOTE 常量。
* 2026-10-14 控制方定案:提示条按 menuKey 取、不分支角色,谁能进这一页谁就看得到,
* 于是"超级管理员可用上方公司 tab 切换公司""本页全平台共享,不按公司区分"这类只描述超管观感的句子
* 会摊到普通账号脸上 —— 整批撤掉,文案回到旧版原文。tab 本身与它的接线没动。
* 反向守门:tests/align-operation-guide.test.ts 钉这几句不得回流。
*/
export interface OperationGuideData {
text: string
@@ -17,48 +19,21 @@ export const OPERATION_GUIDE_FALLBACK: OperationGuideData = {
/** 折叠状态 localStorage key(沿用旧版 shufuAdminGuideCollapsed 语义)。 */
export const OPERATION_GUIDE_STORAGE_KEY = 'shufuAdminGuideCollapsed'
/** §9.3 的承载:公司 tab 改的是「行数观感」,只写进既有引导文案,不做页头控件/提示条
* (§12 第 5 条把那种提示条算未批的界面暴露;当前哪一家由 is-active 的 tab 表达,一处事实不留两处)。
* 这句必须以「超级管理员」开头、不能写成祈使式的「由上方 tab 决定」:引导文案按 menuKey 取、
* 不分支角色,而非超管根本看不到 tab 条(company-tab store 的 visibleForOperator 里有 isSuperAdmin)。
* 这一句由参与 tab 的 14 页共用、不各抄一遍——文案差一个字,护栏就只盯得住其中一页。
* 由 tests/align-operation-guide.test.ts 的 guide_copy_carries_company_tab_note_for_every_scoped_page
* 按 COMPANY_SCOPED_PAGES 逐页盯着(分母取注册表,加一页忘了补文案会当场红)。 */
const COMPANY_TAB_GUIDE_NOTE = ' 超级管理员可用页面上方的公司 tab 切换公司,切换后行数会变化——行数变少不是数据丢了。'
/** §5 的承载:注册表里显式 companyScoped:false 的 C 类页要的是**另一句**——"这页不参与",
* 不是"会随 tab 变"。同一支护栏反向钉它(不得带 COMPANY_TAB_GUIDE_NOTE)。 */
const COMPANY_SCOPE_NOT_APPLIED_NOTE = ' 本页全平台共享,不按公司区分:超级管理员切换上方公司 tab 时它不会变,这不是筛选坏了。'
/** §6.3 归属口径:店铺落哪家由「负责人」决定,与 tab 无关——这条与直觉相反,不写在界面上就会被报成 bug。 */
const SHOP_OWNER_COMPANY_NOTE = ' 店铺归哪家公司由「负责人」决定,不由公司 tab 决定:负责人选自己,店铺就落在你自己那家。'
export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
admin_users: {
// 2026-10-05 批次 4:与 group-manage 同型偏离——参与公司 tab 的页必须在原文之后带上那句 §9.3,
// 所以这一条不再与旧版 guides 逐字相等(护栏改为 match 原句子串,见 align_guide_users_matches_reference_text)。
text: '先用筛选定位账号,再编辑角色和菜单权限;删除账号会要求二次确认。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '先用筛选定位账号,再编辑角色和菜单权限;删除账号会要求二次确认。',
steps: ['筛选账号', '编辑权限', '确认保存'],
},
admin_columns: {
// 2026-10-06 批次 6:V149 起每家公司一套菜单树 ⇒ 这页参与公司 tab,必须带上 §9.3 那句
// (align-operation-guide 按注册表数分母,缺了它当场红)。
text: '菜单会影响后台和软件端的可见范围。先填写名称并选择对应页面,再设置上级菜单;顺序直接拖动列表左侧手柄调整。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '菜单会影响后台和软件端的可见范围。先填写名称并选择对应页面,再设置上级菜单;顺序直接拖动列表左侧手柄调整。',
steps: ['新增或调整菜单', '设置层级', '拖动排序'],
},
admin_group_manage: {
// 2026-10-05 公司 tab(spec §9.3):这页改为**自带文案**,故意偏离文件头「沿用旧版原文」的约定——
// tab 那句不能塞进 OPERATION_GUIDE_FALLBACK(fallback 会被没进 tab 的页共用,等于把 tab 端给它们)。
// 也不写「跨公司的分组彼此看不见」:那是 Task 11 Step 3 明确没做的半边(附B 记了这条部分强度)。
text: '数据权限分组决定"哪些账号能看到哪些店铺",分组按负责人和归属账号聚拢。超级管理员切换上方公司 tab 后,列表只保留当前公司账号相关的分组。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '数据权限分组决定"哪些账号能看到哪些店铺",分组按负责人和归属账号聚拢。',
steps: ['选择分组', '维护负责人与归属账号', '核对店铺可见范围'],
},
admin_user_secrets: {
text: '用户密钥按账号绑定,列表只展示脱敏值。可对单条立即检测连通性;清空后该用户需要重新配置密钥。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '用户密钥按账号绑定,列表只展示脱敏值。可对单条立即检测连通性;清空后该用户需要重新配置密钥。',
steps: ['筛选用户或状态', '立即检测连通性', '必要时清空'],
},
admin_companies: {
@@ -66,69 +41,52 @@ export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
steps: ['查看公司列表', '新建公司', '改名或启停'],
},
admin_dedupe_total_data: {
text: '支持按关键词、用户、分组和国家筛选;导入前先确认所选分组,导出会按日期范围生成文件。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '支持按关键词、用户、分组和国家筛选;导入前先确认所选分组,导出会按日期范围生成文件。',
steps: ['选择分组', '筛选或导入', '核对并导出'],
},
admin_invalid_asin_data: {
text: '维护不符合规则的 ASIN 或品牌。添加后可使用上方筛选快速回查。'
+ COMPANY_SCOPE_NOT_APPLIED_NOTE,
text: '维护不符合规则的 ASIN 或品牌。添加后可使用上方筛选快速回查。',
steps: ['填写 ASIN/品牌', '选择分组', '保存并回查'],
},
admin_query_asin: {
text: '查询 ASIN 以店铺为单位维护。列表里点击 ASIN 即可复制,点右侧「配置」可一次维护该店铺所有站点的 ASIN。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '查询 ASIN 以店铺为单位维护。列表里点击 ASIN 即可复制,点右侧「配置」可一次维护该店铺所有站点的 ASIN。',
steps: ['筛选店铺', '打开配置抽屉', '保存或导出'],
},
admin_product_categories: {
text: '类目树支持展开查看层级。搜索、编辑和删除都在同一列表中完成。'
+ COMPANY_SCOPE_NOT_APPLIED_NOTE,
text: '类目树支持展开查看层级。搜索、编辑和删除都在同一列表中完成。',
steps: ['搜索类目', '展开层级', '新增或编辑'],
},
admin_skip_price_asin: {
text: '最低价 ASIN 以店铺为单位维护。列表里点击 ASIN 即可复制,点右侧「配置」可一次维护该店铺所有站点的 ASIN 与最低价。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '最低价 ASIN 以店铺为单位维护。列表里点击 ASIN 即可复制,点右侧「配置」可一次维护该店铺所有站点的 ASIN 与最低价。',
steps: ['筛选店铺', '打开配置抽屉', '保存或批量导入'],
},
admin_shop_keys: {
// 2026-10-06 批次 5:这页由「全平台共享」改按公司区分(V150 给 biz_shop_key 加 company_id),
// 所以摘掉 COMPANY_SCOPE_NOT_APPLIED_NOTE、换上共用那一句 §9.3。
text: '紫鸟令牌属于敏感配置。白名单状态可悬停查看检测详情,编辑前请先核对账号名称。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '紫鸟令牌属于敏感配置。白名单状态可悬停查看检测详情,编辑前请先核对账号名称。',
steps: ['新增或筛选密钥', '查看白名单状态', '编辑或删除'],
},
admin_shop_manage: {
text: '店铺信息按分组管理。长商城名会自动缩略,悬停即可查看完整内容。'
+ COMPANY_TAB_GUIDE_NOTE
+ SHOP_OWNER_COMPANY_NOTE,
text: '店铺信息按分组管理。长商城名会自动缩略,悬停即可查看完整内容。',
steps: ['选择分组', '维护店铺信息', '筛选核对结果'],
},
admin_shop_data_crawl_tasks: {
text: '店铺数据任务按状态和时间筛选。批量操作前请核对已选任务。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '店铺数据任务按状态和时间筛选。批量操作前请核对已选任务。',
steps: ['筛选任务', '检查状态', '执行批量操作'],
},
// admin_shop_data_duplicate_check(店铺撞款监控)为例外页:不展示全局提示条,不参与对齐。
// 它进了公司 tab 范围(COMPANY_SCOPED_PAGES)却没有文案可挂,所以那句 §9.3 的看守在这一页由
// tests/align-operation-guide.test.ts 显式豁免;这一页的「切 tab 行数会变」写在页面自身的说明里。
admin_image_video_tasks: {
text: '可先使用筛选缩小任务范围,再查看任务状态、结果和权限范围。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '可先使用筛选缩小任务范围,再查看任务状态、结果和权限范围。',
steps: ['设置筛选', '查看任务结果', '按需处理任务'],
},
admin_history: {
text: '生成记录可按用户和时间范围回溯,用于核对结果文件和执行时间。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '生成记录可按用户和时间范围回溯,用于核对结果文件和执行时间。',
steps: ['设置时间范围', '筛选记录', '查看结果预览'],
},
admin_version: {
text: '上传版本后请核对版本号和下载链接,再通知用户更新。'
+ COMPANY_SCOPE_NOT_APPLIED_NOTE,
text: '上传版本后请核对版本号和下载链接,再通知用户更新。',
steps: ['上传压缩包', '检查版本记录', '维护历史版本'],
},
admin_tutorial: {
text: '上传新的教程压缩包后即刻生效:工具台首页「立即下载教程」以下载最新上传的包为准。确认旧包不再需要后再删除。'
+ COMPANY_SCOPE_NOT_APPLIED_NOTE,
text: '上传新的教程压缩包后即刻生效:工具台首页「立即下载教程」以下载最新上传的包为准。确认旧包不再需要后再删除。',
steps: ['上传教程压缩包', '到工具台核对下载', '清理历史包'],
},
digital_human_version: {
@@ -136,18 +94,15 @@ export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
steps: ['上传草稿', '确认更新日志', '发布或设为最新'],
},
admin_device_logs: {
text: '桌面客户端与麦象采集机上报的日志按来源、日期和关键字筛选;可查看日志尾部、下载完整文件或删除云端记录,云端日志按保留期自动清理。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '桌面客户端与麦象采集机上报的日志按来源、日期和关键字筛选;可查看日志尾部、下载完整文件或删除云端记录,云端日志按保留期自动清理。',
steps: ['选择来源与日期', '查看或下载日志', '必要时删除'],
},
admin_user_secret_usage: {
text: '按日期范围统计各用户的密钥调用次数(货源查询与外观专利按 LLM 请求次数、代理按提取次数),用于评估用户资源损耗。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '按日期范围统计各用户的密钥调用次数(货源查询与外观专利按 LLM 请求次数、代理按提取次数),用于评估用户资源损耗。',
steps: ['选择日期范围', '筛选用户或分组', '核对各模块次数'],
},
admin_task_center: {
text: '按账号、业务、状态、店铺和创建时间筛出客户端任务,点任务查看明细与分组结果;顶部汇总卡给当前在跑与疑似卡住的总量。'
+ COMPANY_TAB_GUIDE_NOTE,
text: '按账号、业务、状态、店铺和创建时间筛出客户端任务,点任务查看明细与分组结果;顶部汇总卡给当前在跑与疑似卡住的总量。',
steps: ['按条件筛任务', '查看任务明细', '核对汇总卡'],
},
}
@@ -2,7 +2,6 @@ import test from 'node:test'
import assert from 'node:assert/strict'
import { readSource } from './helpers.ts'
import { adminPages } from '../src/router/routes.ts'
import { COMPANY_SCOPED_PAGES } from '../src/config/company-scope.ts'
import {
OPERATION_GUIDES,
OPERATION_GUIDE_FALLBACK,
@@ -17,9 +16,7 @@ const EXCEPTED_KEY = 'admin_shop_data_duplicate_check'
test('align_guide_users_matches_reference_text', () => {
const g = operationGuideFor('admin_users')
assert.ok(g)
// 批次 4 起这页参与公司 tab ⇒ 原文之后追加那句 §9.3,不再逐字相等(同 group-manage 那处故意偏离)。
assert.match(g.text, /^先用筛选定位账号,再编辑角色和菜单权限;删除账号会要求二次确认。/)
assert.match(g.text, /超级管理员可用页面上方的公司 tab 切换公司/)
assert.deepEqual(g.steps, ['筛选账号', '编辑权限', '确认保存'])
})
@@ -29,13 +26,9 @@ test('align_guide_history_and_version_reference_text', () => {
})
test('align_guide_group_manage_own_text', () => {
// 2026-10-05 公司 tab(spec §9.3):这页从"沿用旧版通用 fallback"改成自带文案——
// 上一行"对齐旧版 guides 表原文"的约定在这一页是**故意破的**,因为那句 tab 说明
// 不能塞进 fallback(fallback 会被没进 tab 的页共用,等于把 tab 端给它们)。
const g = operationGuideFor('admin_group_manage')
assert.ok(g)
assert.notEqual(g, OPERATION_GUIDE_FALLBACK)
assert.match(g.text, /超级管理员可用页面上方的公司 tab 切换公司/)
assert.deepEqual(g.steps, ['选择分组', '维护负责人与归属账号', '核对店铺可见范围'])
})
@@ -84,57 +77,43 @@ test('align_guide_fallback_shape', () => {
assert.ok(OPERATION_GUIDE_FALLBACK.text.length > 10)
})
test('guide_copy_carries_company_tab_note_for_every_scoped_page', () => {
// spec §9.3:tab 会改行数观感,承载方式是既有引导文案(不新做控件)。
// 分母=COMPANY_SCOPED_PAGES,杜绝"加了一页忘了补文案"。
// 唯一豁免 = EXCEPTED_KEY(撞款监控不展示提示条,那句没有可挂的地方);豁免是**显式列出的**,
// 新页缺文案仍会红(operationGuideFor 对没登记的 key 返回 null ⇒ assert.ok(g) 当场红,没有兜底可糊)。
const scopedKeys = COMPANY_SCOPED_PAGES.map((p) => p.menuKey)
const need = scopedKeys.filter((k) => k !== EXCEPTED_KEY)
assert.ok(need.length >= 15, `取样集非空自检:注册表今天有 ${scopedKeys.length} 页进了 tab 范围(批次 1 的 8 页 + 批次 2 剩下的 3 页 + 批次 3 的 2 页 + 批次 4 的 1 页 + 批次 5 的 1 页 + 批次 6 的 1 页),减去唯一豁免页后只剩 ${need.length} 页`)
assert.ok(scopedKeys.includes(EXCEPTED_KEY),
'取样集前提自检:撞款监控已不在 COMPANY_SCOPED_PAGES 里,上面那道豁免就成了空豁免——把它连同 EXCEPTED_KEY 一起删掉')
for (const key of need) {
const g = operationGuideFor(key)
assert.ok(g, `注册表页缺 guide: ${key}`)
assert.match(g.text, /超级管理员可用页面上方的公司 tab 切换公司/, `${key} 缺 §9.3 那句`)
/**
* 2026-10-14 控制方把公司 tab 那几句观感说明撤了:提示条按 menuKey 取、不分支角色,
* 谁能进这一页谁就看得到。「超级管理员可用上方 tab 切换」「本页全平台共享」这类只对超管成立的话
* 会摊到普通账号脸上,所以整批撤掉。这支用例是反向钉:**不允许回流**。
*
* 两把尺子:① ASCII 的 `tab`,②那四句原文(从已提交的那一版操作提示表里拿回来的,不是抄写)。
* ②单独不可信——中文串在工具链里被插进一个字就会永远匹配不上,而负向断言照样绿;
* 所以下面先钉死「这四句都含 ASCII 的 tab」,让①成为即使②坏了也还有牙的那一把。
*/
test('company_tab_copy_is_pulled_from_every_guide_and_must_not_come_back', () => {
const REMOVED = [
'\u8d85\u7ea7\u7ba1\u7406\u5458\u53ef\u7528\u9875\u9762\u4e0a\u65b9\u7684\u516c\u53f8 tab \u5207\u6362\u516c\u53f8\uff0c\u5207\u6362\u540e\u884c\u6570\u4f1a\u53d8\u5316\u2014\u2014\u884c\u6570\u53d8\u5c11\u4e0d\u662f\u6570\u636e\u4e22\u4e86\u3002',
'\u672c\u9875\u5168\u5e73\u53f0\u5171\u4eab\uff0c\u4e0d\u6309\u516c\u53f8\u533a\u5206\uff1a\u8d85\u7ea7\u7ba1\u7406\u5458\u5207\u6362\u4e0a\u65b9\u516c\u53f8 tab \u65f6\u5b83\u4e0d\u4f1a\u53d8\uff0c\u8fd9\u4e0d\u662f\u7b5b\u9009\u574f\u4e86\u3002',
'\u5e97\u94fa\u5f52\u54ea\u5bb6\u516c\u53f8\u7531\u300c\u8d1f\u8d23\u4eba\u300d\u51b3\u5b9a\uff0c\u4e0d\u7531\u516c\u53f8 tab \u51b3\u5b9a\uff1a\u8d1f\u8d23\u4eba\u9009\u81ea\u5df1\uff0c\u5e97\u94fa\u5c31\u843d\u5728\u4f60\u81ea\u5df1\u90a3\u5bb6\u3002',
'\u8d85\u7ea7\u7ba1\u7406\u5458\u5207\u6362\u4e0a\u65b9\u516c\u53f8 tab \u540e\uff0c\u5217\u8868\u53ea\u4fdd\u7559\u5f53\u524d\u516c\u53f8\u8d26\u53f7\u76f8\u5173\u7684\u5206\u7ec4\u3002',
]
const keys = Object.keys(OPERATION_GUIDES)
assert.ok(keys.length >= 20, `分母只有 ${keys.length} 页,不像整张注册表`)
// 禁句自检:四条互不相同、都够长、且都含 ASCII 锚 tab —— 少一条下面那把 ASCII 尺子就盖不住。
assert.equal(new Set(REMOVED).size, 4, '禁句清单塌了')
for (const s of REMOVED) {
assert.ok(s.length > 20, `禁句短得可疑:${s}`)
assert.ok(s.includes('tab'), `禁句不含 ASCII 锚 tab,反向断言会失明:${s}`)
}
// C 类页(spec §5):它们要的是**另一句**——"这页不参与",不是"会随 tab 变"。
// 分母**取注册表里显式写 companyScoped:false 的页**,不抄名单:漏写一条 ⇒ 这支在自检那句红。
// 批次 2 之前这里是 2 页(店铺密钥 + 商品类目),商品类目一度接上了公司口径;
// 2026-10-06 控制方定案「品牌数据库 / 商品类目 / 教程管理 / 软件版本管理都做成共享的,不区分」,
// 于是这一族一度变成 5 页(店铺密钥 + 品牌库 + 商品类目 + 软件版本 + 教程);
// 同日批次 5 又把店铺密钥改回按公司区分(V150 给 biz_shop_key 加 company_id),今天剩 4 页。
// 后四页是**新登记**的:教程管理与软件版本管理的后端本来就没有公司引用,此前既不在清单也没写 false
// =「不参与但没人说」,现在显式写出来,这句文案与下面那条 deepEqual 才盖得到它们。
const scoped = new Set(COMPANY_SCOPED_PAGES.map((p) => p.menuKey))
const cClass = adminPages.filter((p) => p.companyScoped === false).map((p) => p.menuKey)
assert.ok(cClass.length >= 4, `取样集非空自检:注册表里显式 companyScoped:false 只剩 ${cClass.length} 页——那这句判据就是空跑`)
for (const key of cClass) {
assert.equal(scoped.has(key), false, `${key} 既声明 false 又在清单里,两处口径打架`)
const g = operationGuideFor(key)
assert.ok(g, `不参与 tab 的页缺 guide: ${key}`)
assert.match(g.text, /全平台共享,不按公司区分/, `${key} 缺 §5 那句`)
assert.equal(g.text.includes('公司 tab 切换公司'), false, `${key} 不该带 tab 那句(它不参与)`)
for (const key of keys) {
const text = operationGuideFor(key)!.text
assert.equal(text.includes('tab'), false, `${key} 的文案又出现了 tab`)
for (const s of REMOVED) {
assert.equal(text.includes(s), false, `${key} 又带回了撤掉的那句:${s}`)
}
}
// 「一页不多」的另一半(2026-10-05 修复轮 1):上面只钉了「8 页必须有」+「C 类两页不得有」,
// 没钉「其余页都不得有」。今天 21 个 key 里 admin_columns / admin_version / admin_tutorial 等 10 条 text
// 没有任何内容锚 ⇒ 把 tab 那句追加到其中任一页,全套用例仍然绿;而那句等于把 tab 端给一页不参与 tab 的页,
// 正是 Step 7.2 禁止把它塞进 fallback 的同一个理由。判别子串取**已存在的字面量**,不新造句子。
// 反向分母取 OPERATION_GUIDES 的全部 key(不是 adminPages):没带文案的页走 fallback,由下面那支单独钉。
const withTabNote = Object.keys(OPERATION_GUIDES).filter((k) => operationGuideFor(k)!.text.includes('公司 tab 切换公司'))
assert.deepEqual(withTabNote.sort(), [...need].sort(),
'tab 那句只能出现在 COMPANY_SCOPED_PAGES 那 ' + need.length + ' 页:多一页 = 把公司 tab 端给一页不参与 tab 的页')
const withNotAppliedNote = Object.keys(OPERATION_GUIDES).filter((k) => operationGuideFor(k)!.text.includes('全平台共享,不按公司区分'))
assert.deepEqual(withNotAppliedNote.sort(), [...cClass].sort(),
'「本页不参与」那句只能出现在注册表显式 companyScoped:false 的页:多一页 = 给了它没有的口径')
// fallback 会被所有没带独立文案的页共用,所以这两句都不许进它(Step 7.2 的理由,上面按 key 的分母盖不到)。
assert.equal(OPERATION_GUIDE_FALLBACK.text.includes('公司 tab 切换公司'), false,
'tab 那句不许进 OPERATION_GUIDE_FALLBACK:等于把 tab 端给所有没有独立文案的页')
assert.equal(OPERATION_GUIDE_FALLBACK.text.includes('全平台共享,不按公司区分'), false, '同上:「本页不参与」那句也不许进 fallback')
// 反向钉:这句话只能由文案承载。tab 组件里再长出"当前公司:X"就是第二处表达(§12 第 5 条未批)。
// fallback 会被所有没有独立文案的页共用,那四句同样不许进它。
assert.equal(OPERATION_GUIDE_FALLBACK.text.includes('tab'), false, 'tab 那句不许进 fallback')
// 撤的是文案,不是功能:tab 条还在,而且仍然只由 tab 自己表达"当前哪家"。
const tabs = readSource('src/layout/CompanyTabs.vue')
assert.ok(tabs.length > 0, '取样集非空自检:CompanyTabs.vue 读到了')
assert.equal(tabs.includes('company-tab-hint'), false, '不许有页头"当前公司"提示条')
assert.equal(tabs.includes('当前公司'), false, '同上:当前公司只由 is-active 的 tab 表达')
assert.equal(tabs.includes('当前公司'), false, '当前公司只由 is-active 的 tab 表达')
assert.ok(tabs.includes('useCompanyTabStore'), '公司 tab 本身没被一起撤掉')
})