Skip to content
BranchesTags

Repository files navigation

AgentLab Runner

runner/ 是可独立发布的执行端，用于接收 AgentLab Server 下发的作业并在本机执行。

目标

  • 可单独开源、单独发版（不依赖服务端源码）。
  • 支持 Linux（Ubuntu）和 Windows。
  • 支持快速一键配置 Codex / Claude Code（可二选一或都装）。

运维文档

  • Windows 宿主机 SSH 开启 + Linux 虚拟机连接排障：
    • runner/docs/windows-host-ssh-from-linux-vm.md

Release（Windows 一键启动 EXE）

已提供 GitHub Actions 流水线：.github/workflows/release-windows.yml

  • 触发方式：
    • 推送 tag：runner-v<version>（例如 runner-v0.2.0）会自动构建并发布 Release。
    • 手动触发：Actions -> Release Runner (Windows + Linux) -> Run workflow（只产出构建产物）。
  • 产物：
    • AgentLab-Runner-<version>-windows-x64.zip
    • AgentLab-Runner-<version>-linux-x64.tar.gz
    • 解压后直接双击 AgentLab Runner.exe 启动。

本地打包命令（Windows）：

powershell -ExecutionPolicy Bypass -File scripts/build-release-windows.ps1

Git 命令（可直接执行）

以下命令适用于“runner 作为 submodule 挂在主仓”的常见流程。

  1. 在 runner 子仓提交并推送改动（包含 workflow）：
cd runner
git checkout main
git pull --ff-only origin main
git add .
git commit -m "feat(release): add windows exe release pipeline"
git push origin main
  1. 回到主仓提交 submodule 指针：
cd ..
git checkout main
git pull --ff-only origin main
git add runner
git commit -m "chore: bump runner submodule"
git push origin main
  1. 在 runner 子仓打 tag 并触发 Release：
cd runner
git tag -a runner-v1.0.0-m "runner release v1.0.0"
git push origin runner-v1.0.0

完成后到 runner 仓库的 Actions 或 Releases 页面查看产物：

  • AgentLab-Runner-<version>-windows-x64.zip
  • AgentLab-Runner-<version>-linux-x64.tar.gz

自动验证建议

  • 已提供跨平台冒烟测试：.github/workflows/smoke-test.yml
    • windows-latest：启动 start.ps1 -GuiMode web，检测 http://127.0.0.1:18765/ 是否可达
    • ubuntu-latest：启动 start.sh，检测 http://127.0.0.1:18765/ 是否可达

本地验证建议：

  • Linux：优先用 Docker 跑冒烟测试（方便、快）
  • Windows GUI/Electron：优先用 VM（Hyper-V / VMware / VirtualBox）
    • Windows 容器不适合做 Electron 桌面 GUI 测试

快速开始

  1. 安装依赖（任选其一）
    Linux/Ubuntu（在 runner 独立仓库执行）:
bash scripts/setup-ubuntu.sh --all

中国网络建议（加速 npm/Node 下载）:

bash scripts/setup-ubuntu.sh --all --use-cn-mirror

Windows (PowerShell，在 runner 独立仓库执行):

powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll

中国网络建议（加速 npm/Node 下载）:

powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll -UseChinaMirror

Windows（双击方式，不闪退，推荐给非命令行用户）:

scripts\setup-windows.cmd

Windows（图形化安装器，推荐给小白用户）:

scripts\setup-windows-gui.cmd

Web GUI（跨平台，浏览器界面）:

Linux / macOS:

bash scripts/start-web-gui.sh

Windows:

powershell -ExecutionPolicy Bypass -File scripts/start-web-gui.ps1

Windows（卸载本地工具，按需）:

powershell -ExecutionPolicy Bypass -File scripts/uninstall-windows.ps1-RemoveCodex -RemoveClaude -RemoveNode

或：

scripts\uninstall-windows.cmd -RemoveCodex -RemoveClaude -RemoveNode
  1. 启动 runner

Linux/Ubuntu:

RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash scripts/start-runner.sh

Windows:

powershell -ExecutionPolicy Bypass -File scripts/start-runner.ps1-Server "http://127.0.0.1:3200"-Token "xxxx"

Windows（双击方式）:

scripts\start-runner.cmd

推荐（统一生命周期脚本，自动管理 Web GUI + Runner PID/日志）:

Linux / macOS:

RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" ./start.sh
./stop.sh
./restart.sh

Windows:

.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
.\stop.ps1
.\restart.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"

默认 start.ps1 使用 desktop 模式（Electron 独立窗口 + 系统托盘，可再次唤出）。 若你要强制浏览器模式，可显式指定：

.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"-GuiMode web

说明：

  • 脚本会写入 .run/runner.pid、.run/gui.pid。
  • 日志在 .run/runner.log、.run/gui.log。
  • 如果未提供 RUNNER_TOKEN，会只启动 GUI，不会启动 runner daemon。

GUI 安装器支持：

  • 勾选安装 Codex / Claude
  • 勾选中国镜像加速
  • Codex 一键网页登录（自动打开浏览器 + 自动复制设备码）
  • Claude 引导式登录（自动打开登录页 + 自动拉起 claude login 终端 + 提示弹窗）
  • 一键检查登录状态（Check Login Status）
  • 启动后自动检测 Node / Codex / Claude，顶部显示红绿状态灯（可悬浮看路径）
  • 一键卸载所选工具（Codex / Claude / 可选 Node runtime）
  • 多账号槽位：Save Slot / Activate Slot / Delete Slot
  • 余量查询：刷新后展示当前账号 5h / 7d 剩余额度（进度条 + 百分比）
  • 安装时显示“当前步骤 + 下载速率（KB/s/MB/s）”，避免误判卡死
  • 填写 Server/Token 后一键启动 runner
  • 默认中文界面，可一键切换英文；日志提示也会跟随语言切换

备注：Claude 登录是可选项。没有 Claude 账号也可以只使用 Codex 运行。

说明：当前“余量查询”基于 Codex app-server 的 account/rateLimits/read 接口实现。

GUI 结构（v2）

当前 gui/ 已按功能拆分，便于和 AgentLab 主站共用逻辑：

  • app-v2.js: 页面编排与事件绑定
  • modules/api.js: API 请求封装
  • modules/log.js: 日志渲染
  • modules/env.js: 环境检测与状态渲染
  • modules/quota.js: 额度信息渲染
  • modules/slots.js: 多账号槽位管理
  • styles-v2.css: 统一主题变量（暗色 token）

账号槽位说明：

  • 槽位数据保存在 runner/.accounts/windows/<slot>/
  • 本地凭证切换是“文件级切换”，切换后再启动 CLI 即生效
  • 仅适合你自己的机器使用（凭证文件不加密）
  • runner/.accounts/ 已加入 .gitignore，不要把本机凭证提交到仓库

说明：

  • setup-* 脚本会自动安装 runner 依赖（npm install），不需要再手工执行。
  • 默认把 codex/claude 安装到 runner 本地目录（.tools/npm-global），不污染系统全局环境。
  • 若系统没有可用 Node.js，脚本会优先尝试系统安装；失败时回退到 runner 内的便携 Node（.runtime）。
  • 可通过参数自定义下载源：
    • Windows: -NpmRegistry <url> -NodeDistBaseUrl <url>
    • Ubuntu: --npm-registry=<url> --node-dist-base-url=<url>

如果你在主仓库中运行（runner 作为子目录），命令前加 runner/ 前缀即可，例如：

bash runner/scripts/setup-ubuntu.sh --all
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash runner/scripts/start-runner.sh

最小必需环境

为了运行 runner，本质必需项只有：

  • Node.js 20+（runner 进程与 CLI 依赖）
  • 至少一个 Agent CLI（Codex 或 Claude Code）

脚本已尽量把“必需安装”收敛到以上两项，不再要求额外全局 npm 环境配置。

关于“右键运行闪退”

  • Windows 的“右键 -> 使用 PowerShell 运行”本身会在脚本结束后自动关闭窗口，容易看不到错误信息。
  • 建议优先使用 scripts\setup-windows.cmd / scripts\start-runner.cmd（已内置 -NoExit），或者在终端中手动执行 .ps1。

可选环境变量

  • RUNNER_SERVER: 服务端地址（默认 http://127.0.0.1:3200）
  • RUNNER_TOKEN: 必填，Runner Token
  • RUNNER_ID: 可选，Runner 唯一标识
  • RUNNER_CODEX_EXECUTION_MODE: auto / sandboxed / unsafe
  • RUNNER_EXTERNAL_TASK_SCAN_ENABLED: 外部任务扫描总开关（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CODEX: 是否扫描 Codex 外部任务（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CLAUDE: 是否扫描 Claude 外部任务（1/0，默认 0，可快速关闭噪音来源）
  • RUNNER_EXTERNAL_TASK_FILTER_NOISE: 是否过滤 queue-operation 等噪音会话（1/0，默认 1）

认证说明

  • Codex CLI 安装后请自行完成登录认证（例如运行 codex login）。
  • Claude Code CLI 安装后请自行完成登录认证（例如运行 claude login 或配置对应 API 凭证）。

作为独立仓库维护（Git Submodule）

runner/ 本身是独立 Git 仓库，主仓库只通过 submodule 挂载它。

在主仓库中常用命令：

# 初始化/更新 submodule
git submodule update --init --recursive
# 查看 runner 子模块状态
git submodule status runner

更新 runner 代码的推荐方式：

# 进入 runner 子仓库开发cd runner
git checkout -b feat/xxx
# ...修改并提交...
git push origin HEAD
# 回到主仓库，提交 submodule 指针cd ..
git add runner .gitmodules
git commit -m "chore: bump runner submodule"

About

已弃用

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
GitHub - tkpang/AgentLab_Runner: 已弃用 · GitHub
Skip to content
BranchesTags
Repository files navigation
AgentLab Runner
runner/ 是可独立发布的执行端，用于接收 AgentLab Server 下发的作业并在本机执行。
目标
  • 可单独开源、单独发版（不依赖服务端源码）。
  • 支持 Linux（Ubuntu）和 Windows。
  • 支持快速一键配置 Codex / Claude Code（可二选一或都装）。
运维文档
  • Windows 宿主机 SSH 开启 + Linux 虚拟机连接排障：

    • runner/docs/windows-host-ssh-from-linux-vm.md
Release（Windows 一键启动 EXE）
已提供 GitHub Actions 流水线：.github/workflows/release-windows.yml
  • 触发方式：

    • 推送 tag：runner-v<version>（例如 runner-v0.2.0）会自动构建并发布 Release。
    • 手动触发：Actions -> Release Runner (Windows + Linux) -> Run workflow（只产出构建产物）。
  • 产物：

    • AgentLab-Runner-<version>-windows-x64.zip
    • AgentLab-Runner-<version>-linux-x64.tar.gz
    • 解压后直接双击 AgentLab Runner.exe 启动。
本地打包命令（Windows）：
powershell -ExecutionPolicy Bypass -File scripts/build-release-windows.ps1
Git 命令（可直接执行）
以下命令适用于“runner 作为 submodule 挂在主仓”的常见流程。
  1. 在 runner 子仓提交并推送改动（包含 workflow）：
cd runner
git checkout main
git pull --ff-only origin main
git add .
git commit -m "feat(release): add windows exe release pipeline"
git push origin main
  1. 回到主仓提交 submodule 指针：
cd ..
git checkout main
git pull --ff-only origin main
git add runner
git commit -m "chore: bump runner submodule"
git push origin main
  1. 在 runner 子仓打 tag 并触发 Release：
cd runner
git tag -a runner-v1.0.0-m "runner release v1.0.0"
git push origin runner-v1.0.0
完成后到 runner 仓库的 Actions 或 Releases 页面查看产物：
  • AgentLab-Runner-<version>-windows-x64.zip
  • AgentLab-Runner-<version>-linux-x64.tar.gz
自动验证建议
  • 已提供跨平台冒烟测试：.github/workflows/smoke-test.yml
    • windows-latest：启动 start.ps1 -GuiMode web，检测 http://127.0.0.1:18765/ 是否可达
    • ubuntu-latest：启动 start.sh，检测 http://127.0.0.1:18765/ 是否可达
本地验证建议：
  • Linux：优先用 Docker 跑冒烟测试（方便、快）
  • Windows GUI/Electron：优先用 VM（Hyper-V / VMware / VirtualBox）

    • Windows 容器不适合做 Electron 桌面 GUI 测试
快速开始
  1. 安装依赖（任选其一）
    
Linux/Ubuntu（在 runner 独立仓库执行）:
bash scripts/setup-ubuntu.sh --all
中国网络建议（加速 npm/Node 下载）:
bash scripts/setup-ubuntu.sh --all --use-cn-mirror
Windows (PowerShell，在 runner 独立仓库执行):
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll
中国网络建议（加速 npm/Node 下载）:
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll -UseChinaMirror
Windows（双击方式，不闪退，推荐给非命令行用户）:
scripts\setup-windows.cmd
Windows（图形化安装器，推荐给小白用户）:
scripts\setup-windows-gui.cmd
Web GUI（跨平台，浏览器界面）:
Linux / macOS:
bash scripts/start-web-gui.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-web-gui.ps1
Windows（卸载本地工具，按需）:
powershell -ExecutionPolicy Bypass -File scripts/uninstall-windows.ps1-RemoveCodex -RemoveClaude -RemoveNode
或：
scripts\uninstall-windows.cmd -RemoveCodex -RemoveClaude -RemoveNode
  1. 启动 runner
Linux/Ubuntu:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash scripts/start-runner.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-runner.ps1-Server "http://127.0.0.1:3200"-Token "xxxx"
Windows（双击方式）:
scripts\start-runner.cmd
推荐（统一生命周期脚本，自动管理 Web GUI + Runner PID/日志）:
Linux / macOS:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" ./start.sh
./stop.sh
./restart.sh
Windows:
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
.\stop.ps1
.\restart.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
默认 start.ps1 使用 desktop 模式（Electron 独立窗口 + 系统托盘，可再次唤出）。
若你要强制浏览器模式，可显式指定：
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"-GuiMode web
说明：
  • 脚本会写入 .run/runner.pid、.run/gui.pid。
  • 日志在 .run/runner.log、.run/gui.log。
  • 如果未提供 RUNNER_TOKEN，会只启动 GUI，不会启动 runner daemon。
GUI 安装器支持：
  • 勾选安装 Codex / Claude
  • 勾选中国镜像加速
  • Codex 一键网页登录（自动打开浏览器 + 自动复制设备码）
  • Claude 引导式登录（自动打开登录页 + 自动拉起 claude login 终端 + 提示弹窗）
  • 一键检查登录状态（Check Login Status）
  • 启动后自动检测 Node / Codex / Claude，顶部显示红绿状态灯（可悬浮看路径）
  • 一键卸载所选工具（Codex / Claude / 可选 Node runtime）
  • 多账号槽位：Save Slot / Activate Slot / Delete Slot
  • 余量查询：刷新后展示当前账号 5h / 7d 剩余额度（进度条 + 百分比）
  • 安装时显示“当前步骤 + 下载速率（KB/s/MB/s）”，避免误判卡死
  • 填写 Server/Token 后一键启动 runner
  • 默认中文界面，可一键切换英文；日志提示也会跟随语言切换
备注：Claude 登录是可选项。没有 Claude 账号也可以只使用 Codex 运行。
说明：当前“余量查询”基于 Codex app-server 的 account/rateLimits/read 接口实现。
GUI 结构（v2）
当前 gui/ 已按功能拆分，便于和 AgentLab 主站共用逻辑：
  • app-v2.js: 页面编排与事件绑定
  • modules/api.js: API 请求封装
  • modules/log.js: 日志渲染
  • modules/env.js: 环境检测与状态渲染
  • modules/quota.js: 额度信息渲染
  • modules/slots.js: 多账号槽位管理
  • styles-v2.css: 统一主题变量（暗色 token）
账号槽位说明：
  • 槽位数据保存在 runner/.accounts/windows/<slot>/
  • 本地凭证切换是“文件级切换”，切换后再启动 CLI 即生效
  • 仅适合你自己的机器使用（凭证文件不加密）
  • runner/.accounts/ 已加入 .gitignore，不要把本机凭证提交到仓库
说明：
  • setup-* 脚本会自动安装 runner 依赖（npm install），不需要再手工执行。
  • 默认把 codex/claude 安装到 runner 本地目录（.tools/npm-global），不污染系统全局环境。
  • 若系统没有可用 Node.js，脚本会优先尝试系统安装；失败时回退到 runner 内的便携 Node（.runtime）。
  • 可通过参数自定义下载源：

    • Windows: -NpmRegistry <url> -NodeDistBaseUrl <url>
    • Ubuntu: --npm-registry=<url> --node-dist-base-url=<url>
如果你在主仓库中运行（runner 作为子目录），命令前加 runner/ 前缀即可，例如：
bash runner/scripts/setup-ubuntu.sh --all
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash runner/scripts/start-runner.sh
最小必需环境
为了运行 runner，本质必需项只有：
  • Node.js 20+（runner 进程与 CLI 依赖）
  • 至少一个 Agent CLI（Codex 或 Claude Code）
脚本已尽量把“必需安装”收敛到以上两项，不再要求额外全局 npm 环境配置。
关于“右键运行闪退”
  • Windows 的“右键 -> 使用 PowerShell 运行”本身会在脚本结束后自动关闭窗口，容易看不到错误信息。
  • 建议优先使用 scripts\setup-windows.cmd / scripts\start-runner.cmd（已内置 -NoExit），或者在终端中手动执行 .ps1。
可选环境变量
  • RUNNER_SERVER: 服务端地址（默认 http://127.0.0.1:3200）
  • RUNNER_TOKEN: 必填，Runner Token
  • RUNNER_ID: 可选，Runner 唯一标识
  • RUNNER_CODEX_EXECUTION_MODE: auto / sandboxed / unsafe
  • RUNNER_EXTERNAL_TASK_SCAN_ENABLED: 外部任务扫描总开关（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CODEX: 是否扫描 Codex 外部任务（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CLAUDE: 是否扫描 Claude 外部任务（1/0，默认 0，可快速关闭噪音来源）
  • RUNNER_EXTERNAL_TASK_FILTER_NOISE: 是否过滤 queue-operation 等噪音会话（1/0，默认 1）
认证说明
  • Codex CLI 安装后请自行完成登录认证（例如运行 codex login）。
  • Claude Code CLI 安装后请自行完成登录认证（例如运行 claude login 或配置对应 API 凭证）。
作为独立仓库维护（Git Submodule）
runner/ 本身是独立 Git 仓库，主仓库只通过 submodule 挂载它。
在主仓库中常用命令：
# 初始化/更新 submodule
git submodule update --init --recursive
# 查看 runner 子模块状态
git submodule status runner
更新 runner 代码的推荐方式：
# 进入 runner 子仓库开发cd runner
git checkout -b feat/xxx
# ...修改并提交...
git push origin HEAD
# 回到主仓库，提交 submodule 指针cd ..
git add runner .gitmodules
git commit -m "chore: bump runner submodule"
About
已弃用
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - tkpang/AgentLab_Runner: 已弃用 · GitHub
Skip to content
BranchesTags
Repository files navigation
AgentLab Runner
runner/ 是可独立发布的执行端，用于接收 AgentLab Server 下发的作业并在本机执行。
目标
  • 可单独开源、单独发版（不依赖服务端源码）。
  • 支持 Linux（Ubuntu）和 Windows。
  • 支持快速一键配置 Codex / Claude Code（可二选一或都装）。
运维文档
  • Windows 宿主机 SSH 开启 + Linux 虚拟机连接排障：

    • runner/docs/windows-host-ssh-from-linux-vm.md
Release（Windows 一键启动 EXE）
已提供 GitHub Actions 流水线：.github/workflows/release-windows.yml
  • 触发方式：

    • 推送 tag：runner-v<version>（例如 runner-v0.2.0）会自动构建并发布 Release。
    • 手动触发：Actions -> Release Runner (Windows + Linux) -> Run workflow（只产出构建产物）。
  • 产物：

    • AgentLab-Runner-<version>-windows-x64.zip
    • AgentLab-Runner-<version>-linux-x64.tar.gz
    • 解压后直接双击 AgentLab Runner.exe 启动。
本地打包命令（Windows）：
powershell -ExecutionPolicy Bypass -File scripts/build-release-windows.ps1
Git 命令（可直接执行）
以下命令适用于“runner 作为 submodule 挂在主仓”的常见流程。
  1. 在 runner 子仓提交并推送改动（包含 workflow）：
cd runner
git checkout main
git pull --ff-only origin main
git add .
git commit -m "feat(release): add windows exe release pipeline"
git push origin main
  1. 回到主仓提交 submodule 指针：
cd ..
git checkout main
git pull --ff-only origin main
git add runner
git commit -m "chore: bump runner submodule"
git push origin main
  1. 在 runner 子仓打 tag 并触发 Release：
cd runner
git tag -a runner-v1.0.0-m "runner release v1.0.0"
git push origin runner-v1.0.0
完成后到 runner 仓库的 Actions 或 Releases 页面查看产物：
  • AgentLab-Runner-<version>-windows-x64.zip
  • AgentLab-Runner-<version>-linux-x64.tar.gz
自动验证建议
  • 已提供跨平台冒烟测试：.github/workflows/smoke-test.yml
    • windows-latest：启动 start.ps1 -GuiMode web，检测 http://127.0.0.1:18765/ 是否可达
    • ubuntu-latest：启动 start.sh，检测 http://127.0.0.1:18765/ 是否可达
本地验证建议：
  • Linux：优先用 Docker 跑冒烟测试（方便、快）
  • Windows GUI/Electron：优先用 VM（Hyper-V / VMware / VirtualBox）

    • Windows 容器不适合做 Electron 桌面 GUI 测试
快速开始
  1. 安装依赖（任选其一）
    
Linux/Ubuntu（在 runner 独立仓库执行）:
bash scripts/setup-ubuntu.sh --all
中国网络建议（加速 npm/Node 下载）:
bash scripts/setup-ubuntu.sh --all --use-cn-mirror
Windows (PowerShell，在 runner 独立仓库执行):
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll
中国网络建议（加速 npm/Node 下载）:
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll -UseChinaMirror
Windows（双击方式，不闪退，推荐给非命令行用户）:
scripts\setup-windows.cmd
Windows（图形化安装器，推荐给小白用户）:
scripts\setup-windows-gui.cmd
Web GUI（跨平台，浏览器界面）:
Linux / macOS:
bash scripts/start-web-gui.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-web-gui.ps1
Windows（卸载本地工具，按需）:
powershell -ExecutionPolicy Bypass -File scripts/uninstall-windows.ps1-RemoveCodex -RemoveClaude -RemoveNode
或：
scripts\uninstall-windows.cmd -RemoveCodex -RemoveClaude -RemoveNode
  1. 启动 runner
Linux/Ubuntu:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash scripts/start-runner.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-runner.ps1-Server "http://127.0.0.1:3200"-Token "xxxx"
Windows（双击方式）:
scripts\start-runner.cmd
推荐（统一生命周期脚本，自动管理 Web GUI + Runner PID/日志）:
Linux / macOS:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" ./start.sh
./stop.sh
./restart.sh
Windows:
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
.\stop.ps1
.\restart.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
默认 start.ps1 使用 desktop 模式（Electron 独立窗口 + 系统托盘，可再次唤出）。
若你要强制浏览器模式，可显式指定：
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"-GuiMode web
说明：
  • 脚本会写入 .run/runner.pid、.run/gui.pid。
  • 日志在 .run/runner.log、.run/gui.log。
  • 如果未提供 RUNNER_TOKEN，会只启动 GUI，不会启动 runner daemon。
GUI 安装器支持：
  • 勾选安装 Codex / Claude
  • 勾选中国镜像加速
  • Codex 一键网页登录（自动打开浏览器 + 自动复制设备码）
  • Claude 引导式登录（自动打开登录页 + 自动拉起 claude login 终端 + 提示弹窗）
  • 一键检查登录状态（Check Login Status）
  • 启动后自动检测 Node / Codex / Claude，顶部显示红绿状态灯（可悬浮看路径）
  • 一键卸载所选工具（Codex / Claude / 可选 Node runtime）
  • 多账号槽位：Save Slot / Activate Slot / Delete Slot
  • 余量查询：刷新后展示当前账号 5h / 7d 剩余额度（进度条 + 百分比）
  • 安装时显示“当前步骤 + 下载速率（KB/s/MB/s）”，避免误判卡死
  • 填写 Server/Token 后一键启动 runner
  • 默认中文界面，可一键切换英文；日志提示也会跟随语言切换
备注：Claude 登录是可选项。没有 Claude 账号也可以只使用 Codex 运行。
说明：当前“余量查询”基于 Codex app-server 的 account/rateLimits/read 接口实现。
GUI 结构（v2）
当前 gui/ 已按功能拆分，便于和 AgentLab 主站共用逻辑：
  • app-v2.js: 页面编排与事件绑定
  • modules/api.js: API 请求封装
  • modules/log.js: 日志渲染
  • modules/env.js: 环境检测与状态渲染
  • modules/quota.js: 额度信息渲染
  • modules/slots.js: 多账号槽位管理
  • styles-v2.css: 统一主题变量（暗色 token）
账号槽位说明：
  • 槽位数据保存在 runner/.accounts/windows/<slot>/
  • 本地凭证切换是“文件级切换”，切换后再启动 CLI 即生效
  • 仅适合你自己的机器使用（凭证文件不加密）
  • runner/.accounts/ 已加入 .gitignore，不要把本机凭证提交到仓库
说明：
  • setup-* 脚本会自动安装 runner 依赖（npm install），不需要再手工执行。
  • 默认把 codex/claude 安装到 runner 本地目录（.tools/npm-global），不污染系统全局环境。
  • 若系统没有可用 Node.js，脚本会优先尝试系统安装；失败时回退到 runner 内的便携 Node（.runtime）。
  • 可通过参数自定义下载源：

    • Windows: -NpmRegistry <url> -NodeDistBaseUrl <url>
    • Ubuntu: --npm-registry=<url> --node-dist-base-url=<url>
如果你在主仓库中运行（runner 作为子目录），命令前加 runner/ 前缀即可，例如：
bash runner/scripts/setup-ubuntu.sh --all
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash runner/scripts/start-runner.sh
最小必需环境
为了运行 runner，本质必需项只有：
  • Node.js 20+（runner 进程与 CLI 依赖）
  • 至少一个 Agent CLI（Codex 或 Claude Code）
脚本已尽量把“必需安装”收敛到以上两项，不再要求额外全局 npm 环境配置。
关于“右键运行闪退”
  • Windows 的“右键 -> 使用 PowerShell 运行”本身会在脚本结束后自动关闭窗口，容易看不到错误信息。
  • 建议优先使用 scripts\setup-windows.cmd / scripts\start-runner.cmd（已内置 -NoExit），或者在终端中手动执行 .ps1。
可选环境变量
  • RUNNER_SERVER: 服务端地址（默认 http://127.0.0.1:3200）
  • RUNNER_TOKEN: 必填，Runner Token
  • RUNNER_ID: 可选，Runner 唯一标识
  • RUNNER_CODEX_EXECUTION_MODE: auto / sandboxed / unsafe
  • RUNNER_EXTERNAL_TASK_SCAN_ENABLED: 外部任务扫描总开关（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CODEX: 是否扫描 Codex 外部任务（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CLAUDE: 是否扫描 Claude 外部任务（1/0，默认 0，可快速关闭噪音来源）
  • RUNNER_EXTERNAL_TASK_FILTER_NOISE: 是否过滤 queue-operation 等噪音会话（1/0，默认 1）
认证说明
  • Codex CLI 安装后请自行完成登录认证（例如运行 codex login）。
  • Claude Code CLI 安装后请自行完成登录认证（例如运行 claude login 或配置对应 API 凭证）。
作为独立仓库维护（Git Submodule）
runner/ 本身是独立 Git 仓库，主仓库只通过 submodule 挂载它。
在主仓库中常用命令：
# 初始化/更新 submodule
git submodule update --init --recursive
# 查看 runner 子模块状态
git submodule status runner
更新 runner 代码的推荐方式：
# 进入 runner 子仓库开发cd runner
git checkout -b feat/xxx
# ...修改并提交...
git push origin HEAD
# 回到主仓库，提交 submodule 指针cd ..
git add runner .gitmodules
git commit -m "chore: bump runner submodule"
About
已弃用
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - tkpang/AgentLab_Runner: 已弃用 · GitHub
Skip to content
BranchesTags
Repository files navigation
AgentLab Runner
runner/ 是可独立发布的执行端，用于接收 AgentLab Server 下发的作业并在本机执行。
目标
  • 可单独开源、单独发版（不依赖服务端源码）。
  • 支持 Linux（Ubuntu）和 Windows。
  • 支持快速一键配置 Codex / Claude Code（可二选一或都装）。
运维文档
  • Windows 宿主机 SSH 开启 + Linux 虚拟机连接排障：

    • runner/docs/windows-host-ssh-from-linux-vm.md
Release（Windows 一键启动 EXE）
已提供 GitHub Actions 流水线：.github/workflows/release-windows.yml
  • 触发方式：

    • 推送 tag：runner-v<version>（例如 runner-v0.2.0）会自动构建并发布 Release。
    • 手动触发：Actions -> Release Runner (Windows + Linux) -> Run workflow（只产出构建产物）。
  • 产物：

    • AgentLab-Runner-<version>-windows-x64.zip
    • AgentLab-Runner-<version>-linux-x64.tar.gz
    • 解压后直接双击 AgentLab Runner.exe 启动。
本地打包命令（Windows）：
powershell -ExecutionPolicy Bypass -File scripts/build-release-windows.ps1
Git 命令（可直接执行）
以下命令适用于“runner 作为 submodule 挂在主仓”的常见流程。
  1. 在 runner 子仓提交并推送改动（包含 workflow）：
cd runner
git checkout main
git pull --ff-only origin main
git add .
git commit -m "feat(release): add windows exe release pipeline"
git push origin main
  1. 回到主仓提交 submodule 指针：
cd ..
git checkout main
git pull --ff-only origin main
git add runner
git commit -m "chore: bump runner submodule"
git push origin main
  1. 在 runner 子仓打 tag 并触发 Release：
cd runner
git tag -a runner-v1.0.0-m "runner release v1.0.0"
git push origin runner-v1.0.0
完成后到 runner 仓库的 Actions 或 Releases 页面查看产物：
  • AgentLab-Runner-<version>-windows-x64.zip
  • AgentLab-Runner-<version>-linux-x64.tar.gz
自动验证建议
  • 已提供跨平台冒烟测试：.github/workflows/smoke-test.yml
    • windows-latest：启动 start.ps1 -GuiMode web，检测 http://127.0.0.1:18765/ 是否可达
    • ubuntu-latest：启动 start.sh，检测 http://127.0.0.1:18765/ 是否可达
本地验证建议：
  • Linux：优先用 Docker 跑冒烟测试（方便、快）
  • Windows GUI/Electron：优先用 VM（Hyper-V / VMware / VirtualBox）

    • Windows 容器不适合做 Electron 桌面 GUI 测试
快速开始
  1. 安装依赖（任选其一）
    
Linux/Ubuntu（在 runner 独立仓库执行）:
bash scripts/setup-ubuntu.sh --all
中国网络建议（加速 npm/Node 下载）:
bash scripts/setup-ubuntu.sh --all --use-cn-mirror
Windows (PowerShell，在 runner 独立仓库执行):
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll
中国网络建议（加速 npm/Node 下载）:
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll -UseChinaMirror
Windows（双击方式，不闪退，推荐给非命令行用户）:
scripts\setup-windows.cmd
Windows（图形化安装器，推荐给小白用户）:
scripts\setup-windows-gui.cmd
Web GUI（跨平台，浏览器界面）:
Linux / macOS:
bash scripts/start-web-gui.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-web-gui.ps1
Windows（卸载本地工具，按需）:
powershell -ExecutionPolicy Bypass -File scripts/uninstall-windows.ps1-RemoveCodex -RemoveClaude -RemoveNode
或：
scripts\uninstall-windows.cmd -RemoveCodex -RemoveClaude -RemoveNode
  1. 启动 runner
Linux/Ubuntu:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash scripts/start-runner.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-runner.ps1-Server "http://127.0.0.1:3200"-Token "xxxx"
Windows（双击方式）:
scripts\start-runner.cmd
推荐（统一生命周期脚本，自动管理 Web GUI + Runner PID/日志）:
Linux / macOS:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" ./start.sh
./stop.sh
./restart.sh
Windows:
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
.\stop.ps1
.\restart.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
默认 start.ps1 使用 desktop 模式（Electron 独立窗口 + 系统托盘，可再次唤出）。
若你要强制浏览器模式，可显式指定：
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"-GuiMode web
说明：
  • 脚本会写入 .run/runner.pid、.run/gui.pid。
  • 日志在 .run/runner.log、.run/gui.log。
  • 如果未提供 RUNNER_TOKEN，会只启动 GUI，不会启动 runner daemon。
GUI 安装器支持：
  • 勾选安装 Codex / Claude
  • 勾选中国镜像加速
  • Codex 一键网页登录（自动打开浏览器 + 自动复制设备码）
  • Claude 引导式登录（自动打开登录页 + 自动拉起 claude login 终端 + 提示弹窗）
  • 一键检查登录状态（Check Login Status）
  • 启动后自动检测 Node / Codex / Claude，顶部显示红绿状态灯（可悬浮看路径）
  • 一键卸载所选工具（Codex / Claude / 可选 Node runtime）
  • 多账号槽位：Save Slot / Activate Slot / Delete Slot
  • 余量查询：刷新后展示当前账号 5h / 7d 剩余额度（进度条 + 百分比）
  • 安装时显示“当前步骤 + 下载速率（KB/s/MB/s）”，避免误判卡死
  • 填写 Server/Token 后一键启动 runner
  • 默认中文界面，可一键切换英文；日志提示也会跟随语言切换
备注：Claude 登录是可选项。没有 Claude 账号也可以只使用 Codex 运行。
说明：当前“余量查询”基于 Codex app-server 的 account/rateLimits/read 接口实现。
GUI 结构（v2）
当前 gui/ 已按功能拆分，便于和 AgentLab 主站共用逻辑：
  • app-v2.js: 页面编排与事件绑定
  • modules/api.js: API 请求封装
  • modules/log.js: 日志渲染
  • modules/env.js: 环境检测与状态渲染
  • modules/quota.js: 额度信息渲染
  • modules/slots.js: 多账号槽位管理
  • styles-v2.css: 统一主题变量（暗色 token）
账号槽位说明：
  • 槽位数据保存在 runner/.accounts/windows/<slot>/
  • 本地凭证切换是“文件级切换”，切换后再启动 CLI 即生效
  • 仅适合你自己的机器使用（凭证文件不加密）
  • runner/.accounts/ 已加入 .gitignore，不要把本机凭证提交到仓库
说明：
  • setup-* 脚本会自动安装 runner 依赖（npm install），不需要再手工执行。
  • 默认把 codex/claude 安装到 runner 本地目录（.tools/npm-global），不污染系统全局环境。
  • 若系统没有可用 Node.js，脚本会优先尝试系统安装；失败时回退到 runner 内的便携 Node（.runtime）。
  • 可通过参数自定义下载源：

    • Windows: -NpmRegistry <url> -NodeDistBaseUrl <url>
    • Ubuntu: --npm-registry=<url> --node-dist-base-url=<url>
如果你在主仓库中运行（runner 作为子目录），命令前加 runner/ 前缀即可，例如：
bash runner/scripts/setup-ubuntu.sh --all
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash runner/scripts/start-runner.sh
最小必需环境
为了运行 runner，本质必需项只有：
  • Node.js 20+（runner 进程与 CLI 依赖）
  • 至少一个 Agent CLI（Codex 或 Claude Code）
脚本已尽量把“必需安装”收敛到以上两项，不再要求额外全局 npm 环境配置。
关于“右键运行闪退”
  • Windows 的“右键 -> 使用 PowerShell 运行”本身会在脚本结束后自动关闭窗口，容易看不到错误信息。
  • 建议优先使用 scripts\setup-windows.cmd / scripts\start-runner.cmd（已内置 -NoExit），或者在终端中手动执行 .ps1。
可选环境变量
  • RUNNER_SERVER: 服务端地址（默认 http://127.0.0.1:3200）
  • RUNNER_TOKEN: 必填，Runner Token
  • RUNNER_ID: 可选，Runner 唯一标识
  • RUNNER_CODEX_EXECUTION_MODE: auto / sandboxed / unsafe
  • RUNNER_EXTERNAL_TASK_SCAN_ENABLED: 外部任务扫描总开关（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CODEX: 是否扫描 Codex 外部任务（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CLAUDE: 是否扫描 Claude 外部任务（1/0，默认 0，可快速关闭噪音来源）
  • RUNNER_EXTERNAL_TASK_FILTER_NOISE: 是否过滤 queue-operation 等噪音会话（1/0，默认 1）
认证说明
  • Codex CLI 安装后请自行完成登录认证（例如运行 codex login）。
  • Claude Code CLI 安装后请自行完成登录认证（例如运行 claude login 或配置对应 API 凭证）。
作为独立仓库维护（Git Submodule）
runner/ 本身是独立 Git 仓库，主仓库只通过 submodule 挂载它。
在主仓库中常用命令：
# 初始化/更新 submodule
git submodule update --init --recursive
# 查看 runner 子模块状态
git submodule status runner
更新 runner 代码的推荐方式：
# 进入 runner 子仓库开发cd runner
git checkout -b feat/xxx
# ...修改并提交...
git push origin HEAD
# 回到主仓库，提交 submodule 指针cd ..
git add runner .gitmodules
git commit -m "chore: bump runner submodule"
About
已弃用
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '
GitHub - tkpang/AgentLab_Runner: 已弃用 · GitHub
Skip to content
BranchesTags
Repository files navigation
AgentLab Runner
runner/ 是可独立发布的执行端，用于接收 AgentLab Server 下发的作业并在本机执行。
目标
  • 可单独开源、单独发版（不依赖服务端源码）。
  • 支持 Linux（Ubuntu）和 Windows。
  • 支持快速一键配置 Codex / Claude Code（可二选一或都装）。
运维文档
  • Windows 宿主机 SSH 开启 + Linux 虚拟机连接排障：

    • runner/docs/windows-host-ssh-from-linux-vm.md
Release（Windows 一键启动 EXE）
已提供 GitHub Actions 流水线：.github/workflows/release-windows.yml
  • 触发方式：

    • 推送 tag：runner-v<version>（例如 runner-v0.2.0）会自动构建并发布 Release。
    • 手动触发：Actions -> Release Runner (Windows + Linux) -> Run workflow（只产出构建产物）。
  • 产物：

    • AgentLab-Runner-<version>-windows-x64.zip
    • AgentLab-Runner-<version>-linux-x64.tar.gz
    • 解压后直接双击 AgentLab Runner.exe 启动。
本地打包命令（Windows）：
powershell -ExecutionPolicy Bypass -File scripts/build-release-windows.ps1
Git 命令（可直接执行）
以下命令适用于“runner 作为 submodule 挂在主仓”的常见流程。
  1. 在 runner 子仓提交并推送改动（包含 workflow）：
cd runner
git checkout main
git pull --ff-only origin main
git add .
git commit -m "feat(release): add windows exe release pipeline"
git push origin main
  1. 回到主仓提交 submodule 指针：
cd ..
git checkout main
git pull --ff-only origin main
git add runner
git commit -m "chore: bump runner submodule"
git push origin main
  1. 在 runner 子仓打 tag 并触发 Release：
cd runner
git tag -a runner-v1.0.0-m "runner release v1.0.0"
git push origin runner-v1.0.0
完成后到 runner 仓库的 Actions 或 Releases 页面查看产物：
  • AgentLab-Runner-<version>-windows-x64.zip
  • AgentLab-Runner-<version>-linux-x64.tar.gz
自动验证建议
  • 已提供跨平台冒烟测试：.github/workflows/smoke-test.yml
    • windows-latest：启动 start.ps1 -GuiMode web，检测 http://127.0.0.1:18765/ 是否可达
    • ubuntu-latest：启动 start.sh，检测 http://127.0.0.1:18765/ 是否可达
本地验证建议：
  • Linux：优先用 Docker 跑冒烟测试（方便、快）
  • Windows GUI/Electron：优先用 VM（Hyper-V / VMware / VirtualBox）

    • Windows 容器不适合做 Electron 桌面 GUI 测试
快速开始
  1. 安装依赖（任选其一）
    
Linux/Ubuntu（在 runner 独立仓库执行）:
bash scripts/setup-ubuntu.sh --all
中国网络建议（加速 npm/Node 下载）:
bash scripts/setup-ubuntu.sh --all --use-cn-mirror
Windows (PowerShell，在 runner 独立仓库执行):
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll
中国网络建议（加速 npm/Node 下载）:
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll -UseChinaMirror
Windows（双击方式，不闪退，推荐给非命令行用户）:
scripts\setup-windows.cmd
Windows（图形化安装器，推荐给小白用户）:
scripts\setup-windows-gui.cmd
Web GUI（跨平台，浏览器界面）:
Linux / macOS:
bash scripts/start-web-gui.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-web-gui.ps1
Windows（卸载本地工具，按需）:
powershell -ExecutionPolicy Bypass -File scripts/uninstall-windows.ps1-RemoveCodex -RemoveClaude -RemoveNode
或：
scripts\uninstall-windows.cmd -RemoveCodex -RemoveClaude -RemoveNode
  1. 启动 runner
Linux/Ubuntu:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash scripts/start-runner.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-runner.ps1-Server "http://127.0.0.1:3200"-Token "xxxx"
Windows（双击方式）:
scripts\start-runner.cmd
推荐（统一生命周期脚本，自动管理 Web GUI + Runner PID/日志）:
Linux / macOS:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" ./start.sh
./stop.sh
./restart.sh
Windows:
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
.\stop.ps1
.\restart.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
默认 start.ps1 使用 desktop 模式（Electron 独立窗口 + 系统托盘，可再次唤出）。
若你要强制浏览器模式，可显式指定：
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"-GuiMode web
说明：
  • 脚本会写入 .run/runner.pid、.run/gui.pid。
  • 日志在 .run/runner.log、.run/gui.log。
  • 如果未提供 RUNNER_TOKEN，会只启动 GUI，不会启动 runner daemon。
GUI 安装器支持：
  • 勾选安装 Codex / Claude
  • 勾选中国镜像加速
  • Codex 一键网页登录（自动打开浏览器 + 自动复制设备码）
  • Claude 引导式登录（自动打开登录页 + 自动拉起 claude login 终端 + 提示弹窗）
  • 一键检查登录状态（Check Login Status）
  • 启动后自动检测 Node / Codex / Claude，顶部显示红绿状态灯（可悬浮看路径）
  • 一键卸载所选工具（Codex / Claude / 可选 Node runtime）
  • 多账号槽位：Save Slot / Activate Slot / Delete Slot
  • 余量查询：刷新后展示当前账号 5h / 7d 剩余额度（进度条 + 百分比）
  • 安装时显示“当前步骤 + 下载速率（KB/s/MB/s）”，避免误判卡死
  • 填写 Server/Token 后一键启动 runner
  • 默认中文界面，可一键切换英文；日志提示也会跟随语言切换
备注：Claude 登录是可选项。没有 Claude 账号也可以只使用 Codex 运行。
说明：当前“余量查询”基于 Codex app-server 的 account/rateLimits/read 接口实现。
GUI 结构（v2）
当前 gui/ 已按功能拆分，便于和 AgentLab 主站共用逻辑：
  • app-v2.js: 页面编排与事件绑定
  • modules/api.js: API 请求封装
  • modules/log.js: 日志渲染
  • modules/env.js: 环境检测与状态渲染
  • modules/quota.js: 额度信息渲染
  • modules/slots.js: 多账号槽位管理
  • styles-v2.css: 统一主题变量（暗色 token）
账号槽位说明：
  • 槽位数据保存在 runner/.accounts/windows/<slot>/
  • 本地凭证切换是“文件级切换”，切换后再启动 CLI 即生效
  • 仅适合你自己的机器使用（凭证文件不加密）
  • runner/.accounts/ 已加入 .gitignore，不要把本机凭证提交到仓库
说明：
  • setup-* 脚本会自动安装 runner 依赖（npm install），不需要再手工执行。
  • 默认把 codex/claude 安装到 runner 本地目录（.tools/npm-global），不污染系统全局环境。
  • 若系统没有可用 Node.js，脚本会优先尝试系统安装；失败时回退到 runner 内的便携 Node（.runtime）。
  • 可通过参数自定义下载源：

    • Windows: -NpmRegistry <url> -NodeDistBaseUrl <url>
    • Ubuntu: --npm-registry=<url> --node-dist-base-url=<url>
如果你在主仓库中运行（runner 作为子目录），命令前加 runner/ 前缀即可，例如：
bash runner/scripts/setup-ubuntu.sh --all
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash runner/scripts/start-runner.sh
最小必需环境
为了运行 runner，本质必需项只有：
  • Node.js 20+（runner 进程与 CLI 依赖）
  • 至少一个 Agent CLI（Codex 或 Claude Code）
脚本已尽量把“必需安装”收敛到以上两项，不再要求额外全局 npm 环境配置。
关于“右键运行闪退”
  • Windows 的“右键 -> 使用 PowerShell 运行”本身会在脚本结束后自动关闭窗口，容易看不到错误信息。
  • 建议优先使用 scripts\setup-windows.cmd / scripts\start-runner.cmd（已内置 -NoExit），或者在终端中手动执行 .ps1。
可选环境变量
  • RUNNER_SERVER: 服务端地址（默认 http://127.0.0.1:3200）
  • RUNNER_TOKEN: 必填，Runner Token
  • RUNNER_ID: 可选，Runner 唯一标识
  • RUNNER_CODEX_EXECUTION_MODE: auto / sandboxed / unsafe
  • RUNNER_EXTERNAL_TASK_SCAN_ENABLED: 外部任务扫描总开关（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CODEX: 是否扫描 Codex 外部任务（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CLAUDE: 是否扫描 Claude 外部任务（1/0，默认 0，可快速关闭噪音来源）
  • RUNNER_EXTERNAL_TASK_FILTER_NOISE: 是否过滤 queue-operation 等噪音会话（1/0，默认 1）
认证说明
  • Codex CLI 安装后请自行完成登录认证（例如运行 codex login）。
  • Claude Code CLI 安装后请自行完成登录认证（例如运行 claude login 或配置对应 API 凭证）。
作为独立仓库维护（Git Submodule）
runner/ 本身是独立 Git 仓库，主仓库只通过 submodule 挂载它。
在主仓库中常用命令：
# 初始化/更新 submodule
git submodule update --init --recursive
# 查看 runner 子模块状态
git submodule status runner
更新 runner 代码的推荐方式：
# 进入 runner 子仓库开发cd runner
git checkout -b feat/xxx
# ...修改并提交...
git push origin HEAD
# 回到主仓库，提交 submodule 指针cd ..
git add runner .gitmodules
git commit -m "chore: bump runner submodule"
About
已弃用
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - tkpang/AgentLab_Runner: 已弃用 · GitHub
Skip to content
BranchesTags
Repository files navigation
AgentLab Runner
runner/ 是可独立发布的执行端，用于接收 AgentLab Server 下发的作业并在本机执行。
目标
  • 可单独开源、单独发版（不依赖服务端源码）。
  • 支持 Linux（Ubuntu）和 Windows。
  • 支持快速一键配置 Codex / Claude Code（可二选一或都装）。
运维文档
  • Windows 宿主机 SSH 开启 + Linux 虚拟机连接排障：

    • runner/docs/windows-host-ssh-from-linux-vm.md
Release（Windows 一键启动 EXE）
已提供 GitHub Actions 流水线：.github/workflows/release-windows.yml
  • 触发方式：

    • 推送 tag：runner-v<version>（例如 runner-v0.2.0）会自动构建并发布 Release。
    • 手动触发：Actions -> Release Runner (Windows + Linux) -> Run workflow（只产出构建产物）。
  • 产物：

    • AgentLab-Runner-<version>-windows-x64.zip
    • AgentLab-Runner-<version>-linux-x64.tar.gz
    • 解压后直接双击 AgentLab Runner.exe 启动。
本地打包命令（Windows）：
powershell -ExecutionPolicy Bypass -File scripts/build-release-windows.ps1
Git 命令（可直接执行）
以下命令适用于“runner 作为 submodule 挂在主仓”的常见流程。
  1. 在 runner 子仓提交并推送改动（包含 workflow）：
cd runner
git checkout main
git pull --ff-only origin main
git add .
git commit -m "feat(release): add windows exe release pipeline"
git push origin main
  1. 回到主仓提交 submodule 指针：
cd ..
git checkout main
git pull --ff-only origin main
git add runner
git commit -m "chore: bump runner submodule"
git push origin main
  1. 在 runner 子仓打 tag 并触发 Release：
cd runner
git tag -a runner-v1.0.0-m "runner release v1.0.0"
git push origin runner-v1.0.0
完成后到 runner 仓库的 Actions 或 Releases 页面查看产物：
  • AgentLab-Runner-<version>-windows-x64.zip
  • AgentLab-Runner-<version>-linux-x64.tar.gz
自动验证建议
  • 已提供跨平台冒烟测试：.github/workflows/smoke-test.yml
    • windows-latest：启动 start.ps1 -GuiMode web，检测 http://127.0.0.1:18765/ 是否可达
    • ubuntu-latest：启动 start.sh，检测 http://127.0.0.1:18765/ 是否可达
本地验证建议：
  • Linux：优先用 Docker 跑冒烟测试（方便、快）
  • Windows GUI/Electron：优先用 VM（Hyper-V / VMware / VirtualBox）

    • Windows 容器不适合做 Electron 桌面 GUI 测试
快速开始
  1. 安装依赖（任选其一）
    
Linux/Ubuntu（在 runner 独立仓库执行）:
bash scripts/setup-ubuntu.sh --all
中国网络建议（加速 npm/Node 下载）:
bash scripts/setup-ubuntu.sh --all --use-cn-mirror
Windows (PowerShell，在 runner 独立仓库执行):
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll
中国网络建议（加速 npm/Node 下载）:
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll -UseChinaMirror
Windows（双击方式，不闪退，推荐给非命令行用户）:
scripts\setup-windows.cmd
Windows（图形化安装器，推荐给小白用户）:
scripts\setup-windows-gui.cmd
Web GUI（跨平台，浏览器界面）:
Linux / macOS:
bash scripts/start-web-gui.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-web-gui.ps1
Windows（卸载本地工具，按需）:
powershell -ExecutionPolicy Bypass -File scripts/uninstall-windows.ps1-RemoveCodex -RemoveClaude -RemoveNode
或：
scripts\uninstall-windows.cmd -RemoveCodex -RemoveClaude -RemoveNode
  1. 启动 runner
Linux/Ubuntu:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash scripts/start-runner.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-runner.ps1-Server "http://127.0.0.1:3200"-Token "xxxx"
Windows（双击方式）:
scripts\start-runner.cmd
推荐（统一生命周期脚本，自动管理 Web GUI + Runner PID/日志）:
Linux / macOS:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" ./start.sh
./stop.sh
./restart.sh
Windows:
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
.\stop.ps1
.\restart.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
默认 start.ps1 使用 desktop 模式（Electron 独立窗口 + 系统托盘，可再次唤出）。
若你要强制浏览器模式，可显式指定：
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"-GuiMode web
说明：
  • 脚本会写入 .run/runner.pid、.run/gui.pid。
  • 日志在 .run/runner.log、.run/gui.log。
  • 如果未提供 RUNNER_TOKEN，会只启动 GUI，不会启动 runner daemon。
GUI 安装器支持：
  • 勾选安装 Codex / Claude
  • 勾选中国镜像加速
  • Codex 一键网页登录（自动打开浏览器 + 自动复制设备码）
  • Claude 引导式登录（自动打开登录页 + 自动拉起 claude login 终端 + 提示弹窗）
  • 一键检查登录状态（Check Login Status）
  • 启动后自动检测 Node / Codex / Claude，顶部显示红绿状态灯（可悬浮看路径）
  • 一键卸载所选工具（Codex / Claude / 可选 Node runtime）
  • 多账号槽位：Save Slot / Activate Slot / Delete Slot
  • 余量查询：刷新后展示当前账号 5h / 7d 剩余额度（进度条 + 百分比）
  • 安装时显示“当前步骤 + 下载速率（KB/s/MB/s）”，避免误判卡死
  • 填写 Server/Token 后一键启动 runner
  • 默认中文界面，可一键切换英文；日志提示也会跟随语言切换
备注：Claude 登录是可选项。没有 Claude 账号也可以只使用 Codex 运行。
说明：当前“余量查询”基于 Codex app-server 的 account/rateLimits/read 接口实现。
GUI 结构（v2）
当前 gui/ 已按功能拆分，便于和 AgentLab 主站共用逻辑：
  • app-v2.js: 页面编排与事件绑定
  • modules/api.js: API 请求封装
  • modules/log.js: 日志渲染
  • modules/env.js: 环境检测与状态渲染
  • modules/quota.js: 额度信息渲染
  • modules/slots.js: 多账号槽位管理
  • styles-v2.css: 统一主题变量（暗色 token）
账号槽位说明：
  • 槽位数据保存在 runner/.accounts/windows/<slot>/
  • 本地凭证切换是“文件级切换”，切换后再启动 CLI 即生效
  • 仅适合你自己的机器使用（凭证文件不加密）
  • runner/.accounts/ 已加入 .gitignore，不要把本机凭证提交到仓库
说明：
  • setup-* 脚本会自动安装 runner 依赖（npm install），不需要再手工执行。
  • 默认把 codex/claude 安装到 runner 本地目录（.tools/npm-global），不污染系统全局环境。
  • 若系统没有可用 Node.js，脚本会优先尝试系统安装；失败时回退到 runner 内的便携 Node（.runtime）。
  • 可通过参数自定义下载源：

    • Windows: -NpmRegistry <url> -NodeDistBaseUrl <url>
    • Ubuntu: --npm-registry=<url> --node-dist-base-url=<url>
如果你在主仓库中运行（runner 作为子目录），命令前加 runner/ 前缀即可，例如：
bash runner/scripts/setup-ubuntu.sh --all
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash runner/scripts/start-runner.sh
最小必需环境
为了运行 runner，本质必需项只有：
  • Node.js 20+（runner 进程与 CLI 依赖）
  • 至少一个 Agent CLI（Codex 或 Claude Code）
脚本已尽量把“必需安装”收敛到以上两项，不再要求额外全局 npm 环境配置。
关于“右键运行闪退”
  • Windows 的“右键 -> 使用 PowerShell 运行”本身会在脚本结束后自动关闭窗口，容易看不到错误信息。
  • 建议优先使用 scripts\setup-windows.cmd / scripts\start-runner.cmd（已内置 -NoExit），或者在终端中手动执行 .ps1。
可选环境变量
  • RUNNER_SERVER: 服务端地址（默认 http://127.0.0.1:3200）
  • RUNNER_TOKEN: 必填，Runner Token
  • RUNNER_ID: 可选，Runner 唯一标识
  • RUNNER_CODEX_EXECUTION_MODE: auto / sandboxed / unsafe
  • RUNNER_EXTERNAL_TASK_SCAN_ENABLED: 外部任务扫描总开关（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CODEX: 是否扫描 Codex 外部任务（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CLAUDE: 是否扫描 Claude 外部任务（1/0，默认 0，可快速关闭噪音来源）
  • RUNNER_EXTERNAL_TASK_FILTER_NOISE: 是否过滤 queue-operation 等噪音会话（1/0，默认 1）
认证说明
  • Codex CLI 安装后请自行完成登录认证（例如运行 codex login）。
  • Claude Code CLI 安装后请自行完成登录认证（例如运行 claude login 或配置对应 API 凭证）。
作为独立仓库维护（Git Submodule）
runner/ 本身是独立 Git 仓库，主仓库只通过 submodule 挂载它。
在主仓库中常用命令：
# 初始化/更新 submodule
git submodule update --init --recursive
# 查看 runner 子模块状态
git submodule status runner
更新 runner 代码的推荐方式：
# 进入 runner 子仓库开发cd runner
git checkout -b feat/xxx
# ...修改并提交...
git push origin HEAD
# 回到主仓库，提交 submodule 指针cd ..
git add runner .gitmodules
git commit -m "chore: bump runner submodule"
About
已弃用
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - tkpang/AgentLab_Runner: 已弃用 · GitHub
Skip to content
BranchesTags
Repository files navigation
AgentLab Runner
runner/ 是可独立发布的执行端，用于接收 AgentLab Server 下发的作业并在本机执行。
目标
  • 可单独开源、单独发版（不依赖服务端源码）。
  • 支持 Linux（Ubuntu）和 Windows。
  • 支持快速一键配置 Codex / Claude Code（可二选一或都装）。
运维文档
  • Windows 宿主机 SSH 开启 + Linux 虚拟机连接排障：

    • runner/docs/windows-host-ssh-from-linux-vm.md
Release（Windows 一键启动 EXE）
已提供 GitHub Actions 流水线：.github/workflows/release-windows.yml
  • 触发方式：

    • 推送 tag：runner-v<version>（例如 runner-v0.2.0）会自动构建并发布 Release。
    • 手动触发：Actions -> Release Runner (Windows + Linux) -> Run workflow（只产出构建产物）。
  • 产物：

    • AgentLab-Runner-<version>-windows-x64.zip
    • AgentLab-Runner-<version>-linux-x64.tar.gz
    • 解压后直接双击 AgentLab Runner.exe 启动。
本地打包命令（Windows）：
powershell -ExecutionPolicy Bypass -File scripts/build-release-windows.ps1
Git 命令（可直接执行）
以下命令适用于“runner 作为 submodule 挂在主仓”的常见流程。
  1. 在 runner 子仓提交并推送改动（包含 workflow）：
cd runner
git checkout main
git pull --ff-only origin main
git add .
git commit -m "feat(release): add windows exe release pipeline"
git push origin main
  1. 回到主仓提交 submodule 指针：
cd ..
git checkout main
git pull --ff-only origin main
git add runner
git commit -m "chore: bump runner submodule"
git push origin main
  1. 在 runner 子仓打 tag 并触发 Release：
cd runner
git tag -a runner-v1.0.0-m "runner release v1.0.0"
git push origin runner-v1.0.0
完成后到 runner 仓库的 Actions 或 Releases 页面查看产物：
  • AgentLab-Runner-<version>-windows-x64.zip
  • AgentLab-Runner-<version>-linux-x64.tar.gz
自动验证建议
  • 已提供跨平台冒烟测试：.github/workflows/smoke-test.yml
    • windows-latest：启动 start.ps1 -GuiMode web，检测 http://127.0.0.1:18765/ 是否可达
    • ubuntu-latest：启动 start.sh，检测 http://127.0.0.1:18765/ 是否可达
本地验证建议：
  • Linux：优先用 Docker 跑冒烟测试（方便、快）
  • Windows GUI/Electron：优先用 VM（Hyper-V / VMware / VirtualBox）

    • Windows 容器不适合做 Electron 桌面 GUI 测试
快速开始
  1. 安装依赖（任选其一）
    
Linux/Ubuntu（在 runner 独立仓库执行）:
bash scripts/setup-ubuntu.sh --all
中国网络建议（加速 npm/Node 下载）:
bash scripts/setup-ubuntu.sh --all --use-cn-mirror
Windows (PowerShell，在 runner 独立仓库执行):
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll
中国网络建议（加速 npm/Node 下载）:
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll -UseChinaMirror
Windows（双击方式，不闪退，推荐给非命令行用户）:
scripts\setup-windows.cmd
Windows（图形化安装器，推荐给小白用户）:
scripts\setup-windows-gui.cmd
Web GUI（跨平台，浏览器界面）:
Linux / macOS:
bash scripts/start-web-gui.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-web-gui.ps1
Windows（卸载本地工具，按需）:
powershell -ExecutionPolicy Bypass -File scripts/uninstall-windows.ps1-RemoveCodex -RemoveClaude -RemoveNode
或：
scripts\uninstall-windows.cmd -RemoveCodex -RemoveClaude -RemoveNode
  1. 启动 runner
Linux/Ubuntu:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash scripts/start-runner.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-runner.ps1-Server "http://127.0.0.1:3200"-Token "xxxx"
Windows（双击方式）:
scripts\start-runner.cmd
推荐（统一生命周期脚本，自动管理 Web GUI + Runner PID/日志）:
Linux / macOS:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" ./start.sh
./stop.sh
./restart.sh
Windows:
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
.\stop.ps1
.\restart.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
默认 start.ps1 使用 desktop 模式（Electron 独立窗口 + 系统托盘，可再次唤出）。
若你要强制浏览器模式，可显式指定：
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"-GuiMode web
说明：
  • 脚本会写入 .run/runner.pid、.run/gui.pid。
  • 日志在 .run/runner.log、.run/gui.log。
  • 如果未提供 RUNNER_TOKEN，会只启动 GUI，不会启动 runner daemon。
GUI 安装器支持：
  • 勾选安装 Codex / Claude
  • 勾选中国镜像加速
  • Codex 一键网页登录（自动打开浏览器 + 自动复制设备码）
  • Claude 引导式登录（自动打开登录页 + 自动拉起 claude login 终端 + 提示弹窗）
  • 一键检查登录状态（Check Login Status）
  • 启动后自动检测 Node / Codex / Claude，顶部显示红绿状态灯（可悬浮看路径）
  • 一键卸载所选工具（Codex / Claude / 可选 Node runtime）
  • 多账号槽位：Save Slot / Activate Slot / Delete Slot
  • 余量查询：刷新后展示当前账号 5h / 7d 剩余额度（进度条 + 百分比）
  • 安装时显示“当前步骤 + 下载速率（KB/s/MB/s）”，避免误判卡死
  • 填写 Server/Token 后一键启动 runner
  • 默认中文界面，可一键切换英文；日志提示也会跟随语言切换
备注：Claude 登录是可选项。没有 Claude 账号也可以只使用 Codex 运行。
说明：当前“余量查询”基于 Codex app-server 的 account/rateLimits/read 接口实现。
GUI 结构（v2）
当前 gui/ 已按功能拆分，便于和 AgentLab 主站共用逻辑：
  • app-v2.js: 页面编排与事件绑定
  • modules/api.js: API 请求封装
  • modules/log.js: 日志渲染
  • modules/env.js: 环境检测与状态渲染
  • modules/quota.js: 额度信息渲染
  • modules/slots.js: 多账号槽位管理
  • styles-v2.css: 统一主题变量（暗色 token）
账号槽位说明：
  • 槽位数据保存在 runner/.accounts/windows/<slot>/
  • 本地凭证切换是“文件级切换”，切换后再启动 CLI 即生效
  • 仅适合你自己的机器使用（凭证文件不加密）
  • runner/.accounts/ 已加入 .gitignore，不要把本机凭证提交到仓库
说明：
  • setup-* 脚本会自动安装 runner 依赖（npm install），不需要再手工执行。
  • 默认把 codex/claude 安装到 runner 本地目录（.tools/npm-global），不污染系统全局环境。
  • 若系统没有可用 Node.js，脚本会优先尝试系统安装；失败时回退到 runner 内的便携 Node（.runtime）。
  • 可通过参数自定义下载源：

    • Windows: -NpmRegistry <url> -NodeDistBaseUrl <url>
    • Ubuntu: --npm-registry=<url> --node-dist-base-url=<url>
如果你在主仓库中运行（runner 作为子目录），命令前加 runner/ 前缀即可，例如：
bash runner/scripts/setup-ubuntu.sh --all
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash runner/scripts/start-runner.sh
最小必需环境
为了运行 runner，本质必需项只有：
  • Node.js 20+（runner 进程与 CLI 依赖）
  • 至少一个 Agent CLI（Codex 或 Claude Code）
脚本已尽量把“必需安装”收敛到以上两项，不再要求额外全局 npm 环境配置。
关于“右键运行闪退”
  • Windows 的“右键 -> 使用 PowerShell 运行”本身会在脚本结束后自动关闭窗口，容易看不到错误信息。
  • 建议优先使用 scripts\setup-windows.cmd / scripts\start-runner.cmd（已内置 -NoExit），或者在终端中手动执行 .ps1。
可选环境变量
  • RUNNER_SERVER: 服务端地址（默认 http://127.0.0.1:3200）
  • RUNNER_TOKEN: 必填，Runner Token
  • RUNNER_ID: 可选，Runner 唯一标识
  • RUNNER_CODEX_EXECUTION_MODE: auto / sandboxed / unsafe
  • RUNNER_EXTERNAL_TASK_SCAN_ENABLED: 外部任务扫描总开关（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CODEX: 是否扫描 Codex 外部任务（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CLAUDE: 是否扫描 Claude 外部任务（1/0，默认 0，可快速关闭噪音来源）
  • RUNNER_EXTERNAL_TASK_FILTER_NOISE: 是否过滤 queue-operation 等噪音会话（1/0，默认 1）
认证说明
  • Codex CLI 安装后请自行完成登录认证（例如运行 codex login）。
  • Claude Code CLI 安装后请自行完成登录认证（例如运行 claude login 或配置对应 API 凭证）。
作为独立仓库维护（Git Submodule）
runner/ 本身是独立 Git 仓库，主仓库只通过 submodule 挂载它。
在主仓库中常用命令：
# 初始化/更新 submodule
git submodule update --init --recursive
# 查看 runner 子模块状态
git submodule status runner
更新 runner 代码的推荐方式：
# 进入 runner 子仓库开发cd runner
git checkout -b feat/xxx
# ...修改并提交...
git push origin HEAD
# 回到主仓库，提交 submodule 指针cd ..
git add runner .gitmodules
git commit -m "chore: bump runner submodule"
About
已弃用
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();
GitHub - tkpang/AgentLab_Runner: 已弃用 · GitHub
Skip to content
BranchesTags
Repository files navigation
AgentLab Runner
runner/ 是可独立发布的执行端，用于接收 AgentLab Server 下发的作业并在本机执行。
目标
  • 可单独开源、单独发版（不依赖服务端源码）。
  • 支持 Linux（Ubuntu）和 Windows。
  • 支持快速一键配置 Codex / Claude Code（可二选一或都装）。
运维文档
  • Windows 宿主机 SSH 开启 + Linux 虚拟机连接排障：

    • runner/docs/windows-host-ssh-from-linux-vm.md
Release（Windows 一键启动 EXE）
已提供 GitHub Actions 流水线：.github/workflows/release-windows.yml
  • 触发方式：

    • 推送 tag：runner-v<version>（例如 runner-v0.2.0）会自动构建并发布 Release。
    • 手动触发：Actions -> Release Runner (Windows + Linux) -> Run workflow（只产出构建产物）。
  • 产物：

    • AgentLab-Runner-<version>-windows-x64.zip
    • AgentLab-Runner-<version>-linux-x64.tar.gz
    • 解压后直接双击 AgentLab Runner.exe 启动。
本地打包命令（Windows）：
powershell -ExecutionPolicy Bypass -File scripts/build-release-windows.ps1
Git 命令（可直接执行）
以下命令适用于“runner 作为 submodule 挂在主仓”的常见流程。
  1. 在 runner 子仓提交并推送改动（包含 workflow）：
cd runner
git checkout main
git pull --ff-only origin main
git add .
git commit -m "feat(release): add windows exe release pipeline"
git push origin main
  1. 回到主仓提交 submodule 指针：
cd ..
git checkout main
git pull --ff-only origin main
git add runner
git commit -m "chore: bump runner submodule"
git push origin main
  1. 在 runner 子仓打 tag 并触发 Release：
cd runner
git tag -a runner-v1.0.0-m "runner release v1.0.0"
git push origin runner-v1.0.0
完成后到 runner 仓库的 Actions 或 Releases 页面查看产物：
  • AgentLab-Runner-<version>-windows-x64.zip
  • AgentLab-Runner-<version>-linux-x64.tar.gz
自动验证建议
  • 已提供跨平台冒烟测试：.github/workflows/smoke-test.yml
    • windows-latest：启动 start.ps1 -GuiMode web，检测 http://127.0.0.1:18765/ 是否可达
    • ubuntu-latest：启动 start.sh，检测 http://127.0.0.1:18765/ 是否可达
本地验证建议：
  • Linux：优先用 Docker 跑冒烟测试（方便、快）
  • Windows GUI/Electron：优先用 VM（Hyper-V / VMware / VirtualBox）

    • Windows 容器不适合做 Electron 桌面 GUI 测试
快速开始
  1. 安装依赖（任选其一）
    
Linux/Ubuntu（在 runner 独立仓库执行）:
bash scripts/setup-ubuntu.sh --all
中国网络建议（加速 npm/Node 下载）:
bash scripts/setup-ubuntu.sh --all --use-cn-mirror
Windows (PowerShell，在 runner 独立仓库执行):
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll
中国网络建议（加速 npm/Node 下载）:
powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1 -InstallAll -UseChinaMirror
Windows（双击方式，不闪退，推荐给非命令行用户）:
scripts\setup-windows.cmd
Windows（图形化安装器，推荐给小白用户）:
scripts\setup-windows-gui.cmd
Web GUI（跨平台，浏览器界面）:
Linux / macOS:
bash scripts/start-web-gui.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-web-gui.ps1
Windows（卸载本地工具，按需）:
powershell -ExecutionPolicy Bypass -File scripts/uninstall-windows.ps1-RemoveCodex -RemoveClaude -RemoveNode
或：
scripts\uninstall-windows.cmd -RemoveCodex -RemoveClaude -RemoveNode
  1. 启动 runner
Linux/Ubuntu:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash scripts/start-runner.sh
Windows:
powershell -ExecutionPolicy Bypass -File scripts/start-runner.ps1-Server "http://127.0.0.1:3200"-Token "xxxx"
Windows（双击方式）:
scripts\start-runner.cmd
推荐（统一生命周期脚本，自动管理 Web GUI + Runner PID/日志）:
Linux / macOS:
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" ./start.sh
./stop.sh
./restart.sh
Windows:
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
.\stop.ps1
.\restart.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"
默认 start.ps1 使用 desktop 模式（Electron 独立窗口 + 系统托盘，可再次唤出）。
若你要强制浏览器模式，可显式指定：
.\start.ps1 -Server "http://127.0.0.1:3200"-Token "xxxx"-GuiMode web
说明：
  • 脚本会写入 .run/runner.pid、.run/gui.pid。
  • 日志在 .run/runner.log、.run/gui.log。
  • 如果未提供 RUNNER_TOKEN，会只启动 GUI，不会启动 runner daemon。
GUI 安装器支持：
  • 勾选安装 Codex / Claude
  • 勾选中国镜像加速
  • Codex 一键网页登录（自动打开浏览器 + 自动复制设备码）
  • Claude 引导式登录（自动打开登录页 + 自动拉起 claude login 终端 + 提示弹窗）
  • 一键检查登录状态（Check Login Status）
  • 启动后自动检测 Node / Codex / Claude，顶部显示红绿状态灯（可悬浮看路径）
  • 一键卸载所选工具（Codex / Claude / 可选 Node runtime）
  • 多账号槽位：Save Slot / Activate Slot / Delete Slot
  • 余量查询：刷新后展示当前账号 5h / 7d 剩余额度（进度条 + 百分比）
  • 安装时显示“当前步骤 + 下载速率（KB/s/MB/s）”，避免误判卡死
  • 填写 Server/Token 后一键启动 runner
  • 默认中文界面，可一键切换英文；日志提示也会跟随语言切换
备注：Claude 登录是可选项。没有 Claude 账号也可以只使用 Codex 运行。
说明：当前“余量查询”基于 Codex app-server 的 account/rateLimits/read 接口实现。
GUI 结构（v2）
当前 gui/ 已按功能拆分，便于和 AgentLab 主站共用逻辑：
  • app-v2.js: 页面编排与事件绑定
  • modules/api.js: API 请求封装
  • modules/log.js: 日志渲染
  • modules/env.js: 环境检测与状态渲染
  • modules/quota.js: 额度信息渲染
  • modules/slots.js: 多账号槽位管理
  • styles-v2.css: 统一主题变量（暗色 token）
账号槽位说明：
  • 槽位数据保存在 runner/.accounts/windows/<slot>/
  • 本地凭证切换是“文件级切换”，切换后再启动 CLI 即生效
  • 仅适合你自己的机器使用（凭证文件不加密）
  • runner/.accounts/ 已加入 .gitignore，不要把本机凭证提交到仓库
说明：
  • setup-* 脚本会自动安装 runner 依赖（npm install），不需要再手工执行。
  • 默认把 codex/claude 安装到 runner 本地目录（.tools/npm-global），不污染系统全局环境。
  • 若系统没有可用 Node.js，脚本会优先尝试系统安装；失败时回退到 runner 内的便携 Node（.runtime）。
  • 可通过参数自定义下载源：

    • Windows: -NpmRegistry <url> -NodeDistBaseUrl <url>
    • Ubuntu: --npm-registry=<url> --node-dist-base-url=<url>
如果你在主仓库中运行（runner 作为子目录），命令前加 runner/ 前缀即可，例如：
bash runner/scripts/setup-ubuntu.sh --all
RUNNER_SERVER="http://127.0.0.1:3200" RUNNER_TOKEN="xxxx" bash runner/scripts/start-runner.sh
最小必需环境
为了运行 runner，本质必需项只有：
  • Node.js 20+（runner 进程与 CLI 依赖）
  • 至少一个 Agent CLI（Codex 或 Claude Code）
脚本已尽量把“必需安装”收敛到以上两项，不再要求额外全局 npm 环境配置。
关于“右键运行闪退”
  • Windows 的“右键 -> 使用 PowerShell 运行”本身会在脚本结束后自动关闭窗口，容易看不到错误信息。
  • 建议优先使用 scripts\setup-windows.cmd / scripts\start-runner.cmd（已内置 -NoExit），或者在终端中手动执行 .ps1。
可选环境变量
  • RUNNER_SERVER: 服务端地址（默认 http://127.0.0.1:3200）
  • RUNNER_TOKEN: 必填，Runner Token
  • RUNNER_ID: 可选，Runner 唯一标识
  • RUNNER_CODEX_EXECUTION_MODE: auto / sandboxed / unsafe
  • RUNNER_EXTERNAL_TASK_SCAN_ENABLED: 外部任务扫描总开关（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CODEX: 是否扫描 Codex 外部任务（1/0，默认 1）
  • RUNNER_EXTERNAL_TASK_SCAN_CLAUDE: 是否扫描 Claude 外部任务（1/0，默认 0，可快速关闭噪音来源）
  • RUNNER_EXTERNAL_TASK_FILTER_NOISE: 是否过滤 queue-operation 等噪音会话（1/0，默认 1）
认证说明
  • Codex CLI 安装后请自行完成登录认证（例如运行 codex login）。
  • Claude Code CLI 安装后请自行完成登录认证（例如运行 claude login 或配置对应 API 凭证）。
作为独立仓库维护（Git Submodule）
runner/ 本身是独立 Git 仓库，主仓库只通过 submodule 挂载它。
在主仓库中常用命令：
# 初始化/更新 submodule
git submodule update --init --recursive
# 查看 runner 子模块状态
git submodule status runner
更新 runner 代码的推荐方式：
# 进入 runner 子仓库开发cd runner
git checkout -b feat/xxx
# ...修改并提交...
git push origin HEAD
# 回到主仓库，提交 submodule 指针cd ..
git add runner .gitmodules
git commit -m "chore: bump runner submodule"
About
已弃用
Resources
Readme
Activity
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages