XGameHarness 后台

项目

填了仓库地址的项目，客户端能自己拉到本机 —— 那个人不用知道地址、也不用管目录叫什么名字。没填也行，那他只能自己拉好了再打开。

id	显示名	仓库

加一个项目

id

显示名

说明

仓库地址（可以不填）

分支

服务器写和下发对着的仓（留空 = 跟上面同一个）

只认 https://… 和 git@主机:路径。拉取用的是每个人自己机器上的 git 凭据 —— 服务器不存任何仓库密钥，也就不用担心密钥跟着客户端跑到别人机器上。

harness 从哪儿拉

客户端装 harness 时用这个地址。不填的话客户端不会去猜 —— 它会直说服务器没给，因为猜错了拉下来的是别人的仓库，而那件事看起来完全正常。

仓库地址

分支

新机器装第一次

已经装了的机器不用来这儿下 —— 客户端自己会更新，而且只下差分（一两兆）。这个整包是给还没装过的机器的。

这个下载地址不需要登录 —— 客户端要能自动取更新，那条路就不能挡。知道地址的人都下得到。能不能用是另一回事：装完第一屏要填服务器、用名册上的账号登录，没在名册上的人开不了任何项目。

发版包

版本	大小	发布时间	文件

删旧包省磁盘，代价是还停在那一版的人下次更新会重下整包（一百五十多兆，不是几兆）。而这台服务器不知道谁停在哪一版 —— 客户端不回传这个。所以下面每一行都能删，但没有哪一行是「肯定没人用」。

出包

这次打成哪个版本号

这一下会：把服务器上那份仓库拉到最新、按这个版本号打一个包、 发布出去。发布之后，装着客户端的人下次开机就会看到这个新版本。三到四分钟，中途可以停。

构建输出

模型代理

账号

客户端看不到这些凭据，也选不了用哪个 —— 它们只在这台服务器上。

id	显示名	引擎	状态

放一个账号进来

为服务器单独登录，不要复制本机正在使用的凭据。 同一份订阅登录凭据在两处续期可能互相失效。请用下面的独立目录登录，导入后交给服务器使用。

1 · 选择引擎

2 · 在自己的 Windows 电脑上登录

开始菜单搜索并打开 Windows PowerShell，粘贴下面的命令并回车。需要本机已安装 Claude Code；在弹出的浏览器里登录服务器专用账号。

查看登录命令

$env:CLAUDE_CONFIG_DIR = Join-Path $env:USERPROFILE 'xgh-claude-server'
claude auth login
explorer.exe $env:CLAUDE_CONFIG_DIR

登录完成后会打开凭据目录。下一步选择其中的 .credentials.json。

2 · 登录服务器要使用的 ChatGPT 账号

先将本机 XGS 更新到 1.1.12 或以上。右键桌面 XGS 快捷方式 →「打开文件所在的位置」，记住安装目录。
开始菜单搜索并打开 Windows PowerShell，点击下面的复制按钮，将整段命令粘贴进去并回车。命令在你的电脑运行，不是在服务器 SSH 中运行。
弹出文件选择框后，在刚才的安装目录选择 XGameHarness Studio.exe。它会使用 XGS 内置的 Codex，无需另外安装 Node.js 或 CLI。
浏览器打开登录页，登录供服务器使用的 ChatGPT 账号并完成授权。若浏览器没自动打开，复制终端中显示的登录地址到浏览器。
终端出现「登录成功」后会打开一个新目录。回到本页面，在下一步导入其中的 auth.json。

查看登录命令

& {
  Add-Type -AssemblyName System.Windows.Forms
  $xgsPicker = New-Object System.Windows.Forms.OpenFileDialog
  $xgsPicker.Title = '选择已安装的 XGameHarness Studio.exe（不是安装包）'
  $xgsPicker.Filter = 'XGameHarness Studio|XGameHarness Studio.exe'
  $xgsPicker.InitialDirectory = Join-Path $env:LOCALAPPDATA 'Programs'
  if ($xgsPicker.ShowDialog() -ne 'OK') { return }
  $xgsRoot = Split-Path $xgsPicker.FileName
  $xgsCli = Join-Path $xgsRoot 'resources\sidecar\node_modules\@openai\codex-win32-x64\vendor\x86_64-pc-windows-msvc\bin\codex.exe'
  if (!(Test-Path -LiteralPath $xgsCli)) { throw '请先将 XGS 更新到 1.1.12 或以上，再选择安装目录里的程序。' }
  $xgsPreviousHome = $env:CODEX_HOME
  try {
    $env:CODEX_HOME = Join-Path $env:USERPROFILE ('xgh-codex-server-' + [guid]::NewGuid().ToString('N'))
    New-Item -ItemType Directory -Path $env:CODEX_HOME | Out-Null
    [IO.File]::WriteAllText((Join-Path $env:CODEX_HOME 'config.toml'), 'cli_auth_credentials_store = "file"', (New-Object Text.UTF8Encoding($false)))
    & $xgsCli login
    if ($LASTEXITCODE -ne 0) { throw '登录未完成，请查看上方错误后重试。' }
    $xgsAuth = Join-Path $env:CODEX_HOME 'auth.json'
    if (!(Test-Path -LiteralPath $xgsAuth)) { throw '没有生成 auth.json，请检查账号是否允许文件凭据存储。' }
    Write-Host '登录成功。回到管理后台，导入打开目录中的 auth.json。'
    Write-Host $env:CODEX_HOME
    Start-Process explorer.exe -ArgumentList $env:CODEX_HOME
  } finally { $env:CODEX_HOME = $xgsPreviousHome }
}

每次创建独立目录，登录结束后恢复原来的 CODEX_HOME。导入后由服务器续期，请勿再用这份凭据运行本机 Codex。文件含登录令牌，只在本管理后台导入。

没有生成 auth.json / 登录失败怎么办？

先确认选择的是已安装的 XGS 程序，不是 Setup 安装包。登录时不要关闭 PowerShell；遇到网络错误先确认电脑能打开 ChatGPT，再重新运行命令。若公司账号禁止文件凭据存储，请联系管理员。不要从平时使用的 .codex 目录拿凭据顶替。

OpenAI 官方登录说明

3 · 导入登录文件

选择 .credentials.json

文件只在点击「添加账号」后上传。

也可以粘贴文件完整内容

凭据 JSON

4 · 给账号起个名字

账号 ID（字母、数字、短横线）

显示名

添加后确认上方账号池开关已开启，再在客户端切换到对应引擎、选择服务器账号。保存成功只代表凭据已入库；发送一条消息成功才代表中转可用。

谁烧了多少

这是账，不是闸 —— 记下来而已，谁都不会因为这张表被拦。按人限额还没做。

看多久

谁	请求	没成	上行 / 下行	token（输入 · 输出 · 缓存读）	最近一次

导出 / 导入

导出的这份带密码哈希，跟 users.json 一样敏感 —— 它足以让人拿去离线爆破。别丢进聊天工具，别提交进版本库。

自动备份

每次改名册之前自动存一份，留最近 10 份。要恢复的话在服务器上把它拷回 users.json —— 后台不做一键恢复：那一下会覆盖所有人的密码，值得多走一步。

文件	大小	时间