raindrop-ai/workshop
GitHub: raindrop-ai/workshop
Workshop是一个本地调试工具,为编程智能体提供实时追踪和自愈评估能力,解决AI开发中缺乏透明度和自动化测试的问题。
Stars: 535 | Forks: 19
# ther word to translate.
**您的智能体缺失的本地调试器。** 在本地实时观察您的智能体思考过程,
就在它发生的那一刻:每一个 token、每一次工具调用、每一个决策。
赋予 Claude Code 读取您的追踪记录、针对您的代码库编写评估并修复问题的能力。
## 安装
```
curl -fsSL https://raindrop.sh/install | bash
```
## 从源代码构建
```
git clone https://github.com/raindrop-ai/workshop.git
cd workshop
bun install
bun run dev
```
`bun run dev` 启动本地 Workshop 守护进程和 Vite UI。启动后打开
`http://localhost:5899`。
## 为您的智能体添加追踪工具
在您的代码库中打开您选择的编程智能体并运行:
```
/instrument-agent
```
这将为您的智能体添加 Raindrop 追踪工具,并在浏览器中打开 Workshop。
就这样。追踪记录会在您的智能体运行时实时流入 UI。
## 功能
- **实时流式追踪。** 每个 token、工具调用和 span 在发生时实时流入 Workshop。无需轮询,无需刷新。
- **编程智能体集成。** Claude Code 读取您的追踪记录,针对您的代码库编写评估,并修复发现的问题。
- **自愈评估循环。** Claude 编写评估,运行您的智能体,观察失败,修复代码,然后重新运行——直到每个断言都通过。
- **本地回放。** `/setup-agent-replay` 脚手架生成一个 HTTP 端点,可将生产环境追踪记录重放到您真实的智能体代码上。
## 全面兼容
- **语言:** TypeScript, Python, Go, Rust
- **SDK:** Vercel AI SDK, OpenAI Agents SDK, Anthropic SDK, Claude Agent SDK,
LangChain, LangGraph, CrewAI, Mastra, Pydantic AI, DSPy, Google ADK, Strands,
Agno, Deep Agents
- **服务商:** AWS Bedrock, Azure OpenAI, Vertex AI
- **编程智能体:** Claude Code, Codex, Devin, Cursor, OpenCode
## 配置
| 环境变量 | 用途 | 默认值 |
| --- | --- | --- |
| `RAINDROP_WORKSHOP_PORT` | HTTP + WS 端口 | `5899` |
| `RAINDROP_WORKSHOP_DB_PATH` | SQLite 数据库文件 | `~/.raindrop/raindrop_workshop.db` |
| `RAINDROP_LOCAL_DEBUGGER` | SDK 端:镜像追踪记录的目的地 | 未设置 |
## Perhaps "CLI" is a common abbreviation that is often used as is in Chinese contexts. I think I should keep it as "CLI" since it's a technical term.
```
raindrop workshop # start and open UI
raindrop workshop setup # write .env, then start and open
raindrop workshop status # check health
raindrop workshop reset # delete local DB after confirmation
raindrop update # update the binary
```
## 许可证
MIT。
标签:AI代理, SDK集成, SOC Prime, 代理开发, 代理评估, 代理调试, 代码修复, 代码评估, 可视化界面, 多语言支持, 安全测试框架, 实时跟踪, 工具调用监控, 开发工具, 开发环境, 性能分析, 数据管道, 日志审计, 本地调试, 编码助手, 自动化攻击, 自愈系统, 跟踪流, 软件工程, 逆向工具