知识库

这里保存经过整理、仍适用于当前环境的操作说明。博客文章记录问题发生时的过程，知识库更关心“现在应该怎样做”。如果旧文章与这里冲突，以知识库中标注的最近验证日期为准。

快速入口

嵌入式与硬件

• ESP32 工程目录与组件边界
• BLE 连接参数、通知背压与断线定位
• I2C 总线恢复、SPI 显示与 ST7789 初始化
• 串口日志、故障注入与长时间稳定性测试

桌面工具

• Python 虚拟环境、依赖锁定与干净机验证
• 蓝牙上位机状态机和迟到回调隔离
• PyInstaller 目录版、单文件版与启动性能
• 可导出的诊断包、脱敏日志和配置迁移

AI 工程与自动化

• LLM API 的超时、限流、重试与幂等
• JSON Schema 结构化输出与语义校验
• 检查点、补偿操作和写入前预演
• 自动化任务的退出码、审计记录与回滚

自托管与运维

• Halo、PostgreSQL、Nginx 与 Docker Compose 服务清单
• 数据库、附件、配置与证书的分层备份
• HTTP 到 HTTPS、反向代理和真实客户端地址
• 独立环境恢复演练与变更验证

文档约定

每份操作说明尽量包含适用版本、前置条件、完整命令、期望输出、失败表现、验证步骤和回滚方法。命令中的域名、路径、账号与令牌使用明确占位符；公开页面不会保存真实密码、Cookie、数据库转储或未脱敏日志。

建议阅读顺序

第一次访问可以先看“关于”了解内容边界，再从“项目档案”选择项目，通过分类阅读背景文章，最后回到知识库执行当前步骤。需要了解站点本身如何恢复和维护时，可查看“站点历史”和自托管专题。

更新状态

• 最近整理：2026 年 9 月
• 当前重点：嵌入式调试链、桌面发布、AI 自动化可靠性、站点恢复
• 维护原则：先验证再发布；影响行为的修订保留日期和原因

知识库会持续压缩重复步骤，但不会隐藏失败边界。一个步骤只有在干净环境中得到可重复结果，才会被标记为当前推荐方案。