通过 Chrome DevTools Protocol 为 Trae IDE 实现自动化持续工作

License: MIT Node.js Version npm version

• ✅ 完全自动化 - 启动即注入,无需手动操作
• ✅ 非侵入式 - 不修改 Trae 核心文件
• ✅ 多版本支持 - 支持国际版和国内版
• ✅ 场景检测 - 智能识别多种中断场景
• ✅ 状态重置 - 新对话自动重置状态,无缝切换
• ✅ 卡死监控 - 长时间无响应自动尝试恢复
• ✅ 易于扩展 - 支持自定义场景
• ✅ 全局命令 - 安装后可在任何位置使用

• 项目现阶段可以用于实现个人新想法、个人新项目,或者作为参考
• 可以提供相关参考,来实现ai全自动自主变成。
• trae ralph 主要由两个部分组成:CPD 注入js脚本,trae rules 规范
• CPD 注入 js 脚本可以使 trae 一直工作
• trae rules 规范用来规范 trae AI 对项目的开发
• trae ralph 现在的场景检测可能不全面
• trae ralph 现在的场景处理可能会跳过或冲突,这个后面可能会重构场景处理规则来解决
• ⚠️ 现在的危险命令操作,trae 使用了直接执行的方案。注意,谨慎使用,避免对系统造成损害。主要是删除命令
• 需求分析,用户页面生成太简单

• 下载并进入目录 cd Trae-Ralph

• 安装依赖 npm install

• 配置 Trae 路径,需要指定本地trae或者trae-cn 路径 npm run config -- --trae-path "D:\Program Files\Trae\Trae.exe"

• 部署 Ralph 模板到指定项目 npm run rules:inject -- "PrjectPath"

• 使用trae ralph 启动 trae 或者 trae-cn,默认启动国际版 npm run start,启动国内版 npm run start:cn

• 在 trae 中打开项目

• 最好第一次任务时,在对话框输入前面增加 "先加载 Ralph 开发规则,在决定怎么做",点击发送开始trae对话

  先加载 Ralph 开发规则,在决定怎么做
  使用 Ralph 模式开发
  // 需求描述
  

• 点击 "开启 Tralph" 按钮,开启 Ralph 模式

全局安装(推荐):

npm install -g trae-ralph

安装后可以直接使用命令:

trae-ralph config
trae-ralph start

本地开发安装:

git clone https://github.com/your-username/trae-ralph.git
cd trae-ralph
npm install

首次使用需要配置 Trae 路径:

# 全局安装后
trae-ralph config
# 本地开发
npm run config

快速配置(推荐):

# 配置国际版
trae-ralph config --trae-path "D:\Program Files\Trae\Trae.exe"
# 配置国内版
trae-ralph config --cn --trae-path "D:\Program Files\Trae CN\Trae CN.exe"

全局安装后:

# 启动国际版(默认)
trae-ralph start
# 启动国内版
trae-ralph start --cn

本地开发:

# 启动国际版(默认)
npm start
# 启动国内版
npm run start:cn

模板位于 .trae-templates/,可部署到任意项目的 .trae/ 目录:

# 部署到当前项目
trae-ralph setup-trae
# 或者使用 npm script
npm run setup-trae
# 部署到指定目录
trae-ralph setup-trae --path /path/to/project
# 或者使用 npm script
npm run setup-trae -- --path /path/to/project
# 选择性部署
trae-ralph setup-trae --rules 01-ralph-core-concepts,02-architecture-patterns
trae-ralph setup-trae --skills scenario-detection,error-recovery
# 或者使用 npm script
npm run setup-trae -- --rules 01-ralph-core-concepts,02-architecture-patterns
# 增量更新(保留用户自定义文件)
trae-ralph setup-trae --update
# 或者使用 npm script
npm run setup-trae -- --update
# 仅验证模板一致性
trae-ralph setup-trae --validate-only
# 或者使用 npm script
npm run setup-trae -- --validate-only

最好第一次任务时,在对话框输入前面增加 "先加载 Ralph 开发规则,在决定怎么做"

先加载 Ralph 开发规则,在决定怎么做
使用 Ralph 模式开发
// 需求描述

1. 启动 Trae 并开启远程调试端口
2. 通过 CDP 连接到 Trae
3. 注入 JavaScript 脚本
4. 自动检测 AI 工作状态
5. 当 AI 停止时自动发送"继续"命令

内置 6 个场景,自动检测和响应:

• 上下文限制
• 请求限制
• 交互式命令
• 需要确认
• 提前完成
• 长时间思考
• 回复卡死监控 (系统级)

管理场景:

npm run scenarios

可以查看、创建、编辑、删除和测试场景。

配置文件位于 ~/.trae-ralph/config.json:

{
 "version": "1.0.0",
 "trae": {
 "international": {
 "path": "Trae 路径",
 "port": 9222
 },
 "china": {
 "path": "Trae CN 路径",
 "port": 9223
 }
 },
 "defaultVersion": "international"
}

• 配置指南 - 详细配置说明
• 场景系统 - 场景检测和管理
• 元素选择器 - DOM 元素定位
• 更新日志 - 版本更新记录
• 模板系统 - Ralph 模板总览与导航

npm run config

npm run config -- --trae-path "正确的路径"

确保国际版和国内版使用不同端口(9222 和 9223)。

npm run scenarios
# 选择 "6. 测试场景检测"

• Node.js >= 14.0.0
• chrome-remote-interface - CDP 客户端
• Chrome DevTools Protocol - 远程调试协议

MIT License - 详见 LICENSE 文件

如果你在使用过程中遇到问题、有任何建议或者新需求,欢迎通过以下方式联系:

• 📧 邮箱: yhuiche@gmail.com
• 🐧 QQ 群: 点击加入(群号:661990120)
• 🐛 问题反馈: GitHub Issues
• ⭐ 项目地址: github.com/ylubi/Trae-Ralph

提示: 查看 docs/ 文件夹获取详细文档。