# ESP32-S3 Task Beacon

这是“灵动实验室”任务提醒器的可学习、可复现开源快照。项目从范围、采购、接线和结构延伸到固件、主机端、WebStorm 插件、数字验收和排障手册。

## 交付结构

| 目录 | 内容 |
| --- | --- |
| `0000_项目总览/` | 范围、系统架构与快速开始 |
| `0001_采购清单/` | 工程 BOM；不包含第三方商品图和时效性价格 |
| `0002_接线图/` | W001-W023 逐线表、10 阶段图、总图与离线总览 |
| `0003_3D建模/` | OpenSCAD 参数化模型、STL、预览、打印与装配 |
| `0004_设备固件/` | ESP-IDF 主程序与显示、Wi-Fi、状态组件 |
| `0005_后台应用/` | Python 任务中心、管理页、启动脚本与单元测试 |
| `0006_WebStorm插件/` | JetBrains 插件源码、描述和构建脚本 |
| `0007_整体测试与验收/` | 一键数字验收、C 测试和验收矩阵 |
| `0008_安装部署与故障排查/` | 启动、烧录、串口监视与常见故障定位 |

## 快速开始

1. 先阅读 [`0000_项目总览/快速开始.md`](0000_项目总览/快速开始.md)，按 `0001` 和 `0002` 核对物料与接线。
2. 使用 `0005_后台应用/` 启动本机任务中心，默认管理地址为 `http://127.0.0.1:8770/`。
3. 在 `0004_设备固件/` 中使用 ESP-IDF `5.5.x` 配置、编译和烧录。
4. 运行 `0007_整体测试与验收/run_acceptance.sh` 执行公开包的数字验收。

具体命令、串口监视交接和故障定位见 [`0008_安装部署与故障排查/`](0008_安装部署与故障排查/README.md)。

## 安全与验收边界

- 公开包不包含 `sdkconfig`、`runtime/`、设备令牌、Wi-Fi 资料、运行日志、串口记录、构建缓存或本机状态。
- 发布前已通过结构、接线资产、71 项 Python 测试、3 组 C 测试和 WebStorm 插件构建检查。
- 上述是对当前源码快照的数字验收，不代表本次发布重新执行了实体接线、烧录或按键测试。

详见 [SECURITY.md](SECURITY.md) 和 [`0007_整体测试与验收/验收矩阵.md`](0007_整体测试与验收/验收矩阵.md)。

## 许可

- 项目原创软件代码：MIT，见 [LICENSE-CODE.txt](LICENSE-CODE.txt)。
- 3D 模型、STL、接线图与项目文档：CC BY-SA 4.0，见 [LICENSE-HARDWARE.md](LICENSE-HARDWARE.md)。
- 文泉驿字形数据保留其上游条款，见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

## 快照信息

- 版本：`1.1.0`
- 发布日期：`2026-10-23`
- 适配目标：ESP32-S3 + ST7789（保留 SSD1306 回退支持）
- 固件工具链：ESP-IDF `5.5.x`