【开源推广】20个包， 70天，我的桌面端coding agent终于能见人了——piwin

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

- 我的帖子已经打上 开源推广 标签： 是

- 我的开源项目完整开源，无未开源部分： 是

- 我的开源项目已链接认可 LINUX DO 社区： 是

- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

github.com

GitHub - mimimaster/piwin: 基于pi的桌面端coding agent

基于pi的桌面端coding agent

简介：

这是一个基于Pi SDK打造的面向个人的桌面端编码助手，支持PI生态，很多设计理念参考pi，对于习惯使用桌面端的佬友，欢迎尝试使用，详细可看文档站https://docs.piwinwin.com/

最快使用方式：

1.准备一个devin账号，免费的就行，使用项目的devin oauth登录；

2.配置好你的文本推理模型；

3.如果你有些免费的grok账号，使用xgrok，用web渠道（现在还活着吧）搞点生图、生视频、实时语音的模型，配置上去。ok，至此 agent能充血满。

实图直出：

特色功能一览

- 灵活配置

- Pi生态支持

- code_search

- 子代理编排

- artifact实时渲染

- 全双工语音托管

- 闪卡

灵活配置

模型配置

piwin 支持各种类型模型的 BYOK 配置（除 decision 外，后续会补上）

特殊说明：

生图/生视频：对应 image_gen、video_gen 内置工具，配置才激活。

全双工语音：可以通过 codex oauth 登录直接拦截codex的live模型，或配置 realtime 语音模型（暂时只支持gemini和openai协议，后面功能会持续完善）即可开启语音托管。

知识库与闪卡 (RAG)：支持 embedding、reranker 及 minerU，目前主要用于 LLM WIKI 拆分出闪卡流程（更多产品形态还在构思迭代中——简单说，我搞了个RAG架子但是没有很好的产品形态）。

提示：项目通过拉取开源项目维护模型 Catalogue，点击界面上的“同步模型目录”即可一键刷新最新配置，这个功能可以一键带出具体模型配置，比如说填充某个最新模型的配置（上下文窗口，effort，生图，视频等参数），这样就不用费力去填写新模型的配置了，但是最好还是点击下拉查看一下模型参数，看是否匹配。

功能展示

视觉委托

就是为纯文本模型准备的功能，可以委托已配置过的视觉模型进行视觉识别

功能展示

oauth登录

项目沿用pi原生的oauth，在此基础上进行的oauth支持。

OAuth 登录后的套餐模型统一在【模型】配置页面管理。

！！超级阿姆斯特朗回旋喷气加速式阿姆斯特朗重要使用说明！！：

建议使用oauth devin，搞一个免费账号就行，oauth之后，这样就能免费使用devin的web_search和code_search(又称fast-context,后文会进一步说明)

功能展示

web_search

web_search 是一个独立的内置工具（Tool），支持用户自由配置外部搜索能力，也支持调用模型自带的联网搜索，并且可以自由调整触发优先级。默认使用模型内置搜索能力。

用户可以极其自由自定义要使用的web_search能力——支持cli和http，有问题可以再讨论

功能展示

Pi生态支持

支持AgentRuntime级别的拓展安装，涉及到TUI之类的交互的拓展是不支持或者部分支持；

piwin采用分级安装策略，然后可在拓展市场tab中搜索相应的拓展，搜索源使用的是github和npm registry；

如果后面这个项目有人用的话会考虑搭一个插件或者拓展站，没人用我就自娱自乐；

功能展示

code_search

说明：就是Devin 的 fast-context。

特殊在于，它被我抽成原声的host工具，就是跟read和grep同级，这样表现更好；

这里推荐两种mcp工具，一种是agent memory，一种是代码语义检索；前者可以让你在不同agent保留项目的工作记忆吧，后者可以帮你减少上下文的压力

这里说下这个工具的好处：

子代理编排

内置两种自带模版，ultra和fusion，前者是codex的ultra，就是派scout出去代码语义检索，去了解情况，参考 【拯救 5.6 Sol（1）】开箱即用、快速高效、减少上下文腐烂的Codex子代理实践 ；后者是根据devin fusion公开文档信息实现；

artifact实时渲染

现在各大桌面级的agent基本都有这个功能，差别在触发的积极性，piwin触发是很积极；

piwin的artifact具现分为两部分，inline和canvas。前者直接在对话实时渲染富文本信息，后者就是主动唤醒画布；

这个功能有比较细致的开关，(chat会话默认全开启，agent会话默认开启canvas)用户可以根据喜好控制（四个按钮），大伙儿可以根据自己的使用情况去开启，毕竟artifact好看虽然好看，但是消耗的token相对也多，这里是场景展示：

语音托管

就想搞个跟codex的实时语音一样的功能，grok bot最近也出了个，体验还是跟实时语音模型能力有很大关系。

闪卡

更多

右侧栏工具

右侧栏工具什么的都是应有尽有，这里右侧栏大部分都是找cursor借的 ^-^

用量统计和其他

工具链展示：

因为coding agent调用链展示还蛮重要的，很多细节我也是打磨有一段时间了，所以这里也展示一下

###子代理

子代理是可以展开看到里面的运行情况的，这里没展开是因为展开没那么好看，这个灵感是找cursor借的

工具链一览

更多可以看下我的文档站，有更具体的展示，不过文档站人味不多；

部署方式

githu和文档站都提供了mac和windows的一体包，支持web部署，具体可看readme，开发状态更是灵活；，文档站走的cf r2；

结语

实际体验还有超级多的功能欢迎佬友们体验！

项目目前可能还有不少毛病，我一个人精力有限，很多地方打磨得还不够细。真心希望感兴趣的佬友能上手试试，用了有不爽的地方可以提 issue，有想法也超级欢迎 PR，欢迎大家一起共建，respect!! ^-^。

最后还是再贴一下仓库和文档站：

github仓库： GitHub - mimimaster/piwin: 基于pi的桌面端coding agent · GitHub

文档站：https://docs.piwinwin.com/

btw

这个项目很多灵感信息都是从佬友们的帖子来的，比如artifact具现是五月份有佬友发帖分享claude的文章，当时我就搞了几个项目，但效果一般；站内的fast-context mcp让我注意到windsurf(devin)，后面没想到这家伙有这么多工具可以薅，还有很多上下文相关的文章，都让我真的学到了agent的相关知识，“学AI，上L站”是正确的！