⚠️ 这篇已失效,仅作历史记录保留

本文写于 2026-08-10,依据的是 gameboxclient旧代码基线。 当前代码库已被整体替换:文中反复出现的 /workspace(游戏资源库)、 /option(游戏发布栈)、src/views/Workspace/src/views/UI/ 在新代码中均已不存在, 所有 file:line 引用都无法再定位。

请改读重建后的课程首页, 或直接看新的架构图接手文档

Reference · 定位第一站

路由定位速查

界面文字 → 路由 → 目录 → 接口环境。全部摘自源码,非转述。

为什么需要这张表

路由名和目录名不一一对应,按 path 猜目录会猜错五个。 下表带 ★ 的五行是必须查表的。
来源:src/router/index.tsasyncRouterMap)+ src/locales/zh-CN.tsrouter 段 + src/config/axios/service.ts:31-64

全表

界面文字 路由 组件 接口环境
游戏资源库 /workspace views/Workspace/index.vue 默认分支
游戏发布栈 /option views/Option/Option.vue ★不是 index.vue 默认分支
策划工作台 /excel views/Database/index.vue 默认分支
动画编辑器 /animation views/Editor/index.vue 默认分支
地图 /map views/Default/index.vue 默认分支
地图转换 /tmap views/MapTransform/index.vue 默认分支
资源商城 /store views/Shop/index.vue 默认分支
网关 /gateway views/GateWay/index.vue(大小写不同) VITE_API_GATEWAY_PCODE / _PATH
UI 编辑器 /ui views/UI/index.vue 默认分支
动画转换 /transform views/Transform/index.vue 默认分支
脚本管理 /script views/Script/index.vue VITE_API_SCRIPT_PCODE / VITE_API_PATH
新脚本管理 /newscript views/NewScript/index.vue VITE_API_SCRIPT_PCODE / VITE_API_PATH
游戏公告 /gameNotice views/GM/GameNotice/index.vue VITE_API_GAMENOTICE_PCODE / _PATH
登录公告 /loginNotice views/GM/LoginNotice/index.vue VITE_API_LOGINNOTICE_PCODE / VITE_API_PATH
门派设置 /sectConfig views/GM/SectConfig/index.vue VITE_API_SECTCONFIG_PCODE / _PATH
区服标签配置 /regionTagConfig views/GM/regionTagConfig/index.vue(小写开头) VITE_API_LOGINNOTICE_PCODE / VITE_API_PATH
全局数据 /globalData views/GM/GlobalData/index.vue 默认分支
查找文件 /cosDownload views/CosDownload/index.vue 默认分支
使用教程 /document views/Document/index.vue(文档小窗口专用,见 src/permission.ts:40-60docView() 默认分支
登录 /login views/Login/index.vue 默认分支

没有路由的界面

界面 在哪 注意
GM views/GM/Index.vue,在 src/App.vue:12 直接引入 弹窗形态,地址栏不变,但会把 currentRouter 改成 '/GM'
个人信息 views/Information/index.vuesrc/App.vue:15 同为弹窗
地图弹窗 views/MapTransform/Components/MapDialog.vuesrc/App.vue:18 同为弹窗

src/router/index.ts:143-158/creator/project 两条路由整段被注释掉了。src/locales/zh-CN.tsdashboardanalysisdevToolpassword 等 key 也没有对应路由——那是脚手架残留,别照着找页面。

定位流程

看到界面文字 │ rg "那句中文" src/locales/zh-CN.ts → 拿到 router.xxx 的 key │ 或直接 rg "那句中文" src → 硬编码文案直接命中页面 ▼ 查上表 → 组件路径 │ 页面里 rg "import .* from '@/api" → API 模块 ▼ src/api/** → src/config/axios/service.ts(url 含 1000y 才走动态切换) │ ▼ 副作用:src/utils/extend/{svn,jenkins,python,third}.ts 或 electron/main/channel/**(IPC)

权限点在哪

没有后端菜单下发。src/store/modules/permission.ts:36-44generateRoutes() 只是 cloneDeep(asyncRouterMap) 再补一条 404 ——零权限过滤。真正的权限点分散在:

所以「某个人看不到这个按钮」这类问题,不要去路由表里找,去页面里找 v-if