# qt.mechrevo-ecreader

**Repository Path**: zinface/qt.mechrevo-ecreader

## Basic Information

- **Project Name**: qt.mechrevo-ecreader
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mechrevo-perfmode

机械革命无界 14Pro 笔记本性能模式 DDE Dock 插件 + 独立 GUI 查看器。

通过读取 EC 寄存器 0xE4 获取当前性能模式（节能/平衡/性能），在 Deepin/GXDE 任务栏显示图标，或通过独立 GUI 窗口查看。

## 架构

```
┌─────────────────────────────────────────────────────────┐
│ 用户会话                          │ 系统服务 (root)       │
│                                   │                      │
│  DDE Dock  ──DBus──►  mechrevo-ecreader  ──QFile──►  EC  │
│  (libperfmode.so)   │  (com.mechrevo.ECReader)  │ 寄存器  │
│                   │                            │  0xE4   │
│  mechrevo-perfmode-│                            │         │
│  viewer (独立 GUI)  │                            │         │
└─────────────────────────────────────────────────────────┘
```

- **mechrevo-ecreader**: 以 root 运行的特权 DBus 服务，通过 QFile 读取 `/sys/kernel/debug/ec/ec0/io`，启动时自动加载 `ec_sys` 内核模块
- **mechrevo-perfmode-plugin**: DDE/GXDE Dock 插件，5 秒定时轮询，显示自定义绘制图标
- **mechrevo-perfmode-viewer**: 独立 Qt GUI 窗口，用于测试或 Dock 不可用时查看

## 模式与颜色

| EC 值 | 模式 | 图标 | 颜色 |
|-------|------|------|------|
| 0x00 | Performance | P | 🔴 `#eb4034` |
| 0x01 | Balanced | B | 🔵 `#347aeb` |
| 0x02 | Power-Saver | E | 🟢 `#2eb85c` |
| 其他 | Unknown | ? | ⚪ `#b4b4b4` |

## 安装

### 从 deb 包安装

```bash
sudo dpkg -i mechrevo-ecreader_1.0.0-1_amd64.deb
sudo dpkg -i mechrevo-perfmode-plugin_1.0.0-1_amd64.deb
sudo dpkg -i mechrevo-perfmode-viewer_1.0.0-1_amd64.deb
```

安装后自动启动后端服务，重启 dde-dock 加载插件：

```bash
killall dde-dock
```

### 从源码编译安装

```bash
# 编译后端
cd backend && qmake backend.pro && make -j$(nproc) && cd ..

# 编译插件
qmake perfmode.pro && make -j$(nproc)

# 编译查看器
cd viewer && qmake viewer.pro && make -j$(nproc) && cd ..

# 安装
sudo ./install.sh
```

## 文件结构

```
├── backend/
│   ├── backend.pro          # 后端构建文件
│   └── main.cpp             # DBus 特权服务
├── viewer/
│   ├── viewer.pro           # 查看器构建文件
│   ├── main.cpp             # Qt GUI 窗口
│   └── mechrevo-perfmode-viewer.desktop
├── debian/
│   ├── control              # 包定义 (3 个 binary 包)
│   ├── rules                # debhelper 构建规则
│   ├── mechrevo-ecreader.*
│   ├── mechrevo-perfmode-plugin.*
│   └── mechrevo-perfmode-viewer.*
├── perfmodeplugin.h/cpp     # DDE Dock 插件
├── perfmode.pro             # 插件构建文件
├── perfmode.json            # 插件元数据
├── com.mechrevo.ECReader.*  # DBus 策略 + 接口定义
├── com.mechrevo.ECReader.service  # systemd unit
├── install.sh               # 一键安装脚本
└── show_ec_mode.sh          # EC 调试脚本
```

## 依赖

- Qt 5 (Widgets, DBus)
- dde-dock / gxde-dock-dev (插件构建)
- debhelper (debian 打包)
- Linux 内核模块: `ec_sys` (服务自动加载)

## 打包

```bash
dpkg-buildpackage -us -uc -b
```