面向普通人的手机使用指南。84 章、11 篇，从看懂手机硬件参数讲到用 AI 工具做出自己的第一个 App。
- 在线阅读：https://classtechstar.github.io/Yihggh.github.io/
- 多语言入口：index.html（按浏览器语言跳转）
- PDF 下载：见 PDF 下载
- Android 应用：19 种语言各有独立 APK，见 apk-v1.8-r2 Release（书名统一版，versionCode 2 可覆盖旧包）
内容与代码采用 CC BY-NC-SA 4.0 许可。
一条流水线，多端交付，全程可校验：
Markdown 源稿（source/，逐章）
│
▼ bookkit build（manifest/languages.json 单一数据源）
19 种语言单文件 HTML（v1.8/，每语言一个，离线自足）
├──▶ XeLaTeX 排版 ──▶ 5 个 Release 共 93 本 PDF（latex/）
├──▶ aapt2 / d8 / apksigner ──▶ 19 个 Android APK（Release：apk-v1.8-r2）
├──▶ PWA：sw.js 精准缓存，断网可读（manifest.webmanifest）
├──▶ 章节自测题库（quiz/，zh-CN + ja，gen_quiz.py 自动生成）
└──▶ MCP Server（mcp/server.py）──▶ Claude 等 AI 客户端直查全书结构/全文
质量门（全部自动化，0 error / 0 warn）：
bookkit lint --all-versions：结构、章节锚点、目录、版本串、lang/RTL、NUL、残留字、覆盖率bookkit check --claims：README / index.html 的每一处"宣称数字与链接" ↔ 真实内容逐条比对bookkit build --verify：构建产物与已发布成品逐章比对web_smoke.py：20 个页面 console 零报错 + 锚点解析 + h3 计数- 多语言逐节点对齐审计：译文与 zh-CN 源稿按位置 1:1 校验后发布
详见 docs/competition/：项目说明书、 答辩演示脚本、数据与证据。
全书分四块：
基础（第 0–7 章）：手机里到底有什么。SoC、运存、存储分别干什么，怎么管文件，Wi-Fi 和流量的区别，装 App 该注意什么，怎么把手机调顺手。
软件与安全（第 8–26 章）：账号怎么管、照片怎么备份、密码怎么存、手机丢了第一时间做什么、诈骗短信怎么认、权限该不该给。
生活场景（第 27–36 章）：给长辈和孩子配手机、屏幕时间怎么控、手机和智能家居、投屏、数字遗产。这部分是实操向的，照着做就行。
开发（第 37–69 章）：从零学做 App。怎么跟 AI 描述需求、怎么让它写代码、怎么调试，到用 Kotlin / Swift 在安卓和 iOS 上各做一个，再上架。
每章开头有「本章导览」，结尾有「动手练习」。页面带阅读进度记忆、字号调节、深色模式和朗读；也做了 PWA，装到桌面后断网能看。
写这本书的起因是我爸妈老问我「存储满了删什么」「这条中奖短信是真的吗」「照片怎么搬到新手机」。市面上要么是太浅的入门册子，要么是维修手册，把原理讲清楚的没几本。所以我写了一本，安卓和 iOS 都覆盖。
| 语言 | 在线阅读 | APK 安装包 |
|---|---|---|
| 简体中文 | zh-CN.html | APK |
| 繁體中文 | zh-TW.html | APK |
| 粵語 | yue.html | APK |
| English | en.html | APK |
| 한국어 | ko.html | APK |
| 日本語 | ja.html | APK |
| Русский | ru.html | APK |
| Italiano | it.html | APK |
| Português | pt.html | APK |
| Español | es.html | APK |
| Français | fr.html | APK |
| Deutsch | de.html | APK |
| العربية | ar.html | APK |
| עברית | he.html | APK |
| ภาษาไทย | th.html | APK |
| Bahasa Indonesia | id.html | APK |
| Bahasa Melayu | ms.html | APK |
| Ελληνικά | el.html | APK |
| 文言文 | lzh.html | APK |
每种语言都是完整的 84 章单文件 HTML，可以离线打开。阿拉伯语和希伯来语做了从右到左排版。
XeLaTeX 排版，带目录和书签，五个 Release 共 93 本（17 + 19 × 4），全部免费。
| 版本 | Release | 内容 |
|---|---|---|
| v1.8（推荐） | latex-pdf-v1.8-20261028 | 19 种语言 × 84 章，书名统一版 |
| v1.8 旧版 | latex-pdf-v1.8-final | 19 种语言（旧书名） |
| v1.7 | latex-pdf-v1.7 | 19 种语言 |
| v1.6 | latex-pdf-v1.6 | 19 种语言 |
| v1.5 | latex-pdf-v1.5 | 17 种语言 |
v1.5–v1.8 旧版 PDF 用的是各语言各自的旧书名（如英文 Master Your Phone!）， 20261028 这一版起统一为《你缺失的那门手机课》及其译名。
latex/ 里是 19 种语言的 LaTeX 源稿，想自己改排版可以直接编译。
主分支只留 v1.8，旧版本打包放到了 Release：
- HTML 归档（v1.5–v1.7）：html-archive
- HTML 归档（v1.3–v1.4）：legacy-html-archive
- 源稿与翻译：source/（中文）与 source/translations/（另外 18 种语言）
19 种语言各一个独立应用，包名不同，可以同时装。正文内嵌在包里，离线能看；联网时才加载完整排版样式。需要 Android 5.0 以上。
下载见上面的语言表，或 Releases。
| 目录 | 说明 |
|---|---|
v1.8/ |
最新版本，19 种语言的单文件 HTML |
source/ |
中文源稿（单一事实源）：chapters/ 84 章、parts/ 11 篇导语、book.json |
source/translations/ |
另外 18 种语言的翻译源稿，与成品逐章等价 |
manifest/ |
languages.json：语言元数据、版本门禁、入口页卡片 |
bookkit/ |
Python 工具链（零依赖）：extract / build / lint / check / index / i18n / latex / release |
scripts/ |
质检与维护脚本，见 scripts/README.md |
latex/ |
19 种语言的 LaTeX 书稿源文件与编译产物 |
mcp/ |
本书结构的 MCP 查询服务器，AI 客户端可以直连查章节 |
quiz/ |
章节自测题库（82 章 218 题）与 quiz.html 答题页 |
index.html |
多语言阅读入口页（卡片块由 bookkit index 生成） |
手机课-LaTeX-PDF/ |
排版管线脚本（typeset.py，PDF 可复现；大文件见 Releases） |
python -m bookkit lint # 结构/锚点/目录/版本串/lang 检查
python -m bookkit check --claims --index # README / index.html 宣称值与死链校验
python -m bookkit build --verify # 源稿重建 HTML，与成品逐章比对
python -m bookkit i18n --report coverage.md
python scripts/html_audit.py # 全量审计（顺序/编号/排版产物）几点说明：
- 源稿是唯一事实源。中文和另外 18 种语言都是 Markdown，改完一键重建 HTML。 构建产物和线上成品逐章比对，19 种语言全部等价。
- 翻译从成品反解而来，
python scripts/extract_translations.py会逐章校验保真度。 - 质检有两道闸门：
html_audit.py管 HTML，pdf_audit.py管 PDF 书签与编号。
- v1.5–v1.7 已归档。其中 v1.7 有六种语言（it/ko/pt/ru/yue/zh-TW）缺第 37–41 章， v1.6 有零星缺章，详见归档说明。v1.8 无缺章，请优先读 v1.8。
- 文言文（lzh）v1.7 的旧文件曾有 NUL 字符损坏，已修复；推荐阅读 v1.8/lzh.html。
- 项目 QQ 群：1074995524
- 哔哩哔哩：@ClassTechStar
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。