refactor(HDMI-Tool): 划分 src/assets/release 三区目录, 补齐人读/AI 读双文档与发布流水线

README.md

@@ -5,31 +5,48 @@ LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板调试配套上位机工
 
 ## 工具一览
 
-| 工具 | 用途 | 快速开始 |
+| 工具 | 用途 | 获取 |
 |---|---|---|
-| [HDMI-Tool](HDMI-Tool/) | HDMI 源端：EDID 查看/解算、分辨率切换、纯色与测试图案全屏投屏（R/G/B 纯色值按钮用于位交换类测试） | 双击 `HDMI-Tool.exe`；详见 [HDMI-Tool/README.md](HDMI-Tool/README.md) |
+| [HDMI-Tool](HDMI-Tool/) | HDMI 源端：EDID 查看/逐字节解析、分辨率切换、纯色与测试图案全屏投屏 | 到 [Releases](https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools/releases) 下 `HDMI-Tool-vX.Y.Z-win64.zip`，解压即用；详见 [HDMI-Tool/README.md](HDMI-Tool/README.md) |
 | [I2C-Inject](I2C-Inject/) | LT8619C 寄存器在线读写：RP2040 注入器在 demo 板 I2C 总线上择机注入（避让主控轮询，写后自动读回校验） | 需配合 RP2040 固件 `rp2040_inject.py`；详见 [I2C-Inject/README.md](I2C-Inject/README.md) |
 
 ## 环境要求
 
-- 打包版 exe 开箱即用（Windows 10/11 x64，无需安装 Python）
-- 源码运行：Python ≥3.10；HDMI-Tool 为纯标准库（自定义图片 JPG/BMP 需 Pillow）；
+- 发布版 zip 开箱即用（Windows 10/11 x64，无需安装 Python）
+- 源码运行：Python ≥3.10；HDMI-Tool 为纯标准库（自定义图片 JPG/BMP 需可选 Pillow）；
   I2C-Inject 需 `py -m pip install pyserial`
-- 重新打包：各工具目录内 `python build_exe.py`（自动安装 PyInstaller）
+- 重新打包：`HDMI-Tool/src/build_exe.py`（自动安装 PyInstaller）；I2C-Inject 目录内 `python build_exe.py`
 
 ## 目录结构
 
+每个工具内统一三区：**src/ 源代码（人写）** → **assets/ 生成资产（可再生成）** →
+**release/ 打包与发布产物（机器生成）**；README.md 面向使用者，AGENTS.md 面向 AI/Agent（工程约定与构建规程）。
+
 ```
 LT8619C_Debug_Tools/
-├── HDMI-Tool/            # 源码 + 打包 exe + 测试图资产 + 图标 + README
-├── I2C-Inject/           # PC 端 GUI + RP2040 固件 + 打包 exe + 图标 + README
+├── HDMI-Tool/
+│   ├── src/                 # 源码 + 打包/发布脚本 + 图标源
+│   ├── assets/              # 生成的测试图案 PNG（gen_*.py 产物）
+│   ├── release/             # 打包 exe + 运行配置（入库）；发布 zip（不入库）
+│   ├── README.md            # 使用说明
+│   └── AGENTS.md            # AI/Agent 工程档案
+├── I2C-Inject/              # PC 端 GUI + RP2040 固件 + 打包 exe + 图标 + README
 ├── LICENSE
 └── README.md
 ```
 
+## 发布流程（HDMI-Tool）
+
+```powershell
+cd HDMI-Tool/src
+python build_exe.py                              # 打包 → ../release/HDMI-Tool.exe
+python package_release.py <版本>                  # → ../release/HDMI-Tool-v<版本>-win64.zip
+python publish_gitea.py HDMI-Tool-v<版本>-win64.zip   # 上传 Gitea Release(需 GITEA_TOKEN)
+```
+
 ## 备注
 
-- 源码与打包产物均入库：exe 改动跟随源码提交更新
+- 源码与打包产物（exe、pattern_slots.json）均入库；发布 zip 不入库，只上传 Gitea Release
 - 两件工具的寄存器语义（0x606E 位交换 / 0x606D 整组顺序）均经 demo 板逻辑分析仪
   双色交叉实测，过程数据与规程存于上游主仓库 `doc/architecture/`
-- 更新：2026-09-03
+- 更新：2026-09-10