steve-berlin/unbox-the-machine

# 拆解机器 —— 探索嵌入式 Linux 设备的入门课程 这是一个静态的、通俗易懂的课程，教授小型嵌入式 Linux 设备的 内部工作原理，以及如何从零经验开始安全地探索它们。 课程**包含**实践教程：20 个主要部分（简介 + 第 1-19 部分），以 **Nokia G-010G-P** 光纤调制解调器为操作示例； 外加基于 **DIGITAL+ T11** 卫星机顶盒（STMicroelectronics STi7101 处理器）的 7 步进阶路线； 以及包含 140 个术语的词汇表 —— 提供测验、“动手实践”练习、内联 SVG 图表、浅色/深色主题，且无需构建步骤。 备份于 。 ## 技术 纯 HTML + 一个共享的 CSS 文件 + 一个约 30 行的 JavaScript 文件用于测验。 **没有框架，无需构建步骤，没有依赖。** 每个页面都是可以直接打开的普通文件。 ## 本地运行 任何静态文件服务器都可以。它是为 [pyweb-vanilla](https://github.com/steve-berlin/pyweb-vanilla) 构建的 —— 从 仓库根目录运行它，它就会提供 `index.html` 的服务。或者，如果已经安装了 Python： ``` python3 -m http.server 8000 # 然后打开 http://localhost:8000 ``` ## 目录结构 ``` index.html course home + full lesson list glossary.html every term, in plain English (~143) lessons/ one HTML file per part (multi-page) 00-introduction.html 01-whats-inside.html 02-uart-hidden-console.html … through … 19-ethics-safety.html t11-00-overview.html second path: DIGITAL+ T11 (STi7101), 7 steps … through … t11-06-limits-and-legal.html css/style.css shared styles (light + dark, mobile) js/quiz.js progressive-enhancement quizzes js/progress.js per-part "done" marks + home progress bar (localStorage) docs/ ELI11 notes for each script (quiz.md, progress.md) TOPIC.md the course brief / spec CLAUDE.md guidance for AI assistants working on this repo ``` ## 添加课程 1. 复制 `lessons/` 中的现有文件作为你的模板。 2. 保持结构：面包屑导航 → TL;DR（太长不看/摘要） → 简单解释 → 图表 → 测验 → 下一课。 3. 将课程添加到 `index.html` 中对应的列表里 —— 主课程，或者 T11 路线（将其 `soon` 状态的行更改为链接）。 4. 在 `glossary.html` 中定义任何新术语。 ## 编辑约定 - 使用通俗易懂的语言，不使用行话。例如，优先使用“永久存储”而不是“flash”。 - 先解释后操作。事实和猜测要明确区分。 - 在对硬件或软件进行任何更改之前，安全备份优先。 - 使用**相对**路径（`../css/style.css`），以便页面在提供服务和作为 `file://` 打开时都能正常工作。 - T11 路线在付费电视加密处停止：本课程不教授如何破解条件接收，并且每个步骤都会说明它所基于的主要部分。 ## 托管与备份 托管/部署由站点所有者 管理。仓库备份 于 ： ``` git push origin main ``` ## 许可证 AGPL-3.0 —— 详见 [`LICENSE`](LICENSE)。

标签：UART串口调试, 后端开发, 多模态安全, 嵌入式系统, 教程文档, 数据可视化, 硬件分析, 纯静态网页, 路由器拆解