========================================
  CoreDesk使用说明
  版本：以软件窗口标题栏为准（发布时自动递增）
========================================

一、运行环境
  - 操作系统：Windows 10/11 64 位
  - Python：3.11 及以上（需先安装 Python）
  - 依赖库：customtkinter（首次运行前请执行 安装依赖.bat）

二、启动方式
  1. 双击「启动CoreDesk.bat」（若为编译版则双击 CoreDesk.exe）
  2. 首次使用建议先看「docs」目录下的文档

三、目录说明
  - coredesk/  核心程序（勿改动；内部按 core/comm/device/service/gui 分层）
  - packages/     诊修套件（可自行增加/删除，放入 .py 即生效，见 docs/诊修工具开发文档.md）
  - deploy_images/ 部署用操作系统镜像（部署固化系统时使用，可替换/补充板卡对应镜像）
  - testcase/     自动测试用例（按 CPU 架构 arm32/arm64/mips/x86 组织）
  - docs/         文档（产品介绍、项目说明、诊修工具开发文档、固化流程、Shell 命令手册、结构说明）
  - data/         运行时数据（设备列表、审计日志、报告、配置等，自动生成）

四、基本操作
  1. 设备列表 → 新增/导入设备（网络设备填 IP，串口设备选 COM 口与波特率；
     连接方式可选「自动」=网络优先、连不上自动切串口）
  2. 选中设备 → 查看详情（一键体检 / 诊修套件 / 制品仓库 / 启动体检 / 部署固化 / 终端 / 串口 / 文件管理）
  3. 部署固化：全新部署（空板）或更新镜像（已有系统），向导分步执行；新手只需选板卡→开始部署
  4. 启动与镜像体检：详情页操作按钮「启动体检」进入，检测板卡启动 / u-boot / 镜像匹配 / 网络健康，
     并可修复 bootcmd 或 TFTP 刷镜像（u-boot 深度检查会重启板卡）
  5. 自动测试：选测试集 → 上传并运行（iperf 对端用本机 IP）
  6. 制品仓库（Armory）：从设备详情「制品仓库」或设备列表顶部「制品仓库部署」进入；搜索/下载/
     一键安装翼辉云枢软件包到板卡（需主机装 armory CLI）。设备列表支持多选设备后批量部署。
  7. 设置页（侧边栏「设置」）用选项卡区分：通用 / AI 服务 / 制品仓库（填 AcoHub 账号密码，
     保存后制品仓库搜索/安装自动登录；密码本地保存，不会打包进发布产物）

五、编写诊断工具（诊修套件）——给拿到本软件的人
  1. 每个诊修套件是一个方案包：可放 packages/ 下的单个 .py 文件，或用「目录包」（packages/<名称>/
     含 __init__.py，可附带 app/ 专用可执行文件）；放入即生效（删除即移除），无需改主程序。
  2. 编写教程 / 完整用例 / 说明文档：见 docs/诊修工具开发文档.md（快速上手、元数据字段、
     run(ctx) 全部 API、安全规范、兼容性匹配、风险确认机制、死机信息导出完整示例、可直接
     复制的模板、部署与测试方法；含「方案包内携带 APP」说明，可用 ctx 上传并运行专用 APP）。
  3. 起步：复制诊修工具开发文档第 10 节模板改名后修改；或参照内置套件 builtin_*.py 写法。
  4. 校验加载：侧边栏「专项诊修」→「↻ 刷新」查看；命令行校验见 packages/README.md。

六、注意事项
  - 设备详情/部署需要板卡在线（网络 Telnet 或串口）
  - 串口波特率可用「自动检测」探测，避免设置错误
  - 部署会改写板卡系统，请务必先备份数据（详情页「备份配置」）
  - 如遇问题，导出执行日志（侧边栏「导出执行日志」）反馈给翼辉技术支持