Forkybot AI：优化且安全的 Bytebot

这是 Bytebot 的一个经过优化和安全加固的分支，Bytebot 是一个开源 AI 代理，可控制虚拟桌面以自动化复杂任务。

原项目已被归档且无人维护。本分支挽救了这一构想，对其进行了现代化改造，并使其达到生产就绪状态，应用了软件工程、安全和文档方面的最佳实践。

🎯 这个项目做什么？

想象一位拥有自己电脑的虚拟员工。你可以用自然语言给它下达指令，例如*“从这个月我的三个供应商门户下载发票，并把它们整理到一个文件夹中”*，代理就会打开浏览器、浏览各个门户、下载文件并整理它们。全程自主完成，但你随时可以接管控制权（Human-in-the-loop，人在回路中）。

✨ 关键改进（工程阶段）

本分支并非简单的复制。我们进行了三个工程阶段，将其提升到新的水平：

阶段 A：安全（CVE-2026-78250 补丁）

• 无限循环缓解：实现了可配置的安全限制（MAX_TASK_ITERATIONS 和 TASK_TIMEOUT_MS），以防止拒绝服务（DoS）和不受控制的 API 开销。
• Human-in-the-loop：如果任务超出限制，它不会失败。它会转换为 NEEDS_HELP 状态，以便由人工介入并恢复任务。

阶段 B：优化（体积缩减 85%）

• 迁移至 Debian Bookworm-slim：保持与 glibc、VS Code 和 1Password 的完全兼容性，但移除了不必要的软件和编译工具。
• 多阶段构建：最终镜像体积从 ~7 GB 缩减至 ~1.09 GB，提高了效率并减少了攻击面。
• 深度清理：移除了 Thunderbird、xfce4-goodies 和冗余的编辑器。

阶段 C：集成验证（冒烟测试）

• 验证了桌面、代理、UI 和数据库的并发启动。
• 检查了内部通信（VNC 端口 9990）和外部通信（UI 端口 9992）。

📚 活文档（Obsidian）

本分支的一大贡献是其项目大脑，一个 Obsidian 库（vault/），作为上下文，让 AI（以及人类）在架构中导航而不迷失方向。它包括：

• ADR（架构决策记录），解释每项变更的原因。
• 针对代理、UI 和虚拟桌面的详细文件地图。
• 工作协议（PROTOCOLO_TRABAJO.md 和 PROTOCOLO_OBSIDIAN.md），定义 AI 代理在本项目中应如何工作。

🛠️ 使用的技术

• 代理：NestJS（Node.js 20 Alpine）
• 虚拟桌面：Debian Bookworm-slim、XFCE、Xvfb、TigerVNC
• 前端：Next.js 15、Tailwind CSS、noVNC
• 数据库：PostgreSQL 16
• 基础设施：Docker、Docker Compose、多阶段构建

🚀 如何开始

# 克隆仓库
git clone https://github.com/TU_USUARIO/forkybot_AI.git
cd forkybot_AI

# 配置环境变量（例如 Gemini API Key）
echo "GEMINI_API_KEY=tu_clave_aqui" > docker/.env

# 启动技术栈
docker-compose -f docker/docker-compose.yml up -d

# 访问界面
# 在浏览器中打开 http://localhost:9992