Repository navigation
Roadmap and Contributing
本手册描述 v0.3.135。显示器控制、系统音量与输入、鼠标、总配置和型号预设、桌面面板、软件色温、Windows HDR 以及本地 OSD 配对已提供；另含 WMI 内屏亮度、原生 RP2040 USB / HTTP 光照订阅、采样设置、64 MiB 历史和按时间/日出日落调节亮度与 FC 主题；具体硬件效果以设备实测为准。
后续重点包括更多型号的色温/场景与原厂导航适配、显示器 USB/HID 协议研究、WMI 实机验收与厂商接口评估、混合 DPI 和热插拔体验，以及在线配置分享与适配报告服务。应用自动联动、定时应用整套配置、ICC/MHC2、C3/CH552 固件、HID/BLE 光照接入、FC 刷写和偏好学习也尚未实现。光照相关 Windows/WinUI/MSI/Setup 自动化已通过；实体 RP2040 完整联调、真实显示器及混合 DPI 仍待确认。计划不代表已有支持或承诺日期。
本仓库采用 MIT License。允许使用、修改、分发和商业使用，包括在闭源项目中使用；分发软件副本或实质部分时，需要保留版权与许可声明。软件按“现状”提供，完整条款以 LICENSE 为准。
第三方依赖和单独注明许可的内容继续适用各自许可证。本仓库的 MIT 声明不改变独立网站仓库或外部参考项目的许可。
- 报告问题：按诊断模板给出环境、复现步骤和实测证据。
- 提交型号适配：注明完整型号、固件、连接、HDR 状态、指令来源、请求/返回与实体效果，不把别的品牌指令当作通用协议。
- 改进翻译或文档：提交修正，说明对应界面或页面；保留八种界面的键和占位符一致性。
- 开发贡献：先看贡献指南；社区以 PR 协作，维护者当前仍可直推，未来强制评审步骤见维护手册。工程细节见 agent.md 与开发手册。用户手册源文件在
docs/wiki/，工程结构和开发约束不混入普通使用步骤。
| 项目 | 参考方向 |
|---|---|
| Twinkle Tray | 分阶段发现、通信隔离和兼容处理 |
| ddcutil / ddccontrol-db | DDC 能力解释、型号定义与适配库维护 |
| msigd | 特定 MSI 显示器的 USB/HID 协议研究 |
| ddc-mode-switcher / ddc-toolkit | 特定型号的原厂菜单映射和实测记录 |
这些项目是研究参考，不代表 FC 已集成其全部能力；不同品牌、型号和固件之间不能直接继承控制协议。引入外部代码或数据时仍需遵守对应许可证。
This guide covers v0.3.135. Current features include monitor controls, system Volume/Input, mouse settings, global profiles and model presets, a desktop panel, software temperature, Windows HDR and local OSD pairing, plus WMI panel brightness, native RP2040 USB/HTTP light subscriptions, sampling controls, 64 MiB history and scheduled brightness/FC themes. Hardware behavior still requires verification.
Planned work includes broader model adaptation, monitor USB/HID research, physical WMI validation and OEM interfaces, mixed-DPI/hot-plug improvements, and online sharing/adaptation services. Automatic application rules, scheduled whole-profile application, ICC/MHC2 management, C3/CH552 firmware, HID/BLE light input, flashing and learning are unimplemented. Light-related Windows/WinUI/MSI/Setup automation passed; physical RP2040 integration, real displays and mixed DPI remain unverified. Plans are not support claims or delivery dates.
This repository uses the MIT License. It permits use, modification, distribution and commercial use, including in closed-source projects, provided the copyright and permission notice is retained in copies or substantial portions. The software is provided as-is; the LICENSE contains the full terms. Third-party dependencies and separately licensed content retain their own licenses, and this does not relicense the independent website repository or reference projects.
Report issues with the diagnostic checklist. Model adaptations need exact model/firmware, connection, HDR state, protocol provenance and observed results. Translation fixes should preserve locale keys and placeholders. For code contributions, start with CONTRIBUTING.md. Community changes use PRs; the maintainer retains direct push access until the strict review policy is activated. For engineering details, read agent.md and the development guide. User-guide sources live in docs/wiki/.
The reference projects above inform discovery, DDC interpretation, model libraries and specific USB/native-menu research. They are not promises of equivalent FC hardware coverage. Respect the relevant licenses when reusing external code or data.
FluentControl · 手册基线 / Guide baseline v0.3.135 · MIT License · 文档源文件 / Edit these docs · 更新记录 / Changelog