LEGACY TAKEOVER · PROJECT MAP

接手一个九万行的老项目,
先把地图画出来。

GameBox 客户端是策划、美术、运营每天在用的配置与发布工具。 前任已经走了。这里是它的架构图、文件地图、功能全集、依赖关系, 以及一条能走完的学习路线。

9.8万
行 TS / Vue
58
条路由
121
个 npm 依赖

START HERE

第一天只需要读这一份。

📘
已开放约 25 分钟

接手文档:
跑起来、调试、改需求、发版、已知坑

十节内容,从 npm i 为什么会失败讲到必须问人的清单。 第一周的所有问题都能在这里找到起点。

打开接手文档

THE PROJECT MAP

项目地图

四份从源码逐条核出来的资料。每条实现描述都带 file:line,你能跳过去核对。

THE TAKEOVER ROUTE

课程路线

不是把 Vue、Electron 背一遍。每一节只解决一个接手时真的会遇到的问题, 按能够独立维护的顺序推进。01–04 已出正文。

KEEP THESE CLOSE

卡住时,不用从头翻代码。

三张速查卡放在每节课旁边。它们只记录项目的真实入口、规则和已经确认的排障动作。

先看分诊表

HOW THIS STAYS USEFUL

这份资料为什么可信。

01 · 唯一证据是源码每条实现描述都带 file:line,写的时候逐条核对过。没有行号的实现描述,按「在编」处理。

02 · 现状与规范分开说项目源码只说明「现在怎么做」;判断「应该怎么做」才引用官方文档,并标 ✅照做 / ⚠️隔离 / ❌别学。

03 · 每节都有真机动作学完必须能在运行中的应用里验证,不做只有概念的阅读。

04 · 基线是会漂的全部内容基于 2026-08-12 的 gameboxclient 工作区快照。有人提交代码后行号会变,文件名和函数名仍然有效。