AiPy 开源版和 AiPy Pro 有什么区别?该装哪一个
装 AiPy 之前先得回答一个问题:装哪个? GitHub 上有个开源仓库 knownsec/aipyapp,官网上有个客户端下载按钮,两者名字都叫 AiPy,但拿到手完全不是一回事。搞混了会白折腾一整天——比如想在服务器上跑却去下了客户端安装包。
一、官方自己怎么划这条线
FAQ 里有一条问题就叫「开源版 AiPy 和 AiPy Pro 有什么区别」,官方回答只有一句话:
AiPy 是项目的开源引擎适合极客使用;AiPy Pro 是面向普通用户的客户端版本,客户端版本对普通人更易用。
这句话信息量不大,但定了调:开源版是引擎,Pro 是产品。 引擎给你内核,产品给你内核加上一整圈外围设施。
二、两边共享的内核:Python-use
要理解这两个版本的关系,得先看仓库 README 里那个概念——Python-use。
README 的原话是:Python-use 是把整个 Python 执行环境提供给 LLM 使用,可以想象为 LLM 坐在电脑前用键盘在 Python 命令行解释器里输入各种命令、按回车运行、然后观察执行结果、再输入代码和执行。
紧接着有一句对比,这句才是关键:
和 Agent 的区别是 Python use 不定义任何 tools 接口,LLM 可以自由使用 Python 运行环境提供的所有功能。
「不定义任何 tools 接口」,这是 AiPy 和大多数 Agent 产品在设计上的分岔口。常见做法是给模型一组封装好的工具(读文件、发请求、查数据库),模型在这组工具里选;Python-use 的做法是不给工具清单,直接给一个 Python 解释器,能力边界等于 Python 生态本身的边界。
这个选择的好处在 README 的动机里说得很清楚:数据工程师处理 csv、excel、json、html、sqlite、parquet 这些格式,常规流程是启动 Python、import pandas as pd、敲一堆命令、生成一堆中间临时文件,中途还得去找 AI 描述需求、手工拷贝生成的代码回来运行。Python-use 要省掉的就是这个来回搬运的动作。
代价也是真实的。站内文章 AiPy 智能体集市怎么用 里提到官方手册的一条说明:如果不指定生图智能体,AiPy 可能直接编写 Python 脚本来画图,效果不佳。 这就是「什么都能用代码硬做」的另一面——它不会承认自己不擅长,会硬写。Pro 的智能体集市,某种程度上就是给这个范式补上的「专业工具层」。
两个版本共享这个内核。区别在内核外面。
三、开源版给你什么
两种运行模式。 README 写明有任务模式和 Python 模式:任务模式非常简单易用,直接输入你的任务即可,适合不熟悉 Python 的用户;Python 模式适合熟悉 Python 的用户,既可以输入任务也可以输入 Python 命令。默认是任务模式,通过 --python 参数切换。
两种模式的数据互通,这点 README 特意强调了:aipython 处理完你的自然语言命令后,你可以用标准 Python 命令查看各种数据。也就是说 AI 跑完之后留在内存里的变量,你能接着自己查——这对调试和验证很有用。
配置极简。 README 给的最小配置就是在 ~/.aipyapp/aipyapp.toml 里写一段 [llm.xxx],填 type 和 api_key,就能跑。
装第三方库要你点头。 README 里展示了这个交互:模型需要某个包时会打出「LLM 申请安装第三方包」并列出包名,等你输入 y 或 n。默认是 n。这是开源版唯一的、也是最原始的一道闸门。
MCP 靠命令行管。 源码里有一整套 mcp 子命令(status / enable / disable / server),细节见 AiPy 怎么接 MCP 服务。
能部署到服务器。 FAQ 明确说开源版本可部署于服务器中。这是它相对客户端唯一的、但也是决定性的场景优势。
四、Pro 独有的那一大圈
把官方 FAQ 和使用指南里归属客户端的能力列出来,能看到 Pro 补的东西相当多:
智能体集市。 FAQ 的说法是 AiPy Pro 集市中拥有海量智能体,包括官方精品 APP、MCP 工具、Skills,同时支持用户自定义添加。开源版没有这一层。
安全中心。 这是 Pro 2.0 引入的,手册里拆成好几块:启用安全沙盒后所有新启动的任务隔离运行在本地沙盒环境;文件安全可以给文件或文件夹单独分配只读或完全访问权限;命令安全的规则逻辑是匹配允许或禁止列表,不在列表内的命令执行前弹出询问确认;网络安全可分别针对域名、IP 地址、端口设置允许或拒绝规则;日志审计做到敏感操作全程留痕、日志不可篡改。此外还有删除保护——任务过程中删除的文件优先进回收站,开启后还能配置批量删除审批,一次性删除达到一定数量时需要人工审批。
对比一下就明白差距在哪:开源版的安全边界只有「装包要你点头」这一条;Pro 把文件、命令、网络三个维度都做成了可配规则。 如果你打算让 AI 在有真实数据的机器上干活,这一层不是可选项。
工作空间。 支持自定义工作目录,并可针对工作空间配置文件安全、命令安全、网络安全等策略,把敏感操作和日常任务分置在不同工作空间运行。
定时任务。 可以设置每日定时执行的任务并指定使用的智能体。有个前提条件手册标了:需要保持 AiPy Pro 客户端在线运行,不可退出,否则定时任务无法执行。 想要真正不间断,官方的方案是把开源版放云主机——这两条路在这里交汇了。
手机控制。 支持微信、企业微信、QQ、飞书四种通讯软件来控制 AiPy Pro。微信是最简单的,扫描 AiPy 中的二维码即可,扫描连接成功后需要重启客户端。手机微信版本有下限要求,官方使用指南(2026-08-24 快照)括注的是 v8.0.69 及以上,微信太旧的话扫了也连不上。企业微信、QQ、飞书需要去各自的开发平台创建机器人,拿到 APP ID 和 APP Secret 填进去。
数字秘书与玄幻模式。 FAQ 说明 AiPy Pro 2.0 正式上线了数字秘书模式,支持全语音交互,由数字秘书按指示干活、汇报进度、展示成果。手册给了具体用法:可以把 AiPy 窗口隐藏只保留数字秘书,长按 F8 或鼠标长按麦克风按钮跟它对话,中途还能语音问进度。玄幻模式则是一套沉浸式界面皮肤,2.0 里做了升级。
模型管理。 FAQ 说本地模型、OpenRouter、阿里百炼、火山方舟等 API 都支持,AiPy Pro 用户在客户端设置里添加。注意手册里有一条门槛:使用自定义模型需要账号等级达到官方规定的等级,靠积分升级(具体积分数值以客户端内说明为准,这类规则会调整)。
其他零碎但实用的。 提示词优化(2.0 起可以在对话框右下角一键优化提示词)、风格与记忆、经验沉淀、数据迁移(导出所有任务数据和 .aipyapp 目录下的全部文件,在另一台电脑导入即可同步)、镜像源与代理设置、重置运行环境。
五、平台支持不一样
| 开源引擎 aipyapp | 客户端 AiPy Pro | |
|---|---|---|
| Windows | 支持(需 Python 环境) | 支持,官方标注 Windows 10 及以上 |
| macOS | 支持(需 Python 环境) | 支持,分 Apple 芯片版与 Intel 芯片版 |
| Linux 服务器 | 支持部署 | 不适用 |
| 国产信创系统 | 命令行版支持 | 官方称完美适配麒麟、统信及海光 CPU |
信创这一栏两边都覆盖,但客户端在统信上需要额外放开签名验证,这一步的细节和取舍在 AiPy 怎么安装 里讲了。
六、该装哪个
按目的对号入座:
你是普通用户,想让电脑上多个能干活的助手 —— 装 Pro。集市、安全沙盒、图形界面这些不是锦上添花,是让这个产品能被正常使用的前提。开源版没有集市,意味着你得自己解决「生图变线条」这类问题。
你要 7×24 无人值守 —— 走开源版上云主机。Pro 的定时任务要求客户端一直开着,笔记本合盖就断。手册里那套「云主机装 aipy 加通讯软件机器人」的组合,才是不间断方案。
你要读代码、改行为、集成进自己的系统 —— 只能是开源版。仓库里 aipyapp/aipy/、aipyapp/exec/、aipyapp/llm/ 几个目录把任务管理、代码执行、模型客户端拆得很清楚,改起来有下手的地方。
你在企业里评估 —— 两个都要看,但重点看 Pro 的安全中心那一套是否够用。开源版没有命令白名单和网络规则,把它直接放到有生产数据的机器上,风险敞口是你自己扛。
七、关于官方的自我定位,标注一下
FAQ 里有一条「AiPy 有哪些独创的技术创新」,官方给了两点自述:一是 AiPy 于 2025 年 4 月正式推出,称是全球较早实现大模型驱动、桌面端完整任务闭环的桌面通用智能体之一,发布时间早于 Claude Code、Claude Cowork、WorkBuddy 等同类产品,同时也是国内较早的本地开源通用智能体项目之一;二是独创全语音数字秘书模式,称多数同类产品仅支持语音转文字输入,无法形成完整语音交互闭环。
这两段是官方口径,不是本文的结论。 发布先后和「同类产品做没做到」这类判断需要逐个核对各家的公开发布记录,本文没有做这件事,因此原样标注来源、不做背书也不做否定。你在做选型时,涉及横向比较的说法建议都回到各家官方文档自行核对。
核实边界
本文依据 2026-08-24 抓取的以下官方内容写成:AiPy 官方常见问题页 https://www.aipyaipy.com/faq.html 与 https://www.aipy.app/faq.html、官方使用指南 https://www.aipyaipy.com/manual/、中国官网 https://www.aipyaipy.com/ 与海外站 https://www.aipy.app/,以及开源仓库 https://github.com/knownsec/aipyapp 的中英文 README。
没核到、因此本文没写的部分:Pro 的价格、套餐与积分规则的具体数值(会调整,以客户端内实时说明为准);集市中智能体的数量与名单;两个版本的具体版本号与发布节奏;开源版与 Pro 在同一任务上的实际效果差异(需要实际运行对比,作者没有安装运行过任何一个版本);官方自述中涉及友商发布时间先后的说法,本文只做转述、未独立核实。