# 3d_printer_firmware_course

**Repository Path**: csbobo/3d_printer_firmware_course

## Basic Information

- **Project Name**: 3d_printer_firmware_course
- **Description**: 3D 打印机教程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-29
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 3D 打印机固件专家养成教程

当前阶段：**M0 — 第 10 章样章已审校，62 章注册表与站点首页完成；下一步写 01–03 试点章**。

## 文档

- [需求文档](docs/需求文档.md)
- [Agent 操作契约](AGENTS.md)

## 已确认的关键决策

| 编号 | 决策 | 结果 |
|---|---|---|
| D1 | 实机 | 先无实机（仿真/日志），后 CoreXY + ADXL345 + 逻辑分析仪 |
| D2 | 规模 | 62 章完整版 |
| D3 | 学习周期 | 32 周专家路径 |
| D4 | HTML | 单文件内嵌全部资源 |
| D5 | 交付 | 仅 MD + HTML |
| D6 | 许可 | 原创内容不设限制；上游代码仍遵循 GPL/AGPL |
| D7 | 深度 | Klipper/Marlin L4，其余 L2 |
| D8 | 岗位 | 固件/运动控制为主，整机/切片兼顾 |
| D9 | 光固化 | 仅全景对比 |
| D10 | 公开 | 先私有，结构兼容未来开源 |

## 已完成（M0）

1. 冻结 `meta/versions.json`：Klipper `v0.13.0@61c0c8d`，Marlin `2.1.2.9@7d300b4`。
2. 建立 `meta/repo-map/klipper.md`、`meta/repo-map/marlin.md` 与第 10 章调用链。
3. 完成第 10 章 20 条事实卡与 `status: sourced` 大纲。
4. 实现 `snippet.py`、`build.py`、`check.py`，生成第 10 章单文件 HTML。
5. 完成第 10 章 10.0–10.13 正文初稿：16 个自动抽取片段、5 张内联 SVG。
6. 完成实验 A（S1 仿真）与实验 B（S0 源码核对），生成第 10 章单文件 HTML。
7. 实现 `VelocityProfile` 与 `QueueViz` 交互、静态降级与离线冒烟检查。
8. 加入静态 `a11y` 检查（label/alt/标题层级/锚点/canvas）。
9. Lighthouse 无障碍 100、Best Practices 100（浅色与深色主题）。
10. 建立 `meta/chapters.yml`（62 章注册表）、`site/index.html` 与样章复盘。

## 工具

```bash
python -m pip install -r requirements-dev.txt
python tools/snippet.py --check curriculum
python tools/build.py --all        # 章节 + 站点首页
python tools/build.py --site       # 只重建 site/index.html
python tools/check.py --all
python -m pytest
python -m ruff check tools tests
```

## 下一步

1. 按 `meta/reviews/10-retrospective.md` 的规范，写 Part 0 的 01–03 试点章。
2. 三章后做跨章一致性检查，再进入 Part 1 批量生产。
3. 实验 C 留到 Linux/WSL/MSYS2；S2 等实机。

## 交付目标

- 8 个部分、62 章教程，每章一份 Markdown + 一份单文件 HTML。
- 源码事实库、实验库（S0/S1/S2）、术语表、结课项目。
- 覆盖 Klipper、Marlin 及切片器、Host、Web UI 等生态项目。
- 全程离线可读，无 CDN、无外部请求。