Serena Desktop — 让 ChatGPT 指挥 Codex 干活的本地代码工作台

项目简介

Serena Desktop 是一款面向 Windows 开发者的本地代码工作台，核心思路是将 ChatGPT 的推理能力与 Codex 的代码执行能力通过 MCP 协议串联起来：由 ChatGPT 负责理解需求、规划步骤，由 Codex 负责实际写代码。项目作者在 V2EX 分享时提到，自己 20x 的 Codex 额度总是不够用，而 ChatGPT 可以帮助拆分任务、写提示词，从而节省 Codex 的消耗。

核心功能

• MCP Broker 统一入口：将 Serena 代码检索、Git 查询、CodeGraph 结构探索和 Codex Agent 任务管理汇集到同一个桌面应用中，通过统一 MCP 地址供 AI 客户端使用
• 项目代码理解：通过 Serena 读取文件、检索代码、定位符号与引用，让 AI 真正「看懂」你的项目
• Git 状态查询：查询工作区状态、差异、提交历史、分支与 worktree
• 代码结构探索：接入 CodeGraph，探索跨模块调用链与变更影响范围
• 多项目切换管理：在首页同步并切换多个已初始化的项目工作区
• 本地 Agent 任务管理：在应用内创建 Codex 任务，查看执行状态与结果详情
• 服务状态诊断：集中查看各服务运行状态，支持环境检测、重启和日志查看
• Cloudflare Tunnel 内网穿透：自带免费 Cloudflare Tunnel 网关，支持将本地 MCP 服务暴露给 ChatGPT 插件使用

技术实现

项目基于 Tauri 2 构建桌面应用（src-tauri/Rust 后端 + Web 前端），受管安装固定为官方 serena-agent==1.7.0（Python 3.13）。MCP Broker 默认监听 http://127.0.0.1:9120/mcp，固定对外暴露 18 个工具（7 个 source* 工具从 Serena 读取描述，4 个 workspace 和 6 个 git_ 工具由本地实现，另有 codegraph_explore 专用 Adapter）。

CodeGraph Adapter 使用独立子进程运行，崩溃不会影响主应用，具备完善的错误恢复机制（最多重试一次，间隔至少 30 秒），单次图查询含排队/恢复总预算 50 秒。

快速上手

1. 前往 Releases 下载 Windows 可执行文件，预装 Git
2. 在 Git 仓库根目录执行 serena project create --index 建立索引（已有 .serena/project.yml 则执行 serena project index）
3. 返回应用首页点击「同步项目」，选择并激活项目
4. 在设置中启用「MCP 连接入口」，将地址填入支持 HTTP MCP 的 ChatGPT 插件或其他 AI 客户端

适用人群

• Codex 额度紧张的 Windows 开发者
• 需要让 AI 理解本地代码库项目的团队
• 希望在一个界面统一管理代码检索、Git 查询和 AI 任务的前端/全栈工程师

官方链接

• GitHub：https://github.com/lifei6671/serena-desktop
• Releases（含 Windows exe 下载）：https://github.com/lifei6671/serena-desktop/releases
• 问题反馈：https://github.com/lifei6671/serena-desktop/issues