🦀 Rust 易用工具集 —— 由 @Loong Wan Fork、开发与维护
文档格式 · 模板渲染 · 规则引擎 · 通用工具等高频场景的 Rust 工具集
Easy-4-Rust 是 partme-ai 开源生态下的 Rust 工具集组织，托管由 @Loong Wan Fork、开发与维护的 Rust 项目，面向文档格式处理、模板渲染、规则引擎与通用工具等高频场景。目前共 19 个公开仓库（14 个原创项目 + 3 个上游 fork 跟踪 + 2 个组织基础设施）。
📌 重要说明：本组织不托管以下常见开源项目的官方版本：
这些项目都有完整的官方仓库，请直接使用官方版本。本组织内的同名 crate 均为独立实现（API 兼容或语义兼容），不包含上游代码。
| Crate | 说明 | 状态 |
|---|---|---|
easyexcel-rust |
流式 Excel 框架（API 兼容 EasyExcel） | ✅ |
easypdf-rust |
PDF 创建、读取与操作（Builder API，纯 Rust，零 unsafe） | ✅ |
easyofd-rust |
OFD（开放版式文档）操作库 | ✅ |
easydoc-rust |
DOC/DOCX 文档操作（easyexcel-rust 的文档对应） | ✅ |
| Crate | 说明 | 状态 |
|---|---|---|
thymeleaf-rust |
Thymeleaf 风格动态内容渲染引擎（框架无关） | ✅ |
freemarker-rust |
Apache FreeMarker 语义兼容的 Rust 实现 | ✅ |
| Crate | 说明 | 状态 |
|---|---|---|
liteflow-rust |
LiteFlow 规则引擎的 Rust 移植 | 🚧 筹备中 |
qlexpress-rust |
嵌入式表达式与动态脚本引擎（行为兼容 QLExpress4） | ✅ |
| Crate | 说明 | 状态 |
|---|---|---|
sa-token-rs |
认证鉴权框架（Sa-Token 移植，async-first，Rust 1.85+） | ✅ |
| Crate | 说明 | 状态 |
|---|---|---|
vernal |
轻量 IoC / AOP / 应用上下文框架 | ✅ |
hutool-rust |
Hutool 能力模型的 idiomatic Rust 实现（HiTool） | ✅ |
druid-rust |
Druid 数据库连接池的 Rust 移植 | 🚧 筹备中 |
agent-job |
分布式任务调度与工作流编排（兼容 XXL-JOB 协议） | ✅ |
xls-cli |
Agent-safe 表格 CLI / TUI（XLS · XLSX · CSV · Markdown · HTML · JSON） | ✅ |
| 仓库 | 上游 |
|---|---|
sa-token-rust |
sa-tokens/sa-token-rust（官方） |
aspect-rs |
yijunyu/aspect-rs（Rust AOP 框架） |
raft |
louisphilipmarcoux/raft（Raft 分布式 KV 存储） |
以上 fork 仅作上游同步跟踪，使用请以各自上游仓库为准。
| 项目 | 说明 | 维护方 |
|---|---|---|
easyexcel |
流式 Excel 框架 | alibaba/easyexcel |
sa-token |
认证鉴权框架（Java） | dromara/Sa-Token |
hutool |
Java 工具箱 | dromara/hutool |
以上 Java 工具不属于本组织托管，需要时请直接访问对应官方仓库。
┌─────────────────────────────────────────────────────────────┐
│ easy-4-rust 工具集矩阵 │
├─────────────────────────────────────────────────────────────┤
│ 文档处理 │ easyexcel-rust · easypdf-rust · easyofd-rust · │
│ │ easydoc-rust │
│ 模板渲染 │ thymeleaf-rust · freemarker-rust │
│ 规则脚本 │ liteflow-rust · qlexpress-rust │
│ 安全权限 │ sa-token-rs │
│ 框架工具 │ vernal · hutool-rust · druid-rust · │
│ │ agent-job · xls-cli │
├─────────────────────────────────────────────────────────────┤
│ ↓ 基础设施层（依赖） │
│ ddd-4-rust · tokio · serde · ... │
└─────────────────────────────────────────────────────────────┘
⚠️ 尚未发布到 crates.io。 在发布之前，使用 git 依赖：
[dependencies]
# 文档处理（任选）
easyexcel-rust = { git = "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/easy-4-rust/easyexcel-rust" }
easypdf-rust = { git = "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/easy-4-rust/easypdf-rust" }
easyofd-rust = { git = "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/easy-4-rust/easyofd-rust" }
easydoc-rust = { git = "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/easy-4-rust/easydoc-rust" }
# 通用工具与框架
hutool-rust = { git = "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/easy-4-rust/hutool-rust" }
vernal = { git = "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/easy-4-rust/vernal" }
# 运行时
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }各 crate 的具体 API 与使用示例，请直接查看对应仓库的 README。筹备中的仓库（🚧）暂不可用。
| 组织 | 说明 |
|---|---|
| 🧰 easy-4-java | Java 工具集组织（Spring Boot Starter · 第三方 SDK · 框架扩展） |
| 🏛️ ddd-4-rust | DDD 基础构件 Rust 版 |
| 🏛️ ddd-4-java | DDD 基础构件 Java 版 |
| 💾 rbatis-plus | RBatis ORM 增强生态 |
| 🧠 partme-ai | 顶层 AI 智能体生态品牌 |
欢迎贡献新的工具 crate！
- Fork 目标仓库
- 创建特性分支
- 遵循既有 crate 命名与 API 风格
- 补充单元测试、文档与 CHANGELOG
- 提交 Pull Request
新 crate 提案请先在 Discussions 发起 RFC。
本组织下所有 crate 采用 Apache 2.0 开源许可证。
Made with ❤️ by PartMe AI Team