Zebar 开源项目安装与使用教程

1. 项目目录结构及介绍

Zebar 是一个用于创建可定制化且跨平台的任务栏、桌面小部件和弹出窗口的工具。下面是其基本的目录结构概述：

zebar
├── cargo.lock           # Rust依赖关系锁文件
├── Cargo.toml          # Rust项目的主配置文件
├── CONTRIBUTING.md     # 贡献指南
├── editorconfig        # 编辑器配置文件
├── gitattributes       # Git属性文件
├── gitignore           # Git忽略文件列表
├── npmrc               # Node.js配置文件
├── nvmrc               # Node Version Manager配置
├── prettierignore      # Prettier代码格式化忽略文件
├── LICENSE.md          # 许可证文件
├── README.md           # 项目说明文件
├── package.json        # Node.js项目配置
├── pnpm-lock.yaml      # pnpm依赖关系锁文件
├── pnpm-workspace.yaml # pnpm工作区配置
├── rust-toolchain.toml # Rust工具链配置文件
├── rustfmt.toml        # Rust代码格式化配置
└── examples             # 示例小部件目录
    ├── ...
    └── ...

每个部分都服务于特定目的，比如 examples 目录提供了快速上手的模板和示例；Cargo.toml 和相关 Rust 配置负责构建Rust后端；而前端配置则分散在各个小部件的HTML、JavaScript文件中。

2. 项目的启动文件介绍

Zebar没有传统的单一“启动文件”，但它的运行主要依赖于编译后的二进制文件或是通过本地开发环境来启动服务。对于终端用户而言，Windows、MacOS和Linux的预编译版本可以直接从最新发布页下载运行。若要从源码构建，核心在于执行Rust项目构建命令（如 cargo run）。

对于开发者来说，通常是从 Cargo.toml 文件入手，使用 cargo 命令进行编译和运行，这是启动Zebar背后的驱动力。

3. 项目的配置文件介绍

Zebar的配置主要体现在两个层面：全局配置和每个小部件的个性化配置。

全局配置通常涉及：

• 环境设置：可能通过 .env 文件或命令行参数指定，虽然具体实现细节在提供的信息中未明确指出。
• 系统级配置：位于 %userprofile%/glzr/zebar 的默认配置文件夹，包含了初始的通用配置和小部件模板。

单个小部件配置：

• 每个小部件都有一个 .zebar.json 配置文件，定义了小部件的行为、外观和使用的系统信息（如电池状态、CPU使用率等）。
• 配置文件通常包括：
  • 刷新间隔 (refreshInterval)：控制数据更新频率。
  • HTML文件路径：指向小部件界面的HTML文件。
  • provider配置：如电池、CPU使用情况等数据提供者的详细配置。

例如，电池信息配置展示如下：

{
  "battery": {
    "refreshInterval": 5000,
    "chargePercent": true
  }
}

这表明该小部件每5秒更新一次电池充电百分比。

通过这些配置，用户可以定制自己独特的桌面体验，利用JavaScript和HTML进行前端交互设计，并通过Rust后端接入丰富的系统数据。