v1.1.0 — WizFi360 WiFi 版：第四硬件形态

新硬件形态：WizFi360 WiFi 版

基于 RP2040 + WizFi360 WiFi 模块，通过 WiFi TCP 与 PC
通信，无需蓝牙。

特性	说明
主控	RP2040（WizFi360-EVB-Pico）
通信	WiFi TCP（端口 57321）
输出	WS2812×2 双灯 + MAX98357A 扬声器
传感器	振动传感器 + 马达
供电	USB 即插即用

新功能

• 静态 IP 自动分配：GUI 自动扫描局域网空闲
  IP，注入设备配置，无需手动查 IP
• GUI 桥接按钮：烧录+配对后，在 GUI
  内一键启动守护进程，无需另开终端
• 烧录后自动获取 IP：wizfi360 烧录完成后自动从串口抓取设备 IP
  并完成配对
• wizfiatcontrol 库：封装 WiFi 连接、TCP Server、AT 指令收发

改进

• +IPD 格式解析修复（匹配 WizFi360 实际响应格式）
• 振动传感器 PULL_DOWN 修复（RP2040 GPIO 浮空导致 IRQ 不触发）
• surrogate 字符清理（防止 daemon 推送含 emoji 的消息崩溃）
• config 覆盖正则修复（缩进行的 WIFI_SSID/WIFI_PASSWORD 正确替换）

文档

• 全部文档更新为四种硬件形态（dshell / panel / clock / wizfi360）
• setup_tool_guide 新增 WizFi360 分叉路径截图（WiFi 配置 / TCP 配对）
• firmware/README.md 新增库文件说明
• presentation 更新至 v1.1.0

---

四种硬件形态

形态	主控	通信	输出
D-Shell	ESP32-S3	BLE	2.4寸触摸屏 + LVGL + WS2812×8 + 语音
Panel	ESP32-S3	BLE	2.4寸触摸屏 + LVGL + 语音
Clock	ESP32-C3	BLE	WS2812×2 + 语音
WizFi360 🆕	RP2040	WiFi TCP	WS2812×2 + 语音 + 振动

安装

# CLI 烧录（新形态）
python scripts/flash_device.py --variant wizfi360 \
  --wifi-ssid "MyWiFi" --wifi-password "password"

# 或使用 GUI 一键工具
dist/Claude_Assistant_Setup.exe

WizFi360 使用 .uf2 固件格式（拖拽烧录），详见 [firmware/README.md]。

v1.0.0: 新增 D-Shell 第三硬件形态，首个正式版本发布

🖥️ 新增 D-Shell 第三硬件形态

正式面板硬件 D-Shell（ESP32-S3） 上线：

规格	详情
主控	ESP32-S3
屏幕	ST7789V 2.4 寸 LCD（320×240）
触摸	GT911 I²C 电容触摸
灯带	WS2812×8 彩虹流水灯（ISR 50ms 定时器驱动）
语音	MAX98357A I²S 功放 + 豆包 TTS
UI	LVGL 像素角色动画 + 多 session 历史记录

🌈 LED 灯带：彩虹流水灯

• 不再跟随工作状态变化，改为 HSV 色轮彩虹流光
• 正弦波调制色相间距，疏密变化不单调
• 连接时白闪 500ms，断连自动熄灭
• 彻底解决灯带与屏幕状态不同步问题

🛠️ GUI 烧录工具

• 新增 D-Shell (ESP32-S3) 屏幕+角色+灯带 选项
• 角色选择（8 种预设 + 自定义）对 Panel / D-Shell 均开放
• 固件自动匹配 dshell 专用 .bin

📋 文档全面更新

• 全部 README（中/英/公开版）：两种→三种硬件形态
• D-Shell 标注为正式面板硬件，Panel 标注为 Waveshare 开发板
• 演示文稿新增 v1.0.0 幻灯片，硬件规格页改为三列布局
• 装机指南扩充 D-Shell 选型路径和固件匹配说明
• firmware/README.md 固件列表补全 dshell

📦 固件

文件	说明
claude-buddy-dshell-esp32s3-v0.9.bin	D-Shell 正式面板 MicroPython
固件
display_renderer.py	st7789v + GT911 + LVGL + WS2812 彩虹灯带

🔄 变更记录（v1.0.0 · 2026-06-23）

• 新增 dshell 硬件形态（ST7789V + GT911 触摸 + WS2812×8 灯带）
• display_renderer.py：适配 st7789v 驱动，LED 灯带简化为彩虹流水
• GUI 新增 D-Shell RadioButton，角色选择对屏幕版开放
• 版本号升级至 1.0.0（首个正式版本）
• 全部文档更新为三种硬件形态
• presentation 新增 v1.0.0 版本幻灯片
• setup_tool_guide 扩充 D-Shell 路径
• Claude_Assistant_Setup_v1.0.0.exe 重新打包

v0.12.0

振动传感器/马达（3 文件）

• device/vibration.py — 新增：异步脉冲控制模块（新文件）
• device/light_renderer.py — 集成拍击检测 IRQ + 振动马达脉冲；预计算颜色支持全局亮度；配置开关保护
• device/config.py — 新增 CLOCK_VIB_SENSOR_PIN、CLOCK_VIB_MOTOR_PIN、VIB_SENSOR_ENABLE、VIB_MOTOR_ENABLE、LIGHT_BRIGHTNESS、LIGHT_CONNECT_BRIGHTNESS

Trigger Interrupt 修复（1 文件）

• device/voice_task.py — 新增 trigger_interrupt() 最高优先级语音（保留队列）；修复 _EVENT_STATE 缺 "working" 导致拍击无声

GUI 烧录工具（3 文件）

• setup_tool/gui.py — 新增亮度滑块、振动传感器/马达勾选框
• setup_tool/worker.py — _apply_config_overrides 支持 bool/int 字段
• setup_tool/version.py — v0.11.0 → v0.12.0
• setup_tool/tests/test_worker.py — 新增：配置覆写单元测试（新文件）

文档（7 文件）

• .claude/CLAUDE.md — 更新架构说明
• README.md / README_EN.md — 振动/亮度文档 + 插件在线/离线安装说明
• README_public.md / README_EN_public.md — v0.12.0 变更日志 + 插件安装说明
• presentation.html / presentation_EN.html — 新增 v0.12.0 幻灯片 + 插件 GitHub 链接

v0.11.0—跨电脑兼容 + 版本号系统 (2026-06-07)

新增

• 版本号系统：EXE 文件名、GUI 窗口标题、关于对话框均显示版本号，便于追溯和管理 - 版本持久化：python -m setup_tool.builder --version X.Y.Z 设置版本号后自动持久化，下次不传参数沿用上一次版本号

• EXE 跨电脑兼容性重构：打包后的烧录工具可在不同电脑间正常使用
  优化

• 公开仓库构建脚本全面改进，排除测试文件、统一编译 lib 目录、新增 skill 搬运 - 双语文档体系完善（中英文 README、25 步图文装机指南）

• GUI 烧录工具稳定性改进

修复 - flash_device.py 修复 device/lib/logging.py 编译为 .mpy 后未烧录的问题

• build_public.py 清空目录时保留 .git 仓库避免历史丢失

完整变更

自 v0.10.0 以来共 17 次提交，涵盖 EXE 跨电脑兼容、版本号系统、文档体系重构、构建脚本优化等多个方面。

v0.10.1

图文操作指南 — setup_tool_guide.md 25 步完整截图教程，
涵盖 Clock/Panel 分叉路径、豆包 TTS 语音生成、自定义角色导入。
配套 25 张 EXE 操作截图（docs/exe1.png ~ exe25.png）。

双语文档体系 — 新增 4 个英文文档，与中文版平行：
- README_EN.md（项目说明英文版，含 Clock 叙事引言）
- setup_tool_guide_EN.md（25 步装机指南英文版）
- skill_EN.md（Claude Code Skill 描述英文版）
- presentation_EN.html（演示文稿英文版，无中文遗留）
各文件顶部设语言切换索引 [🇨🇳 中文] · [🇬🇧 English]。

GUI 烧录工具优化：
- EXE 与设备代码分离，支持用户选择烧录目录
- GUI 布局优化：固件烧录排布调整、自定义面板角色提示
- 修复 logging.py 编译后 .mpy 未烧录到设备的问题
- 新增 MicroPython unittest 框架支持

公开仓库构建（scripts/build_public.py）：
- 清空目标目录时保留 .git 元数据，避免 public 仓库历史丢失
- 排除测试目录、编译 lib/ 为 .mpy、新增 skill 同步、精简 EXE
- 新增 4 个英文文档同步：README_EN.md / setup_tool_guide_EN.md /
skill_EN.md / presentation_EN.html
- 触发时机规范化：手动运行，非自动触发
- README / CLAUDE.md 新增触发时机说明与发布核验清单

README 更新：
- 新增 Clock 闹钟版叙事引言（痛点 → 方案 → 体验，面向终端用户）
- 新增 build_public.py 触发时机与核验要求文档
- 变更记录按日期降序重排，早期内部里程碑移到最后

演示文稿：
- presentation.html 版本徽标 v0.10.0 → v0.10.1
- presentation_EN.html 清理全部遗留中文文本
- 新增 v0.10.1 幻灯片页