diff --git a/Cargo.toml b/Cargo.toml index d963b2d..b69e166 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -2,6 +2,7 @@ name = "aether" version = "0.1.0" edition = "2024" +license = "Apache-2.0" default-run = "aether" [dependencies] diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..d645695 --- /dev/null +++ b/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/README.md b/README.md index e69de29..2969185 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,263 @@ +# Aether + +[![CI](https://github.com/slow2342/aether/actions/workflows/ci.yml/badge.svg)](https://github.com/slow2342/aether/actions/workflows/ci.yml) +[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](#license) +[![Rust](https://img.shields.io/badge/rust-%3E%3D1.85-orange)](https://www.rust-lang.org/) + +English | [中文](docs/README_zh.md) + +A distributed key-value store built in Rust, using Raft consensus for replication, RocksDB for storage, and gRPC for client communication. + +## Why Aether? + +Aether is a distributed key-value store for coordination, configuration, and service discovery -- a Rust alternative to etcd. + +- **Single binary, zero dependencies** -- drop it on any machine, no Go runtime or shared libraries needed +- **No GC, predictable latency** -- Rust's ownership model eliminates stop-the-world pauses that plague Go and JVM-based stores under high write throughput +- **Stateless gateway** -- horizontally scale read capacity by adding gateway nodes that proxy to the Raft cluster without participating in consensus +- **Coordination built-in** -- distributed locks, leader election, barriers, and FIFO queues are first-class primitives, not recipes you assemble yourself + +## Features + +Beyond the core KV store, Aether provides: + +- **Transactions** -- Compare-and-swap (CAS) operations via `Txn` RPC +- **Watch** -- Bidirectional streaming for real-time key-range change notifications +- **Leases** -- TTL-based keys with automatic expiry and keep-alive streaming +- **Distributed Lock** -- Mutex and read-write lock primitives +- **Leader Election** -- Campaign-based election with observer streaming +- **Sessions** -- Client session lifecycle with timeout negotiation +- **Barriers & Queues** -- Distributed coordination primitives +- **Data Sharding** -- Region-based key-range sharding with split/merge scheduling +- **Cluster Discovery** -- Static, DNS, and token-based peer discovery for dynamic cluster bootstrap +- **Auth** -- JWT authentication with RBAC (users, roles, key-range permissions) +- **Observability** -- Prometheus metrics, structured JSON logging, health check endpoints + +## Quick Start + +### Single Node + +```bash +# Download the binary from releases, then: +aether --node-id 1 --addr 127.0.0.1:2379 +``` + +### 3-Node Cluster + +Create a config file for each node: + +
+node1.toml + +```toml +node_id = 1 +addr = "127.0.0.1:2379" +data_dir = "/tmp/aether-node1" + +[[cluster.peers]] +node_id = 2 +addr = "127.0.0.1:2380" + +[[cluster.peers]] +node_id = 3 +addr = "127.0.0.1:2381" +``` +
+ +
+node2.toml + +```toml +node_id = 2 +addr = "127.0.0.1:2380" +data_dir = "/tmp/aether-node2" + +[[cluster.peers]] +node_id = 1 +addr = "127.0.0.1:2379" + +[[cluster.peers]] +node_id = 3 +addr = "127.0.0.1:2381" +``` +
+ +
+node3.toml + +```toml +node_id = 3 +addr = "127.0.0.1:2381" +data_dir = "/tmp/aether-node3" + +[[cluster.peers]] +node_id = 1 +addr = "127.0.0.1:2379" + +[[cluster.peers]] +node_id = 2 +addr = "127.0.0.1:2380" +``` +
+ +```bash +aether --config node1.toml # terminal 1 +aether --config node2.toml # terminal 2 +aether --config node3.toml # terminal 3 +``` + +### Gateway Mode + +Stateless proxy that routes requests to a backend cluster: + +```bash +aether --gateway --addr 127.0.0.1:2379 \ + --backends 127.0.0.1:2380,127.0.0.1:2381,127.0.0.1:2382 +``` + +## Configuration + +Aether reads `aether.toml` from the current directory by default. CLI flags override config file values. + +
+Full config reference + +```toml +node_id = 1 +addr = "127.0.0.1:2379" +data_dir = "/var/lib/aether" + +[cluster] +heartbeat_interval_ms = 1000 +election_timeout_ms = 10000 +snapshot_trigger_log_entries = 10000 + +[[cluster.peers]] +node_id = 2 +addr = "10.0.0.2:2379" + +[cluster.discovery] +method = "static" # static, dns, token + +[auth] +enabled = false +token_expiry_hours = 24 +signing_key = "" + +[lease] +max_leases = 10000 +max_ttl = 86400 + +[log] +level = "info" # trace, debug, info, warn, error +json = false +log_dir = "" # empty = stdout only +log_file_prefix = "aether" + +[metrics] +listen_addr = "127.0.0.1:9090" + +[shard] +max_regions = 1024 +max_region_size_bytes = 67108864 +auto_split = false +``` +
+ +## API + +All services are exposed on the same gRPC address (default `127.0.0.1:2379`). + +```protobuf +service AetherKV { + rpc Put(PutRequest) returns (PutResponse); + rpc Get(GetRequest) returns (GetResponse); + rpc Delete(DeleteRequest) returns (DeleteResponse); + rpc Range(RangeRequest) returns (RangeResponse); + rpc Txn(TxnRequest) returns (TxnResponse); +} +``` + +| Service | Operations | +|---------|-----------| +| `AetherWatch` | Watch (bidirectional streaming) | +| `AetherLease` | LeaseGrant, LeaseRevoke, LeaseKeepAlive, LeaseTimeToLive, LeaseLeases | +| `AetherAuth` | Authenticate, UserAdd/Delete/Get/List, RoleAdd/Delete/Get/List, UserGrantRole, UserRevokeRole | +| `AetherCluster` | MemberAdd, MemberRemove, MemberList, MemberPromote | +| `AetherMaintenance` | Status, AlarmList, AlarmAdd, AlarmDelete, Defragment | +| `AetherLock` | Lock, Unlock | +| `AetherElection` | Campaign, Observe, Leader, Resign | +| `AetherBarrier` | Create, Await | +| `AetherQueue` | Enqueue, Dequeue | +| `AetherSession` | Create, Renew, Close | +| `AetherShard` | CreateRegion, SplitRegion, MergeRegions, GetRegion | + +Proto definitions are in [`proto/`](proto/). + +## Observability + +```bash +# Prometheus metrics (on the same address as gRPC, port from metrics.listen_addr) +curl http://127.0.0.1:9090/metrics + +# Health checks (same address as metrics) +curl http://127.0.0.1:9090/health/live # liveness +curl http://127.0.0.1:9090/health/ready # readiness (Raft + storage) +``` + +## Benchmarks + +Run `cargo bench` to reproduce. Results on Apple M-series (single-threaded): + +**Storage (RocksDB)** + +| Operation | Latency | +|-----------|---------| +| put (256 B) | 1.6 us | +| put (1 KB) | 2.2 us | +| put (64 KB) | 26 us | +| get (hit) | 442 ns | +| get (miss) | 121 ns | +| delete | 1.4 us | +| batch_write (10 ops) | 5.8 us | +| scan (100 keys) | 12.9 us | +| scan (1000 keys) | 149 us | + +**Raft Log Store** + +| Operation | Latency | +|-----------|---------| +| append_entries (1 entry) | 23 us | +| append_entries (10 entries) | 48 us | +| append_entries (100 entries) | 90 us | +| entries_read (100) | 13.3 us | +| entries_read (1000) | 140 us | +| save_hard_state | 18.6 us | +| compact (100 entries) | 37 us | + +## Docker + +```bash +docker build -t aether . + +docker run -d --name aether-1 \ + -p 2379:2379 \ + -v aether-data:/data \ + aether --node-id 1 --addr 0.0.0.0:2379 --data-dir /data +``` + +## Development + +Requires Rust 1.85+ (Edition 2024). + +```bash +cargo build # debug build +cargo build --release # release build +cargo test # all tests +cargo clippy -- -D warnings # lint +cargo fmt -- --check # format check +``` + +## License + +Licensed under the [Apache License, Version 2.0](LICENSE). diff --git a/docs/README_zh.md b/docs/README_zh.md new file mode 100644 index 0000000..1e9c66d --- /dev/null +++ b/docs/README_zh.md @@ -0,0 +1,263 @@ +# Aether + +[![CI](https://github.com/slow2342/aether/actions/workflows/ci.yml/badge.svg)](https://github.com/slow2342/aether/actions/workflows/ci.yml) +[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](#license) +[![Rust](https://img.shields.io/badge/rust-%3E%3D1.85-orange)](https://www.rust-lang.org/) + +[English](../README.md) | 中文 + +基于 Rust 构建的分布式键值存储引擎，使用 Raft 共识协议实现数据复制，RocksDB 作为底层存储，gRPC 提供客户端通信。 + +## 为什么选择 Aether？ + +用 Rust 实现的分布式键值存储，适用于服务发现、配置管理和分布式协调场景，可作为 etcd 的替代方案。 + +- **单文件部署，无外部依赖** -- 一个二进制文件即可运行，无需 Go 运行时环境 +- **无 GC 停顿，延迟稳定** -- 避免了 Go/JVM 存储在高写入压力下的 GC 延迟毛刺 +- **Gateway 代理模式** -- 读流量增大时可水平扩展 Gateway 节点，不参与 Raft 共识 +- **锁、选举、屏障、队列内置** -- etcd 中需要自行组装的协调原语，这里开箱即用 + +## 功能特性 + +在核心 KV 存储之上，Aether 还提供： + +- **事务** -- 通过 `Txn` RPC 实现 CAS（Compare-and-Swap）操作 +- **Watch** -- 双向流式传输，实时推送键范围变更通知 +- **租约** -- 基于 TTL 的键管理，支持自动过期和 Keep-Alive 流 +- **分布式锁** -- 互斥锁和读写锁原语 +- **Leader 选举** -- 基于 Campaign 的选举机制，支持 Observer 流 +- **会话管理** -- 客户端会话生命周期管理，支持超时协商 +- **屏障与队列** -- 分布式协调原语 +- **数据分片** -- 基于 Region 的键范围分片，支持分裂/合并调度 +- **集群发现** -- 静态、DNS 和基于 Token 的节点发现，支持动态集群引导 +- **认证鉴权** -- JWT 认证 + RBAC 权限（用户、角色、键范围权限） +- **可观测性** -- Prometheus 指标、结构化 JSON 日志、健康检查端点 + +## 快速开始 + +### 单节点 + +```bash +# 从 Releases 下载二进制文件，然后： +aether --node-id 1 --addr 127.0.0.1:2379 +``` + +### 三节点集群 + +为每个节点创建配置文件： + +
+node1.toml + +```toml +node_id = 1 +addr = "127.0.0.1:2379" +data_dir = "/tmp/aether-node1" + +[[cluster.peers]] +node_id = 2 +addr = "127.0.0.1:2380" + +[[cluster.peers]] +node_id = 3 +addr = "127.0.0.1:2381" +``` +
+ +
+node2.toml + +```toml +node_id = 2 +addr = "127.0.0.1:2380" +data_dir = "/tmp/aether-node2" + +[[cluster.peers]] +node_id = 1 +addr = "127.0.0.1:2379" + +[[cluster.peers]] +node_id = 3 +addr = "127.0.0.1:2381" +``` +
+ +
+node3.toml + +```toml +node_id = 3 +addr = "127.0.0.1:2381" +data_dir = "/tmp/aether-node3" + +[[cluster.peers]] +node_id = 1 +addr = "127.0.0.1:2379" + +[[cluster.peers]] +node_id = 2 +addr = "127.0.0.1:2380" +``` +
+ +```bash +aether --config node1.toml # 终端 1 +aether --config node2.toml # 终端 2 +aether --config node3.toml # 终端 3 +``` + +### Gateway 模式 + +无状态代理，将请求路由到后端集群： + +```bash +aether --gateway --addr 127.0.0.1:2379 \ + --backends 127.0.0.1:2380,127.0.0.1:2381,127.0.0.1:2382 +``` + +## 配置 + +Aether 默认读取当前目录下的 `aether.toml`。CLI 参数会覆盖配置文件中的值。 + +
+完整配置参考 + +```toml +node_id = 1 +addr = "127.0.0.1:2379" +data_dir = "/var/lib/aether" + +[cluster] +heartbeat_interval_ms = 1000 # Raft 心跳间隔 +election_timeout_ms = 10000 # Raft 选举超时 +snapshot_trigger_log_entries = 10000 # 触发快照的日志条目数 + +[[cluster.peers]] +node_id = 2 +addr = "10.0.0.2:2379" + +[cluster.discovery] +method = "static" # static, dns, token + +[auth] +enabled = false +token_expiry_hours = 24 +signing_key = "" # JWT 签名密钥（启用认证时必填） + +[lease] +max_leases = 10000 +max_ttl = 86400 # 最大租约 TTL（秒） + +[log] +level = "info" # trace, debug, info, warn, error +json = false # JSON 结构化日志 +log_dir = "" # 为空则仅输出到 stdout +log_file_prefix = "aether" + +[metrics] +listen_addr = "127.0.0.1:9090" + +[shard] +max_regions = 1024 +max_region_size_bytes = 67108864 # 64 MB +auto_split = false +``` +
+ +## API + +所有服务通过同一个 gRPC 地址暴露（默认 `127.0.0.1:2379`）。 + +```protobuf +service AetherKV { + rpc Put(PutRequest) returns (PutResponse); // 写入键值对 + rpc Get(GetRequest) returns (GetResponse); // 读取单个键或范围 + rpc Delete(DeleteRequest) returns (DeleteResponse); // 删除单个键或范围 + rpc Range(RangeRequest) returns (RangeResponse); // 范围扫描 + rpc Txn(TxnRequest) returns (TxnResponse); // 原子 CAS 事务 +} +``` + +| 服务 | 操作 | +|------|------| +| `AetherWatch` | Watch（双向流式） | +| `AetherLease` | LeaseGrant, LeaseRevoke, LeaseKeepAlive, LeaseTimeToLive, LeaseLeases | +| `AetherAuth` | Authenticate, UserAdd/Delete/Get/List, RoleAdd/Delete/Get/List, UserGrantRole, UserRevokeRole | +| `AetherCluster` | MemberAdd, MemberRemove, MemberList, MemberPromote | +| `AetherMaintenance` | Status, AlarmList, AlarmAdd, AlarmDelete, Defragment | +| `AetherLock` | Lock, Unlock | +| `AetherElection` | Campaign, Observe, Leader, Resign | +| `AetherBarrier` | Create, Await | +| `AetherQueue` | Enqueue, Dequeue | +| `AetherSession` | Create, Renew, Close | +| `AetherShard` | CreateRegion, SplitRegion, MergeRegions, GetRegion | + +Proto 定义见 [`proto/`](proto/)。 + +## 可观测性 + +```bash +# Prometheus 指标（与 gRPC 使用相同地址，端口由 metrics.listen_addr 配置） +curl http://127.0.0.1:9090/metrics + +# 健康检查（与 metrics 同端口） +curl http://127.0.0.1:9090/health/live # 存活检查 +curl http://127.0.0.1:9090/health/ready # 就绪检查（Raft + 存储） +``` + +## 基准测试 + +运行 `cargo bench` 可复现。以下为 Apple M 系列芯片的单线程测试结果： + +**存储引擎（RocksDB）** + +| 操作 | 延迟 | +|------|------| +| put (256 B) | 1.6 us | +| put (1 KB) | 2.2 us | +| put (64 KB) | 26 us | +| get (命中) | 442 ns | +| get (未命中) | 121 ns | +| delete | 1.4 us | +| batch_write (10 条) | 5.8 us | +| scan (100 键) | 12.9 us | +| scan (1000 键) | 149 us | + +**Raft 日志存储** + +| 操作 | 延迟 | +|------|------| +| append_entries (1 条) | 23 us | +| append_entries (10 条) | 48 us | +| append_entries (100 条) | 90 us | +| entries_read (100 条) | 13.3 us | +| entries_read (1000 条) | 140 us | +| save_hard_state | 18.6 us | +| compact (100 条) | 37 us | + +## Docker + +```bash +docker build -t aether . + +docker run -d --name aether-1 \ + -p 2379:2379 \ + -v aether-data:/data \ + aether --node-id 1 --addr 0.0.0.0:2379 --data-dir /data +``` + +## 开发 + +需要 Rust 1.85+（Edition 2024）。 + +```bash +cargo build # Debug 构建 +cargo build --release # Release 构建 +cargo test # 运行所有测试 +cargo clippy -- -D warnings # Lint 检查 +cargo fmt -- --check # 格式检查 +``` + +## 许可证 + +基于 [Apache License, Version 2.0](LICENSE) 许可。