> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/zh/tools/code-development.md).

# 代码与开发

Crew 可以编写和执行 Python 代码、分析数据、创建可视化图表，甚至修改你 GitHub 仓库中的代码。

## Python 沙箱

Crew 在安全、隔离的沙箱环境中运行 Python 代码。每次执行都从全新的环境开始。

### 数据分析

> "分析这个 CSV 文件——找出收入最高的前10个客户，计算月度趋势，生成一张可视化图表。"

> "读取这个 Excel 表格，创建一个按地区和产品类别展示销售额的数据透视表。"

> "计算这组数据中营销支出和营收之间的相关性。"

### 图表创建

> "用这组数据生成一张月度营收柱状图：\[粘贴或上传数据]"

> "帮我生成一张折线图，对比我们三条产品线过去一年的表现。"

> "帮我做一个费用分布的饼图。"

### 数据处理

> "清洗这个 CSV——去重、修正日期格式、处理缺失值，然后保存清洗后的版本。"

> "用'客户ID'列合并这两个表格，生成一份合并报告。"

> "把这个 JSON 文件转换成格式规范的 CSV。"

### 预装库

沙箱预装了以下 Python 库：

* **pandas** — 数据操作和分析
* **numpy** — 数值计算
* **matplotlib** — 图表和可视化
* **openpyxl** — Excel 文件读写
* **python-docx** — Word 文档处理
* **Pillow** — 图片处理
* **lxml** — XML/HTML 解析

### 工作原理

1. 你向 Crew 提出数据处理需求
2. Crew 编写 Python 代码
3. 代码在隔离的沙箱中运行
4. 结果（文本输出、文件、图表）返回给你

### 沙箱限制

| 套餐    | 最大执行时间 |
| ----- | ------ |
| Free  | 30 秒   |
| Basic | 120 秒  |
| Plus  | 300 秒  |
| Pro   | 300 秒  |

### 文件配合使用

上传文件后再要求执行代码时，文件会自动加载到沙箱中：

> \[上传 sales\_data.xlsx] "分析这个表格，生成一份带图表的摘要报告。"

输出文件（图表、处理后的数据、生成的文档）会保存到 我的文件。

## GitHub 集成

> **套餐要求：** Pro 套餐

### 仓库管理

> "列出我的 GitHub 仓库。"

> "帮我看看 my-org/my-repo 有哪些未解决的 Issue。"

> "哪些 PR 在等待我审查？"

### API 访问

Crew 可以完整访问 GitHub API，因此你可以：

* 创建和管理 Issue
* 审查 Pull Request
* 检查 CI/CD 状态
* 管理仓库设置
* 以及 GitHub API 支持的所有其他操作

## 编程代理

编程代理可以自主修改你的 GitHub 仓库代码：

> "在 my-org/frontend-app 中，修复登录表单的问题。提交按钮在手机上不能用。"

> "在 my-org/web-app 中给注册表单添加输入验证。"

> "在 my-org/api-server 中重构数据库模块，使用连接池。"

### 工作原理

1. 你描述想要的代码变更
2. Crew 在安全环境中克隆你的仓库
3. Agent 阅读代码，理解结构，然后进行修改
4. 将变更提交到新分支
5. 创建 Pull Request 供你审查

Agent 在后台运行——PR 准备好后会通知你。

### 最佳实践

* **描述要具体**：详细说明你想要的行为，而不仅仅是"修复 Bug"
* **提及文件**：如果你知道哪些文件需要修改，记得提到
* **务必审查**：Agent 创建 PR 但绝不会直接推送到 main 分支——合并前务必审查

## 实用场景

### 数据分析流水线

> \[上传 quarterly\_data.xlsx] "分析这份季度数据：1）计算每条产品线的同比增长率，2）为前3项关键指标创建图表，3）生成一份包含所有发现的 PDF 报告。"

### 快速计算

> "计算10万元人民币按年利率5%复利计算10年的金额，按月复利。展示每年的余额表格。"

### 文件格式转换

> "把这个 JSON API 响应转换成一个列标题清晰的 Excel 表格。"

### 网页抓取 + 分析

> "帮我搜索世界500强名单，提取公司名称和营收数据，生成一张展示前20名营收的图表。"

### 自动报告（搭配定时任务）

> "设置一个每周一早上9点的定时任务：从 \[API URL] 获取最新数据，分析趋势，创建图表，然后把报告发到我的邮箱。"

## 小贴士

* **先上传文件**：先附上表格和数据文件，再提出分析需求
* **指定输出要求**："做一张图表"可以；"做一张柱状图，Y轴是月度营收，X轴是月份，按产品线用不同颜色区分"更好
* **逐步优化**：如果第一次分析结果不理想，让 Crew 调整——它记得之前的上下文
* **保存结果**：让 Crew 把重要的输出保存到 我的文件 或 Google Drive
* **搭配邮件**："分析数据，生成报告，然后发邮件给团队"
* **需要更深入？** 如果需要复杂的多步骤分析或精美排版的研究报告，试试 [Deep Work](https://docs.crew.you/zh/tools/deep-work.md)
