字澈 · Ziche

字澈是一个面向 Windows 的系统界面字体工作台。它读取当前用户的六项系统界面字体设置，提供实时预览与按真实字体渲染的字体选择器，并在用户确认后写入系统设置。

下载最新 Windows 安装包

_{应用界面：实时字体预览与全局字体控制。}

下载与安装

普通用户无需下载源码，也无需安装 Node.js、npm 或 C++ 工具链。请前往 最新发布页，下载对应的 Windows 发布资产。

文件	用途
Ziche-Setup-<版本>-x64.exe	**推荐。**标准 Windows 图形安装包，随系统语言提供简体中文/English 安装界面；可选择仅为当前用户或所有用户安装、修改安装目录，并创建开始菜单和桌面快捷方式。安装后可在“已安装的应用”中卸载。
Ziche-Portable-<版本>-x64.exe	免安装单文件版；直接运行即可，不创建安装记录或快捷方式。
SHA256SUMS.txt	两个可执行文件的 SHA-256 校验和。
SelfTestReport.json	打包、静默安装、运行时和静默卸载的自动自检结果。
Source code (zip) / Source code (tar.gz)	源代码快照，不是普通用户要下载的应用程序。

当前公开版本目标为 Windows 10/11 x64。首次运行未签名的 EXE 时，Windows SmartScreen 可能显示提示；请只从本仓库的 Release 页面下载，必要时先用 SHA256SUMS.txt 校验文件。

界面预览

以下截图展示字澈的主要功能。示例仅用于界面说明，未执行“应用”操作。

全局调整与逐项定制

全局控制可一次管理六项系统界面字体；标题栏、图标、调色板标题、提示、消息框和菜单也可以独立细调。

已安装字体的实时下拉预览

下拉列表直接枚举已安装字体，并在列表内显示真实字体效果；顶部预览区会同步展示当前选择。

项目结构

• src/：唯一的 React 渲染界面，负责预览、编辑与确认交互。
• electron/：桌面窗口与受限 IPC 边界；所有来自界面的字体数据都会在这里校验。
• native/：Windows C++ 本机服务，枚举已安装字体、读取系统字体、在确认操作后应用设置。
• shared/：前后端共享的数据契约。
• scripts/：本机服务编译、运行时准备和发布包验证。
• build/icon.svg：Windows 安装包、开始菜单和任务栏使用的字澈矢量图标源文件。

没有另一套旧界面、回退渲染路径或对父目录的运行时依赖；应用的唯一运行路径是 React + Electron + ZicheNative.exe。

开发前置条件

以下仅适用于从源码开发或自行打包，不适用于下载 Release 的普通使用者。

• Windows 10/11 x64
• Node.js（使用锁定的 package-lock.json 安装依赖）
• Visual Studio Build Tools，且已安装“C++ 桌面开发”工作负载或 MSVC x64 C++ 工具链

git clone https://github.com/y4Nkk/ZiChe.git
cd ZiChe
npm ci
npm run dev

npm run dev 会启动 Vite 开发服务器与 Electron 窗口。系统设置只会在应用内明确确认“应用”后才会写入。

本地构建与验证

npm run typecheck
npm run package:windows
npm run verify:package -- release/win-unpacked release/PackageSelfTest.json
npm run verify:installer -- release/Ziche-Setup-<版本>-x64.exe release/InstallerSelfTest.json

成功后，release/ 中会有两种面向用户的交付物：

Ziche-Setup-<版本>-x64.exe
Ziche-Portable-<版本>-x64.exe

安装验证会在受控的临时目录中执行静默安装、检查已安装应用的运行时内容和原生字体服务，再执行静默卸载；验证结束后会清理测试安装目录。

release/、dist/ 和 node_modules/ 都是本机生成内容，已排除在 Git 版本控制之外。

GitHub 自动构建与发布

仓库维护一条唯一的 Windows 发布流水线：编译 React、Electron 和原生字体服务，产出安装版与免安装版，然后分别验证未安装应用和实际 NSIS 安装/卸载流程。

工作流	触发时机	作用
.github/workflows/ci.yml	推送到 main、创建或更新面向 main 的 Pull Request、手动运行	还原锁定依赖，执行类型检查，构建 Setup.exe 和单文件免安装版，验证 app.asar、SVG 图标、六项原生字体数据及静默安装/卸载。成功的 main 构建会更新滚动预发布 latest。
.github/workflows/release.yml	推送严格的 v主版本.次版本.修订版本 标签，或手动输入标签	要求标签与 package.json 版本一致，重新构建和自检后创建固定语义版本的 GitHub Release。

latest 只在所有构建与自检均通过后更新，是面向日常使用的滚动预发布。它提供：

Ziche-Setup-<版本>-x64.exe
Ziche-Portable-<版本>-x64.exe
SHA256SUMS.txt
SelfTestReport.json

对外固定某一版时，先将 package.json 版本更新为目标版本，再推送同名标签，例如：

git tag v1.2.0
git push origin v1.2.0

固定版本 Release 与持续更新的 latest 相互独立；日常提交只需：

git add -A
git commit -m "说明本次改动"
git push origin main

许可

MIT，详见 LICENSE。