Runbooks

「发版」其实是三件不同的事

三条链路，动的东西完全不同，风险也完全不同。 把它们当成一件事，是这个岗位最容易出的事故。

三条链路一览

Runbook A · 资源发布

A-1 · 先搞清楚它动的是哪个目录

这是最容易搞错的一点。workspace() （src/api/workspace/index.ts:96-102）返回的是：

getHiddenResourcePath() + '/' + gameEnv.VITE_API_CHANNEL_SVN

而 getHiddenResourcePath()（:75-86）最后一行是：

path.join(path.parse(baseurl).root, '.hidden_resource')

path.parse(x).root 取的是盘符根目录 —— Windows 上是 C:\，macOS 上是 /。 所以工作副本在 C:\.hidden_resource\<渠道>， 不在应用安装目录下，也不在你的代码仓库里。

A-2 · ⚠️ 自动的 add / delete 发生在你确认之前

点发布卡片后，complieproject_svn() （src/utils/extend/svn.ts:161-176）做的第一件事是：

if (flag) {
  await svnAddUnversionedFiles(localUrl, option)   // 把未纳入版本的文件 svn add
  await svnRemoveMissingFiles(localUrl, option)    // 把本地已删的文件 svn delete
}
const target = await svnStatus(localUrl)           // 然后才列状态给你看

也就是说，等弹窗出现、你看到那份文件列表时， 「加入版本控制」和「标记删除」这两件事已经做完了。 弹窗只决定要不要 commit。

A-3 · ⚠️ 一次最多只提交 100 个文件，多的静默丢弃

svnCommit()（svn.ts:268-284）：

const commitList = localFiles.map(...)
SVN.commands.commit(commitList.splice(0, 100), mergeOption, function (error) {
  resolve(!error)      // ← 只要这 100 个没报错，就返回成功
})

Array.splice(0, 100) 返回前 100 个元素， 剩下的留在 commitList 里 —— 而 commitList 之后再没被用过。我实测验证过：

// 250 个文件的情况
传给 commit 的: 100 个
剩在 commitList 里没人管的: 150 个

A-4 · 全局闸门（但它比看上去弱）

只要 Jenkins 上有任何构建在跑，发布就走不下去 —— 包括纯本地的 SVN 提交。看到「当前有打包任务在进行中」是设计如此，不是 bug。 范围确实是「任何」：getActiveBuilds() 遍历 JOB_TYPES 里配置的全部 job （jenkins/monitor.ts:73、jenkins/config.ts:8）。

Runbook B · 客户端打包与自动更新

B-1 · build:pro 不是打包

在 macOS 上跑 build:electron:* 产出的是 macOS 包， 不是 Windows 安装包。要出 Windows 正式包必须在 Windows 环境。

B-2 · ⚠️ 打包的发布地址和客户端的更新地址对不上

// updater.ts:89-97
autoUpdater.on('update-available', (info) => {
  Logger.info('检查到有更新，开始下载新版本')
  autoUpdater.downloadUpdate()          // ← 无条件，没人问过用户
  sendUpdateMessage(message.updateAva)  // ← 这只是通知渲染层，下载已经开始了
})

Runbook C · 服务器更新 🔴

C-1 · 两个入口，别搞混

Dashboard 首页上有两张卡片都能通向「重启线上服务器」， 但走的是完全不同的组件。初版文档只写了一个，还写错了组件名。

入口一：「更新服务器」卡片 → 打包构建

入口二：「服务器管理」卡片 → 更新服务程序

C-2 · 四步流程

入口一最终跑的是 startFun()（src/views/GameEditor/Dashboard/method.ts:593） 顺序执行，每步失败就 throw 中断：

C-3 · 确认框是有的 —— 但它不告诉你要动哪些服

两个入口都有 ElMessageBox.confirm：

文案统一定义在 src/views/Database/const.ts:59-61 的 WarningInfo。 serverControl.vue:55-62 那个 ElTooltip 是悬停提示，确认框在后面的弹窗里 —— 初版文档看到 tooltip 就下了「没有确认框」的结论，是只看了一层。

// method.ts:564-584
for (const item of data) {
  if (index == 1) { await changeServerStatus(item.sId, 1) }   // 一键开服
  else if (index == 3) { excelBackByCopy(...) }               // 表回滚
  else { startFun(item) }        // ← 注意：没有 await
}

站点版本 dcc04aa · 2026-08-14 内容基线 gameboxclient @ 2026-08-12