Trae SOLO CN 每日签到自动化

从"这是个套壳 Web 吗？"到"自动点击签到"的完整实现记录。

一、需求与想法

Trae SOLO CN（字节跳动面向中文用户的 AI IDE）每天点击左下角头像会弹出一个账户菜单，其中有一项：

每日签到领 200 积分

右侧有一个按钮，未签到时显示为可点击的"签到"类文字；已签到时显示为灰色的"今日已签"。

目标：让电脑每天自动完成这个点击，无需手动打开 Trae、点头像、点签到按钮。

二、关键判断：它是不是"套壳 Web"？

打开安装目录 C:\Program Files\TRAE SOLO CN 检查：

发现	含义
`chrome_100_percent.pak`、`v8_context_snapshot.bin`、`icudtl.dat`	Chromium 内核
`libEGL.dll`、`libGLESv2.dll`	GPU 渲染
`resources/app/` 下有 3615 个文件，没有 `app.asar`	Electron 应用，代码未打包，可直接读取
`main.js` 里出现 `out-build/vs/platform/...`、`webContentExtractorService`	基于 VS Code 内核 fork（和 Cursor 同源）
没有 `WebView2Loader.dll`	排除 Tauri / Wails / CEF-WebView2

结论：TRAE SOLO CN.exe 是 Electron（Chromium 142）+ VS Code 架构 的套壳 Web 应用。左下角头像、签到菜单、设置页全是 DOM，因此可以用 Web 自动化技术操控。

三、技术路线：Chrome DevTools Protocol (CDP)

Electron 应用本质上就是 Chromium。Chromium 提供 远程调试协议（CDP），允许外部程序通过 WebSocket 访问页面 DOM、执行 JS。

3.1 开启调试端口

启动时加上 Chromium 参数：

"C:\Program Files\TRAE SOLO CN\TRAE SOLO CN.exe" --remote-debugging-port=9222

注：上述路径仅为示例。现在脚本会自动定位 Trae 可执行文件（见 6.3），无需手动填写路径。

启动后访问：

http://localhost:9222/json

可以看到类似：

{
  "description": "",
  "devtoolsFrontendUrl": "...",
  "id": "B8FD94AF...",
  "title": "vscode-file://.../solo-lite.html",
  "type": "page",
  "url": "vscode-file://.../solo-lite.html",
  "webSocketDebuggerUrl": "ws://localhost:9222/devtools/page/B8FD94AF..."
}

这就是 Trae 主界面的 WebSocket 调试端点。

3.2 为什么不用 F1 命令

应用内 F1 命令可能被改或隐藏，但 CDP 是 Chromium 底层能力，只要应用是用 Chromium 渲染的，这个通道就绕不开。

四、定位关键元素

连接 CDP 后，在页面里执行 JS 来查找元素。实际探查到的关键选择器：

元素	选择器/特征
左下角头像入口	类名前缀 `accountTrigger`，文本包含 `用户` 的 `<button>`
账户弹窗容器	类名前缀 `accountPopover`、`accountCard`
每日签到标题	类名前缀 `accountCheckinTitle`（文本 `每日签到领 200 积分`）
签到按钮	类名前缀 `accountCheckinButton`
签到按钮文字	类名前缀 `accountCheckinButtonLabel`

由于 CSS 类名是工具生成的哈希后缀（如 accountCheckinButton-hoMtQt），脚本里使用 *[class*="accountCheckinButton"] 这种前缀匹配，比完全固定类名更抗更新。

五、核心脚本设计

项目使用 Node.js >= 18，零第三方依赖（自带 fetch 与 WebSocket）。

流程：

1. 确保 Trae 已开启调试端口
   ├─ 端口已开：直接连接
   ├─ 未运行：自动启动 Trae（带调试端口）
   └─ 已运行但无端口：安全报错，或加 --force 参数强制重启

2. 连接 CDP，定位 workbench page

3. 点击左下角头像打开账户菜单（状态感知，避免重复点击关闭菜单）

4. 在菜单中查找"每日签到"行，读取右侧按钮文本
   ├─ 文本包含"已签" → 今日已签，退出码 2
   └─ 否则 → 点击按钮，等待 2 秒后验证文本是否变为"今日已签"

5. 输出结果并关闭 CDP 连接（加 --close 参数时再关闭 Trae 进程）

脚本入口：src/auto-checkin.mjs。

六、使用方式

6.1 命令行参数（推荐用法）

:: 最简单：自动定位 Trae，默认端口 9222
node src/auto-checkin.mjs

:: 指定 Trae 路径 + 自定义端口
node src/auto-checkin.mjs --dir "C:\Program Files\TRAE SOLO CN\TRAE SOLO CN.exe" --port 9223

:: Trae 已在运行但无调试端口时，强制重启
node src/auto-checkin.mjs --force

:: 独立 profile 隔离测试（不干扰主账号）
node src/auto-checkin.mjs --dir "C:\Program Files\TRAE SOLO CN\TRAE SOLO CN.exe" --port 9223 --force --profile "%TEMP%\trae-test-profile"

:: 签到完成后自动关闭 Trae（适合无人值守/任务计划场景）
node src/auto-checkin.mjs --force --close

:: 查看全部参数说明
node src/auto-checkin.mjs --help

参数一览：

参数	作用	默认值
`--dir <path>` / `--exe <path>`	Trae 可执行文件路径（不传则自动扫描定位）	自动定位
`--port <n>`	CDP 调试端口	`9222`
`--force`	已运行但无调试端口时强制重启（也可 `--force 1`）	关
`--profile <path>`	使用独立 user-data-dir（profile）启动，用于隔离测试	默认账号
`--close`	签到完成后关闭 Trae 进程（适合无人值守）	关

兼容旧用法：以上参数均有对应环境变量 TRAECHECKIN_EXE / TRAECHECKIN_PORT / TRAECHECKIN_FORCE_RELAUNCH / TRAECHECKIN_USER_DATA_DIR / TRAECHECKIN_CLOSE，但命令行参数优先级更高。实际优先级：命令行参数 > 环境变量 > 自动扫描定位。

6.2 首次/手动运行

:: 方法 A：双击 launch-with-debug.bat 启动 Trae（已带调试端口，自动定位 Trae）
:: 方法 B：如果 Trae 已经在运行但无端口，用 PowerShell 强制重启（自动定位）
powershell -ExecutionPolicy Bypass -File scripts\relaunch-with-debug.ps1

:: 运行签到脚本（同样会解析并定位 Trae 路径）
node src/auto-checkin.mjs

6.3 如何定位 Trae（自定义路径 + 自动扫描）

launch-with-debug.bat 与 relaunch-with-debug.ps1 都调用共用的 scripts\locate-trae.ps1 定位；src\auto-checkin.mjs 内实现了等效的 Node 版定位。三处按同一优先级解析 Trae 可执行文件路径：

自定义路径：优先使用命令行参数 --dir/--exe（或 TRAECHECKIN_EXE 环境变量、relaunch-with-debug.ps1 的 -ExePath 参数）。
正在运行的进程：查询系统中正在运行的 TRAE*.exe 主进程，取其真实可执行路径。
注册表卸载项：扫描 HKLM/HKCU 卸载列表里 DisplayName 含 Trae 的安装位置。
常见安装目录：有限深度（3 层）扫描以下位置：C:\Program Files、C:\Program Files (x86)、%LOCALAPPDATA%\Programs、%USERPROFILE%。

因此别人克隆本项目后，无需修改任何代码即可直接运行——只要 Trae 安装在本机，无论装在哪个盘/目录都能被自动找到。

6.4 每日自动签到（Windows 任务计划）

方式一：一键脚本（推荐）

:: 安装：默认每天 12:00 签到
install-schedule.bat

:: 自定义时间（24 小时制），例如每天 09:30
install-schedule.bat 09:30

:: 卸载
uninstall-schedule.bat

脚本会自动用 schtasks 注册名为 TraeDailyCheckin 的任务，每天定时执行：

node "项目目录\src\auto-checkin.mjs" --force --close

--force：Trae 已在前台运行也能带端口重启
--close：签到完成后关闭 Trae，避免常驻占用资源

方式二：手动配置

打开"任务计划程序" → 创建基本任务，每天固定时间触发。
操作选择"启动程序"，程序设为： node "D:\Projects\trae-daily-checkin\src\auto-checkin.mjs" --force --close
建议签到时间设为开机后或午休时间，并勾选"无论用户是否登录都要运行"（需要保存密码）。

如果希望签到后 Trae 保持打开（正常使用时），命令去掉 --close 即可。

七、退出码说明

退出码	含义
`0`	签到成功
`1`	失败/异常（含未登录 `not_logged_in`、找不到按钮、签到后验证不通过等）
`2`	今日已签（无需重复操作）

脚本 [RESULT] 输出中可能出现的 status 值：

status	含义
`success`	真实点击并签到成功
`already_signed`	今日已签
`not_logged_in`	账户未登录（弹窗里出现"登录/扫码"等入口），需要先手动登录
`click_failed`	找到了按钮但点击失败
`unknown`	点击后按钮文字未变成"今日已签"，需人工查看

八、验证结果

8.1 端到端签到测试（9223 端口，独立新登录账号）

在某次"未登录 → 手动登录"的新账号实例上，跑了一次完整的真实签到：

cd /d "D:\Projects\trae-daily-checkin" && node src\auto-checkin.mjs --port 9223

日志输出：

[OK] 调试端口已开放
[INFO] 点击左下角头像...
[INFO] 签到按钮状态: {"buttonText":"签到","title":"每日签到领 200 积分"}
[INFO] 尝试点击签到按钮...
[RESULT] { "status": "success", "detail": "今日已签" }

脚本走通了真实流程：连接新实例 CDP → 点击左下角头像弹出账户菜单 → 读到签到按钮文字为「签到」（未签状态）→ 真实点击按钮 → 验证按钮文字变成「今日已签」，退出码 0。

8.2 已有账号"今日已签"状态识别

另一次测试中，脚本正确识别到"今日已签"状态：

调试端口成功打开：

VERSION: Chrome/142.0.7444.235
[page] vscode-file://.../solo-lite.html

脚本正确识别到"今日已签"状态，输出：

{
  "status": "already_signed",
  "detail": "今日已签"
}

说明自动化链路完全跑通；当按钮可点击时，脚本会真实点击并完成签到。

8.3 独立 profile 测试（不干扰主账号）

Electron 默认单实例：如果 Trae 已在运行，再带端口启动新实例不会生效。为了在一个"干净的新账号"上验证，而不影响主账号，可以用独立的 user-data-dir（profile）：

:: 指定独立 profile + 独立端口，并强制重启到新实例（未登录）
node src/auto-checkin.mjs --port 9223 --force --profile "D:\temp\trae-test-profile"

首次运行会用独立 profile 打开一个全新窗口，需手动登录一次（该登录态只保存在这个独立 profile 里，不影响主账号）。之后再运行脚本即可完成真实签到。验证过程中，主账号（9222 端口）全程不受影响。

说明：此方式是"带端口启动已在运行的 Trae 无效"限制的绕过手段——不同 --user-data-dir 会被 Electron 视为不同实例，因此可以和主账号并存。

九、已知限制与注意事项

CSS 类名可能随更新变化：脚本使用 class*="前缀" 匹配，但仍需在 Trae 更新后抽查一次。
调试端口的安全风险：--remote-debugging-port=9222 只监听 127.0.0.1，本机安全；但任何本机进程都能连接，公用电脑不建议长期开启。
单实例限制：Electron 单实例机制导致"带端口启动"在已有实例运行时不会生效，因此脚本在冲突时默认安全退出，并提供强制重启选项。
UI 弹窗/网络失败：如果签到接口失败，按钮文本不会变成"今日已签"，脚本会返回 unknown，此时需要人工查看。

十、项目文件说明

trae-daily-checkin/
├── package.json                  # 项目元数据
├── README.md                     # 本文件
├── launch-with-debug.bat         # 双击启动 Trae（带调试端口，自动定位路径）
├── install-schedule.bat          # 一键注册"每日自动签到"任务计划
├── uninstall-schedule.bat        # 删除"每日自动签到"任务计划
├── scripts/
│   ├── locate-trae.ps1           # 通用定位 Trae 路径（进程/注册表/常见目录，可单独调用）
│   └── relaunch-with-debug.ps1   # 强制重启 Trae 并开放端口（复用 locate-trae.ps1 定位）
└── src/
    └── auto-checkin.mjs          # 自动签到主脚本（Node 版路径定位：自定义/自动扫描）

十一、后续可扩展

增加截图/日志落盘，方便排查失败原因。
在 Windows 任务计划里直接触发，实现完全无人值守。
如果 Trae 未来封禁 CDP，可以改用 无障碍 API（MSAA/UIA） 或 Playwright 的 Electron 支持 作为备用方案。

实现日期：2026-08-19

Navigation Menu

Repository files navigation

Trae SOLO CN 每日签到自动化

一、需求与想法

二、关键判断：它是不是"套壳 Web"？

三、技术路线：Chrome DevTools Protocol (CDP)

3.1 开启调试端口

3.2 为什么不用 F1 命令

四、定位关键元素

五、核心脚本设计

六、使用方式

6.1 命令行参数（推荐用法）

6.2 首次/手动运行

6.3 如何定位 Trae（自定义路径 + 自动扫描）

6.4 每日自动签到（Windows 任务计划）

七、退出码说明

八、验证结果

8.1 端到端签到测试（9223 端口，独立新登录账号）

8.2 已有账号"今日已签"状态识别

8.3 独立 profile 测试（不干扰主账号）

九、已知限制与注意事项

十、项目文件说明

十一、后续可扩展

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
scripts		scripts
src		src
.gitignore		.gitignore
README.md		README.md
install-schedule.bat		install-schedule.bat
launch-with-debug.bat		launch-with-debug.bat
package.json		package.json
uninstall-schedule.bat		uninstall-schedule.bat

Latest commit

History

Folders and files

Repository files navigation

Trae SOLO CN 每日签到自动化

一、需求与想法

二、关键判断：它是不是"套壳 Web"？

三、技术路线：Chrome DevTools Protocol (CDP)

3.1 开启调试端口

3.2 为什么不用 F1 命令

四、定位关键元素

五、核心脚本设计

六、使用方式

6.1 命令行参数（推荐用法）

6.2 首次/手动运行

6.3 如何定位 Trae（自定义路径 + 自动扫描）

6.4 每日自动签到（Windows 任务计划）

七、退出码说明

八、验证结果

8.1 端到端签到测试（9223 端口，独立新登录账号）

8.2 已有账号"今日已签"状态识别

8.3 独立 profile 测试（不干扰主账号）

九、已知限制与注意事项

十、项目文件说明

十一、后续可扩展

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages