LWE

简体中文

English

简体中文

English

外观

v1 版本路线图 ​

本页记录从当前 v0.6.1 发布线迈向 LWE v1 的维护中开发方向。发布后请删除或折叠过时版本小节；当产品范围、已验证运行时支持或发布优先级变化时，应同步更新本页。

v1 目标 ​

LWE v1 应成为可信赖的 Linux Wallpaper Engine 迁移应用，而不是宣称广泛运行时兼容的产品。

v1 目标包括：

  • 基于 Tauri 2 和 SvelteKit 的 Linux 桌面应用；
  • 由 Rust 后端负责 Workshop、Library、Desktop、Settings、兼容性、持久化和运行时集成服务；
  • 以 Wallpaper Engine 创意工坊内容作为主要内容来源；
  • 视频类壁纸是 v1 唯一可运行的运行时类型；
  • 场景类和网页类壁纸可用于元数据识别和兼容性报告，但除非未来实现并验证，否则不可运行；
  • Wayland + niri 是已验证桌面目标；
  • 英文和简体中文用户可见文档与文案持续维护。

版本序列 ​

版本主题主要结果
v0.7.0支持矩阵锁定产品事实保持一致并有测试覆盖。
v0.8.0运行时强化视频应用、清除和恢复在 niri 上可靠工作。
v0.8.5Library 工作流强化日常 Library 工作流安全且清晰。
v0.9.0Workshop 清晰度发现和 Steam 同步预期诚实明确。
v0.9.5诊断与发布准备支持能力和发布姿态准备就绪。
v1.0.0-rc.1首个候选版范围冻结并完成端到端验证。
v1.0.0-rc.2可选阻塞修复候选版仅在 rc.1 发现发布阻塞问题时使用。
v1.0.0稳定 v1诚实、可靠、视频优先的稳定版。

v0.7.0：支持矩阵锁定 ​

主题：让产品事实在所有位置保持一致。

交付内容：

  • 权威支持矩阵：
    • 视频是可运行的首发目标；
    • 场景仅用于元数据识别和兼容性报告；
    • 网页仅用于报告识别；
    • 其他/应用内容不支持运行时工作流。
  • 兼容性策略、Library 投影、Workshop 详情、Desktop apply 和文档保持一致。
  • 场景不再显示为完全支持或可应用。
  • Apply 仅对可运行视频 Library 项启用；对仅识别项目禁用并给出解释。
  • 英文和简体中文文档同步更新。

验收标准：

  • 已同步视频报告为可运行支持。
  • 已同步场景报告为已识别/运行时不支持。
  • 网页报告为运行时不支持。
  • Desktop apply 在调用后端前以清晰原因拒绝非视频内容。
  • 测试覆盖视频、场景、网页、缺少元数据和缺少主资源行为。
  • CI 测试不依赖 Steam 或真实桌面会话。

不得宣称：

  • 场景运行时支持；
  • 网页运行时支持；
  • 泛 Wayland 支持；
  • 超出已验证 Wayland + niri 路径的合成器支持。

v0.8.0：niri 上可靠的视频运行时 ​

主题：让当前运行时路径可靠。

交付内容：

  • 强化将视频应用到选定显示器的流程。
  • 强化按显示器清除。
  • 清除一个显示器时保留其他输出上的壁纸。
  • 启动时恢复已保存分配。
  • 改进 Desktop 运行时状态，包括活动输出、过期状态、恢复失败和后端初始化/运行时错误。
  • 为运行时变更保留有文档说明的手动真实桌面验证清单。

在已验证 Wayland + niri 上的验收标准：

  • LWE 能发现活动显示器。
  • 已同步视频壁纸可见地应用到一个显示器。
  • 在有硬件条件时，多显示器应用可用。
  • 清除一个显示器不会停止其他显示器壁纸。
  • 重启后恢复已保存分配，或报告明确恢复失败。
  • 缺少视频文件、输出不匹配、Wayland layer-shell 失败、EGL 失败和后端超时都会产生可操作错误。

不得宣称：

  • niri 之外的运行时可靠性；
  • 场景或网页运行时支持；
  • CI 已验证桌面运行时行为，除非存在已验证真实桌面 runner。

v0.8.5：Library 工作流强化 ​

主题：让 Library 成为可信赖的日常使用界面。

交付内容：

  • Library 卡片和详情面板清晰展示运行时状态。
  • Apply 控件受可运行状态和显示器可用性限制。
  • 应用、清除和恢复后，已分配显示器标签保持准确。
  • 刷新、应用和清除流程尽可能保留用户上下文。
  • 空状态、过期状态、不可用状态和部分支持状态易于理解。
  • 大型本地库的分页和过滤保持可预期。

验收标准：

  • 可运行视频项目易于识别和应用。
  • 如果 Library 展示仅识别的场景/网页项目，它们不可应用且解释原因。
  • 应用失败不会用死状态替换已填充的详情 UI。
  • Library 命令/单元测试不依赖已安装 Steam。
  • Desktop invalidation 后 Library 状态正确更新。

不得宣称：

  • 所有 Library 项都可运行，除非 UI 强制保证这一点；
  • 仅识别的场景/网页项目可通过重新同步变成可运行支持。

v0.9.0：Workshop 与同步清晰度 ​

主题：让发现和获取预期诚实明确。

交付内容：

  • 围绕 Steam Web API key 设置打磨 Workshop 搜索和过滤。
  • 本地 Workshop 刷新解释已同步、缺少 project.json、缺少主资源和不支持运行时类型。
  • “在 Steam 中打开”明确作为获取/订阅交接。
  • Settings 清晰展示 Steam 集成状态。
  • 在线搜索结果不暗示本地同步或运行时支持。

验收标准：

  • 缺少 Steam API key 时引导用户到 Settings。
  • Steam 未安装、缺少 Wallpaper Engine、没有 Workshop 内容时尽可能产生不同信息。
  • 格式错误的项目元数据不会导致整个目录扫描失败。
  • 场景/网页搜索结果标记为已识别/运行时不支持。
  • 网络和解析测试避免真实 Steam API 调用。

不得宣称：

  • LWE 直接下载 Workshop 内容；
  • 搜索结果可见代表本地内容已同步；
  • Steam 元数据推断是权威结果。

v0.9.5：诊断、持久化与候选版准备 ​

主题：为可支持的 v1 候选版做准备。

交付内容：

  • 用户可复制的诊断界面。
  • 验证语言、主题、Steam API key、登录启动偏好和 Workshop 过滤条件的设置持久化。
  • 敏感值被隐藏。
  • 在文档中加入发布冒烟检查清单。
  • 记录包和发布产物预期。

诊断信息应包括：

  • 可用时显示 LWE 版本和包类型；
  • 可用时显示 OS、会话和合成器线索；
  • 显示器发现结果；
  • 运行时后端状态或最近后端初始化错误；
  • Steam 发现结果；
  • Wallpaper Engine Workshop 内容可用性；
  • 按兼容性/运行时状态统计的 Library 数量；
  • 当前支持范围提醒。

验收标准：

  • 设置在重启后保留。
  • 诊断信息不会暴露 Steam API key。
  • 登录启动不可用状态非致命且可见。
  • .deb、.rpm、.AppImage、AUR stable 和 AUR git 发布路径均有文档说明。
  • 必需 CI 检查已记录且通过。
  • 影响运行时的候选版必须进行手动运行时验证。

不得宣称：

  • 诊断是完美的环境检测；
  • 登录启动适用于所有桌面、会话和包格式；
  • 包安装成功即可保证运行时支持。

v1.0.0-rc.1：首个候选版 ​

主题：冻结范围并端到端验证。

交付内容：

  • 除阻塞问题外冻结功能。
  • 完整审查英文和简体中文文档。
  • 起草带明确支持范围的发布说明。
  • 通过手动 niri 运行时验收。
  • 更新已知限制页面或小节。

验收标准：

  • 全套 CI 通过：
    • pnpm check
    • pnpm test
    • pnpm build
    • pnpm docs:build
    • cargo fmt --all -- --check
    • cargo clippy --workspace --all-targets -- -D warnings
    • cargo check --workspace
    • cargo test --workspace
  • 新安装 → Settings → Workshop/Library → 应用视频 → 清除 → 重启恢复路径完成手动验证。
  • 手动检查场景/网页仅识别行为。
  • 没有用户可见文案宣称未支持运行时行为。
  • 发布产物构建成功。

不得宣称：

  • v1 final 稳定性；
  • 广泛合成器支持；
  • 场景/网页运行时支持。

v1.0.0-rc.2：可选阻塞修复候选版 ​

主题：仅修复 rc.1 发现的发布阻塞问题。

允许工作：

  • 数据丢失修复；
  • 安装或启动失败修复；
  • 已验证 niri 上视频应用/清除/恢复失败修复；
  • 错误支持范围声明修复；
  • 包或发布产物阻塞修复；
  • 严重文档不一致修复。

验收标准：

  • rc.1 阻塞问题已解决。
  • 不增加新功能范围。
  • 对受影响区域重新进行手动验证。

不得宣称超出 rc.1 范围的新能力。

v1.0.0：稳定 v1 ​

主题：可靠、诚实的首个稳定版本。

v1 交付内容：

  • 视频 Wallpaper Engine 壁纸可在已验证 Wayland + niri 路径上运行。
  • 场景/网页可用于兼容性报告，但运行时不支持。
  • Library-first 日常工作流。
  • 通过 Steam 进行 Workshop 发现/获取交接。
  • Desktop 显示器应用、清除和恢复流程。
  • Settings 持久化与诊断。
  • 英文和简体中文维护文档。
  • 发布产物：.deb、.rpm、.AppImage、AUR lwe 和 AUR lwe-git。

v1 验收标准：

  • 全套 CI 通过。
  • 文档构建通过。
  • 新安装路径已记录并验证。
  • 手动真实桌面 niri 验收通过。
  • 不支持的场景/网页行为清楚且不可运行。
  • 已知限制已记录。
  • 发布说明准确描述支持范围。

v1 不得宣称：

  • 完整 Wallpaper Engine 兼容；
  • 场景壁纸运行时；
  • 网页壁纸运行时；
  • 创作者/编辑工具；
  • 云或社区功能；
  • 高级自动化；
  • 泛 Wayland 支持；
  • 未经明确验证的 GNOME/KDE/Hyprland/sway 支持；
  • 独立于 Steam 的 LWE 托管 Workshop 下载。