玄圃Agent产品系统Vibe Coding

软件开发里，现有对话式助手大多只给修改建议，读代码、改文件、跑命令、配环境仍要人自己切换工具完成。玄圃 Agent 因此立项：把「理解任务」和「在真实工程里动手」接到同一条对话中。用户用自然语言描述目标，Agent 在本机工作区直接检索、改写代码并执行命令；任务需要 Linux 或隔离环境时，再转到云端沙箱接力，做完把结果写回电脑。面向个人开发者、学生课程实践和中小团队日常研发，解决助手无法落地执行、本地环境难配、重复操作耗时长的问题

项目包含桌面客户端、云端 Agent 能力核心、云端工作区和账号计费四块。桌面端负责登录、多会话、工作目录、截图提问，以及规划、推理、工具执行、收尾等实时状态。能力核心是自研的多步工具循环：读文件、精确替换、新建覆盖、目录列举、全文检索、终端命令、网页搜索与页面抓取、任务清单，并可将探索或改写交给隔离上下文的子代理。云端工作区在独立 Linux 上用容器跑命令，文件落在任务目录，时长到期后回收。账号侧提供注册登录、套餐额度、激活密钥和管理后台，按整回合用量结算。主要功能是让编程助手从只输出建议，变成在用户电脑或云端沙箱里把任务做完

我负责玄圃 Agent 从客户端到云端的整体设计与主要编码。技术栈为 Electron、TypeScript、React 桌面端，Bun 与 MySQL 云网关，上游对接千问等 OpenAI 兼容模型；云端执行面用 Docker 做命令隔离。架构是「云端是脑、本机是手」：提示词、工具决策、子代理、会话和计费留在服务端，文件与终端在客户端本地执行，上游密钥不下发。亮点是流式多步工具循环、本机与云端可中途切换，以及整回合含子代理统一扣费。难点在于命令超时后要接着等原进程而不能重复拉起，长对话要裁剪历史，云端任务结束还要把工作区安全回收并回到本机继续