docs: agent 文档体系按用户级默认工作约定重整为开发需求与进度管理

This commit is contained in:
2026-09-25 01:48:18 +08:00
parent f594f60fdd
commit 733847a58c
4 changed files with 148 additions and 123 deletions
+11 -8
View File
@@ -1,8 +1,8 @@
# AGENTS.md — DLPilot 工程档案(供 AI/Agent 使用)
# AGENTS.md — DLPilot 工程档案(开发约束与进度)
> **本文档面向 AI/Agent**,是人类文档 [README.md](README.md) 的姊妹篇,两者不重叠:
> README 回答"这是什么、怎么用";本文回答"代码怎么组织、怎么构建发布、改动时哪些约束不能破坏"。
> 任何 Agent 在修改本目录代码前应先读完本文。
> 人类文档 [README.md](README.md) 回答"这是什么、怎么用";本文记录"代码怎么组织、
> 怎么构建发布、改动时哪些约束不能破坏",兼作本工具的进度记录。
> 修改本目录代码前先读完本文。仓库整体的开发需求与进度管理见根目录 `agent.md`。
## 1. 项目定位
@@ -169,11 +169,14 @@ python publish_gitea.py ../release/DLPilot-v<版本>-win64.zip --replace --insec
7. `python build_exe.py` → 双击 release/DLPilot.exe 确认图标/双栏布局/投图/光机区渲染;
8. `python package_release.py <版本>` —— 不报"引用图片缺失"即栏位完整性 OK。
## 8. v0.4.0 交接(2026-09-24)
## 8. v0.4.0 进度记录(2026-09-24)
- 入口已切换 `app_fluent.py`;历史 `app_gui.py` 保留,不改其历史版本号。
- 本次验证:源码编译通过、RS485 自测 ALL PASS、Qt 离屏浅色渲染、正式 EXE 定时退出码 0。
原生桌面自动化不可用,未完成成品 Light 截图;未将硬件功能标记为本次实机验证通过。
- 发布须将本次源码、文档、EXE 纳入同一个提交,确认远端标签指向该提交;zip 不入库。
- `release/pattern_slots.json` 的本机串口记忆改动、外部 `EDID-viewer/` 不属于本次 UI 提交。
发布使用仓库预置配置,临时打包后恢复本机文件,勿将运行态配置悄悄提交。
- 发布已将本次源码、文档、EXE 纳入同一个提交(`74b64dc`),远端标签 `DLPilot-v0.4.0`
指向该提交、附件已核对;zip 不入库。
- `release/pattern_slots.json` 的本机串口记忆改动属于运行态配置,勿随提交悄悄带入;
发布使用仓库预置配置,临时打包后恢复本机文件。
- 关联动态:EDID-Viewer 已于 2026-09-25 从本工具的"源端 EDID 查看"需求独立成工具
入库并发布 v0.1.0,与本目录无代码共享;I2C-Inject 已标记暂停开发(详见根 `agent.md`)。