# 怎么让 AI 在手机上运行 Python？

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：模型与 AI 能力。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/python_runtime/

## 功能说明

应用内置完整的 Python 3.12，随应用安装，不需要下载或配置。打开 **代码工作台** 工具后，AI 会在需要时直接在手机上运行 Python：表格筛选统计、数据分析与画图、批量处理文件、生成 Word / PPT / PDF 都可以交给它。

- 自带 pandas、numpy、openpyxl、matplotlib（已配中文字体）、Pillow、lxml 等常用库。
- python-docx、python-pptx、pypdf、pdfplumber 等常见库在首次用到时自动安装（需要联网），装好后长期保留。
- 同一对话里算好的变量和数据会保留，后续可以接着处理。
- 技能文档里写的命令行（如 `python scripts/x.py`、`pip install`）用应用内模拟的 bash 执行。
- MCP 服务可以填写 `uvx`、`pipx run`、`python -m` 启动命令，在内置 Python 环境里运行。

## 怎么使用

1. 在输入框 **工具 → 选择工具** 开启 **代码工作台**（推荐组合已包含）。
2. 把要处理的文件放进对话：用 **@** 引用，或在会话文件里导入。表格、数据类文件放进工作区让 Python 处理，比整篇直接发给 AI 更省上下文。
3. 直接说要做什么，例如「按部门统计这张表的平均分并画柱状图」「把这 20 张图片统一裁成 1:1」。
4. 回复里的代码卡片显示每段代码做了什么、用时多久；展开后可以看输出和代码。生成的文件出现在「生成文件」卡片里，可以预览、保存或分享。
5. 设置 → 连接与高级 → **Python 运行环境** 可以查看运行状态和已安装的包，也可以一键清除自己装的包。

## 最佳实践

- 需要精确计算、统计或批量处理时，明确说「用 Python 算」，结果比让模型心算可靠。
- 想用 Skill 市场的 PDF、Excel、Word、PPT、海报设计、GIF 动图等技能，安装后在助手中启用，或在输入框用 **/** 指定。技能详情会标出「本机可运行」「部分可用」或「需要外部环境」。
- 不能运行系统程序（如 LibreOffice、Node.js），需要编译的 Python 包也装不上，AI 会改用纯 Python 的办法；依赖 npx、Docker 的 MCP 服务请改用它的远程地址。
- 首次自动安装库需要联网，在弱网下可能稍慢；安装失败时 AI 会看到原因并换用其他办法。