快速上手：把 Piwin 调教成你最顺手的编程搭档

你好！欢迎使用 Piwin · 砚。

Piwin 是一个面向个人开发者的智能编程工作台。它的设计初衷不是卖给企业的复杂系统，而是做一款自己每天写代码都离不开、用着极顺手、配置极其简单省心的工具。

无论你手里握着各大厂商的官方会员订阅，还是有各种免费白嫖渠道，又或者纯本地跑模型，Piwin 都能让你以最舒服的方式统一调度。

🚀 极速装配：三步让你的 Agent 「充血拉满」

很多刚接触 Piwin 的开发者常问：“我手头预算有限（或者只有各种免费账号），怎样用最低的门槛甚至直接白嫖，快速调教出一个写代码扎实、能联网检索、能摸清代码仓库架构、还能生图生视频和实时语音对话的全能 Agent？”

跟着下面这套被无数开发者验证过的**「黄金三步装配法」**，花上几分钟，你的智能体直接彻底“充血拉满”：

第一步：准备一个 Devin 账号（免费的就行），一键 OAuth 登录

准备工作：去官网免费注册一个 Devin 账号（普通免费账号即可，不需要付费订阅）。
操作步骤：
1. 打开 Piwin 客户端，点击左下角 「设置 ➔ OAuth 登录」；
2. 找到 Devin，点击 「登录」，浏览器会自动调起官方授权页面，一键确认即可；
3. 授权完成后，凭证全自动安全保存在本机的 ~/.piwin 中，完全不需要手动抓包抠 Token。
直接解锁两大核心王牌：
- 高质量 Web 搜索 (web_search)：直接使用 Devin 官方清洗过的实时网页检索。查最新技术文档、搜最新 GitHub Issue 报错毫秒级响应，再也不用专门去申请配额有限的商业搜索 API Key；
- 全仓库代码检索 (code_search)：智能体派发只读子代理深入分析你的工程目录、符号引用与调用拓扑，0 上下文污染，主模型无需将无关代码整篇塞进窗口就能迅速摸清架构。
详细指引：Devin OAuth 授权与凭据管理

第二步：配置好你的「力工模型」

什么是力工模型？ 智能体需要一个每天勤恳搬砖、改代码、修 Bug、跑单测的核心推理引擎。它应当代码逻辑扎实、响应快速、量大管饱。
推荐配置方案：
- 高性价比 / 极低成本首选：DeepSeek-V3（或 DeepSeek-R1 / V3.2 系列）。无论是通过 DeepSeek 官方开放平台、硅基流动、还是各类聚合中转（如 OpenRouter）的 API Key，又或者本地 Ollama，在 「设置 ➔ 模型配置」 中直接填入 Base URL 和 API Key 即可。代码能力强，且成本极低；
- 顶级官方会员订阅：如果你手握 Claude Pro/Max（Claude 3.7 Sonnet）、ChatGPT Codex（GPT-4o / o3-mini）或 Kimi Coding，在 「设置 ➔ OAuth 登录」 中直接点击对应服务商一键授权，无需自建或租用昂贵的转发反代；
省钱跑腿秘诀（视觉委托）：写前端界面或调试页面样式时常常需要丢截图。顺手在 「设置 ➔ 模型与委托」 中把 「视觉委托 (Vision Delegation)」 勾选并指向免费的 Google Gemini 2.5 Flash（Google AI Studio 每天免费 1500 次调用）或硅基流动 Qwen-VL。轻量视觉模型毫秒级看图提取排版与报错，主力力工模型只负责专心写代码，立省 80% 以上 Token 账单！
详细指引：模型与通道配置指南与视觉模型与免费渠道配置指引

第三步：免费 Grok 账号 + xgrok，把生图、生视频与实时语音全部挂上去

准备工作：如果你手头有一些免费的 xAI Grok 账号，配合社区开源的 xgrok 工具（利用 Grok Web 端逆向渠道桥接转 API，目前 Web 渠道稳定可用，对免费账号极为友好）。
操作步骤（补齐多模态所有短板）：
1. 配置生图模型 (image_gen)：在「设置 ➔ 模型与委托 ➔ 图像生成模型」中接入 xgrok 的生图端点（支持 Grok / FLUX 格式）。聊天中随口吩咐“帮我画个应用图标”或“做一张封面配图”，智能体自动调用工具出图并原生渲染；
2. 配置生视频模型 (video_gen)：在「设置 ➔ 模型与委托 ➔ 视频生成模型」中，协议类型选择 xGrok Videos（xgrok-videos，端点路径 /videos/generations），模型名称填入 grok-imagine-video。生成动态视觉或操作演示视频时，Agent 自动产出短视频并在界面中原生展示播放器；
3. 配置实时全双工语音 (Live Realtime Voice)：在「设置 ➔ 实时语音」中填入 xgrok 的 OpenAI Realtime 兼容 WebSocket 端点（如 wss://.../v1/realtime，模型填入 grok-voice-think-fast）。输入框右侧的小麦克风瞬间点亮，戴上耳机即可与智能体边口语闲聊探讨、边下发编码任务，随时可以开口打断！
详细指引：模型多模态委托指南与全双工实时语音 Live 指南

🎉 OK，至此你的 Agent 已彻底「充血拉满」！

三步配完后，你的个人编程智能体已全面进入满血状态：

┌───────────────────────────────────────────────────────────────┐
│               Piwin 全能 Agent 充血作战就绪                    │
├───────────────────────────────────────────────────────────────┤
│  🧠 核心主脑 (力工模型)  : DeepSeek-V3 / Claude 3.7 专心搬砖写代码 │
│  👀 视觉跑腿 (视觉委托)  : Gemini Flash 免费毫秒看截图提取结构  │
│  🌐 全局雷达 (Devin OAuth) : 免费免 Key 极速高质量 Web 搜索    │
│  🔍 代码侦察 (Devin OAuth) : 免污染后台 Code Search 摸透工程拓扑│
│  🎨 创意生图 (xgrok Web) : 原生 image_gen 随叫随画应用配图     │
│  🎬 动态视频 (xgrok Web) : 原生 video_gen xGrok 动态视频生成   │
│  🎙️ 语音结对 (xgrok Web) : 全双工实时 Live 语音边聊边写代码  │
└───────────────────────────────────────────────────────────────┘

不需要掏昂贵的技术底座授权费，用巧劲把手头的免费账号与性价比渠道盘活，每天写代码就能体验到最爽快的智能体伴侣。

2. 深入了解：为什么说配置极其方便？

在市面上很多工具里，想接几个不同的模型或者搜索服务，常常要折腾反代、写复杂的环境变量、或者面对频繁断联的脚本。在 Piwin 中，我们把日常需要用到的配置收拢成了几套极简路径：

1.1 官方订阅一键登录 (OAuth)，无需折腾反代

如果你已经订阅了 Kimi Code、Claude Pro/Max、ChatGPT Codex、xAI Grok 等官方套餐：

点击客户端左下角 「设置 ➔ OAuth 登录」，点击对应平台即可在浏览器中完成一键授权；
授权凭证直接写在本地设备中，无需再自建或者租用昂贵的转发中转站；
授权完毕后，在会话中直接挑选对应的官方模型即可开始对话。

关于 Claude 订阅用量的提醒

Anthropic 官方规定所有第三方客户端的调用均走 Extra Usage 计费。如果你要授权 Claude 官方账号，记得在 Claude 账户用量设置页打开 Extra Usage 额度即可。

1.2 自由输入各种 API 密钥

如果你在各大模型厂商（OpenAI、Anthropic、DeepSeek、硅基流动、Groq 等）或者聚合平台（如 OpenRouter）有额度：

在 「设置 ➔ 模型配置」 中直接填入 Base URL 与 API Key；
支持全部 OpenAI 兼容接口、Anthropic 原生接口以及本地 Ollama 端口；
密钥全程保存在你本地电脑的 ~/.piwin 下，不会上传到任何第三方服务器。

1.3 视觉委托（跑腿省钱的核心秘诀）

写前端、改样式、看报错时，经常需要把截图丢给 Agent。如果直接用昂贵的深度思考模型（如 Claude 3.7 Sonnet / o3-mini）处理大图片，Token 消耗极快且速度偏慢。

Piwin 提供了极为方便的**「视觉委托 (Vision Delegation)」**机制：

你可以在设置里单独指定一个轻量视觉模型（强烈推荐 Google Gemini Flash，完全免费且极速，或者硅基流动 Qwen2.5-VL、本地 Ollama）；
当你粘贴或拖入截图时，轻量模型负责毫秒级看懂图片并提取文字结构，主力模型只负责根据整理好的信息专心写代码；
效果不打折扣，但能帮你省下至少一半以上的 Token 账单。
详细配置请看：视觉模型与免费渠道配置指引。

1.4 Web 搜索：开箱即用，轻松白嫖

遇到最新的开源库（比如刚刚发布的库版本变更）或时效性报错，模型自己的知识库可能不够新，联网搜索是刚需。

Piwin 支持多种极低门槛的配置方案：

Tavily Search：注册即送每月 1000 次 免费额度，返回结果专为 AI 清洗，极为干净；
Brave Search：提供开发者免费查询档位；
Devin 专属 Token：如果你提取了 Devin 个人 Token，可直接零门槛接入它的极速搜索服务；
本地自建：支持对接自建的 SearXNG，彻底零依赖。
详细配置请看：Web 搜索配置指南。

1.5 Devin OAuth：一键授权，自动搞定 Web 搜索与代码检索

在最新版本中，你完全不需要自己去抓包挖 Token 了！我们已经把 Devin OAuth 官方授权直接做进了客户端：

一键自动获取：进入客户端 「设置 ➔ OAuth 登录」，点击 Devin 即可在浏览器中一键授权，客户端会自动保存凭证；
直接解锁两大核心能力：
- Web 搜索 (web_search)：高质量网页清洗检索，查资料毫秒级返回；
- Code Search (code_search)：派出只读子代理深入你的代码仓库梳理依赖与拓扑，完全不污染主模型的上下文！
想手动挖也支持：如果你习惯自己从网络请求里抓取 Token 手动填入，或者使用专属代理，设置里同样为你保留了手动填入入口。
详细指引请看：Devin Token 与 OAuth 授权指引。

3. 核心模块配置直通车

根据你当前想配置的环节，点击下方直接跳转详细图文指引：

功能模块	能帮你解决什么？	详细指南
官方订阅登录	一键连入 Kimi Code、Claude、Codex、Grok 等官方账号	OAuth 登录指引
模型与通道配置	接入 DeepSeek、OpenAI、本地 Ollama 等各类模型端点	模型配置指南
视觉委托配置	免费配置 Gemini Flash / 硅基流动，看图省钱又快	视觉模型指南
实时全双工语音	边聊边写代码，全双工可打断的 Live 语音结对编程	实时语音指南
Web 搜索配置	接入 Tavily 每月免费 1000 次搜索或 Devin 专属搜索	Web 搜索指引
Devin OAuth 授权	一键自动获取凭据，直接搞定 Web 搜索与代码检索	Devin 授权与 Token 指引
Code Search 检索	仓库再大也不怕，0 上下文污染进行精准架构摸底	Code Search 指南
子代理编排	Auto 智能编排：按需路由 Scout 取证与 Sidekick 执行（含 Ultra Code、Fusion）	Auto 智能编排
多端开箱运行	macOS 一体包、Windows 包、iPad 远程直连	多端使用指南

快速上手：把 Piwin 调教成你最顺手的编程搭档 ​

🚀 极速装配：三步让你的 Agent 「充血拉满」 ​

第一步：准备一个 Devin 账号（免费的就行），一键 OAuth 登录 ​

第二步：配置好你的「力工模型」 ​

第三步：免费 Grok 账号 + xgrok，把生图、生视频与实时语音全部挂上去 ​

🎉 OK，至此你的 Agent 已彻底「充血拉满」！ ​

2. 深入了解：为什么说配置极其方便？ ​

1.1 官方订阅一键登录 (OAuth)，无需折腾反代 ​

1.2 自由输入各种 API 密钥 ​

1.3 视觉委托（跑腿省钱的核心秘诀） ​

1.4 Web 搜索：开箱即用，轻松白嫖 ​

1.5 Devin OAuth：一键授权，自动搞定 Web 搜索与代码检索 ​

3. 核心模块配置直通车 ​