ZCode 的社区分支，只做该做的改动
An independent community fork of ZCode
保留完整功能与上游可同步性；遥测与厂商服务默认关闭，模型用你自己的 API Key 直接接入，会话与设置仍与官方客户端共用同一份数据；另提供独立的命令行版（TUI + Web）。
Full upstream feature set, kept in sync. Telemetry and vendor services are off by default, models connect with your own API key, and sessions stay shared with the official client. A standalone CLI (TUI + Web) is released alongside the desktop build.
默认关闭的东西
Off by default
上游这些能力都保留在代码里，只是不再默认启用；把开关打开即恢复原行为。
Upstream keeps the code — it is simply not enabled by default. Flip the switch to restore it.
遥测与监控Telemetry
数仓上报、ARMS、OTLP 全部默认关闭；采样器注册也一并纳入总开关，不留后台常驻定时器。
Warehouse reporting, ARMS and OTLP are off; sampler registration is gated by the same switch, so nothing keeps polling in the background.
官方账号体系Account sign-in
不要求登录，也不再用账号状态作为启动门禁；模型通过 API Key 直接接入。
No sign-in required, and account state no longer gates startup. Models connect directly with an API key.
厂商服务Vendor services
反馈、会话分享、套餐购买入口、插件市场远端源默认关闭；本地内置插件不受影响。
Feedback, conversation sharing, plan purchase and the remote plugin marketplace are off; bundled plugins still work.
相对上游多做的事
What this fork adds
模型额度显示Model balance
用已配置的 API Key 查询 DeepSeek、GLM Coding、Kimi、MiniMax、OpenRouter 的余额与套餐余量；未配置的厂商自动隐藏。
Query balances for DeepSeek, GLM Coding, Kimi, MiniMax and OpenRouter using the keys you already configured. Providers without one stay hidden.
透明的紫色主题Translucent theme
「紫夜」主题让桌面与窗口材质透出来，色板取自 Zed 的 Nightfox 主题包。Web 端自动改用纯色。
A "Dusk" theme reveals the desktop through vibrancy and acrylic, with a palette taken from Zed's Nightfox pack. The web build falls back to solid colour.
更新只检测，不代装Check-only updates
检测本仓库的 Release 并引导你前往下载，不在应用内下载或安装——避免被装回官方版本。
Detects a newer release and sends you to the download page. Nothing is installed in-app, so you can never be silently switched back to upstream.
命令行版独立发行Standalone CLI
与桌面版同版本号的 TUI + Web 独立发行包，覆盖 macOS arm64 与 Linux x64 / arm64；下载安装包后离线即可安装。
A TUI + Web bundle released alongside the desktop build under the same version, covering macOS arm64 and Linux x64/arm64. Install offline from a downloaded tarball.
与官方客户端的边界
How it relates to upstream
两者可以并排安装，数据边界清晰：
Install side by side; the data boundary is explicit:
| 项目 | 说明 | Item | Behaviour |
|---|---|---|---|
| 会话与模型设置 | 存放在 .zcode 数据根，与官方客户端共用同一份，装上即可读到既有对话与配置。 |
Sessions & settings | Shared through the .zcode data root, so existing conversations and configuration carry over. |
| 界面偏好 | 使用独立的 Electron 数据目录，两者互不影响，也因此可以同时运行。 | UI preferences | A separate Electron data directory keeps them independent — which is why both can run at once. |
| 跨端契约 | zcode:// 协议、@zcode/* 包名、ZCODE_* 环境变量与 .zcode 目录名保持与上游一致。 |
Contracts | The zcode:// scheme, @zcode/* scopes, ZCODE_* variables and the .zcode directory intentionally match upstream. |
命令行版（TUI + Web）
CLI (TUI + Web)
与桌面版同版本号、独立发行，覆盖 macOS arm64 与 Linux x64 / arm64，需要 Node.js 24。从 Releases 下载 ZCode-Libre-CLI-<版本>.tar.gz 后在本机安装，全程不需要联网：
Released independently under the same version as the desktop build, covering macOS arm64 and Linux x64/arm64; Node.js 24 required. Download ZCode-Libre-CLI-<version>.tar.gz from Releases and install it locally — no network needed:
tar -xzf ZCode-Libre-CLI-*.tar.gz
node zcode/bin/zcode.mjs # TUI
node zcode/bin/zcode.mjs --web # Web UI
# 安装到 ~/.zcode/runtime 并生成 zcode 命令 / install and get the zcode command
sh install.sh --tarball ./ZCode-Libre-CLI-*.tar.gz
zcode # TUI
zcode --web # Web UI本地构建
Build locally
需要 Git、Node.js 24.14.0 与 pnpm 10.33.2，版本以仓库的 mise.toml 为准。
Requires Git, Node.js 24.14.0 and pnpm 10.33.2; mise.toml is the source of truth.
git clone https://github.com/wenyinos/ZCode-Libre.git
cd ZCode-Libre
pnpm bootstrap
pnpm dev:desktop # 桌面开发 / desktop dev
pnpm bundle:desktop # 打包当前平台 / package for this platform许可与来源
License & provenance
- 源码来自 ZCode，第一方代码依 Apache-2.0 授权，原始版权归 Z.AI Co., Ltd 所有，授权与声明保持上游原样。
- Source comes from ZCode. First-party code is Apache-2.0; original copyright remains with Z.AI Co., Ltd, and the license text is unchanged.
- 本分支的修改与新增功能同样以 Apache-2.0 提供；品牌资源与构建产物由本分支维护。
- Changes and additions in this fork are offered under the same Apache-2.0 terms; brand assets and build artifacts are maintained here.
- 与 Z.ai 无从属关系，也不代表其立场。
- Not affiliated with, nor endorsed by, Z.ai.