未应用
命令未被接受。保留上次确认的状态，并报告哪项操作失败。
工作原理
架构
托盘应用将用户选择发送给本地服务，由服务检查条件并应用受支持的硬件设置。
控制路径
WinUI 托盘
用户选择的设置
用户选择的设置
类型化命名管道请求
带版本号的通信约定
带版本号的通信约定
LocalSystem 服务
策略和串行化
策略和串行化
协议 + HID
严格匹配设备的 I/O
严格匹配设备的 I/O
状态和操作结果会返回托盘应用。
| 项目 | 职责 | 信任边界 |
|---|---|---|
OpenBlade.Contracts | 定义配置、状态、功能和结果的带版本 IPC 消息。 | 不含平台或 HID 代码。 |
OpenBlade.Protocol | 验证报告、严格核对设备身份、存储脱敏夹具，并提供类型化 HID 操作和灯光渲染。 | 只有该机型的已验证或实验性支持明确允许的类型化操作，才能访问 HID。 |
OpenBlade.Service | 持有控制句柄，按顺序执行硬件操作，运行自动化，确认状态，并处理状态偏离和诊断。 | 以高权限的 LocalSystem 身份运行 IPC 服务器。 |
OpenBlade.Tray.Core | 管理界面状态、命令、配置、遥测选项和服务客户端逻辑，不依赖 WinUI。 | 在未提权的用户进程中运行。 |
OpenBlade.Tray | 负责 WinUI 3 窗口、Mica 样式、托盘图标、启动设置和用户交互。 | 作为未提权的当前用户界面运行。 |
OpenBlade.Display | 枚举显示器，并通过 Windows 设置刷新率、HDR 和色彩配置。 | 使用当前交互会话的 API。 |
OpenBlade.Platform | 读取 Windows NVIDIA GPU 活动计数器，列出并关闭阻止 GPU 休眠的应用，并应用处理器能效策略。 | 不含 HID 代码。仅操作当前用户自己的进程。 |
OpenBlade.Deployment | 解析已授权登记的本地开发部署清单，并验证签名。 | 依据本地部署信任策略检查清单和安装程序哈希；安装由代理完成。 |
OpenBlade.Session / SessionAgent | 负责当前用户会话中的显示、输入、音频和流式灯光。托盘应用退出后，配置自动化、自定义按键和交互灯效仍会运行。 | 每个已登录用户运行一个实例。服务仅接受来自活动控制台会话的硬件更改。 |
OpenBlade.Capture | 为开发者提供类型化捕获、查询和可逆验证工具。 | 正式安装包不包含此工具；安装程序也会拒绝安装包含它的文件包。 |
OpenBlade.FirmwareSmoke | 对已连接的 Blade 执行可恢复原状的固件检查，并在完成后恢复。 | 此开发工具不包含在正式安装程序中。 |
OpenBlade.DeploymentBroker / DeploymentClient | 无需反复请求权限即可安装本地构建的 OpenBlade，支持首次安装回滚。 | 仅供本地开发使用，且必须先在该计算机上明确授权并完成登记。正式安装包不包含此工具。 |
OpenBlade.Setup | 安装或卸载应用，管理服务和会话组件，并保留配置。 | 仅在修改计算机级设置时请求管理员权限。不会覆盖已安装的较新版本。 |
状态和优先级
服务按优先级决定采用哪些设置：手动覆盖、临时供电覆盖、当前配置，最后是已确认的固件状态。只有值发生变化时才写入。
固件行为因机型而异。 RZ09-0581 会把固定转速、手动曲线和最大转速都报告为同一种手动温控状态。适配器在确认这一通用固件状态的同时，保留用户选择的具体模式。
控制权与冲突
- 所有硬件操作都经由服务中的同一个入口，依次执行。
- 控制会话开始前，服务检查目标机型、VID/PID 和特征报告结构。已验证后端固定用途元组；实验性准入通过只读性能查询选择唯一响应的接口。
- OpenBlade 会检查是否有其他 Razer 控制器同时控制笔记本。经过验证的 Synapse Blade Blocker 安装 可让 Synapse 与 OpenBlade 同时运行，由 Synapse 管理外设。OpenBlade 不会卸载这些软件。你可以在“故障排除”中请求停止已知的 Synapse 和 Chroma 服务，并批准管理员权限；此操作仅限固定列表中的服务。OpenBlade 会显示各服务在 Windows 中的状态，不更改其启动类型。
- 通过安全检查后，OpenBlade 可恢复被其他应用更改的性能模式或风扇设置。选择“通知我”可报告更改并保留现状。从旧版本升级的配置需要确认一次才开始恢复。OpenBlade 从不自动启用 HyperBoost。用户开启的灯光策略也可按同样方式恢复灯光。
- 服务负责持续播放键盘动画灯效。静态设置和固件灯效在支持的情况下只需写入一次。
实验性支持的授权范围
这五种 实验性配置 使用根据上游实现编写的独立后端。每次写入仍须严格核对主机身份，并检查当前状态、供电和其他控制器。这些配置不会继承已验证后端的灯光判定数据、Driver 模式控制权、手动风扇控制或全功率适配器分类。
如果命令可能已提交，但结果无法确认，实验性写入就会暂停。恢复时会先清空旧会话，再重新执行只读准入和状态检查，不会重发结果不明的命令。灯光会继续暂停，直到用户重新选择实际生效的灯光设置。诊断仅在本地保留有限的历史记录。
故障处理
结果未知
写入可能已到达笔记本，但无法确认结果。此时应停止写入，并核实当前状态。实验性控制必须先明确执行只读的“恢复”操作，才能接受下一次请求。
被其他程序更改
报告更改，然后按你的选择恢复已确认设置或保留现状。绝不重放结果未知的写入。
数据不可用
无法获取的数据应明确显示为不可用。如果手动风扇曲线运行时温度数据丢失，曲线会请求该机型支持的最大转速；实际写入前仍须通过设备和控制器检查。