| 推荐栏目 | 本仓库实际位置 |
|---|---|
| src：PS源码 | board/app |
| src：PC上位机 | host/fpga/host |
| src：RTL/HLS | fpga/ip_repo、fpga/hls_vision、nn_accelerator/hls |
| build：重建脚本 | fpga/create_project.tcl、fpga/build_project.tcl、nn_accelerator/build |
| sim：验证 | sim/run_checks.py、tools、nn_accelerator/tests |
| board：部署 | board/README.md、board/app/ready_to_tt |
| data：模型及黄金向量 | nn_accelerator/handoff |
| skill：可复用经验 | skill/readme.md |
| report：报告与协作证据 | report、evidence |
保留运行程序的原有相对目录，避免为目录外观破坏导入和模型加载。GitHub版保留完整Vivado工程快照和生成文件；比赛RAR版移除可重建的 fpga/project、Python缓存和日志备份。两版业务代码、模型和bit/hwh一致。原始输入ZIP不改动。
- PC安装 host/requirements.txt，运行
python host/fpga/host/host_app.py，或 host/fpga/host/start_host.bat。网络地址在界面填写。 - 将 board/app 的内容复制到板上
/home/xilinx/jupyter_notebooks/app。在板端运行bash run_final_hud.sh --new-background。按 board/demo_operations.md 先采空背景，再掌心标定。相机不能由多个Notebook/程序同时控制。 - 使用真实舵机前按 board/README.md 核对供电和行程；用户提供的校准只适用于原实物。mode4失联保护和现有速度参数原样保留。校园网登录是可选的环境部署，不需要在GitHub放个人帐号配置。
- HDMI为1024×600，摄像头800×480，CNN输入96×96灰度，15类。PS执行ROI和调度，PL执行分割与CNN，不能写成所有操作都在PL。
Vivado/Vitis HLS 2025.1，xc7z020clg400-2。在新目录运行 vivado -mode batch -source fpga/create_project.tcl。GitHub版已有project时可打开已有工程，或复制一份后移出project再重建；创建脚本拒绝覆盖。Windows建议映射空闲短盘符防止HLS文件名超过路径限制。CNN执行 vitis-run --mode hls --tcl nn_accelerator/build/gray15_fist_v1/run_synth.tcl，具体以本机2025.1命令行环境为准。导出IP后重新生成bit/hwh，必须按黄金向量和模型标识符核对，不能只替换权重文件。
python sim/run_checks.py 不连接硬件。python tools/verify_release.py 核验本版文件清单。检测、测试与历史硬件记录分开存放在 evidence。原舵机库历史 source-manifest 若不匹配，不能当作本次文件清单；发布完整性以根 release_manifest.json 为准。
GitHub版保留第三方工具要求的大小写（例如 component.xml 内引用的 HDL 文件、SKILL.md、Makefile）。比赛RAR内文件名统一小写英文并同步改路径引用；skill.md 用于提交阅读，安装到支持的智能体时需恢复标准 SKILL.md 文件名。见 skill/readme.md。版权、许可证和第三方来源保留在各自目录；third_party/code-humanizer 不是本队原创Skill。没有为整体仓库虚构统一开源许可，公开发布时应保留各依赖许可。
采用11月3日板端及上位机；保留模型、RTL和部署bit/hwh。补齐原包漏带的Digilent TMDS接口描述（从本地现有工程原样复制），不改变HDMI时序或功能。新增/补全通用技能、测试入口与哈希清单。版本选择及新增依赖见evidence/source_selection.json和evidence/tmds_dependency.json。