Trae Ralph Loop CDP

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

特点

• ✅ 完全自动化 - 启动即注入，无需手动操作
• ✅ 非侵入式 - 不修改 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

常用命令

命令	说明
npm run config	配置 Trae 路径
npm run config -- --trae-path "路径"	快速配置国际版
npm run config -- --cn --trae-path "路径"	快速配置国内版
npm start	启动国际版
npm run start:cn	启动国内版
npm run inject	注入到已运行的国际版
npm run inject:cn	注入到已运行的国内版
npm run scenarios	管理场景
trae-ralph setup-trae	部署 Ralph 模板到当前项目

Ralph 模板系统

模板位于 .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/ 文件夹获取详细文档。