开源 ZCode：一款覆盖桌面、Web 与终端的 AI 编程工作台

这两年，很多开发者已经习惯把需求交给 AI：读项目、改页面、补测试、查报错，确实能省下不少重复劳动。

麻烦也随之出现。Agent 不只会聊天，它还要读取文件、执行命令、调用模型和插件。遇到商业项目，大家关心的也不再只是“代码写得怎么样”，还会追问：它读了什么、请求发到哪里、哪些操作能在本机完成？

近期围绕 ZCode 数据处理方式的讨论，让这类问题集中浮出水面。

随后发布修复说明并开放源码。

争议细节仍应以官方说明、第三方审计结果和当前代码为准，但有一点很明确：对开发工具来说，可审阅、可构建、可验证，本身就是重要能力。

ZCode 是什么

ZCode 是 Z.ai 推出的 AI 编程工作台。它不是单一桌面客户端，而是一套包含桌面应用、浏览器工作台、终端 Agent、后端服务、共享 UI 和 Agent 运行时的完整工程。

这套设计覆盖了几种常见习惯：喜欢图形界面的开发者可以用 Electron 桌面端；服务器或远程环境里可以直接运行 zcode；不想安装桌面壳，也能通过 zcode --web 在浏览器里工作。

它能解决什么

ZCode 的核心价值不是多一个聊天框，而是把 Agent 放进真实开发流程。它可以围绕工作区读取上下文、调用工具、执行多步骤任务，并把终端、Web 和桌面体验接到同一套运行时上。

仓库还公开了共享协议、RPC、Provider、客户端 SDK、业务服务与持久化模块。

团队想研究 Agent 如何组织任务，或准备基于现有工作台做二次开发，不必只盯着一个打包后的客户端。

同一套能力能从桌面、浏览器和终端进入，场景切换时不用重新适应一套工具。

技术架构

项目采用 pnpm workspace 管理多包工程。

packages/desktop 负责 Electron 主进程、Host、Renderer 与打包；

packages/web 提供浏览器客户端；packages/server 承担 HTTP、WebSocket 和远程连接；

packages/ui 放置 React 组件、Hooks 与 Zustand 状态。

Agent CLI、TUI、运行时和工具位于 apps/zcode-cli。

共享类型、RPC、Provider 和客户端能力则拆分在独立包中。

这样的目录结构比较适合按模块阅读，也方便只调试 Web、桌面端或 Agent。

部署与运行

参与源码开发前，需要准备 Git、Node.js 24.14.0 和 pnpm 10.33.2。克隆仓库后，在根目录执行：

pnpm bootstrap

桌面开发使用 pnpm dev:desktop；

Web 开发使用 pnpm dev:web，默认会启动 5173 端口的前端和 3030 端口的后端。

命令行发行包可通过 pnpm build:zcode 构建，运行 zcode 进入 TUI，运行 zcode --web 启动浏览器界面。

普通使用者可以从官网下载对应系统的安装包；

准备改代码、检查行为或定制功能，再走仓库里的构建流程更合适。

开源协议

项目自有代码采用 Apache License 2.0。

即刻体验一波

假设刚接手一个旧项目，想先让 Agent 梳理模块，而不是立刻改文件。可以把源码拉到测试目录，执行 pnpm dev:web，浏览器打开本地地址，再把工作区指向目标项目。

先让 Agent 输出目录职责、启动入口和依赖关系，确认它读取了哪些文件；接着要求生成只读的改造计划；计划没问题，再把任务拆成接口调整、页面修改和测试补充。整个过程中，终端日志、网络请求和源码实现都能同步检查。

这个场景里，开源带来的价值很直接：不只是能运行，还能沿着代码和请求链路验证工具到底做了什么。

结语

ZCode 这次开放的不只是一个界面壳，桌面端、Web、后端、CLI 和 Agent 运行时都能在仓库中找到。对普通开发者，它多了一种跨终端使用 AI Agent 的选择；对团队和工具作者，它也提供了一个可以阅读、构建和讨论的工程样本。

开源不会自动消除所有数据与执行风险，但它让关键问题有机会回到代码、配置和可复现结果上。

后续项目如何维护、社区如何审阅，反而更值得持续观察。

仓库：https://github.com/zai-org/ZCode