我这两天把号里 Pi 系列的五篇文章从头翻了一遍,发现一件事。

五篇里,没有一篇解释过:这个 Pi 和大多数人听过的那个 Pi,没有任何关系。

这是我的疏忽。写第一篇的时候我以为大家都懂,写到第五篇才发现,同一个名字底下已经站了三样东西。

同名最麻烦的地方不是装错,是你从此不再看。

所以这篇只干一件事:先把三样东西摆到一张表上,再给你一个三十秒能做完的判定。

先说清到底是两个还是三个,这一步最容易绕。

世界只有两个。一边是写代码的,一边是手机上点一下的,这两边毫无关系。

但"桌面版"这个东西,两边各有一个;写代码那边除了桌面版,还多一个终端里的本体。

两个世界,三样东西。所以你会看到两个都叫 Pi Desktop,还有一个干脆就叫 Pi。

一张表看完,三样各占一列。下面逐样说,前两样我能给出真截图,第三样只有文字,原因写到那一节里。

第一样,pi.dev,本体在终端里

这是 pi.dev 的首页,我今天早上截的。最上面一行公告写着 Pi 1.0 已经发布,中间那句英文的意思很直白:市面上的 agent 框架一大把,这一个归你改。

下面那个黑框里是一行命令,粘进 PowerShell 回车就装完了。旁边还有 curl、npm、pnpm、bun 四个标签,你想用哪个都行。

我特意把这一屏放最前面,因为它一句话就说清了身份:Pi 是个跑在命令行里的编码 agent,装它的方式是粘一条命令。

一个挖矿项目不会让你在终端里敲 powershell。它会让你下载一个手机 App,注册账号,填邀请码。

而这个动作,恰好是总览表最后一列的全部流程。记住这个对照,后面很多事一眼就能分。

第二样,PI-Desktop,社区给它配的驾驶舱

它叫 PI-Desktop,仓库在 vastsa/PI-Desktop,作者是社区里的独立开发者,不是 Pi 官方。许可证 LGPL-3.0,我截图那一刻是七千六百多 star。

仓库简介里有一句写得很明白:Local-first AI coding agent desktop,用的引擎是 pi Agent Harness。翻译过来就是,Pi 提供发动机,PI-Desktop 给它配了驾驶舱和仪表盘。

它干的事,是把终端里靠命令和记忆完成的那一套,摆到界面上:开项目、管会话、装插件、调权限,原来要记的参数变成能点的按钮。

这跟第一样是同一个世界的两件东西,一个是引擎,一个是方向盘。

这是它的发布页,左边一整列版本号,最新是 0.22.0-beta.3 预览版,稳定版停在 0.21.0。

记住这个数字,它比名字好用。

第三样,Pi Desktop 0.6.4,矿圈那个

Pi Network 那个项目从 2019 年跑到现在,2025 年 2 月开放主网,按它自己公开的数字有六千万注册用户,靠的是手机点一下算活跃。它的逻辑跟算力无关,跟你在手机上出现的次数有关。

它自家的桌面客户端,版本号是 0.6.4,用途是让用户的电脑当自己的服务器,跑一些本地的小应用,再从手机上的浏览器访问。

那篇官方博客里还写了这么一句:这些跑在本地的小应用,可以是 AI agents。

这一样我没法给你截图。它官网从我这边打不开,代理和直连都超时,试了三次。上面这些版本号和那句 agent 说明,都是从公开文本里核的,不是看图说话。

撞就撞在这儿:三样里有俩都在说"桌面上的 AI",一个带界面的编码工具,一个能跑 agent 的本地服务器,光看介绍分不出来。

三者的关系就这么点:左边两个是同一棵树,右边那个只是同名。

三样东西,三种用法

看区别最快的办法只有一个:问自己现在要干什么。

想在终端里改代码、批量处理文件,装第一样,一条命令的事。

想要图形界面、不想天天敲命令,装第二样。这两样可以同时装在一台机器上:一个当引擎,一个当方向盘,不冲突。

第三样得先问自己一句:我真的需要一台随时在线、只归我用的本机服务器吗。多数人不需要。同样是挂服务,云主机七天二十四小时不断电,比自己的笔记本靠谱。

三十秒判定

如果你已经在某个下载页上,来不及翻回去看表,就看三样东西。

第一样,域名。pi.dev 和 github.com/earendil-works/pi 是编码 agent 这条线;minepi.com 是另一个世界。域名比名字可靠,名字可以重,域名重不了。

第二样,版本号。0.6.x 那边,0.21.x 或 0.22.x 这边。这个数字在你下载页面上明晃晃摆着,扫一眼就有。差出一个数量级,本来就不该被当成同一件东西的两个形态。

第三样,装完让你填什么。要一个 API key,或者登录你已有的 Claude、ChatGPT 订阅,那是对的。要邀请码、要手机号、要你等身份核验(KYC),那是另一个 Pi。

左边两步就进正题,右边三步都在交代你是谁。这一步最骗不了人。

还有一条更省事的:看有没有 npm 包名。@earendil-works/pi-coding-agent 是这条线上的东西,搜不到这个包名的,都不是。

搜索的时候也多打一个词。只搜 Pi,出来的大半是那个项目;搜 pi.dev 或者 pi coding agent,出来的才是这条线。这两组词的结果页几乎是两个不相交的世界。

顺便提醒一句,网上一堆老教程还写着 @mariozechner/pi-coding-agent,那个包今年五月就弃用了,照着装会报错。

我自己写的那篇,是第二样

上个月那篇桌面版实测,装的是 PI-Desktop,也就是第二列那个社区桌面版。不是 Pi 官方出的,也不是矿圈那个。

发出去之后有人问我"这是不是官方出的",我当时没答清楚。现在答清楚了。

以后看到 AI 圈里说 Pi,先别急着划走。看域名,看版本号,看它装完要你填什么。

三样里对上一件,你就知道自己站在哪个世界里了。

至于那个手机点一下的项目,我不评价,也不建议任何人因为这篇去碰它。它跟写代码没有关系,这句话就够了。

这三行判定我做成了一张竖版图,存在手机里,下次想装什么之前对一眼就行,比回来翻文章快。

Logo

更多推荐