蓝鲸 Agent

这是什么？适合谁？

蓝鲸 Agent（whiteball-shiro/blue-whale-agent）是一个桌面鲸鱼 Agent：大肥鱼：桌面小鲸鱼 Agent，显示 LLM 余额，支持 Codex/本地/云端对话、本地委派分流、文件处理与本地生图，不绑定特定模型。

核心价值：一个叫「大肥鱼」的桌面小鲸鱼 Agent：显示 LLM 余额，支持 Codex/本地/云端对话、本地委派分流、文件处理与本地生图，不绑定特定模型、可接任意 OpenAI 兼容接口。

适合人群：

• 想要桌面 AI 助手的用户
• 用 Codex 的开发者
• 想本地生图的创作者

使用前提：桌面环境（Windows/macOS/Linux）

准备工作

1. 安装：下载桌面应用或克隆运行
2. 环境：桌面系统 + Node.js
3. 准备：AI 接口（Codex/本地/云端）
4. 成本：MIT 开源免费（模型另计）
5. 时间：安装 + 配置约 20 分钟

快速上手（3 步）

第一步：安装运行

git clone https://github.com/whiteball-shiro/blue-whale-agent && 运行

安装桌面鲸鱼 Agent

第二步：配置接口

# 接 Codex/本地/云端或 OpenAI 兼容接口

配置 AI 接口

第三步：开始使用

# 对话/委派/文件处理/生图

使用桌面 Agent 功能

成功判定：在桌面启动蓝鲸 Agent 并完成一次对话或生图。

初级用法

余额显示

查看 LLM 余额

多模型对话

Codex/本地/云端对话

委派分流

本地委派分流

高级玩法

本地生图

本地生成图片

文件处理

处理本地文件

多接口切换

切换 OpenAI 兼容接口

小技巧

1. 先确认桌面环境
2. 按需配置模型接口
3. 关注余额提示
4. 本地生图注意资源
5. 反馈问题给社区

常见踩坑

踩坑 1：接口配置

• 现象：接口配置
• 原因：连不上模型
• 解决：核对 API 配置

踩坑 2：余额不准

• 现象：余额不准
• 原因：显示偏差
• 解决：手动校准

踩坑 3：生图资源

• 现象：生图资源
• 原因：本地生图慢
• 解决：降低分辨率

踩坑 4：项目很新

• 现象：项目很新
• 原因：文档有限
• 解决：以 README 为准

踩坑 5：环境依赖

• 现象：环境依赖
• 原因：Node 版本
• 解决：核对运行环境

常见问题 FAQ

Q: 它是什么？

A: 桌面鲸鱼 AI Agent。

Q: 免费吗？

A: MIT 开源，模型另计。

Q: 支持哪些模型？

A: Codex/本地/云端 + OpenAI 兼容。

Q: 能生图吗？

A: 支持本地生图。

Q: 适合谁？

A: 桌面 AI 助手用户。

进阶学习建议

掌握基础后，建议深入：

1. 深入研究桌面 Agent 与多模型切换
2. 对比 Pinvou Agent/LM Studio 的方案
3. 探索本地委派分流机制

参考链接

• 官方仓库

最后更新：2026-09-03 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成