К основному содержанию
плагин

android-mainline-port — плагин для Claude Code: перенос Linux

Плагин android-mainline-port для Claude Code помогает переносить основной Linux на Android-планшеты и телефоны. Агент подключает его для оценки устройства, планирования этапов и разбора ошибок.

MIT ★ 126 обновлён 2026-11-15

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add yzddmr6/android-mainline-port
/plugin install android-mainline-port@android-mainline-port
Открыть на GitHub

Что делает android-mainline-port

android-mainline-port ведёт перенос основного ядра Linux и настольного дистрибутива на Android-устройство. Он помогает оценить, возможен ли перенос, выбрать маршрут и пройти этапы от подготовки сборки до запуска системы с рабочим рабочим столом и периферией.

Внутри — пошаговый процесс, правила технических решений и база типичных проблем по загрузке, экрану, питанию, беспроводной связи и другим узлам. Есть рекомендации для передачи проекта следующему участнику и проверки результатов. Если fastboot boot возвращает OKAY, но устройство остаётся в Fastboot, один из первых шагов — сверить msm-id и board-id в дереве устройств с ожиданиями bootloader.

Для установки плагина в Claude Code нужны команды добавления marketplace и установки плагина. Другой способ установки через npx skills требует Node.js 22 или выше.

Какие задачи решает

  • оценить возможность переноса Linux на Android-планшет
  • распланировать этапы переноса и критерии их завершения
  • найти причину сбоя при первой загрузке
  • разобрать проблемы с экраном, питанием или периферией
  • передать незавершённый перенос следующему участнику по документации

Примеры запросов агенту

  • Оцени, можно ли перенести основной Linux на мой Android-планшет, и распиши первые шаги.
  • fastboot boot возвращает OKAY, но планшет остаётся в Fastboot. Разбери возможные причины.
  • Прочитай документацию проекта переноса и определи текущий этап и следующие задачи.

Как установить android-mainline-port

Через маркетплейс плагинов

/plugin marketplace add yzddmr6/android-mainline-port
/plugin install android-mainline-port@android-mainline-port

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы об android-mainline-port

Как установить android-mainline-port в Claude Code?

В сессии Claude Code выполни /plugin marketplace add yzddmr6/android-mainline-port и затем /plugin install android-mainline-port@android-mainline-port.

Что делает android-mainline-port?

Помогает оценивать и вести перенос основного ядра Linux и настольного дистрибутива на Android-устройства. Включает этапы работы, правила технических решений и разбор типовых неисправностей.

Какие этапы переноса помогает пройти android-mainline-port?

Процесс охватывает подготовку и сборку, резервное копирование, первую загрузку, запуск графического рабочего стола, установку на накопитель и работу с периферией.

Исходный текст

SKILL.md · MIT
# android-mainline-port

把主线 Linux 内核和桌面发行版移植到 Android 手机、平板的操作手册与经验库,以 Agent Skill 的形式组织,Claude Code、Codex、Cursor、Gemini CLI 等 AI 编程助手都能直接使用,人也可以直接阅读。[English](README.en.md)

经验来自三台高通平板从零到公开发布的完整移植(主线内核 6.17 到 7.4,Ubuntu 26.04 + GNOME)。目标只有一个:从头再移植一台设备时,效率最高、少走弯路。

## 来自这些移植项目

| 设备 | SoC | 项目 |
|---|---|---|
| 小米平板 6 Pro | 骁龙 8+ Gen 1(SM8475) | [yzddmr6/xiaomipad-6pro-mainline](https://github.com/yzddmr6/xiaomipad-6pro-mainline) |
| 一加平板 2 Pro | 骁龙 8 至尊版(SM8750) | [yzddmr6/onepluspad-2pro-mainline](https://github.com/yzddmr6/onepluspad-2pro-mainline) |
| 小米平板 8 Pro | 骁龙 8 至尊版(SM8750) | [yzddmr6/xiaomipad-8pro-mainline](https://github.com/yzddmr6/xiaomipad-8pro-mainline) |

三个项目都在 Android 设备上原生运行 Ubuntu GNOME 桌面,与 Android 双系统共存,不是容器,也不是远程桌面。这份 skill 把三个项目里共同出现、反复出现、花很久才查清的问题,整理成了通用的流程、决策规则和经验条目。

## 📮 关注与交流

技术长文、经验分享和进展动态在公众号;交流群在小红书,扫码进群交流。

<div align="center">
<table>
<tr><th>公众号:熵减矩阵</th><th>小红书:yzddmr6</th></tr>
<tr>
<td align="center"><img src="docs/assets/gzh-qr.png" width="300" alt="公众号:熵减矩阵"></td>
<td align="center"><img src="docs/assets/xhs-qr.jpg" width="300" alt="小红书:yzddmr6"></td>
</tr>
<tr><td align="center">技术长文 · 经验分享 · 进展动态</td><td align="center">进群交流 · 问题反馈</td></tr>
</table>
</div>

## 能帮你做什么

- **评估新设备**:能不能移植、走哪条路线、要多久、需要你决定哪些事。
- **按流程推进**:从立项、构建环境、取证备份、首次启动、点亮桌面、安装到存储、逐个外设,到发布和维护,每一步写清做什么、做到什么程度算完成。
- **做技术决策**:40 多个关键决策点,每个都写了默认做法、"遇到什么情况怎么做"、背后的原因和不适用的情况;包括怎么比较两条实现路线、内核换代和几台设备共用一棵内核、怎么接收社区贡献。
- **改有状态的控制子系统**:充电、显示电源、挂起交接、温控这类 AP 和固件、硬件一起跑控制环的子系统,什么时候停止逐个修补,怎么建统一模型、让人攻击、按情况矩阵和完整的真实过程验收。
- **排查故障**:十一类常见问题模式和通用排查步骤,再按领域查具体的坑;日志里的错误码、函数名、配置项可以直接搜索。
- **中途接手**:规定了必须写哪些文档、技术债怎么登记,下一个人或 agent 只看文档就能继续。
- **和用户、AI 执行者协作**:哪些决定自己做、哪些交给用户;怎么少占用户的时间;怎么给子 agent 写任务而不把思考外包出去。

几条最省时间的经验:

- `fastboot boot` 返回 OKAY 却一直停在 Fastboot,先查设备树的 msm-id/board-id 是否和 bootloader 期望一致,而不是镜像大小。
- 借用固件画面(simpledrm)只用于首次点亮,原生显示接管要尽早并行开始,亮度、熄屏、休眠、外接显示都依赖它。
- 高通平台休眠默认用 s2idle:远端处理器的消息会把 deep 睡眠完整唤醒,而且不出现在唤醒记录里。
- 睡眠时长看墙上时间或挂起前后 BOOTTIME 与 MONOTONIC 差值的变化,dmesg 和 journal 的单调时钟在睡眠中会停。
- ccache 按实测约 0.3 GB 一次完整内核构建来配,10 GB 足够,同时设置 `base_dir`。
- 为了快速跑通而用的临时做法,全部登记进一份统一的技术债表,链路跑通后集中还债。
- 找现成实现按接口词搜(芯片名、驱动名、设备节点、协议),不按项目名搜;在定设计之前搜。
- 请用户到场测试之前,先在真机上把能自动跑的部分完整空跑一遍。

## 安装

### 推荐:npx skills

一条命令装给你在用的所有 AI 编程助手(Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 等),需要 Node.js 22 或更高版本:

```bash
npx skills add yzddmr6/android-mainline-port -g
```

- `-g` 装到用户目录,所有项目都能用;不加则只装到当前项目。
- 运行后会让你选择装给哪些助手;也可以直接指定,例如 `-a claude-code -a codex`。
- 更新:`npx skills update android-mainline-port -g`;卸载:`npx skills remove android-mainline-port -g`。

### Claude Code 插件

在 Claude Code 会话里输入:

```text
/plugin marketplace add yzddmr6/android-mainline-port
/plugin install android-mainline-port@android-mainline-port
```

或者在终端里:

```bash
claude plugin marketplace add yzddmr6/android-mainline-port
claude plugin install android-mainline-port@android-mainline-port
```

更新:在 `/plugin` 的 Marketplaces 页打开自动更新,或手动执行 `claude plugin marketplace update android-mainline-port` 后再 `claude plugin update android-mainline-port@android-mainline-port`。

### Gemini CLI

```bash
gemini skills install https://github.com/yzddmr6/android-mainline-port.git
```

### 手动 git clone

把仓库克隆到助手的 skill 目录,目录名必须是 `android-mainline-port`:

| 助手 | 用户级目录 | 项目级目录 |
|---|---|---|
| Claude Code | `~/.claude/skills/` | `.claude/skills/` |
| Codex | `~/.agents/skills/` | `.agents/skills/` |
| Gemini CLI | `~/.gemini/skills/` 或 `~/.agents/skills/` | `.gemini/skills/` |
| Cursor | `~/.cursor/skills/` 或 `~/.agents/skills/` | `.cursor/skills/` |
| GitHub Copilot | `~/.copilot/skills/` 或 `~/.agents/skills/` | `.github/skills/` |
| OpenCode | `~/.config/opencode/skills/` 或 `~/.agents/skills/` | `.opencode/skills/` |

以 Claude Code 为例:

```bash
git clone --depth 1 https://github.com/yzddmr6/android-mainline-port ~/.claude/skills/android-mainline-port
```

更新时在该目录里执行 `git pull`。不要用 GitHub 的 "Download ZIP",解压出来的目录名带 `-main`,和 skill 名不一致,部分助手会不识别。

### claude.ai 网页与桌面 App

1. 从 [Releases](https://github.com/yzddmr6/android-mainline-port/releases/latest) 下载 `android-mainline-port.zip`。
2. 在 Settings → Capabilities 打开 "Code execution and file creation"。
3. 打开 Customize → Skills,点 "+",选择上传 skill,选中这个 zip。

### 让 AI 帮你装

把下面这段话发给你的 AI 编程助手:

```text
请帮我安装这个 Agent Skill:https://github.com/yzddmr6/android-mainline-port
1. 先判断你自己的用户级 skill 目录:Claude Code 是 ~/.claude/skills,Codex、Gemini CLI、Cursor、GitHub Copilot、OpenCode 可用 ~/.agents/skills,或以你自己文档里写的目录为准。
2. 执行 git clone --depth 1 https://github.com/yzddmr6/android-mainline-port <skill目录>/android-mainline-port;如果目录已存在,改为在里面执行 git pull --ff-only。
3. 目录名必须是 android-mainline-port,和 SKILL.md 里的 name 一致。
4. 确认目录里有 SKILL.md、references/、experience/,且 SKILL.md 开头写着 name: android-mainline-port。
5. 不要改动其他 skill 和设置。最后告诉我装在哪里,是否需要重启或重新加载。
```

### 确认装好了

- Claude Code:输入 `/android-mainline-port`(插件方式是 `/android-mainline-port:android-mainline-port`),能看到这个 skill 即可。
- 其他助手:直接问一句"我想把主线 Linux 移植到一台安卓平板上,先帮我评估",助手会读取这份 skill 再回答。

## 使用示例

装好之后不需要特别的命令,像平常一样描述你的情况即可:

- "我有一台骁龙 8 Gen 3 的平板,BL 能解锁,帮我评估能不能跑主线 Linux + Ubuntu,大概要多久。"
- "`fastboot boot` 返回 OKAY,但屏幕一直停在 Fastboot 界面,pstore 也是空的,帮我排查。"
- "休眠一两秒就被唤醒,帮我查唤醒源。"
- "接手这个移植项目,先读文档,告诉我现在在哪一步、下一步做什么。"

## 内容结构

- **外层框架**:`SKILL.md` 和 `references/`。先做什么后做什么、工作纪律、技术选型、构建环境、怎么判断通过、Ubuntu 集成与解耦。相对稳定。
- **经验库**:`experience/`。按领域记录推荐路线、完成标准和具体的坑(现象、原因、怎么确认、怎么解决、怎么预防),随项目持续追加。

```
SKILL.md                         流程总览、顺序要点、工作纪律、选型原则、用户决策
references/
  process.md                     每一步的详细动作、产出、完成标准
  discipline.md                  文档要记什么、技术债、目录结构、署名、估算、子 agent
  build-environment.md           主机、工具链、ccache、OUT、根文件系统构建、缓存
  decisions.md                   关键技术决策:默认做法、条件与做法、机制、边界
  control-models.md              有状态控制子系统的建模、审查与验收
  verification.md                状态词、证据、冷启动、测试自动化、性能预算
  ubuntu.md                      Ubuntu 分层与解耦、包拆分建议、启动钩子、换发行版
experience/
  README.md                      条目格式和维护规则
  patterns.md                    十一类问题模式与通用处理
  bootloader-and-boot.md         ABL、启动格式、首次启动、调试通道、恢复
  kernel-and-resources.md        内建与模块、资源回收、PMIC 电压、设备树数值
  display.md                     simpledrm 与原生接管、DSC、熄屏亮屏、背光
  gpu.md                         Adreno、固件、自编 Mesa、新 GPU 的 Mesa 缺陷
  touch-and-input.md             触控(TDDI)、按键、键盘配件、指纹
  audio.md                       AudioReach、功放、麦克风、UCM、音量
  wireless.md                    Wi-Fi、蓝牙
  power-and-time.md              电量、充电、休眠、系统时间
  sensors-camera-media.md        传感器与旋转、相机、视频硬解
  usb-and-storage.md             USB、外接显示、分区、双系统、刷写、安装
  ubuntu-userspace.md            Ubuntu 打包、dracut、snap、GNOME 默认值
  build-and-release.md           构建流水线、缓存、可复现性、发布
  testing-and-process.md         判断标准、自动化测试、协作、子 agent
```

移植流程分九步:

| 步 | 做什么 |
|---|---|
| 0 立项 | 资料池、复用调研、硬件清单、选型、估算,和用户确认决策 |
| 1 构建环境 | 工具链、ccache、长期 OUT,原样构建一次社区参考内核 |
| 2 取证与备份 | root,备份并校验,取出运行时设备树、固件、电压、显示参数 |
| 3 首次启动 | 搞清 bootloader,最小设备树,USB 网络 shell,超时自动回原系统 |
| 4 点亮与内存桌面 | 显示、触控、GPU,内存里跑起 GNOME,搭好桌面自动化测试 |
| 5 安装到存储 | 分区、双系统、启动切换、调试通道,冷启动验证 |
| 6 外设 | 一次一个:查复用、对照原厂、单独测试、真机、合并、回归 |
| 7 发布 | 功能冻结、分层打包、按公开文档从零安装验收 |
| 8 维护 | 上游合入就删本地实现,还技术债,每次更新冷启动验证 |

## 适用范围与时效

- 高通平台写得最具体;其他 SoC 的流程和纪律相同,硬件细节需要自己调研。
- Ubuntu 相关部分换发行版时按 `references/ubuntu.md` 最后一节调整。
- 内容基于 2026 年的上游状态。版本号、接口名、上游进度有时效性,使用前请核对;上游已经解决的问题,直接用更简单的办法。
- 正文是中文,各家 AI 都能正常阅读和使用。

## ⚠️ 风险提示

- 解锁 bootloader 会清空设备数据,可能影响保修;刷写分区操作不当可能导致设备无法启动。
- 动手前按 skill 里的要求完整备份分区并校验,确认有恢复手段。
- 本仓库只提供方法和经验,不提供刷机工具、镜像或固件。内容按"原样"提供,使用风险自负。

## 贡献

欢迎通过 Issue 和 Pull Request 补充经验:

- 在 `experience/` 对应文件里按 `experience/README.md` 的格式追加条目。
- 只写确认了根因的问题,写清现象、原因、怎么确认、怎么解决、适用范围。
- 不写设备型号、序列号、地址、校准数据、个人信息;芯片型号、驱动名、错误码可以写,它们是搜索关键字。

## 许可

[MIT](LICENSE)

© yzddmr6 · MIT · yzddmr6/android-mainline-port

Похожие плагины

Все плагины по теме «Мобильная разработка» →
argent-android-emulator-setup software-mansion Скилл argent-android-emulator-setup подключает Android-эмулятор через инструменты Argent MCP: находит готовое устройство или запускает AVD перед UI-задачами. CX Codex +1 32 900установок android-emulator callstack Управляет Android Emulator: запускает приложения, проверяет интерфейс и собирает данные для отладки. Проверяет native-, React Native-, Expo- и Flutter-приложения. CX Codex +1 6 300установок orca-emulator-android stablyai Скилл orca-emulator-android для Claude Code управляет Android-устройством или эмулятором через adb. Запускается для действий в приложении и проверки его состояния. CX Codex +1 6 000установок android-profiler Google LLC Скилл android-profiler для платформ вроде Claude Code и Codex: записывает трассировки Android и разбирает их на предмет джанка, утечек памяти и лагов запуска. Анализ работает даже там, где пользователь не просил профилировать напрямую. CX Codex +1 1 700установок mapbox-android-patterns mapbox Скилл mapbox-android-patterns для Claude Code с официальными паттернами Mapbox Maps SDK для Android. Подхватывает установку SDK, маркеры, геолокацию, стили, камеру и обработку нажатий на карте в Kotlin-проектах с Jetpack Compose и View. CX Codex +1 1 500установок ios-android-logs Cap-go Скилл ios-android-logs показывает, откуда брать логи и краш-отчёты Capacitor-приложения на iOS и Android, и как отфильтровать их до своего процесса. CX Codex +1 1 400установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой