# aarch64_skill

**Repository Path**: windstarry/aarch64_skill

## Basic Information

- **Project Name**: aarch64_skill
- **Description**: 用于检测aarch64环境和编译的skill
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-10
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# aarch64_skill

掌机移植 / 嵌入式 aarch64 相关可复用 Skill 集合，按分类存放。

## 目录结构（分类）

```
aarch64_skill/
├── README.md
├── build/                       # 交叉编译 / 构建类
│   └── aarch64-portmaster-build/   # 用 portmaster-builder:aarch64-latest 镜像做 aarch64 交叉编译 + PortMaster 打包衔接
│       ├── SKILL.md
│       └── references/
│           └── portmaster-launch-script.md
└── runtime/                     # 运行期 / 部署 / 启动 / 库策略
    └── handheld-port-test/         # 掌机测试设备（ROCKNIX/EE4.7）连接、部署、日志分析一体化
        ├── SKILL.md
        ├── references/
        │   └── device-credentials.md
        └── scripts/
            └── device_connect.py
```

### 分类约定

| 分类目录 | 用途 | 已收录 |
| --- | --- | --- |
| `build/` | 交叉编译、构建流水线、镜像内编译 | aarch64-portmaster-build |
| `ports/` | 具体游戏 / 应用移植配方（预留） | — |
| `runtime/` | 运行期、部署、启动脚本、库策略 | handheld-port-test |
| `tools/` | 辅助工具 / 调试 / 校验脚本（预留） | — |

新增 Skill 时，按用途放入对应分类目录，目录名即 Skill 名（kebab-case），其下放置 `SKILL.md` 及 `references/`（如有）。

## 已收录 Skill 说明

### build/aarch64-portmaster-build

在本地 Docker 镜像 `ghcr.io/monkeyx-net/portmaster-build-templates/portmaster-builder:aarch64-latest`
内对 C/C++ 源码做 aarch64（ARM64）交叉编译，并衔接 PortMaster 掌机打包。
覆盖 CMake / autotools / Makefile 三套配方、产物校验（file/readelf -d）、libs/ 打包与官方启动脚本规范、
ROCKNIX 不捆绑 Debian 运行库的实机坑。详见 `build/aarch64-portmaster-build/SKILL.md`。

### runtime/handheld-port-test

掌机测试设备（ROCKNIX / EmuELEC 4.7）的连接、部署与日志分析一体化辅助。连接时设备 IP 必须运行时传入（绝不写死），
按系统自动选凭据（rocknix→root/rocknix、ee47→root/emuelec）；把游戏资源与 `.sh` 部署到 `roms/ports/`（支持全量 / 增量上传）；
可从设备拉取 `log.txt` 回本地分析；提供 `ldd` 缺库门禁与无头启动探针做冒烟验收。统一走 paramiko SFTP，无需 sshpass。
详见 `runtime/handheld-port-test/SKILL.md`，辅助脚本 `runtime/handheld-port-test/scripts/device_connect.py`。