hulk/HW-Debug-Tools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 8 Wiki Activity

chore: 全仓约束 exe 不入库——.gitignore 全局挡 *.exe，历史 39 个 exe blob 已用 git filter-repo 清除(仓库 1.1 GiB -> ~1 MB)；各文档发布约定同步；agent.md 哈希引用按重写后映射更新

Browse Source
This commit is contained in:
hulk
2026-10-13 16:31:45 +08:00
parent 42ff258b35
commit 7ba01eae5e
9 changed files with 23 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.gitignore
+5 -1
View File
@@ -2,11 +2,15 @@
__pycache__/ __pycache__/
*.pyc *.pyc
# PyInstaller 工作目录(打包产物 exe 已直接入库, 构建中间物不入库) # PyInstaller 工作目录(构建中间物不入库)
build/ build/
dist/ dist/
*.spec *.spec
# exe 一律不入库(2026-10-13 起): 交付物只走 Gitea Release 附件, 本地保留。
# 历史 39 个 exe blob 已用 git filter-repo 清除(仓库 1.1 GiB -> ~1 MB (pack 实测))
*.exe
# 发布 zip: 可由 src/package_release.py 重新生成, 只上传 Gitea Release # 发布 zip: 可由 src/package_release.py 重新生成, 只上传 Gitea Release
DLPilot/release/*.zip DLPilot/release/*.zip
EDID-viewer/release/*.zip EDID-viewer/release/*.zip
DLPilot/AGENTS.md
+3 -2
View File
@@ -145,8 +145,9 @@ python publish_gitea.py ../release/DLPilot-v<版本>-win64.zip --replace --insec
发布约定： 发布约定：
- tag/release 命名 `DLPilot-vX.Y.Z`，zip 命名 `DLPilot-vX.Y.Z-win64.zip`（publish_gitea.py - tag/release 命名 `DLPilot-vX.Y.Z`，zip 命名 `DLPilot-vX.Y.Z-win64.zip`（publish_gitea.py
依赖此命名从文件名推 tag）； 依赖此命名从文件名推 tag）；
- **exe、pattern_slots.json 与 release/ 下平铺的图案 png 改动跟随源码/资产生成提交入库； - **pattern_slots.json 与 release/ 下平铺的图案 png 改动跟随源码/资产生成提交入库；
zip 永不入库**（.gitignore 已挡）； exe 不入库**（2026-10-13 起全仓 `.gitignore` 挡 `*.exe`，交付物只走 Gitea
Release 附件，本地保留）；**zip 永不入库**（.gitignore 已挡）；
- publish_gitea.py 幂等：release 已存在则复用，同名资产默认跳过，`--replace` 删旧重传； - publish_gitea.py 幂等：release 已存在则复用，同名资产默认跳过，`--replace` 删旧重传；
- token 读环境变量 `GITEA_TOKEN`：本机已用 setx 持久化为用户级变量（新开的会话/终端自动 - token 读环境变量 `GITEA_TOKEN`：本机已用 setx 持久化为用户级变量（新开的会话/终端自动
继承，值不入库；在 setx 之前启动的进程读不到，需重开终端），急用时也可临时传 `--token`； 继承，值不入库；在 setx 之前启动的进程读不到，需重开终端），急用时也可临时传 `--token`；
DLPilot/README.md
+1 -1
View File
@@ -218,7 +218,7 @@ DLPilot/
│ ├── bw_*.png ×5 # 640x360 黑白系列 │ ├── bw_*.png ×5 # 640x360 黑白系列
│ └── solid_*.png ×10 # 800x600 纯色系列 │ └── solid_*.png ×10 # 800x600 纯色系列
├── release/ # 构建与发布产物（机器生成区, 不手改） ├── release/ # 构建与发布产物（机器生成区, 不手改）
│ ├── DLPilot.exe # 打包单文件版（改动跟随源码提交入库） │ ├── DLPilot.exe # 打包单文件版（不入库，本地保留；随发布上传 Gitea Release）
│ ├── pattern_slots.json # exe 运行配置（栏位预置 + 串口记忆） │ ├── pattern_slots.json # exe 运行配置（栏位预置 + 串口记忆）
│ ├── *.png / README.md # 附属文件平铺副本(由 package_release.py 从 assets/ 同步) │ ├── *.png / README.md # 附属文件平铺副本(由 package_release.py 从 assets/ 同步)
│ └── *.zip # 发布包（不入库, 上传 Gitea Release） │ └── *.zip # 发布包（不入库, 上传 Gitea Release）
EDID-viewer/README.md
+1 -1
View File
@@ -21,7 +21,7 @@ Windows 10/11 显示器 EDID 查看器。使用 **PySide6 / PySide6-Fluent-Widge
- `src/` — 人写代码：界面（main.py）、EDID 解析（edid.py）、Windows 读取（windows_edid.py）、主题（theme.py）、解析测试（test_edid.py）和打包流水线。 - `src/` — 人写代码：界面（main.py）、EDID 解析（edid.py）、Windows 读取（windows_edid.py）、主题（theme.py）、解析测试（test_edid.py）和打包流水线。
- `assets/` — 图标与生成脚本（可再生）。 - `assets/` — 图标与生成脚本（可再生）。
- `release/` — 交付物：`EDID-Viewer.exe` 入库；发布 zip 只上传 Gitea Release，不入库。 - `release/` — 交付物：`EDID-Viewer.exe` 本地保留不入库；发布 zip 只上传 Gitea Release，不入库。
- `AGENTS.md` — 工程约定与任务边界（改代码前必读）；`VALIDATION.md` — 验证记录。 - `AGENTS.md` — 工程约定与任务边界（改代码前必读）；`VALIDATION.md` — 验证记录。
## 环境与构建 ## 环境与构建
I2C-Lab/AGENTS.md
+1 -1
View File
@@ -21,7 +21,7 @@
核1 取时间戳并跑解码状态机(与 GUI 解码同语义) + 核0 USB CDC 命令行。 核1 取时间戳并跑解码状态机(与 GUI 解码同语义) + 核0 USB CDC 命令行。
250MHz/vreg 1.15V。修改引脚/波特/协议时注意 `README.md` §5 与 GUI 同步。 250MHz/vreg 1.15V。修改引脚/波特/协议时注意 `README.md` §5 与 GUI 同步。
- **pyserial 是唯一第三方运行依赖**(缺失降级提示); GUI/解码全标准库+PySide6。 - **pyserial 是唯一第三方运行依赖**(缺失降级提示); GUI/解码全标准库+PySide6。
- **release/ 交付物不入库**(2026-10-13 起, 与 DLPilot/SerialMate 的 exe 入库约定不同): - **release/ 交付物不入库**(2026-10-13 起全仓统一: `.gitignore` 全局挡 `*.exe`):
exe/UF2/BIN/zip 留本地, 待真机验收正式发布时再走流水线(`.gitignore` 已挡 exe/UF2/BIN/zip 留本地, 待真机验收正式发布时再走流水线(`.gitignore` 已挡
`I2C-Lab/release/`)。 `I2C-Lab/release/`)。
I2C-Lab/README.md
+1 -1
View File
@@ -129,4 +129,4 @@ copy build\i2c_lab.uf2 ..\release\firmware\
| `src/` | PC 端: main.py(GUI)/i2cdec.py(解码权威)/probelink.py(链路)/waveview.py(波形)/theme.py + 自检/打包/发布脚本 | | `src/` | PC 端: main.py(GUI)/i2cdec.py(解码权威)/probelink.py(链路)/waveview.py(波形)/theme.py + 自检/打包/发布脚本 |
| `firmware/` | probe 固件: main.c + bus_watch.pio + CMakeLists + make_uf2.py + pico_sdk_import.cmake | | `firmware/` | probe 固件: main.c + bus_watch.pio + CMakeLists + make_uf2.py + pico_sdk_import.cmake |
| `assets/` | 图标(沿用 I2C 橙色母题) | | `assets/` | 图标(沿用 I2C 橙色母题) |
| `release/` | I2C-Lab.exe(入库) + firmware/i2c_lab.uf2/.bin(入库); zip 不入库 | | `release/` | I2C-Lab.exe + firmware/i2c_lab.uf2/.bin（交付物本地保留，不入库）; zip 不入库 |
README.md
+4 -4
View File
@@ -39,18 +39,18 @@ HW-Debug-Tools/
├── DLPilot/ ├── DLPilot/
│ ├── src/ # 源码 + 打包/发布脚本 + 图标源 │ ├── src/ # 源码 + 打包/发布脚本 + 图标源
│ ├── assets/ # 生成的测试图案 PNG（gen_*.py 产物） │ ├── assets/ # 生成的测试图案 PNG（gen_*.py 产物）
│ ├── release/ # 打包 exe + 运行配置（入库）；发布 zip（不入库） │ ├── release/ # 交付物（exe/zip 不入库，本地保留；只上传 Gitea Release 附件）
│ ├── README.md # 使用说明 │ ├── README.md # 使用说明
│ └── AGENTS.md # 工程档案 │ └── AGENTS.md # 工程档案
├── EDID-viewer/ ├── EDID-viewer/
│ ├── src/ # 界面/解析/WMI 读取 + 打包/发布脚本 │ ├── src/ # 界面/解析/WMI 读取 + 打包/发布脚本
│ ├── assets/ # 图标与生成脚本 │ ├── assets/ # 图标与生成脚本
│ ├── release/ # EDID-Viewer.exe + README（入库）；发布 zip（不入库） │ ├── release/ # 交付物（exe/zip 不入库，本地保留；只上传 Gitea Release 附件）
│ ├── README.md # 使用说明 │ ├── README.md # 使用说明
│ └── AGENTS.md # 工程档案 │ └── AGENTS.md # 工程档案
├── SerialMate/ ├── SerialMate/
│ ├── src/ # 协议/串口线程/曲线控件/GUI + 自检 + 打包/发布脚本 │ ├── src/ # 协议/串口线程/曲线控件/GUI + 自检 + 打包/发布脚本
│ ├── release/ # SerialMate.exe + README（入库）；发布 zip（不入库） │ ├── release/ # 交付物（exe/zip 不入库，本地保留；只上传 Gitea Release 附件）
│ ├── README.md # 使用说明 │ ├── README.md # 使用说明
│ └── AGENTS.md # 工程档案 │ └── AGENTS.md # 工程档案
├── I2C-Lab/ ├── I2C-Lab/
@@ -81,7 +81,7 @@ python publish_gitea.py <工具>-v<版本>-win64.zip --insecure # 上传 Gite
## 备注 ## 备注
- 源码与打包产物（exe、pattern_slots.json）均入库；发布 zip 不入库，只上传 Gitea Release - 源码与运行配置入库；exe/zip 等交付物不入库（本地保留），发布只上传 Gitea Release 附件
- `gd32e230f8_firmware_merge_tool/` 是 git 子模块（[独立仓库](https://gitea.hulk.wang/hulk/gd32e230f8_firmware_merge_tool)， - `gd32e230f8_firmware_merge_tool/` 是 git 子模块（[独立仓库](https://gitea.hulk.wang/hulk/gd32e230f8_firmware_merge_tool)，
代码与发布均在其仓内管理，本仓只锁定指针）： 代码与发布均在其仓内管理，本仓只锁定指针）：
新克隆后需 `git submodule update --init` 拉取内容； 新克隆后需 `git submodule update --init` 拉取内容；
SerialMate/AGENTS.md
+1 -1
View File
@@ -18,7 +18,7 @@ SerialMate 是其中的**通用串口/RS485 调试助手**：收发 + 协议解
``` ```
SerialMate/ SerialMate/
├── src/ 源代码区 —— 只有这里可以手改 ├── src/ 源代码区 —— 只有这里可以手改
├── release/ 产物区 —— SerialMate.exe + README.md（入库）， ├── release/ 产物区 —— SerialMate.exe + README.md（exe 不入库本地保留，README 入库），
│ *-win64.zip（gitignore，只上传 Release） │ *-win64.zip（gitignore，只上传 Release）
├── assets/ 图标等生成资产（暂无；build_exe.py 已预留 assets/serial-mate.ico） ├── assets/ 图标等生成资产（暂无；build_exe.py 已预留 assets/serial-mate.ico）
├── README.md 人类文档 ├── README.md 人类文档
agent.md
+6 -4
View File
@@ -49,7 +49,9 @@
FluentIcon 白名单、文本内用单色 Unicode 符号（→ ← ⚠ ⏳ ⚙）。**唯一权威 `icons/`**： FluentIcon 白名单、文本内用单色 Unicode 符号（→ ← ⚠ ⏳ ⚙）。**唯一权威 `icons/`**：
约定文档 `icons/README.md` + 统一生成器 `icons/make_icon.py`（含 `--check` 约定文档 `icons/README.md` + 统一生成器 `icons/make_icon.py`（含 `--check`
复现校验与 `--preview` 家族预览图；各工具内旧 make_ico 脚本保留作历史对照，不再维护）。 复现校验与 `--preview` 家族预览图；各工具内旧 make_ico 脚本保留作历史对照，不再维护）。
- 发布约定：源码与打包产物（exe、运行配置）入库；发布 zip 不入库，只上传 Gitea Release。 - 发布约定：源码与运行配置入库；**exe/zip 等交付物一律不入库**（2026-10-13 起
`.gitignore` 全局挡 `*.exe`；历史 39 个 exe blob 已用 git filter-repo 清除，
仓库 1.1 GiB → ~1 MB (pack 实测)），发布只上传 Gitea Release 附件。
## 2. 开发进度（已完成功能清单） ## 2. 开发进度（已完成功能清单）
@@ -68,7 +70,7 @@
cursor 裁剪用实例级枚举访问，PySide6 6.11 必抛 AttributeError 且异常打断 cursor 裁剪用实例级枚举访问，PySide6 6.11 必抛 AttributeError 且异常打断
`_poll_dlpc` 队列消费（FilmForge 同案）；改 `setMaximumBlockCount(500)` `_poll_dlpc` 队列消费（FilmForge 同案）；改 `setMaximumBlockCount(500)`
环形裁剪 + 逐事件兜底 + 新增 `selftest_log.py` 回归。tag `DLPilot-v0.4.3` 环形裁剪 + 逐事件兜底 + 新增 `selftest_log.py` 回归。tag `DLPilot-v0.4.3`
指向 `c91b4aa`。详见 `DLPilot/AGENTS.md` §9。 指向 `296e220`（历史哈希为 filter-repo 重写前记录）。详见 `DLPilot/AGENTS.md` §9。
### 2.2 EDID-Viewer — 最新发布 v0.1.0（2026-09-25） ### 2.2 EDID-Viewer — 最新发布 v0.1.0（2026-09-25）
- 解析：EDID 1.x 基础身份/时序、CTA（音频 SAD/HDMI VSDB/CEC/HF-VSDB）、HDR 与 - 解析：EDID 1.x 基础身份/时序、CTA（音频 SAD/HDMI VSDB/CEC/HF-VSDB）、HDR 与
@@ -111,7 +113,7 @@
- **v0.1.1（2026-10-13）发布**：接收路径修复（时间戳改 link 线程到达时刻打戳、 - **v0.1.1（2026-10-13）发布**：接收路径修复（时间戳改 link 线程到达时刻打戳、
接收日志批量插入+5000 行上限+积压折叠、通道配置缓存），详见 接收日志批量插入+5000 行上限+积压折叠、通道配置缓存），详见
`SerialMate/ISSUE_rx_timestamp_and_lag.md` 与其 AGENTS.md §7。tag `SerialMate/ISSUE_rx_timestamp_and_lag.md` 与其 AGENTS.md §7。tag
`SerialMate-v0.1.1` 指向 `7a236a6`，Release 附件 `SerialMate-v0.1.1` 指向 `e5b2e45`（历史哈希为重写前记录），Release 附件
`SerialMate-v0.1.1-win64.zip`（63.6 MB）。 `SerialMate-v0.1.1-win64.zip`（63.6 MB）。
### 2.4 I2C-Inject — ⏸ 暂停开发（2026-09-25） ### 2.4 I2C-Inject — ⏸ 暂停开发（2026-09-25）
@@ -165,7 +167,7 @@
## 3. 开发需求与计划（已提出、尚未实现） ## 3. 开发需求与计划（已提出、尚未实现）
### 3.1 DLPilot ### 3.1 DLPilot
- ~~【待素材】校准图案~~（已完成，2026-10-13 `bcb03e2`）：CeramixNano 系列 6 张 - ~~【待素材】校准图案~~（已完成，2026-10-13 `74469cf`）：CeramixNano 系列 6 张
校准图（黑/白/caliPoint/circle_640p/contrast/Sharpness_XY_3）二进制直存 校准图（黑/白/caliPoint/circle_640p/contrast/Sharpness_XY_3）二进制直存
assets/+release/ 平铺（用户素材，无生成脚本），slots 栏位接入、 assets/+release/ 平铺（用户素材，无生成脚本），slots 栏位接入、
package_release 收集规则扩展；随 v0.4.3 之后的下次发布进 zip。 package_release 收集规则扩展；随 v0.4.3 之后的下次发布进 zip。