Skip to content

Releases: ZCodium-project/ZCodium

Release list

v3.14.4

Choose a tag to compare

@github-actions github-actions released this 26 Sep 08:04

官方服务开关:官方平台功能默认全部关闭,只有在“设置 → Z.AI 服务”里手动打开对应开关后才会生效;开关关闭时应用不会连接官方平台,也不会上报任何数据。

ZCodium 3.14.4

Changelog (vs v3.14.3) / 更新日志(相对 v3.14.3)

中文

  • 官方服务开关修复:开关现在会正确保存并在重启后保持;修复了此前“切换开关又弹回、重启后失效”的问题。
  • 打开开关后功能真正生效:例如打开“Z.AI 插件市场与 CDN”后,插件市场可以正常刷新并安装官方插件;Host 会把开关同步给 Agent 进程(重启应用或新启动 Agent 后生效)。
  • 新增“通过浏览器登录”:模型设置页提供浏览器授权登录入口(需先打开“Z.AI API 配置”开关);新用户首次启动的界面不变,仍只需 API Key 或直接跳过,不会被强制登录。
  • 关闭开关时市场为空:关闭“Z.AI 插件市场与 CDN”后,插件市场“公开”页不再展示官方市场与插件,并提示到“设置 → Z.AI 服务”中打开;已安装插件不受影响,仍可管理。
  • 发布说明更新:明确官方服务默认全部关闭,只有打开对应开关才连接官方平台;关闭时不会发起请求,也不会上报任何数据。

English

  • Official-service switches fixed: switches are now persisted and restored after a restart; the previous "toggle snaps back / lost after restart" behavior is fixed.
  • Switches now take effect end to end: with the marketplace switch on, the official marketplace can be refreshed and plugins installed; the host projects switches to the agent process (applies after an app restart or a new agent start).
  • New "Sign in via browser": a browser OAuth sign-in entry on the provider settings page (available after enabling "Z.AI API configuration"); first-run onboarding is unchanged - API key or skip, never forced to log in.
  • Marketplace hidden when the switch is off: with "Z.AI marketplace and CDN" off, the store public tab shows no official marketplace or plugins and points to Settings -> Z.AI services; installed plugins stay manageable.
  • Release notes updated: official services are opt-in and off by default; with switches off the app sends no request and reports nothing.

对比完整变更 / Full diff: v3.14.3...v3.14.4


English

What changed vs ZCode

  • All monitoring and telemetry removed (~26k lines): ARMS RUM, OTLP reporting, crash collection, resource and network sampling, UI analytics - with regression checks so they cannot be reintroduced.
  • Official platform services are opt-in and off by default: account login, feedback upload, coding plans, official MCP credentials, plugin marketplace and remote client config stay disconnected until you enable the matching switch under Settings -> Z.AI services. With every switch off (the default), the app never contacts the official platform and reports nothing; feedback points to GitHub Issues. You can turn any switch off again at any time.
  • No mandatory account: no sign-up wall and no forced login. New users configure their own API key or a custom model provider and start working; a browser sign-in entry appears only after you enable "Z.AI API configuration".
  • No purchase or upgrade prompts by default: nothing pushes you to buy a plan; plan cards and purchase entries appear only after you enable the coding-plan switch, and can be turned off again at any time.
  • No repository upload behavior: snapshot packaging and upload logic removed, with guards against reintroduction.
  • Open source and reviewable: first-party code MIT, upstream Apache-2.0; removal reports for desktop, CLI and UI ship in the repository.
  • Transparent builds: installers are built by GitHub Actions from this repository, and in-app updates point to this repository's GitHub Releases.
  • Honest limitations: Computer Use is an unavailable placeholder; installers are not signed by ZCode.

Install

  • macOS (.dmg): download ZCodium-3.14.4-mac-arm64.dmg (Apple Silicon) or ZCodium-3.14.4-mac-x64.dmg (Intel), open it, drag ZCodium into Applications. The app is not signed by ZCode, so Gatekeeper blocks the first launch - this system block is macOS only. Allow it once with the command below (enter your login password when asked; nothing is shown while typing; the command launches the app and exits immediately):

    sudo /usr/bin/xattr -rd com.apple.quarantine "/Applications/ZCodium.app" && open -a "ZCodium"

    The absolute /usr/bin/xattr path avoids shadowing by other tools with the same name. You can also right-click (Control-click) the app in Finder -> Open -> Open.

  • Windows (.exe): run ZCodium-3.14.4-win-x64.exe. The installer is not signed by ZCode, so SmartScreen shows a warning - a warning, not a system block; click More info -> Run anyway. This is expected, not a corrupted file.

  • Linux x64 (.AppImage): chmod +x ZCodium-3.14.4-linux-x86_64.AppImage && ./ZCodium-3.14.4-linux-x86_64.AppImage.

  • Linux arm64 (.AppImage): chmod +x ZCodium-3.14.4-linux-arm64.AppImage && ./ZCodium-3.14.4-linux-arm64.AppImage.

  • CLI (.tar.gz): requires Node.js 24. Extract and run:

    tar -xzf zcodium-3.14.4.tar.gz
    cd zcodium
    ./install.sh        # installs the zcode command into ~/.zcode/runtime
    zcode --help        # or run: node bin/zcode.mjs --help

中文

相对 ZCode 的改动

  • 移除全部监控与遥测(约 2.6 万行):ARMS RUM、OTLP 上报、崩溃采集、资源与网络采样、UI 埋点,并加了防回归检查,防止重新引入。
  • 官方平台服务默认全部关闭,按开关选择开启:账号登录、反馈上传、编码套餐、官方 MCP 凭证、插件市场与客户端远端配置在对应开关打开前保持断开;默认全关时应用不会连接官方平台,也不会上报任何数据。开关可在“设置 → Z.AI 服务”里随时打开或关闭。
  • 没有强制账号体系:不弹注册墙、不强制登录。首次启动可直接配置自己的 API Key 或自定义模型开始使用;只有打开“Z.AI API 配置”开关后,才会出现浏览器授权登录入口。
  • 默认没有购买与升级引导:不会主动引导你购买套餐;只有打开“套餐与额度”开关后才会显示套餐卡片与购买入口,并可随时关闭。
  • 移除仓库上传行为:快照打包与上传逻辑已删除,并加了防回归保护。
  • 开源可复核:第一方代码 MIT,上游代码 Apache-2.0;桌面端、CLI、UI 的移除报告随仓库发布。
  • 构建透明:安装包由 GitHub Actions 从本仓库构建;应用内更新指向本仓库的 GitHub Releases。
  • 如实说明限制:Computer Use 为不可用占位;安装包没有 ZCode 官方签名。

安装说明

  • macOS(.dmg):按机型下载 ZCodium-3.14.4-mac-arm64.dmg(Apple Silicon)或 ZCodium-3.14.4-mac-x64.dmg(Intel),打开后把 ZCodium 拖进“应用程序”。没有 ZCode 官方签名,Gatekeeper 会拦截首次打开——这是 macOS 独有的系统拦截。用下面命令放行一次(输入密码时不显示字符;命令会自动启动应用并立即退出):

    sudo /usr/bin/xattr -rd com.apple.quarantine "/Applications/ZCodium.app" && open -a "ZCodium"

    使用 /usr/bin/xattr 绝对路径,避免 PATH 中同名工具干扰。也可以在“访达”里右键(Control-点击)应用 -> 打开 -> 弹窗里再点“打开”。

  • Windows(.exe):运行 ZCodium-3.14.4-win-x64.exe。没有 ZCode 官方签名,SmartScreen 会显示警告——只是警告,不是系统拦截;点“更多信息” -> “仍要运行”。这是预期提示,不是文件损坏。

  • Linux x64(.AppImage):chmod +x ZCodium-3.14.4-linux-x86_64.AppImage && ./ZCodium-3.14.4-linux-x86_64.AppImage。

  • Linux arm64(.AppImage):chmod +x ZCodium-3.14.4-linux-arm64.AppImage && ./ZCodium-3.14.4-linux-arm64.AppImage。

  • CLI(.tar.gz):需要 Node.js 24。解压后运行:

    tar -xzf zcodium-3.14.4.tar.gz
    cd zcodium
    ./install.sh        # 安装 zcode 命令到 ~/.zcode/runtime
    zcode --help        # 或直接运行:node bin/zcode.mjs --help

Downloads / 产物

  • macOS Apple Silicon: ZCodium-3.14.4-mac-arm64.dmg / .zip
  • macOS Intel: ZCodium-3.14.4-mac-x64.dmg / .zip
  • Windows x64: ZCodium-3.14.4-win-x64.exe
  • Linux x64: ZCodium-3.14.4-linux-x86_64.AppImage
  • Linux arm64: ZCodium-3.14.4-linux-arm64.AppImage
  • CLI: zcodium-3.14.4.tar.gz
  • Checksums: sha256.txt(下载后可用它校验 / verify downloads with it)
  • Update metadata: latest*.yml, latest.json

v3.14.3

Choose a tag to compare

@github-actions github-actions released this 23 Sep 22:36
fb5628a

ZCodium 3.14.3

Changelog (vs v3.14.2) / 更新日志(相对 v3.14.2)

English

  • Linux arm64 builds: new ZCodium-3.14.3-linux-arm64.AppImage artifact, with auto-update metadata (latest-linux-arm64.yml) so arm64 devices can update automatically.
  • Upstream sync to ZCode v3.14.3 (audited commit-by-commit; telemetry stays stripped):
    • Bots integration: Telegram / Feishu / Lark / Weixin channels, webhook providers, desktop host delivery and the Bots UI.
    • Dynamic workflows: adjust the concurrency limit mid-run, restart/reuse improvements, quiescence & seat-gate fixes, a crash fix, and slimmer workflow tool context.
    • Workflow UI: timeline and card fixes. Protocol v4: projection & transport optimizations. Plus bundled dynamic-workflows skill docs.
  • Audit: the 3 telemetry/upload code paths touched by the upstream commit were stripped during sync (local TTFT reporting, remote connection stats, onboarding upload placeholders); no monitoring or upload behavior was added.

中文

  • Linux arm64 构建:新增 ZCodium-3.14.3-linux-arm64.AppImage 产物,并生成自动更新元数据(latest-linux-arm64.yml),arm64 设备可自动更新。
  • 上游同步至 ZCode v3.14.3(逐提交审计,遥测保持剥离):
    • Bots 集成:Telegram / 飞书 / Lark / 微信渠道、Webhook provider、桌面 host 交付与 Bots 界面。
    • 动态工作流:运行中调整并发上限、修改/重启复用改进、quiescence 与 seat gate 修复、崩溃修复、工具上下文精简。
    • 工作流界面:时间线与卡片修复;协议 v4:投影与传输优化;内置 dynamic-workflows skill 文档。
  • 审计:上游提交涉及的 3 处遥测/上传代码已在同步时剥离(本地 TTFT 上报、远程连接统计、onboarding 上传预留结构);未引入任何监控或上传行为。

English

What changed vs ZCode

  • All monitoring and telemetry removed (~26k lines): ARMS RUM, OTLP reporting, crash collection, resource and network sampling, UI analytics - with regression checks so they cannot be reintroduced.
  • Official platform services disconnected: account login, feedback upload, coding plans, official MCP credentials, plugin marketplace and remote client config are short-circuited before any request; feedback points to GitHub Issues.
  • No account system: no login, no account concepts. Configure your own API key or a custom model provider and start working.
  • No purchase or upgrade prompts: the purchase UI and related copy are removed; nothing pushes you to buy a plan.
  • No repository upload behavior: snapshot packaging and upload logic removed, with guards against reintroduction.
  • Open source and reviewable: first-party code MIT, upstream Apache-2.0; removal reports for desktop, CLI and UI ship in the repository.
  • Transparent builds: installers are built by GitHub Actions from this repository, and in-app updates point to this repository's GitHub Releases.
  • Honest limitations: Computer Use is an unavailable placeholder; installers are not signed by ZCode.

Install

  • macOS (.dmg): download ZCodium-3.14.3-mac-arm64.dmg (Apple Silicon) or ZCodium-3.14.3-mac-x64.dmg (Intel), open it, drag ZCodium into Applications. The app is not signed by ZCode, so Gatekeeper blocks the first launch - this system block is macOS only. Allow it once with the command below (enter your login password when asked; nothing is shown while typing; the command launches the app and exits immediately):

    sudo /usr/bin/xattr -rd com.apple.quarantine "/Applications/ZCodium.app" && open -a "ZCodium"

    The absolute /usr/bin/xattr path avoids shadowing by other tools with the same name. You can also right-click (Control-click) the app in Finder -> Open -> Open.

  • Windows (.exe): run ZCodium-3.14.3-win-x64.exe. The installer is not signed by ZCode, so SmartScreen shows a warning - a warning, not a system block; click More info -> Run anyway. This is expected, not a corrupted file.

  • Linux x64 (.AppImage): chmod +x ZCodium-3.14.3-linux-x86_64.AppImage && ./ZCodium-3.14.3-linux-x86_64.AppImage.

  • Linux arm64 (.AppImage): chmod +x ZCodium-3.14.3-linux-arm64.AppImage && ./ZCodium-3.14.3-linux-arm64.AppImage.

  • CLI (.tar.gz): requires Node.js 24. Extract and run:

    tar -xzf zcodium-3.14.3.tar.gz
    cd zcodium
    ./install.sh        # installs the zcode command into ~/.zcode/runtime
    zcode --help        # or run: node bin/zcode.mjs --help

中文

相对 ZCode 的改动

  • 移除全部监控与遥测(约 2.6 万行):ARMS RUM、OTLP 上报、崩溃采集、资源与网络采样、UI 埋点,并加了防回归检查,防止重新引入。
  • 断开官方平台服务:账号登录、反馈上传、编码套餐、官方 MCP 凭证、插件市场与客户端远端配置在请求前短路;反馈入口指向 GitHub Issues。
  • 没有账号体系:不需要登录,也没有任何账号概念。配置自己的 API Key 或自定义模型即可开始使用。
  • 没有购买与升级引导:购买界面与相关文案已移除,不会引导你购买套餐。
  • 移除仓库上传行为:快照打包与上传逻辑已删除,并加了防回归保护。
  • 开源可复核:第一方代码 MIT,上游代码 Apache-2.0;桌面端、CLI、UI 的移除报告随仓库发布。
  • 构建透明:安装包由 GitHub Actions 从本仓库构建;应用内更新指向本仓库的 GitHub Releases。
  • 如实说明限制:Computer Use 为不可用占位;安装包没有 ZCode 官方签名。

安装说明

  • macOS(.dmg):按机型下载 ZCodium-3.14.3-mac-arm64.dmg(Apple Silicon)或 ZCodium-3.14.3-mac-x64.dmg(Intel),打开后把 ZCodium 拖进“应用程序”。没有 ZCode 官方签名,Gatekeeper 会拦截首次打开——这是 macOS 独有的系统拦截。用下面命令放行一次(输入密码时不显示字符;命令会自动启动应用并立即退出):

    sudo /usr/bin/xattr -rd com.apple.quarantine "/Applications/ZCodium.app" && open -a "ZCodium"

    使用 /usr/bin/xattr 绝对路径,避免 PATH 中同名工具干扰。也可以在“访达”里右键(Control-点击)应用 -> 打开 -> 弹窗里再点“打开”。

  • Windows(.exe):运行 ZCodium-3.14.3-win-x64.exe。没有 ZCode 官方签名,SmartScreen 会显示警告——只是警告,不是系统拦截;点“更多信息” -> “仍要运行”。这是预期提示,不是文件损坏。

  • Linux x64(.AppImage):chmod +x ZCodium-3.14.3-linux-x86_64.AppImage && ./ZCodium-3.14.3-linux-x86_64.AppImage。

  • Linux arm64(.AppImage):chmod +x ZCodium-3.14.3-linux-arm64.AppImage && ./ZCodium-3.14.3-linux-arm64.AppImage。

  • CLI(.tar.gz):需要 Node.js 24。解压后运行:

    tar -xzf zcodium-3.14.3.tar.gz
    cd zcodium
    ./install.sh        # 安装 zcode 命令到 ~/.zcode/runtime
    zcode --help        # 或直接运行:node bin/zcode.mjs --help

Downloads / 产物

  • macOS Apple Silicon: ZCodium-3.14.3-mac-arm64.dmg / .zip
  • macOS Intel: ZCodium-3.14.3-mac-x64.dmg / .zip
  • Windows x64: ZCodium-3.14.3-win-x64.exe
  • Linux x64: ZCodium-3.14.3-linux-x86_64.AppImage
  • Linux arm64: ZCodium-3.14.3-linux-arm64.AppImage
  • CLI: zcodium-3.14.3.tar.gz
  • Checksums: sha256.txt(下载后可用它校验 / verify downloads with it)
  • Update metadata: latest*.yml, latest.json