> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codebanana.com/llms.txt
> Use this file to discover all available pages before exploring further.

> CodeBanana 的本地运行版本，一款直接运行在您电脑上的桌面端 AI Agent。

# 产品介绍

## 什么是 CodeBanana Bot

与 Web 版本不同，CodeBanana Bot 运行在您的本地环境中，使 Agent 能够与您的 **文件、应用程序、浏览器和系统** 直接交互，将 AI 能力从云端扩展到您的个人工作空间。

## Web 与 CodeBanana Bot 的区别

CodeBanana Bot 与 Web 版本是 **同一产品的两种形态**，共享同一套账号体系，并保持数据同步。

| 维度         | Web              | CBBot          |
| ---------- | ---------------- | -------------- |
| 运行环境       | 基于浏览器            | 本地桌面应用         |
| 核心功能       | 完整产品能力（项目、聊天、组织） | 相同的核心能力        |
| Agent 作用范围 | 云端项目与环境          | 本地系统、文件、应用、浏览器 |
| 账号         | 共享               | 共享             |
| 项目可见性      | 云端 + 本地（客户端在线时）  | 云端 + 本地        |
| 最适合        | 协作与便捷访问          | 深度本地自动化        |

> 两个端都会展示相同的项目列表。云端项目始终可访问，而本地项目仅在客户端在线时可用。

***

## 安装

CodeBanana Bot 同时支持 macOS 和 Windows。

| 平台      | 支持情况 |
| ------- | ---- |
| macOS   | ✅    |
| Windows | ✅    |

### 步骤

1. 从 CodeBanana 官网下载安装包
2. 安装：
   * macOS：打开 `.dmg` 并拖动至 Applications
   * Windows：运行 `.exe` 安装程序
3. 启动 CodeBanana Bot，并使用您的账号登录

***

## 登录与同步

### 账号

* 使用与 Web 相同的 CodeBanana 账号
* 支持邮箱登录与第三方登录
* 可同时在 Web 和 CBBot 保持登录状态

### 数据同步

| 数据        | 表现方式             |
| --------- | ---------------- |
| 账户信息      | 实时同步             |
| 账单与套餐     | 跨平台共享            |
| 组织        | 共享成员与权限          |
| Team Plan | 完全同步             |
| 云端项目      | 完全同步             |
| 本地项目      | 已同步；当客户端离线时显示为离线 |
| 聊天记录      | 跨设备同步            |

> 项目配置（Basic Info、Skills、Cron Jobs）是项目级设置，但在不同平台之间保持一致。

***

## 本地 Agent 能力

CodeBanana Bot 支持 Agent 直接在您的 **本地设备** 上执行操作。

### 系统控制

* 读取、创建、修改、删除文件
* 移动文件并进行批量处理
* 执行终端命令与脚本
* 访问系统级信息

### 应用控制

* 打开本地应用程序
* 模拟用户交互（点击、输入等）

### 浏览器自动化

* 浏览网页
* 填写表单并提取数据
* 模拟完整的浏览操作流程

### 屏幕理解

* 捕获屏幕内容
* 分析界面状态
* 校验操作结果

***

## 典型使用场景

| 场景    | 工作流                 |
| ----- | ------------------- |
| 文件整理  | 扫描 → 分类 → 移动文件      |
| 表单自动化 | 打开浏览器 → 填写 → 提交     |
| 报告生成  | 捕获屏幕 → 分析 → 生成报告    |
| 文件监控  | 通过 File Watch 触发工作流 |
| 应用自动化 | 打开应用 → 执行动作         |

***

## Bot 专属功能

### Bot 专属 Skills

CodeBanana Bot 支持 **仅限 Bot 使用的 Skills**，其中包含本地系统操作能力。

| 类型              | 可用范围               |
| --------------- | ------------------ |
| Standard Skills | Web + Bot          |
| Bot-only Skills | 仅 Bot 可用（`Bot` 标签） |

***

### Cron Job 差异

| 能力            | Web   | CBBot    |
| ------------- | ----- | -------- |
| 定时任务          | ✅     | ✅        |
| 系统通知          | ❌     | ✅        |
| File Watch 范围 | 仅项目文件 | 完整本地文件系统 |

***

## 项目状态

| 类型            | 位置   | 可用性       |
| ------------- | ---- | --------- |
| Cloud Project | 服务器  | 始终可用      |
| Local Project | 本地设备 | 客户端离线时不可用 |

```text theme={null}
Projects
├── Cloud Project A (始终可用)
├── Cloud Project B (始终可用)
├── Local Project C (在线时可用)
└── Local Project D (在线时可用)
```