HarmonyOS App
为什么必须自己构建？ 鸿蒙的开发者工具必须登录华为账号才能下载，且其许可禁止再分发。公开 CI 服务因此无法合法构建鸿蒙应用，也就没有可直接安装的 HAP 供下载——只能从源码构建。签名与安装同样依赖这套工具，每一步都绕不开华为开发者账号。若鸿蒙生态允许，Luker 会直接发布现成的 HAP。
Luker 提供了鸿蒙应用，让你直接在设备上运行完整的 Luker 服务与界面，无需依赖云服务器或终端工具。
概述
安装 HAP 后，打开应用即可直接显示完整的 Luker 界面，不需要另外使用浏览器访问地址。应用内置了完整的 Luker 服务端和前端，是一个独立运行的应用。
从源码构建
前置条件
- Node.js 24 或更高版本
- DevEco Studio，安装并登录一次，它提供鸿蒙工具链与
hvigorw
macOS 与 Linux
git clone https://github.com/funnycups/Luker.git
cd Luker
bash harmony-app/scripts/build.shWindows
git clone https://github.com/funnycups/Luker.git
cd Luker
powershell -ExecutionPolicy Bypass -File harmony-app\scripts\build.ps1构建完成后，未签名的 HAP 位于 harmony-app/entry/build/default/outputs/default/entry-default-unsigned.hap。
签名与安装
1. 创建签名证书
在 DevEco Studio 里生成密钥与证书请求文件：依次选择 Build → Generate Key and CSR，设置密钥库名称与路径、密钥库密码、密钥别名与密钥密码。
随后在 AppGallery Connect 创建证书与描述文件：
- 登录 AppGallery Connect，进入 证书、App ID 和 Profile。
- 在 证书 下创建 调试 证书，上传
.csr文件，下载生成的.cer文件。 - 连接设备，执行
hdc shell bm get --udid读取设备 UDID。在 设备 下用该 UDID 添加设备。 - 在 Profile 下为包名
com.luker.harmony创建 调试 描述文件，选择证书与设备，下载.p7b文件。
2. 签名 HAP
用鸿蒙 SDK 里的 hap-sign-tool.jar 为构建出的 HAP 签名：
java -jar hap-sign-tool.jar sign-app \
-keyAlias <密钥别名> \
-signAlg SHA256withECDSA \
-mode localSign \
-appCertFile <证书>.cer \
-profileFile <描述文件>.p7b \
-inFile entry-default-unsigned.hap \
-keystoreFile <密钥库>.p12 \
-outFile luker-signed.hap \
-keyPwd <密钥密码> \
-keystorePwd <密钥库密码>3. 安装 HAP
在设备上启用 开发者选项 与 USB 调试，连接设备后安装：
hdc install -r luker-signed.hapTIP
也可以用 DevEco Studio 完成签名与安装：打开项目，在 File → Project Structure → Signing Configs 里配置自动签名，再在已连接的设备上运行应用。
WARNING
调试描述文件只能安装到其中已登记 UDID 的设备。要在另一台设备上安装，需在 AppGallery Connect 里把该设备加入描述文件并重新下载。
使用方式
安装完成后，打开 Luker 应用：
- 应用会自动启动内置的 Luker 服务
- 界面加载完成后，你会看到与桌面版完全相同的 Luker 界面
- 配置 API 连接、导入角色卡、开始对话——所有操作与桌面版一致
你不需要手动输入任何地址或端口，应用会自动处理一切。
与桌面版的功能差异
鸿蒙版本与桌面版在功能上基本一致，你可以使用所有核心功能，包括多 API 连接、角色卡管理、世界书、预设等。
由于移动设备的屏幕尺寸和交互方式不同，部分界面布局会自动适配移动端显示。