1.0.0

RimLetter v1.0.0 正式版

边缘信使正式版来了。复刻《边缘世界》(RimWorld) 右侧 Letter 信件播报的桌面功能性摆件——硬件占用过高时，信从屏幕右缘坠落滑入提醒；平时完全隐身，告警才出现。

🎉 正式版版本语义

从 v1.0.0 起确立版本规则：版本号只随新功能递增（1.1.0 = 新功能），常规 bug 修复不再升版本号，而是通过内置热补丁系统静默下发；只有恶性 bug（启动崩溃/数据丢失/安全）才升补丁版本。

✨ 新特性

• 热补丁系统：常规 bug 修复不升版本号——启动时自动静默拉取并应用官方补丁（sha256 校验），下载任何旧版本安装包也会自动修复；补丁打崩应用会自动回滚（连续 2 次异常启动自动禁用最近补丁）
• 设置 → 关于 显示「版本 x · 已应用补丁 N」

📋 功能一览

• 全屏透明悬浮层：平时隐身、鼠标穿透，仅信区域可交互
• 游戏原版还原：坠落滑入 + 全屏径向闪光 + 威胁弹跳 + 标题居中溢出 + FLIP 补位动画
• 五种紧急度配色（ThreatBig 红 / ThreatSmall 橙 / NegativeEvent 黄 / NeutralEvent 灰 / PositiveEvent 蓝）
• 规则引擎：CPU / 内存 / 磁盘 / GPU（NVIDIA）监控，阈值/持续时长/回落门槛可配，磁盘可指定分区
• 信弹出位置可调（上方/下方/左侧/右侧 + 边距/间距滑杆），设置窗像真窗口一样拖动
• 本地 HTTP API（token 鉴权）：任何程序触发播报、读写规则
• 插件系统 + 插件市场：注册自定义传感器/规则/主动播报，官方插件仓库一键安装，自动检查更新
• 游戏原声音效，音量可调；开机自启；托盘快捷操作
• 自动更新：静默检查 GitHub 新版，多通道加速 + 测速优选

🖥 平台支持

• Windows x64 / ARM64 / x86（NSIS 安装包，自动更新）
• Linux x64 / ARM64（AppImage 支持自动更新；deb 手动安装）

🧪 测试

259 个单元测试全部通过（node:test）。

⚠️ 注意

• Linux 推荐 X11 会话（Wayland 部分支持）
• Linux 托盘需桌面环境支持 StatusNotifier/AppIndicator（GNOME 需装扩展）
• GPU 温度/占用仅支持 NVIDIA；AMD 请装官方插件 amd-gpu-stats（仅 Windows）
• 游戏素材版权归 Ludeon Studios，仅供个人使用

0.6.5

v0.6.5（2026-08-19）插件市场：更新及时感应 + 插件版本号

新增

• 插件版本号：插件市场表格新增「版本」列，状态列区分「已安装 v1.0.0」（绿）/「有新版本（已装 v0.9.0）」（黄）/「未安装」；本地自动记录已装插件版本（plugins/.installed.json），安装/更新/卸载时维护，操作按钮按状态只显示需要的（安装 / 更新+卸载 / 卸载）
• 插件更新自动提醒：应用启动 30 秒后及此后每 6 小时自动检查插件更新，发现新版弹一封「插件更新可用」信（列出插件名与版本变化，如「天气信」v1.0.0 → v1.2.0），每会话同批插件只提醒一次；可在 config.json 的 market.autoCheck / market.checkIntervalMs 调整或关闭
• 「更新全部」只更新有新版：已是最新的插件自动跳过，结果提示「已更新 N 个插件 / 全部已是最新 / 失败列表」

修复

• 插件市场缓存过期（最长 12 小时读旧清单）：jsDelivr CDN 对 @main 分支引用最长缓存 12 小时，?cb= 参数破不了 CDN 缓存。现在改为先经 GitHub API（动态数据、无 CDN 缓存）把仓库分支解析成最新 commit，再按不可变 commit 地址拉取清单与插件文件——插件作者推送更新后用户立即可见，无需手动「刷新市场」；且清单与插件文件来自同一 commit，不会出现「新清单 + 旧插件文件」版本错配

下载

• Windows：RimLetter-Setup-{x64,ia32,arm64}.exe
• Linux：RimLetter-{x86_64,arm64}.AppImage、RimLetter-{amd64,arm64}.deb

0.6.4

v0.6.4（2026-08-17）Bug 修复与磁盘规则增强

修复

• 修复 Linux 磁盘空间不足误报（issue #2）：Manjaro/KDE 等 Linux 环境下启动即弹「磁盘空间不足」，但实际剩余空间充足——原因是 EFI/启动分区（如 /boot/efi，容量通常不足 1GB）也被纳入磁盘监控，剩余空间恒低于默认 10GB 阈值。现在磁盘监控自动排除 EFI/启动分区（FAT/msdos 文件系统及 /boot、/boot/efi、/efi 挂载点）
• 修复 Linux 第二屏悬停失效：播报显示到第二块屏幕时（v0.6.3 新增），Linux 悬停检测的坐标未换算为窗口本地坐标，现已修正，第二屏来信可正常悬停/查看详情

新增

• 磁盘规则可指定监控分区：规则编辑器新增「磁盘分区」下拉（Windows 上为盘符 C:/D:，Linux 上为挂载点 /、/home 等），可只监控指定分区；未指定时保持原行为（任一分区触发）。旧配置无需迁移
• 磁盘告警信显示具体分区：如「磁盘剩余空间不足 10GB（/home）」，一眼定位是哪个盘

下载

• Windows：RimLetter-Setup-{x64,ia32,arm64}.exe
• Linux：RimLetter-{x86_64,arm64}.AppImage、RimLetter-{amd64,arm64}.deb

0.6.3

v0.6.3（2026-08-15）Linux 适配

新增

• Linux 支持：AppImage（x86_64 / arm64，支持自动更新）+ deb（amd64 / arm64）安装包；GitHub Actions 自动构建 Linux 产物并随 Release 发布
• Linux 磁盘监控：改读 /proc/mounts，只统计真实块设备挂载（自动排除 loop / zram / 网络盘 / 伪文件系统），按挂载点逐一判定
• Linux 开机自启：XDG autostart（~/.config/autostart/rimletter.desktop），设置窗开关直接可用
• Linux 悬停检测：覆盖层点击穿透状态下信件仍可悬停 / 点击（主进程光标轮询）

说明

• Linux 推荐 X11 会话（透明悬浮层 / 置顶 / 点击穿透依赖合成器），Wayland 会话为部分支持
• Linux 托盘需桌面环境支持 StatusNotifier / AppIndicator（GNOME 需安装扩展）
• Linux GPU 监控仅 NVIDIA（AMD 插件依赖 LibreHardwareMonitor，仅 Windows）
• Linux 自动更新仅 AppImage 支持，deb 需手动重装

下载

• Windows：RimLetter-Setup-{x64,ia32,arm64}.exe
• Linux：RimLetter-{x86_64,arm64}.AppImage、RimLetter-{amd64,arm64}.deb

0.6.2

v0.6.2（2026-08-15）

🔧 重构

• 内置 GPU 传感器改名 nvidia-gpu：内置「显卡过热 / 显卡满载」规则引用同步更新，语义明确仅支持 NVIDIA（nvidia-smi 直读）；老配置与 API 规则中 sensor:gpu 自动迁移为 nvidia-gpu（gpu 兼容别名保留，旧引用不失效）

✨ 新增

• AMD 显卡支持：改为官方插件方式 —— 插件市场安装「AMD 显卡监控」（amd-gpu-stats），注册 amd-gpu 传感器，LibreHardwareMonitor 数据源，温度/占用过高来信（阈值/紧急度可配，含测试按钮）

🔧 其他

• 176 单元测试通过

下载：安装包见下方 Assets（x64 推荐，RimLetter-Setup-x64.exe；另有 ia32 / arm64）。已安装 v0.6.1 的用户会自动收到更新。

0.6.1

v0.6.1（2026-08-15）

✨ 新功能

• 信弹出位置支持左/右：「信弹出位置」下拉四选一（上方/下方/左侧/右侧）——新信出现在已有信的上方、下方（垂直堆叠）或左侧、右侧（水平排列），补位动画同步支持水平横移

🛠 修复

• 整行文本框自适应宽度：规则编辑器（标题/描述/音效）、API 绑定地址、插件配置表单的文本字段改为占满行宽——原固定 56px 根本看不清输入内容（尤其 Home Assistant 插件里的 URL 等长文本）

🔧 其他

• 横向/纵向边距滑杆上限提升至 2000px
• 174 单元测试通过

下载：安装包见下方 Assets（x64 推荐，RimLetter-Setup-x64.exe；另有 ia32 / arm64）。已安装 v0.6.0 的用户会自动收到更新。

0.6.0

v0.6.0（2026-08-15）

✨ 新功能

• 信弹出位置可调：设置窗新增「信弹出位置」下拉（上方/下方）——新信出现在已有信堆栈的上方或下方（原版行为为下方）；横向/纵向边距滑杆上限提升至 1000px，新增「信间距」滑杆，全部实时生效
• 设置窗真窗口行为：无边框自绘 UI 外观不变，标题栏可拖动（系统级手感）、双击最大化/还原、拖到屏幕边缘自动吸附；托盘菜单新增「设置窗置顶」开关（可持久化）

🎨 视觉优化

• 滑杆、按钮、下拉控件改为九宫格渲染（border-image）：两端保留、中间拉伸，不再整图拉伸变形（素材：SliderRail / ButtonBG 三态）

🔧 其他

• 旧四角落位置配置（anchor）自动迁移为上方/下方（side），老用户无感升级
• 174 单元测试通过

下载：安装包见下方 Assets（x64 推荐，RimLetter-Setup-x64.exe；另有 ia32 / arm64）。安装后启动即自动更新。

0.5.3

v0.5.3

修复

• 「自动消失时长」滑杆设置现真正生效（此前改配置后信件仍恒 20 秒消失）
• 恢复信（已恢复正常）现按 recoveryDismissMs（默认 10 秒）消失，而非恒 20 秒
• 插件 API api.on('alert' / 'recovered') 事件现实际派发（此前只注册不触发）
• API 添加不带 id 的规则时自动生成 id，避免多条规则共用同一状态槽导致误告警
• API 请求体超过 1MB 时返回 413 提示，不再挂起无响应
• 插件开发文档移除未实现的 rule 事件承诺

测试

• 169 单元测试通过

0.5.2

v0.5.2 插件市场刷新破缓存修复

修复

• 插件市场「刷新市场」仍读不到新清单：jsDelivr CDN 缓存键不含 query string，此前携带的 ?cb= 参数破不了缓存，最长 12 小时内一直读到旧清单；改用 jsDelivr 官方 purge API 按文件路径清理缓存后再拉取，刷新即可读到仓库最新内容
• 刷新按钮增加「刷新中…」状态与失败提示；普通打开市场页 / 安装 / 更新全部不触发 purge，避免滥用清理接口

测试：164 项单元测试通过

0.5.1

v0.5.1 API 绑定地址可配 + HA 集成插件（测试版）

新增

• API 绑定地址可配（api.host，默认 127.0.0.1）：Home Assistant 跑在局域网另一台设备时，改为 0.0.0.0 即可让 HA 经 rest_command 推送通知来信（token 明文 HTTP，请仅用于可信网络）
• 设置页常规新增「API 绑定地址」输入行（重启生效）

修复

• formatLetter 未知紧急度回退中性：HA 等外部 payload 传错 severity 不再报错
• API server 监听 error 事件：host 非法或端口被占时优雅降级，不再未捕获异常崩溃
• 设置页多行按钮结果保留换行：插件生成的 rest_command YAML 可正常查看与复制

新官方插件（测试版）

• Home Assistant 集成（测试版）：接收 HA 通知来信 + HA 实体进规则引擎监控。设置 → 插件管理安装；欢迎反馈 bug（https://github.com/NothingCooker/rimletter-official-plugins/issues）

测试：160 项单元测试通过