# CoreScan

**Repository Path**: laoyue_dev/corescan

## Basic Information

- **Project Name**: CoreScan
- **Description**: 专为deepin打造的极客级硬件驾驶舱，13147行纯C++/Qt6/DTK6底层代码，打包仅670KB。支持S.M.A.R.T.硬盘预警、内联汇编指令集透视、物理级测速、局域网扫描、电池寿命预测等硬核功能。绝对只读，绝不误杀，只为看透每一颗芯片的真相。
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 芯探 CoreScan

基于 **Qt6 + DTK6** 的 deepin / UOS v25 硬件检测工具箱。一块“硬件仪表盘”：
从磁盘空间树图到 S.M.A.R.T. 健康度，从 CPU/GPU 实时监控到电池健康与网络诊断，
全程图形化、中文友好。

## 功能一览

| 模块 | 能力 |
| --- | --- |
| 磁盘 | 目录树图空间分析、文件管理（删除走系统回收站）、S.M.A.R.T. 健康度、磁盘测速、I/O 占用画像 |
| 处理器 | 型号/频率/缓存、各核占用实时曲线、功耗墙信息、指令集透视（AVX2 / AVX-512 / SSE4.2 / VT-x）、CPU 压力测试 |
| 内存 | 用量/速率监控、内存压测、一键释放页缓存 |
| 网络 | 实时流量曲线、延迟测试、局域网设备扫描、流量异常告警 |
| 电池 | 电量/健康度、续航预估、蓝牙/WiFi 射频管理、充电阈值调优 |
| 其它 | 虚拟机环境识别、GPU 型号与占用、系统信息报告导出（PDF / HTML） |

## 支持架构

同一套源码可构建以下架构的 deb 包（CMake 依据 `CMAKE_SYSTEM_PROCESSOR` 自动判定）：

- `amd64`（x86_64）
- `arm64`（aarch64）
- `loong64`（loongarch64，龙芯）

## 权限与安全说明（重要）

芯探遵循“**默认只读、按需提权、最小权限**”原则：

### 1. 无需任何特权、纯只读的能力（占绝大多数）

所有监控数据均以只读方式采集自 `/proc`、`/sys`（sysfs）等内核接口，
**不写入系统任何状态、不修改任何配置**，包括：CPU/内存/网络实时监控、
磁盘空间扫描、电池信息、GPU 信息、指令集检测、虚拟机识别等。

### 2. 需要用户授权（pkexec 提权）的场景

以下少数管理类操作需要修改系统状态，程序会**在点击对应按钮时按需弹出**
系统授权对话框（polkit / pkexec），不会在启动时索取任何权限：

| 场景 | 原理 | 为何需要 root |
| --- | --- | --- |
| 读取 S.M.A.R.T. 硬盘健康数据 | `pkexec smartctl` | smartctl 读取原始磁盘扇区需要 root |
| 释放页缓存 | `pkexec sh -c 'sync && echo 3 > /proc/sys/vm/drop_caches'` | 写 `/proc/sys/vm/` 内核参数 |
| 结束系统进程 | 优先普通权限 `kill`，失败后 `pkexec kill -9` | 结束他人/系统进程需要 root |
| 关闭蓝牙 / WiFi 射频 | `pkexec rfkill block`、`pkexec nmcli radio off` | 射频开关属于系统级操作 |
| 电池充电阈值、CPU 省电调优 | `pkexec tee <sysfs 路径>` | 写 sysfs 硬件控制接口 |

所有 pkexec 命令均为**单条、白名单式**的固定参数，不存在开放式 root shell。

### 3. 文件删除：回收站机制（有“后悔药”）

文件管理中的删除操作**统一调用 `gio trash` 将文件移入系统回收站**，
不使用 `rm -rf` 等暴力物理删除；误删的文件可在回收站中找回。
该操作以当前用户身份执行，无需提权；仅测速程序自建的临时测速文件
在所在分区不支持回收站时，才会就地清理。

## 从源码构建

依赖：`qt6-base-dev`、`libdtk6core-dev`、`libdtk6gui-dev`、`libdtk6widget-dev`、
`cmake`、`g++`（以及打包所需的 `smartmontools`、`libglib2.0-bin` 等）。

```bash
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j"$(nproc)"
# 生成 deb 包（自动判定当前架构：amd64 / arm64 / loong64）
( cd build && cpack -G DEB )
```

构建产物：`build/corescan_<版本>_<架构>.deb`。

## 开源许可

本项目以 **GPL-3.0-or-later**（GNU 通用公共许可证 v3 或更高版本）发布，
详见 [LICENSE](LICENSE) 与 [debian/copyright](debian/copyright)。