# device-manager **Repository Path**: sunstom/device-manager ## Basic Information - **Project Name**: device-manager - **Description**: No description available - **Primary Language**: Unknown - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-17 - **Last Updated**: 2026-11-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Linux 设备管理器 基于 **Qt6 + QML + CMake** 的 Linux 设备管理器:通过配置驱动的方式读取 `/sys` `/proc` /udev 展示设备信息,支持受控修改配置与实时监控。 ## 许可 本项目采用 **GPL-3.0-or-later** 许可(见 [LICENSE](LICENSE))。源文件含 SPDX 标识,版权/许可声明由 [REUSE.toml](REUSE.toml) 统一管理;文档与配置采用 CC-BY-SA-4.0。 核心思想:**框架代码不写任何硬件路径**——每类设备一份 JSON 配置(发现规则 + 属性读取 + 监控 + 可写项),框架按配置解释执行,新增设备类型零代码改动。 ## 目录结构 ``` linux-device-manager/ ├── CMakeLists.txt # 根构建脚本(devmgr_core 静态库 + 3 个可执行目标) ├── src/ # C++ 源码 │ ├── core/ # 核心服务层(配置仓库/属性读取/监控引擎/解析器/hwdata) │ │ └── parsers/ # 值解析器(pci/usb/dmi/cpu/storage/net/edid…) │ ├── controllers/ # QML 桥接控制器(设备/监控/概览) │ └── apps/ # 可执行入口 │ ├── gui_main.cpp # device-manager:GUI 主程序 │ ├── probe_main.cpp # devmgr_probe:配置/实例探测验证(M1) │ └── read_main.cpp # devmgr_read:属性读取端到端验证(M2) ├── qml/ # QML 界面(Main/Sidebar/DeviceList/DetailPanel/MonitorView/OverviewView + components/) ├── config/ # 设备配置(框架的“数据驱动”部分) │ ├── schema/ # device.schema.json 统一 schema │ └── devices/ # 每类设备一份 JSON(cpu/gpu/net/storage/battery…) ├── docs/ # 文档与设计材料 │ ├── architecture/ # 技术架构说明 + 架构图 │ ├── research/ # 调研文档(数据源/界面架构/调研总结) │ ├── prototype/ # 可交互视觉原型(浏览器打开 html) │ └── shots/ # GUI 截图 └── build/ # 构建产物(gitignore) ``` ## 构建与运行 依赖:Qt6(Core/Quick/Qml)+ CMake ≥ 3.16,`/usr/share/hwdata/pci.ids`(厂商名数据库)。 ```bash cmake -S . -B build cmake --build build -j ./build/device-manager # GUI ./build/devmgr_probe # 配置加载/实例展开验证 ./build/devmgr_read # 属性读取验证(默认测 cpu/gpu/net…,可传设备 id) ``` 默认配置目录为项目根 `config/`(相对 build 可执行文件解析,可用 `argv[1]` 覆盖)。 ## 验证钩子(offscreen 截图/环境变量) ```bash QT_QPA_PLATFORM=offscreen QML_SCREENSHOT=/tmp/s.png ./build/device-manager # QML_SELECT_CATEGORY=gpu 切换分类再截图 # QML_SELECT_TAB=mon 切到监控 tab # QML_WIN_W / QML_WIN_H 覆盖窗口宽/高(窄窗/长页验证) # QML_HOVER_DEVICE=1 强制显示首项设备 tooltip # QML_HOVER_ATTR=2 强制显示第 2 属性行 tooltip # QML_OPEN_COMBO=1 自动展开第一个下拉框 ``` ## 更多文档 - 📋 技术架构:[`docs/architecture/技术架构.md`](docs/architecture/技术架构.md) + [`docs/architecture/架构图.html`](docs/architecture/架构图.html) - ⚙️ 配置框架:[`config/配置框架说明.md`](config/配置框架说明.md)(schema + 多类设备示例 + 容错机制) - 🔍 调研总结:[`docs/research/00-调研与设计总结.md`](docs/research/00-调研与设计总结.md) - 🎨 界面原型:[`docs/prototype/dir-3.html`](docs/prototype/dir-3.html)(已选方向:现代毛玻璃卡片)