# HeurAMS-K: HeurAMS 的 Kirigami 现代前端

## 概述

"潜进K型" (HeurAMS-K) 是 [潜进 (HeurAMS)](https://git.pluv27.top/pluv/HeurAMS) 的现代跨平台图形用户界面前端,  
基于 KDE 用户界面框架 **Kirigami** 与 **Qt6** / **KDE Framework6** 构建, 旨在为潜进核心调度器提供遵循 KDE 设计风格的现代原生体验.

> [!NOTE]
> HeurAMS-K 目前处于早期开发阶段, 已建立完整的 CMake 构建框架、QML 模块结构和 Flatpak/Android 打包基础设施.
> 当前图形界面仅包含功能演示级别内容, 尚未与潜进 Python 核心程序库实现对接.

HeurAMS-K 将通过 **PyOtherSide** 直接复用 HeurAMS Python 内核,  
支持 Windows、Linux (原生与 Flatpak)、macOS、Android 和 Plasma Mobile 平台.

## 参与项目

HeurAMS-K 项目需要以下方面的贡献者:

- **C++ / Qt / KDE 框架开发** — 扩展应用层与核心逻辑
- **QML 界面开发** — 设计美观、自适应的学习界面
- **Python 桥接** — PyOtherSide 或类似技术的集成
- **Android / Plasma Mobile** — 移动端适配与测试

由于 KDE Invent 的硬性规定, 仓库主分支使用 `master` 而非 `main`  以便和 KDE 的设施集成, 这与 HeurAMS 主项目不同,  
其他内容请参阅 [潜进主项目贡献指南](https://git.pluv27.top/pluv/HeurAMS/src/branch/main/CONTRIBUTING.md) 了解整体贡献流程.

## 许可证

本项目遵循 REUSE 规范, 各文件头部标注了对应的 SPDX 标识.

| 组件 | 许可证 |
|------|--------|
| 源代码 (C++/QML) | **GPL-2.0-or-later** (大多数文件) |
| CMake 构建文件 | **BSD-2-Clause** / **BSD-3-Clause** |
| KConfig 定义 | **LGPL-2.0-or-later** |
| 元数据 (.desktop, metainfo) | **CC0-1.0** |
| Flatpak 清单 | **FSFAP** |
| Android 构建文件 | **BSD-3-Clause** |

详见 [LICENSES/](LICENSES/) 目录下的许可证全文.