项目概览
本页为维护当前已发布项目的贡献者提供必要上下文。
产品方向
LWE 是一个 Linux 动态壁纸平台，服务于把实际 Wallpaper Engine 工作流迁移到 Linux 的用户。
产品形态是桌面应用优先，而不是守护进程优先。核心差异化能力是把创意工坊发现、获取编排、同步感知、导入、兼容性可见性和运行时支持整合进同一工作流。
首发范围
首发优先事项：
- 以创意工坊为中心的发现和获取编排；
- 将兼容性报告作为用户可见功能；
- 以本地库为中心的日常使用；
- 视频类壁纸运行时支持；
- 英文和简体中文产品界面；
- 用于应用和清除壁纸的 Linux 桌面集成。
首发非目标：
- 完整网页壁纸运行时兼容；
- 创作者工具；
- 云或社区系统；
- 高级自动化规则；
- 对未验证桌面环境承诺支持。
活跃架构
关键路径：
| 路径 | 用途 |
|---|---|
src/ | Svelte/SvelteKit 前端应用 |
src-tauri/ | 活跃 Tauri 桌面壳 |
crates/lwe-core | 共享模型、配置和跨领域 Rust 类型 |
crates/lwe-library | 本地库索引、元数据和本地资源管理 |
crates/lwe-engine | 运行时/播放和 Linux 壁纸集成知识 |
packaging/aur/lwe | 稳定版 AUR 包元数据 |
packaging/aur/lwe-git | 开发版 AUR 包元数据 |
.github/workflows/ | 质量检查、发布和文档部署自动化 |
已退役的 wayvid GUI/CLI 路径只能作为历史上下文。除非规格明确说明其对 LWE 方向有价值，否则不要重新引入旧产品叙事。
发布模型
| 渠道 | 输出 |
|---|---|
| 稳定版 | GitHub Release 构建产物和 AUR lwe |
| 预发布版 | GitHub prerelease 构建产物和 AUR lwe-git |
Linux 发布产物包括 .deb、.rpm 和 .AppImage。
工作区版本来源是 Cargo.toml。预发布版本由发布自动化根据基础版本、GitHub Actions 运行编号和短提交 SHA 派生。
文档模型
所有维护中的文档都应位于 docs/ 下，并作为 VitePress 站点发布。用户可见文档必须同时提供英文和简体中文版本。
文档应优先覆盖：
- 安装；
- 首次使用设置；
- 日常使用；
- 故障排查；
- 贡献者维护规则。
历史规划文档和过时实现说明不应继续保留在发布文档树中；其中仍有价值的信息应合并进维护中的页面。