Skip to content

v3.15.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 12 Oct 22:45
· 15 commits to main since this release
v3.15.0
03a3e45

下载 / 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

Assets 14
Loading