v3.15.1

下载 / Downloads

未签名构建，首次打开会被系统安全提示拦截；用下方 checksums.txt 核对 SHA256。
Unsigned builds — the first launch is blocked by Gatekeeper / SmartScreen. Verify against checksums.txt.

macOS（Apple Silicon / arm64）

下载 .dmg，把 ZCode-Libre 拖入「应用程序」。首次打开若被拦截：
sudo xattr -rd com.apple.quarantine /Applications/ZCode-Libre.app

Windows（x64）

下载 .exe，SmartScreen 提示时选「更多信息」→「仍要运行」。

Linux（x64 与 arm64 均可用）

按发行版选择系统包：包在对应发行版容器内构建，使用该发行版原生的打包后端。

发行版 / Distro	包格式
Debian / Ubuntu	.deb（sudo apt install ./<file>.deb）
Fedora / RHEL / openSUSE	.rpm（sudo dnf install ./<file>.rpm）

架构按文件名后缀区分：x86_64/amd64 为 64 位 x86，aarch64/arm64 为 ARM64。

安装后从应用菜单启动；走终端时用完整路径 /opt/ZCode-Libre/zcode-libre
（包不提供 /usr/bin 入口）。本分支与官方 ZCode 共用 .zcode 数据根，
但使用独立的界面偏好目录，因此两者可以同时安装、同时运行。

命令行版 / CLI（macOS arm64、Linux x64/arm64）

与桌面版同版本号的独立发行包，含终端界面（TUI）与 Web 界面，需要 Node.js 24。
下载本页的 ZCode-Libre-CLI-<版本>.tar.gz 后在本机安装，全程不需要联网：

# 解压即用
tar -xzf ZCode-Libre-CLI-*.tar.gz
node zcode/bin/zcode.mjs        # 终端界面（TUI）
node zcode/bin/zcode.mjs --web  # Web 界面

# 或安装到 ~/.zcode/runtime 并生成 zcode 命令（install.sh 在本页）
sh install.sh --tarball ./ZCode-Libre-CLI-*.tar.gz
zcode        # 终端界面（TUI）
zcode --web  # Web 界面

与桌面版共用 .zcode 数据根；下载页的 sha256.txt 可用于校验安装包。

本次更新 / What's new

本仓库新增 / Added in this fork

• fix: 修 web-share 的 shared 子路径别名，桌面打包恢复可构建 (4a28846)
• fix: 补回遥测开关导出并锁定 Gen UI 快照字节 (188ee5c)
• chore: 版本号改用上游同号 3.15.1 (69a1aca)

上游合并 / Merged from upstream

无

关于这个版本 / About this build

• 遥测与厂商服务默认关闭，模型用你自己的 API Key 接入。
• 应用内更新只检测本仓库的 Release 并引导下载，不会自动安装，也不会被换回官方版本。
• 与上游的完整差异见 UPSTREAM.md。

Full Changelog: v3.15.0...v3.15.1

v3.15.0

下载 / Downloads

未签名构建，首次打开会被系统安全提示拦截；用下方 checksums.txt 核对 SHA256。
Unsigned builds — the first launch is blocked by Gatekeeper / SmartScreen. Verify against checksums.txt.

macOS（Apple Silicon / arm64）

下载 .dmg，把 ZCode-Libre 拖入「应用程序」。首次打开若被拦截：
sudo xattr -rd com.apple.quarantine /Applications/ZCode-Libre.app

Windows（x64）

下载 .exe，SmartScreen 提示时选「更多信息」→「仍要运行」。

Linux（x64 与 arm64 均可用）

按发行版选择系统包：包在对应发行版容器内构建，使用该发行版原生的打包后端。

发行版 / Distro	包格式
Debian / Ubuntu	.deb（sudo apt install ./<file>.deb）
Fedora / RHEL / openSUSE	.rpm（sudo dnf install ./<file>.rpm）

架构按文件名后缀区分：x86_64/amd64 为 64 位 x86，aarch64/arm64 为 ARM64。

安装后从应用菜单启动；走终端时用完整路径 /opt/ZCode-Libre/zcode-libre
（包不提供 /usr/bin 入口）。本分支与官方 ZCode 共用 .zcode 数据根，
但使用独立的界面偏好目录，因此两者可以同时安装、同时运行。

命令行版 / CLI（macOS arm64、Linux x64/arm64）

与桌面版同版本号的独立发行包，含终端界面（TUI）与 Web 界面，需要 Node.js 24。
下载本页的 ZCode-Libre-CLI-<版本>.tar.gz 后在本机安装，全程不需要联网：

# 解压即用
tar -xzf ZCode-Libre-CLI-*.tar.gz
node zcode/bin/zcode.mjs        # 终端界面（TUI）
node zcode/bin/zcode.mjs --web  # Web 界面

# 或安装到 ~/.zcode/runtime 并生成 zcode 命令（install.sh 在本页）
sh install.sh --tarball ./ZCode-Libre-CLI-*.tar.gz
zcode        # 终端界面（TUI）
zcode --web  # Web 界面

与桌面版共用 .zcode 数据根；下载页的 sha256.txt 可用于校验安装包。

本次更新 / What's new

本次同步上游 ZCode v3.15.1（上游发布提交 aac4755），并叠加本分支自己的品牌、策略与构建修复。
This release merges upstream ZCode v3.15.1 plus this fork's own brand, policy and build fixes.

上游 v3.15.1 带来的能力

• Gen UI（生成式界面）：助手回复可以直接渲染成可交互的卡片与页面，带主题适配、Tweaks 微调面板与「保留页面」能力；
  可视化与浮层依赖（d3、floating-ui、lucide）以固定快照随包分发，离线可用。
  Gen UI renders assistant output as interactive cards and pages — theme-aware, with a Tweaks panel and retained pages;
  the visualization/popover libraries ship as pinned offline snapshots.
• UI 插件与插件沙箱：新增 plugin-ui / gen-ui 契约（CONTRACT.md + adapters/components），桌面端为插件界面单独开沙箱渲染通道；
  插件可以自带界面，不再只能返回文本。
• 动态工作流：CLI 新增 dynamic-workflow 包，支持工作流的运行、保存与再次运行；
  聊天内的「保存工作流」弹层给出命名规则、作用域（项目 / 全局）、重名覆盖与遮蔽提醒。
• 远程工作区与手机 Web 远控：远控会话的 workspace 承载与重连语义更新，新增助手代码评论卡片（code comment），
  手机端主题菜单上线；远控主题种子改由 packages/shared 统一类型与校验。
• Agent 与运行时：CLI 的 core / bootstrap / adapters 更新工具解析与运行时契约；插件市场新增 Claude 官方目录源。
• 构建期配置：遥测端点从源码硬编码改为构建期注入（__ZCODE_ARMS_RUM_ENDPOINT__ 等 define），未注入即为空。

本分支对这些能力的处理口径不变：厂商服务与遥测默认关闭，远端插件市场源受策略开关控制，
会话分享与套餐购买走「不支持」占位；紫夜（zai-dusk）主题在上游新增的每个主题入口都已补齐。

本仓库新增 / Added in this fork

• docs: 重制项目海报并在站点补充命令行版 (1dcd4a3)
• fix: CLI 产物上传前扁平化，发布端拦下子目录 (8de1ca2)
• feat: CLI 包改名为 ZCode-Libre-CLI-<版本>.tar.gz (9a70b73)
• fix: 补齐品牌图标漏同步并保留厂商 MCP 专名 (491e82b)
• fix: 更新检查与登录页保留分支策略边界 (e611d0c)
• test: 同步 v3.15.1 后按分支口径对齐断言 (c4760ac)
• docs: 登记 v3.15.1 同步的偏离与自检项 (03a3e45)
• fix: 修 web-share 的 shared 子路径别名，桌面打包恢复可构建 (4a28846)
• fix: 补回遥测开关导出并锁定 Gen UI 快照字节 (188ee5c)

上游合并 / Merged from upstream

• feat: update to v3.15.1 (aac4755)

关于这个版本 / About this build

• 遥测与厂商服务默认关闭，模型用你自己的 API Key 接入。
• 应用内更新只检测本仓库的 Release 并引导下载，不会自动安装，也不会被换回官方版本。
• 本页产物由 188ee5c 构建；tag v3.15.0 指向 03a3e45，两者相差上面最后两条构建修复。
• 从下一版起，本分支版本号直接采用上游发布号（本次即 v3.15.1），自研增量在其上递增，规则见下条链接。
• 与上游的完整差异见 UPSTREAM.md。

Full Changelog: v3.14.7...v3.15.0

v3.14.7

下载 / Downloads

未签名构建，首次打开会被系统安全提示拦截；用下方 checksums.txt 核对 SHA256。
Unsigned builds — the first launch is blocked by Gatekeeper / SmartScreen. Verify against checksums.txt.

macOS（Apple Silicon / arm64）

下载 .dmg，把 ZCode-Libre 拖入「应用程序」。首次打开若被拦截：
sudo xattr -rd com.apple.quarantine /Applications/ZCode-Libre.app

Windows（x64）

下载 .exe，SmartScreen 提示时选「更多信息」→「仍要运行」。

Linux（x64 与 arm64 均可用）

按发行版选择系统包：包在对应发行版容器内构建，使用该发行版原生的打包后端。

发行版 / Distro	包格式
Debian / Ubuntu	.deb（sudo apt install ./<file>.deb）
Fedora / RHEL / openSUSE	.rpm（sudo dnf install ./<file>.rpm）

架构按文件名后缀区分：x86_64/amd64 为 64 位 x86，aarch64/arm64 为 ARM64。

安装后从应用菜单启动；走终端时用完整路径 /opt/ZCode-Libre/zcode-libre
（包不提供 /usr/bin 入口）。本分支与官方 ZCode 共用 .zcode 数据根，
但使用独立的界面偏好目录，因此两者可以同时安装、同时运行。

命令行版 / CLI（macOS arm64、Linux x64/arm64）

与桌面版同版本号的独立发行包，含终端界面（TUI）与 Web 界面，需要 Node.js 24。
下载本页的 ZCode-Libre-CLI-<版本>.tar.gz 后在本机安装，全程不需要联网：

# 解压即用
tar -xzf ZCode-Libre-CLI-*.tar.gz
node zcode/bin/zcode.mjs        # 终端界面（TUI）
node zcode/bin/zcode.mjs --web  # Web 界面

# 或安装到 ~/.zcode/runtime 并生成 zcode 命令（install.sh 在本页）
sh install.sh --tarball ./ZCode-Libre-CLI-*.tar.gz
zcode        # 终端界面（TUI）
zcode --web  # Web 界面

与桌面版共用 .zcode 数据根；下载页的 sha256.txt 可用于校验安装包。

本次更新 / What's new

本仓库新增 / Added in this fork

• fix: 默认关闭项自检逐项断言策略默认值 (b8cf9fc)
• fix: 遥测调用位置改用语法树判断，不再依赖缩进 (8a4dfb0)
• docs: 去掉 README 中重复的遥测章节标题与段落 (9464402)
• docs: 写明架构策略只覆盖受管模块是有意取舍 (882dbc9)
• feat: 命令行版独立发行（TUI + Web，macOS/Linux 三平台） (5d42483)
• chore: CLI 发布流程只负责资产，发布说明由桌面流程统一生成 (fd851ec)
• ci: CLI 构建并入 Release 运行，推一次 tag 完成全部发布 (6847586)
• fix: build:zcode 补齐 TUI 运行时所需的 workspace 包 dist (e3d0799)

上游合并 / Merged from upstream

无

关于这个版本 / About this build

• 遥测与厂商服务默认关闭，模型用你自己的 API Key 接入。
• 应用内更新只检测本仓库的 Release 并引导下载，不会自动安装，也不会被换回官方版本。
• 与上游的完整差异见 UPSTREAM.md。

Full Changelog: v3.14.6...v3.14.7

v3.14.6

下载 / Downloads

未签名构建，首次打开会被系统安全提示拦截；用下方 checksums.txt 核对 SHA256。
Unsigned builds — the first launch is blocked by Gatekeeper / SmartScreen. Verify against checksums.txt.

macOS（Apple Silicon / arm64）

下载 .dmg，把 ZCode-Libre 拖入「应用程序」。首次打开若被拦截：
sudo xattr -rd com.apple.quarantine /Applications/ZCode-Libre.app

Windows（x64）

下载 .exe，SmartScreen 提示时选「更多信息」→「仍要运行」。

Linux（x64 与 arm64 均可用）

按发行版选择系统包：包在对应发行版容器内构建，使用该发行版原生的打包后端。

发行版 / Distro	包格式
Debian / Ubuntu	.deb（sudo apt install ./<file>.deb）
Fedora / RHEL / openSUSE	.rpm（sudo dnf install ./<file>.rpm）

架构按文件名后缀区分：x86_64/amd64 为 64 位 x86，aarch64/arm64 为 ARM64。

安装后从应用菜单启动；走终端时用完整路径 /opt/ZCode-Libre/zcode-libre
（包不提供 /usr/bin 入口）。本分支与官方 ZCode 共用 .zcode 数据根，
但使用独立的界面偏好目录，因此两者可以同时安装、同时运行。

本次更新 / What's new

本仓库新增 / Added in this fork

• docs: README 加入项目介绍海报与站点地址 (c068bf4)
• feat: 官方账号派生凭据在存储层就拒绝读取 (efd58c9)
• docs: README 说明不使用官方账号与官方订阅 (afa3214)
• docs: 写明与官方客户端同时运行时的边界 (7db4e20)
• chore: 版本号提到 3.14.6 (bd57139)

上游合并 / Merged from upstream

无

关于这个版本 / About this build

• 遥测与厂商服务默认关闭，模型用你自己的 API Key 接入。
• 应用内更新只检测本仓库的 Release 并引导下载，不会自动安装，也不会被换回官方版本。
• 与上游的完整差异见 UPSTREAM.md。

Full Changelog: v3.14.5...v3.14.6

v3.14.5

下载 / Downloads

未签名构建，首次打开会被系统安全提示拦截；用下方 checksums.txt 核对 SHA256。
Unsigned builds — the first launch is blocked by Gatekeeper / SmartScreen. Verify against checksums.txt.

macOS（Apple Silicon / arm64）

下载 .dmg，把 ZCode-Libre 拖入「应用程序」。首次打开若被拦截：
sudo xattr -rd com.apple.quarantine /Applications/ZCode-Libre.app

Windows（x64）

下载 .exe，SmartScreen 提示时选「更多信息」→「仍要运行」。

Linux（x64 与 arm64 均可用）

按发行版选择系统包：包在对应发行版容器内构建，使用该发行版原生的打包后端。

发行版 / Distro	包格式
Debian / Ubuntu	.deb（sudo apt install ./<file>.deb）
Fedora / RHEL / openSUSE	.rpm（sudo dnf install ./<file>.rpm）

架构按文件名后缀区分：x86_64/amd64 为 64 位 x86，aarch64/arm64 为 ARM64。

安装后从应用菜单启动；走终端时用完整路径 /opt/ZCode-Libre/zcode-libre
（包不提供 /usr/bin 入口）。本分支与官方 ZCode 共用 .zcode 数据根，
但使用独立的界面偏好目录，因此两者可以同时安装、同时运行。

本次更新 / What's new

本仓库新增 / Added in this fork

• feat: 套餐额度独立成「个人套餐」分区 (88a946a)
• feat: 额度新增 OpenCode Go 与 Command Code (dbf2251)
• feat: 额度补上 StepFun 与 MiniMax Coding Plan (25bfed7)
• feat: 发布页面按来源分栏列出改动 (6024c4a)
• fix: 发布说明识别被上游改写过的提交 (9a49726)
• ci: push 与 PR 上跑类型检查、lint 与分支不变量 (c95ac05)
• ci: 每天检查上游是否前进，有未合入提交就开 issue (f21ccc8)
• fix: 官方账号登录入口在命令面板里仍然可见 (ea61f39)
• fix: 账号菜单里的登录入口同样默认隐藏 (71cf098)
• chore: 版本号提到 3.14.5 (91e7e22)

上游合并 / Merged from upstream

无

关于这个版本 / About this build

• 遥测与厂商服务默认关闭，模型用你自己的 API Key 接入。
• 应用内更新只检测本仓库的 Release 并引导下载，不会自动安装，也不会被换回官方版本。
• 与上游的完整差异见 UPSTREAM.md。

Full Changelog: v3.14.4...v3.14.5

v3.14.4

下载 / Downloads

未签名构建，首次打开会被系统安全提示拦截；用下方 checksums.txt 核对 SHA256。
Unsigned builds — the first launch is blocked by Gatekeeper / SmartScreen. Verify against checksums.txt.

macOS（Apple Silicon / arm64）

下载 .dmg，把 ZCode-Libre 拖入「应用程序」。首次打开若被拦截：
sudo xattr -rd com.apple.quarantine /Applications/ZCode-Libre.app

Windows（x64）

下载 .exe，SmartScreen 提示时选「更多信息」→「仍要运行」。

Linux（x64 与 arm64 均可用）

按发行版选择系统包：包在对应发行版容器内构建，使用该发行版原生的打包后端。

发行版 / Distro	包格式
Debian / Ubuntu	.deb（sudo apt install ./<file>.deb）
Fedora / RHEL / openSUSE	.rpm（sudo dnf install ./<file>.rpm）

架构按文件名后缀区分：x86_64/amd64 为 64 位 x86，aarch64/arm64 为 ARM64。

安装后从应用菜单启动；走终端时用完整路径 /opt/ZCode-Libre/zcode-libre
（包不提供 /usr/bin 入口）。本分支与官方 ZCode 共用 .zcode 数据根，
但使用独立的界面偏好目录，因此两者可以同时安装、同时运行。

本次更新 / What's new

本仓库新增 / Added in this fork

• feat: 标志加几何缺口，轮廓即可与官方区分 (5f038f7)
• feat: 关于窗口注明第三方分支，与智谱官方无关 (80d77c8)
• feat: 社群入口改指自有 Discussions，反馈入口逐处门禁 (b764a19)
• ci: rpm 关闭 build-id 链接，修复与官方包的安装冲突 (d34483d)
• fix: 紫夜主题在桌面 Linux 回退为纯色 (4b830f6)
• chore: 内置反馈地址换成自有 Discussions (ee6957f)
• chore: 版本号提到 3.14.4，并在 UPSTREAM.md 记录版本线策略 (d8659ce)
• ci: 构建时断言 rpm 不含 build-id 链接 (3556ac8)

上游合并 / Merged from upstream

无

关于这个版本 / About this build

• 遥测与厂商服务默认关闭，模型用你自己的 API Key 接入。
• 应用内更新只检测本仓库的 Release 并引导下载，不会自动安装，也不会被换回官方版本。
• 与上游的完整差异见 UPSTREAM.md。

Full Changelog: v3.14.3...v3.14.4

v3.14.3

下载 / Downloads

未签名构建，首次打开会被系统安全提示拦截；用下方 checksums.txt 核对 SHA256。
Unsigned builds — the first launch is blocked by Gatekeeper / SmartScreen. Verify against checksums.txt.

macOS（Apple Silicon / arm64）

下载 .dmg，把 ZCode-Libre 拖入「应用程序」。首次打开若被拦截：
sudo xattr -rd com.apple.quarantine /Applications/ZCode-Libre.app

Windows（x64）

下载 .exe，SmartScreen 提示时选「更多信息」→「仍要运行」。

Linux（x64 与 arm64 均可用）

按发行版选择系统包：包在对应发行版容器内构建，使用该发行版原生的打包后端。

发行版 / Distro	包格式
Debian / Ubuntu	.deb（sudo apt install ./<file>.deb）
Fedora / RHEL / openSUSE	.rpm（sudo dnf install ./<file>.rpm）

架构按文件名后缀区分：x86_64/amd64 为 64 位 x86，aarch64/arm64 为 ARM64。

安装后从应用菜单启动；走终端时用完整路径 /opt/ZCode-Libre/zcode-libre
（包不提供 /usr/bin 入口）。本分支与官方 ZCode 共用 .zcode 数据根，
但使用独立的界面偏好目录，因此两者可以同时安装、同时运行。

本次更新 / What's new

本仓库新增 / Added in this fork

• feat: 品牌与图标改为 ZCode-Libre (2ed6699)
• feat: 遥测与厂商服务默认关闭，屏蔽官方账号登录 (e71a419)
• feat: 新增紫夜（透明）主题 (a7103ae)
• feat: 应用内更新改为检测自有 Release，不下载不安装 (359d689)
• feat: 新增模型额度显示 (8882718)
• docs: 新增 UPSTREAM.md 记录与上游的偏离点与同步流程 (fbe496e)
• docs: 新增 GitHub Pages 项目站点 (2fcba42)
• docs: README 加入项目站点、下载与讨论区链接 (d86ff3f)
• test: 增加默认关闭项的回归检查 (e5a5a08)
• feat: 厂商服务增加逐项 Settings 开关 (795d393)
• ci: 增加三平台 Release 构建，Linux 改为系统包分发 (a57a1b7)
• test: 增加上游同步的提交审计工具 (6bda99d)
• ci: Release 矩阵补齐 macOS x64 与 Linux arm64 (18ae125)
• ci: 修复 Linux 打包并精简矩阵 (177b024)
• ci: Linux 打包改用各发行版容器 (a3a6b02)
• ci: 容器内补齐原生模块工具链 (6c44d09)
• ci: 手动触发时取消旧的 release 运行 (0fe5fcd)
• ci: 移除 pacman 目标，Linux 只保留 deb 与 rpm (5805183)
• ci: 容器内信任工作目录并输出 git 诊断 (f045cc9)
• ci: rpm 也改在 Debian 容器内构建 (a90fecc)
• ci: 支持复用已有产物发布 (979f8d0)
• ci: 修复复用模式的产物展平 (f82ac1e)
• ci: 打包时显式指定生产环境 (0d14000)

上游合并 / Merged from upstream

• feat: update v3.14.3 (29628c9)

关于这个版本 / About this build

• 遥测与厂商服务默认关闭，模型用你自己的 API Key 接入。
• 应用内更新只检测本仓库的 Release 并引导下载，不会自动安装，也不会被换回官方版本。
• 与上游的完整差异见 UPSTREAM.md。

Full Changelog: https://github.com/wenyinos/ZCode-Libre/commits/v3.14.3