如果你这一年没少折腾AI编程工具，大概率会有一个共同感受：本事越来越大，架子也越来越沉。
落到日常，多半是这三种体验：权限确认弹窗一个接一个，点到手软；子代理套着子代理，token烧得莫名其妙；想要的开关找不到，不要的功能删不掉。
就在人人往里堆功能的时候，一个刚发布1.0的终端AI编程代理偏反着来。它叫Pi，官方对它的定位翻译过来就一句话：Agent框架很多，但这一个属于你。
这篇文章只做一件事：把它拆开讲清楚——是什么、凭什么做减法、用起来什么样；文末再看一个把这颗内核搬进桌面的衍生项目。
Pi是一个跑在终端里的可扩展AI编程代理。命令行里丢给它一个目标和一个工作文件夹，剩下它自己推进：翻文件、跑命令、改代码，多步任务接着干，中途随时插话调方向。
它由Earendil Inc.开发，MIT协议开源。能干的也不止写代码：搞研究、记笔记、写文章、整理数据、折腾兴趣项目，都是官方点名的场景。
讲真，它更像一块乐高底座，而不是封装好的成品机器：前者给接口和规则，后者给固定造型。用法也分三层——直接拿来用；用自然语言把它调教成你的工作流；或者拿SDK当内核，嵌进自己的应用里。
最常见的误解是把它当成又一个套壳命令行工具。恰好相反，它的重点不是替你预设一切，而是把设定权交还给你——这个判断，后面每节都在验证。
论功能清单它最短，论设计哲学它最较真。Pi的设计哲学浓缩成一句口号：Primitives, not features——交付原语，不打包功能。
克制到什么程度？子代理嵌套、计划模式、权限确认弹窗、内置待办列表、后台常驻shell——这些能力，同类产品几乎人手一份，它一个没内置。其实官方理由很直白：这些活儿，用户可以让AI现场给自己造。缺什么就让Pi现写一个，改完重载立即生效：
/reload功能是别人预设的答案，原语是你自己出题的资格。更有意思的是立场演变：它曾长期坚持不接MCP，如今不但内置了MCP，还加了Codemode能力——写一小段JS脚本，在沙箱里把多个工具调用串起来，同时保留对MCP扩展方式的兼容。该坚持时坚持，该让步时让步，这才叫成熟的极简主义。
想加功能，让它现场造。定制体系是Pi的重头戏。extensions用TypeScript写成，从底层工具、自定义命令、快捷键、事件钩子到整套终端界面都能摸到；skills是按需取用的能力包；prompt templates是Markdown模板，敲个名字就能展开；主题系统管外观。
这些定制还能打包成package，走npm或git渠道分发安装。官方给出50多个扩展示例，社区更野：有人写出让DOOM跑起来的扩展，还有人做了画图扩展。底座够开放，玩法封不住顶。
模型随便换，不用搬家。15家以上提供商、上百个模型开箱即接，Anthropic和OpenAI领衔，Ollama这类也在列；订阅、API密钥、本地端点都认。会话进行到一半也能换，不用重开：
/model 会话中途换模型 Ctrl+L 键盘党快切 Ctrl+P 常用模型轮着用想接冷门厂商，改一份模型清单配置，或者干脆写个扩展。
会话是一棵树，走岔了就折回去。对话记录不是一条线，是一棵树。哪一步走错了，跳回任意历史节点换个思路重来，其他分支原样保留，全部塞在同一个会话文件里。
/tree 打开会话树，跳回任意节点 /export 存成HTML文件 /share 生成可分享的链接历史不怕走错，思路可以分叉。运行中插话也顺：一句立即送达，一句排队追加，指挥进行中的活儿不用干等。
上下文管得比你还细。系统提示词压到极简，能省的token都省。项目指令用AGENTS.md承载，从用户配置目录、上级目录到当前目录逐层加载；SYSTEM.md则按项目替换或追加系统提示词。
快顶到上下文上限会自动压缩，压缩策略还能定制：按主题压、带着代码感知压、换个模型来压。skills按需才载入，不会把提示词缓存撑爆。扩展还能在每轮前插入自定义消息、筛掉不想要的历史，连RAG和长期记忆都能自己实现。
一套内核，四种用法。交互式终端界面只是默认形态。要自动化，有print与JSON事件流模式，脚本和结构化事件随取；要集成，有RPC模式，靠标准输入输出上的JSON协议遥控独立进程，不挑技术栈；要二次开发，直接上TypeScript SDK，官方生态已有应用拿它当内核。
安全模型这里先记一笔：工具和扩展都揣着主进程级别的权限，由项目信任机制决定哪些项目资源会被加载——没有沙箱兜底。这个细节，下一节展开。
先泼盆冷水：极简不等于万无一失。夸到这里必须停一下，它的棱角同样分明。
权限敞开。工具与扩展不做沙箱隔离，拿到的是主进程级别的权限。跑不可信仓库的代码、装来路不明的扩展、开无人值守的自动化，风险都得自己掂量。
终端门槛。全部交互发生在命令行里，对非程序员和重度图形界面用户不算友好，上手曲线实打实存在。
极简的代价。没有的功能得自己造，写扩展要会TypeScript，对愿意动手的人是自由，对只想开箱即用的人是负担。
说白了，它把复杂度从产品里删掉了，但没有从世界上删掉——只是搬进了你手里。不过，总有人愿意替你接住这摊复杂度。
这个项目叫OmniDeck——终端之外，这颗内核的第二种活法。它用Electron+Vue3写成，是覆盖macOS和Windows的跨平台桌面应用，把两样东西装进同一个壳：一个叫OmniBuddy的AI编程助手，内核正是开篇聊的Pi；一个收录70多个工具的开发者工具箱。口号是「全能桌面，智驭未来」。
三个最实的卖点：离线优先，数据不出本机；装完即用，运行时云端装配；一个应用，两种生产力。
第一条：70多个工具全部本地运行，MCP连接器配置全量留在本地，AI对话的凭证用系统钥匙串加密保管。第二条有细节：安装包不带运行时，首启引导页会去云端仓库把Python、Node、Playwright等在线装配到位，连MinGit都备好，宿主机一个环境不用预装。
AI助手与内核一脉相承：多会话并行、流式吐字、思考过程摊开可见、检查点随时回滚。工作空间把本地目录变成Agent工位，浏览、预览、上传下载都在界面里完成。
配置层也齐：AGENTS.md里的规则分全局、工作空间两级存放，对话时自动注入；MCP连接器可挂本地进程、也可接远程流式服务；多家服务商凭证统一保管；用量按天、会话、模型聚合token与成本，可导出CSV。
工具箱是另一副面孔：8大分类、70多个工具，全部离线可用。拣几类感受一下：转换：JSON与Excel、SQL、YAML互转，正则调试、时间戳换算；加密：AES、DES、RSA，Hash校验，随机密码生成；图片：压缩、转格式、加水印、GIF动图、二维码生成。
文本与格式化：JSON、Markdown、SQL排版，命名风格互转；换算与生活：字节、速率、面积换算，身份证归属、贷款计算、农历查询；网络与其他：HTTP状态码、Cron表达式、端口与DNS查询、世界时钟。
另有财务看板（基金自选、行情明细与贵金属报价）和效率面板（首页仪表盘、常用收藏、待办清单、剪贴板历史）。
全局能力还有几手：截图捕获支持框选与窗口拾取，贴图快面板随手呼出；全局命令面板随手搜索；应用锁用FaceID或密码锁工作区；常驻托盘，常用功能一步直达。
授权也直白：源码按PolyForm Noncommercial 1.0.0开放，个人学习、研究、修改、非商业使用没问题，商业使用不行；核心的Agent引擎闭源，不在公开仓。但Releases页里的安装包，谁都能免费用，商业组织也不例外。
装法就一条：去OmniDeck的Releases页拿安装包，macOS用arm64的dmg，Windows用x64的exe，装完跟着首启引导走一遍。项目地址：https://gitcode.com/m0_59492087/OmniDeck
写在最后：三句口诀收个尾。好框架不靠功能堆，靠原语搭；好工具不替你做主，把设定权还给你；好数据不必上云，本机照样转得漂亮。
开篇说Agent框架很多，属于你的那一个，不该是别人替你装修好的样板间——它该是一块毛坯，墙随你砌，功能随你长。OmniDeck还年轻，愿意围观的可以早点去点一颗Star，项目地址再放一次：https://gitcode.com/m0_59492087/OmniDeck
这篇拆解若有用，欢迎点赞、在看，也欢迎扫码关注，后续继续拆值得玩的AI项目。
AI时代已经来临，每天两分钟，带你掌握一手前沿资讯
关注“AI绘界Studio”，请扫下方二维码
