Reference Card

路由 ↔ 组件对照表

看到地址栏里的 hash,一秒查到源文件。界面名取自 src/locales/zh-CN.ts

基线:2026-08-12 的 gameboxclient 工作区快照。 从 src/router/index.ts 剔除注释条目后逐条核出,共 58 条路由记录。 组件路径相对 src/views/(另有标注的除外)。

怎么用

hash 路由——地址栏长这样: …/index.html#/game/npc_edit?id=123# 后面那段就是路由路径,拿它来查这张表。

地址栏不变的功能是弹窗,不在这张表里, 去功能点清单第三节

全表

界面名 路由 组件 备注
登录 /login views/ReLogin/index.vue Login/index.vue 已被注释,实际用 ReLogin
密码修改 /password views/Login/Password.vue 初始密码 123456 时强制跳这里
首页面板 /game/dashboard GameEditor/Dashboard/index.vue 登录后落地页;1759 行;GM 与地图转换是它的弹窗
NPC /game/npc · /game/npc_edit Npc/index.vue · Npc/NpcEdit.vue 唯一有 view.ts 做字段分组的模块
物品 /game/item · /game/item_edit Item/index.vue · Item/Components/ItemEditor.vue schema 5647 行;路由上方标着 TODO: 暂时关闭
掉落 /game/drop · /game/drop_edit Drop/index.vue · Drop/DropEdit.vue 选项来自物品表
活动 /game/active · /game/active_edit Active/index.vue · Active/ActiveEdit.vue 含时间类控件
商城 /game/shop · /game/shop_edit Shop/index.vue · Shop/Components/ShopEditor.vue 与「npc商店」是两张表
任务 /game/task · /game/task_edit Task/index.vue · Task/Components/TaskEdit.vue module.ts 被多个模块反向依赖
分解 /game/divide · /game/divide_edit Divide/index.vue · components/PropEditor/Components/SpecialForm.vue 编辑页直接指向通用组件;标着 TODO: 暂时关闭
地图 /game/map · /game/map_edit · /game/map_addNpc_edit Map/index.vue · Map/mapEdit.vue · Map/mapAddNpc.vue 全项目唯一 keep: true;依赖 Konva 与 OpenLayers
npc商店 /game/npcStore · /game/npcStore_edit NpcStore/index.vue · NpcStore/edit.vue 表名 store_cfg,靠 tableConfigMap 映射
跳点 /game/gate · /game/gate_edit Gate/index.vue · Gate/edit.vue 无独立 schema;从 NpcStore 与 Skill 的 module.ts 借选项
鉴定类型 /game/identifyType · _edit IdentifyType/index.vue · IdentifyTypeEdit.vue
鉴定属性 /game/identifyProp · _edit IdentifyProp/index.vue · IdentifyPropEdit.vue
升段系统 /game/levelup · _edit Levelup/index.vue · LevelupEdit.vue
精炼、鉴定属性 /game/qualityProp · _edit QualityProp/index.vue · QualityPropEdit.vue 界面名含顿号,不是笔误
精炼属性 /game/reForging · _edit ReForging/index.vue · ReForgingEdit.vue
精炼消耗 /game/reForgingCost · _edit ReForgingCost/index.vue · ReForgingCostEdit.vue
技能 /game/skill · /game/skill_edit Skill/index.vue · Skill/edit.vue 列表页与编辑页共用同一个 i18n 标题键
盒子 /game/box Box/index.vue 无独立编辑路由,弹窗内完成
表编辑 /expert/excel GameEditor/Expert/index.vue 可弹成独立小窗;从 /expert/* 跳进来会先弹确认框
发布 /expert/release views/Option/index.vue /expert 的默认落点
错误日志 /expert/errorlog GameEditor/ErrorLog/index.vue 按版本切换 VITE_API_GM_PCODE
脚本管理 /expert/newscript GameEditor/NewScript/index.vue 独立的 VITE_API_SCRIPT_PCODE
全局数据 /expert/globalData GameEditor/GlobalData/index.vue 独立的 VITE_API_SECTCONFIG_PCODE
最近删除 /expert/delData GameEditor/DelData/index.vue 读 extend/delData/delData.json
查找文件 /expert/cosDownload GameEditor/cosDownload/index.vue 51 行,最短的页面
网关配置 /expert/gateWay views/GateWay/index.vue
(无标题) /expert/mainPage GameEditor/Dashboard/index.vue 与 /game/dashboard 同一组件;无 title 无 showMenu
动画编辑器 /animation/animate GameEditor/Animation/index.vue showMenu: false,菜单里到不了,但组件有 2585 行
(无标题) /base/baseHome · /base/stepEditView BasePage/HomeView · BasePage/StepEditView 无 showMenu,任何菜单都到不了
(无标题) /preload/preloadbase GameEditor/PreloadView/index.vue 登录页把跳它的代码注释了,改跳 Dashboard

三条要记住的规律

列表页 + _edit 编辑页成对出现。 /game/xxx 是列表,/game/xxx_edit 是编辑。 编辑页都带 hidden: true,菜单里看不到,但路由存在。

发布不在 /option 它挂在 /expert/release。旧文档里的 /option/workspace 在当前代码里都不存在了

菜单看不见 ≠ 进不去。 generateRoutes() 不做任何权限过滤 (src/store/modules/permission.ts:37-56), 手敲 hash 地址能进任何页面。

两个 meta 标记的分工

标记 谁消费 效果
meta.showMenu src/components/Menu/src/Menu.vue:47 控制菜单组件整体显不显示
meta.hidden src/components/Menu/src/helper.ts:25 这一条从菜单项列表里过滤掉
meta.keep 路由缓存 全项目只有 /game/map 是 true, 其余全是 false 或被注释
meta.introSteps src/router/intro.ts + 引导系统 新手引导的步骤定义,目前只有 Dashboard、Npc、NpcEdit 三处有