智能体系统
随处部署
同一套代码, 工作发生在哪就部署到哪
三种界面、三种沙箱提供方,智能体行为完全一致。唯一变化的是数据存在哪、工具在哪运行。
PostgreSQL 支撑,SSE 流式,运行中可恢复。
本地优先,密钥经 safeStorage 加密,可离线使用。
BUA 通过 CDP 驱动你已登录的浏览器。
零配置循环 —— 工具在进程内运行,迭代最快。
每个任务一个持久 Linux 工作区,跨轮次保持状态。
每个任务一个全新微型 VM,约 200ms 冷启动,用完即弃。
工作原理
默认自主, 由协议塑形
同一套协议 —— 从一行回答到跨文件重构。澄清与规划只在评估判定需要时才启用。
评估
对照 P0–P3 策略分流 —— 直接回答、需要确认、需要澄清,或先规划。
澄清
可选当上下文、目标或约束会实质影响结果时,先问用户再行动。
规划
可选产出一份明确的待办清单 —— 只列执行阶段,每项都有可验证的产出和交付规格。
执行
线性推进各阶段,安全时并行独立的工具调用,出错时坦诚恢复。
交付
综合输出、对照交付规格验证,返回直接回答或落盘文件。
FAQ
动手之前, 先解答疑问
人们打开仓库五分钟后会问的那些问题。
我能自托管吗?
可以 —— Zapvol 端到端开源。把服务端 + Web 栈跑在你自己的基础设施上,或直接把桌面应用交付给用户。不回传,不强制云账号。
为什么用 TypeScript 而不是 Python?
智能体与 UI 共享代码 —— prompt、schema、工具类型、消息结构 —— TypeScript 让我们从浏览器一直到沙箱都用同一份带类型的契约。Python 会强加一道我们并不需要的协议边界。
它和 Mastra / Vercel AI SDK / LangChain 有什么不同?
Vercel AI SDK 是底层的流式原语 —— 我们构建于其上。Mastra 是同类框架;Zapvol 更进一步,交付的是完整的 Web + 桌面 + 扩展产品,而不只是后端框架。相比 LangChain,我们更看重一个下午就能读懂、带类型且有文档的内部实现。
浏览器扩展(BUA)安全吗?
BUA 是内部专用工具:默认静默执行、无授权弹窗,但有完整的审计日志、弹窗里的全局终止开关,以及 Chrome 无法移除的黄色“调试器已附加”横幅。域名黑名单让运维能排除敏感站点。
支持哪些模型?
Vercel AI SDK 支持的都行 —— Anthropic、OpenAI、Google、Bedrock、Azure、本地 Ollama。模型按档位选择;档位配置存在数据库里,无需部署即可切换。
沙箱隔离是怎么工作的?
每次工具调用都对照一张沙箱能力映射表解析。智能体从不直接碰你的宿主文件系统或 shell —— 它调用一个能力,由沙箱提供方(Node / Daytona / E2B)执行,结果作为带类型的工具输出流回。
这能用于生产吗?
Zapvol 已在内部用于编码、研究和浏览器自动化的生产场景。整套栈 —— 流式、可恢复轮次、三级压缩、经 Redis 的按任务 SSE 回放 —— 是为长时运行的智能体工作打造的,而非演示。
许可证是什么?
源码可得,许可证允许自托管与内部使用。确切条款见仓库;商业再分发需另行协议。