Lithe 的跨平台应用内核，以及插件契约、插件开发资料和官方插件 SDK 的唯一来源。
| 目录 | 内容 |
|---|---|
rust/crates/ |
Rust Core 的 crate，每个子目录是一个 crate，目录名是包名去掉 lithe- 前缀 |
rust/contracts/ |
Core 命令的接口契约和 schema |
rust/fixtures/ |
Core 命令的测试数据，Core 测试和桌面端测试共用 |
rust/logging/ |
日志事件目录 |
shared/plugins/ |
插件契约 contract/v1/、开发指南 guides/、参考 reference/、官方 SDK sdk/{node,java,rust} 和它们的端到端测试 |
scripts/rust-core/ |
Rust Core 注释规范检查（模块文档、英文注释、unsafe 安全说明、导出项 Rustdoc） |
scripts/logging/ |
日志事件目录生成器，从 rust/logging/events/ 生成 rust/crates/diagnostics/src/catalog_generated.rs |
插件开发者从 shared/plugins/README.md 开始，不需要克隆 Lithe 应用仓库。
cargo test --manifest-path rust/Cargo.toml --workspace # Core 测试
scripts/rust-core/verify-rust-core-comments.sh # 注释规范
node scripts/logging/generate-log-events.mjs --check # 日志事件目录与生成表一致
node shared/plugins/scripts/verify-docs.mjs # 契约 $id 与文档链接
node shared/plugins/scripts/sdk-e2e.mjs # 三个 SDK 对当前 Core 的端到端测试修改 shared/plugins/contract/v1/、rust/crates/plugin-model/src/capabilities.rs 或
rust/crates/plugin-rpc/src/ 的 PR，要在同一个 PR 里更新
协议更新记录。
Lithe's cross-platform application core, and the single source of the plugin contract, the plugin developer documentation and the official plugin SDKs.
| Directory | Contents |
|---|---|
rust/crates/ |
The Rust Core crates; each directory is one crate, named after its package without the lithe- prefix |
rust/contracts/ |
Interface contracts and schemas for Core commands |
rust/fixtures/ |
Test data for Core commands, shared by the Core and desktop tests |
rust/logging/ |
The logging event catalog |
shared/plugins/ |
The plugin contract contract/v1/, guides guides/, reference reference/, the official SDKs sdk/{node,java,rust} and their end-to-end tests |
scripts/rust-core/ |
The Rust Core comment rules check (module docs, English comments, unsafe safety sections, Rustdoc on exported items) |
scripts/logging/ |
The logging event catalog generator, which turns rust/logging/events/ into rust/crates/diagnostics/src/catalog_generated.rs |
Plugin authors start at shared/plugins/README.md and never need to clone the Lithe application repository.
A pull request that changes shared/plugins/contract/v1/, rust/crates/plugin-model/src/capabilities.rs or rust/crates/plugin-rpc/src/ updates the protocol changelog in the same pull request.