FRC Framework 详细 TODO

本清单配合 DEVELOPMENT_PLAN.md 使用。状态标记：[ ] 未开始、[-] 进行中、[x] 完成、[!] 阻塞。优先级：P0 必须、P1 重要、P2 后续增强。

0. 完成定义

一项任务只有同时满足以下条件才可标记完成：

实现已经合并，不只是原型或设计稿；
类型检查、lint 和相关测试通过；
新增用户文本包含中英文翻译；
文件读写、进程调用和 IPC 已完成错误处理；
对应功能有至少一个正常用例和一个失败用例；
会影响项目输出时，已验证 Diff、撤销和崩溃恢复；
会生成 Java 时，至少一个 fixture 通过 Spotless 和 Gradle compile；
关键行为已更新开发文档或 ADR。

1. 里程碑总览

里程碑	交付结果	依赖
M0 技术验证	关键技术风险有可运行结论	无
M1 Desktop Shell	Electron 桌面壳、Material 3、双语可运行	M0
M2 Project Core	YAML、事务、Diff、监听和恢复可用	M1
M3 Base & Generator	可创建并编译优化 Base	M2
M4 Structured Robot	可视化创建层级 Subsystem 和电机	M3
M5 Code Collaboration	可导入、识别、跳 IDE 和安全编辑引用	M4
M6 Controls & Commands	多设备绑定和 Command 装配闭环	M5
M7 Presets	Swerve、Limelight 可创建和维护	M6
M8 NT Tuning	NT 差异回写代码闭环	M4、M5
M9 Workflow Complete	Docs、验证、Build/Sim/Deploy 完整	M6、M8
M10 Beta Release	三平台安装包和 Beta 验收	M9

2. M0：仓库与技术验证

2.1 仓库初始化

M0-001 P0 初始化 pnpm workspace，锁定 Node.js LTS 和 pnpm 版本。
M0-002 P0 使用 Electron Forge + Vite + TypeScript strict 创建 apps/desktop。
M0-003 P0 建立 packages/*、resources/*、docs/adr/* 目录。
M0-004 P0 配置 ESLint、Prettier、EditorConfig、typecheck 和统一脚本。
M0-005 P0 建立 Vitest、Playwright 和测试 fixture 基础设施。
M0-006 P0 配置提交前检查，但保证 CI 可独立执行全部检查。
M0-007 P1 建立 Conventional Commits/Changelog 规则。
M0-008 P1 添加第三方依赖许可清单和自动审计脚本。

验收： 新克隆仓库后，一条安装命令和一条开发命令能打开空 Electron 窗口；typecheck、lint、unit test 均可运行。

2.2 Material Design 3 技术验证

M0-020 P0 安装并固定 @material/web 精确版本。
M0-021 P0 用 Lit 渲染 Button、Text Field、Select、Checkbox、Tabs、Dialog、Menu；因 Material Web 2.5 无 Snackbar，按 ADR 0001 使用 Material token aria-live 状态面。
M0-022 P0 建立 ui/material 薄适配入口，禁止业务层自行封装另一套视觉系统。
M0-023 P0 定义黑/灰/白 Material tokens：surface、surface-container、outline、on-surface。
M0-024 P0 验证 Material Symbols 和字体可离线打包。
M0-025 P0 制作三栏工作区原型：Navigation Rail、主内容、Inspector、底部面板。
M0-026 P0 验证键盘焦点、屏幕阅读器标签、缩放和高对比度。
M0-027 P1 验证 1280×720、1920×1080 和高 DPI 下的布局。
M0-028 P0 写 ADR：Material Web 维护模式、锁版和未来替换边界。

验收： 原型不使用第三方 UI 组件库；标准交互控件全部来自 @material/web；断网时视觉和图标完整。

2.3 Electron 安全与跨平台验证

M0-040 P0 建立 Main/Preload/Renderer 三层和共享 IPC 类型。
M0-041 P0 设置 contextIsolation: true、nodeIntegration: false、Renderer sandbox。
M0-042 P0 设置 CSP，禁止无必要的远程内容和动态代码执行。
M0-043 P0 实现最小 contextBridge 示例，不暴露通用 ipcRenderer。
M0-044 P0 实现目录选择和授权根路径验证原型。
M0-045 P0 验证 spawn 参数数组调用，不使用 shell: true。
M0-046 P0 在 Windows、macOS、Linux CI 启动 packaged smoke test。
M0-047 P0 写 ADR：IPC、路径授权、外部程序调用安全模型。

验收： Renderer 无法直接 require('fs')；越出授权项目根目录的 IPC 请求被 Main 拒绝并记录原因。

2.4 Java 分析技术验证

M0-060 P0 用 Tree-sitter Java WASM 解析现有 base 和 10541 项目代表性文件。
M0-061 P0 提取 package、imports、classes、fields、constructors、methods 和源码范围。
M0-062 P0 对不完整和暂时编译错误的 Java 验证容错能力。
M0-063 P0 识别 IronPulse 常见 Motor Config/Factory/Subsystem 构造链。
M0-064 P0 识别 WPILib Trigger/Controller/Command binding 常见写法。
M0-065 P0 验证 import 插入、去重、排序和 static import。
M0-066 P0 定义 Managed/Recognized/Custom 分类和置信度数据结构。
M0-067 P0 写 ADR：parser、targeted edit 和 managed region 策略。

验收： 对选定 fixture 能产生稳定 JSON 索引；存在复杂表达式时不崩溃，且明确返回 Custom 源码范围。

2.5 NT4 技术验证

M0-080 P0 调研 WPILib NT4 协议、可用 Node/WASM 实现和跨平台打包风险。
M0-081 P0 研究 AdvantageScope 的连接交互、地址处理和重连体验。
M0-082 P0 完成依赖许可检查，不复制许可不兼容的实现代码。
M0-083 P0 制作连接本地 simulator、订阅指定 prefix、读取基本类型的 spike。
M0-084 P0 验证写值、断线重连、类型变化和超时。
M0-085 P0 定义 NtClient 接口，使协议实现可替换。
M0-086 P0 写 ADR：NT 客户端选择和协议测试方案。

验收： Windows、macOS、Linux 至少能通过相同接口运行协议测试；若无法做到，必须在 M0 明确替代实现，不把风险推迟到 M8。

2.6 WPILib 工具链验证

M0-100 P0 在三平台调研 WPILib JDK 和工具安装位置。
M0-101 P0 检测系统 Java 与 WPILib JDK，建立选择优先级。
M0-102 P0 用 Node spawn 运行 gradlew tasks、compile 和 simulate dry-run。
M0-103 P0 解析 Gradle error 的文件、行、列和 message。
M0-104 P0 验证进程取消、超时、退出码和流式日志。
M0-105 P0 写 ADR：Toolchain discovery 和平台命令抽象。

验收： 系统 Java 不兼容时可自动选择 WPILib JDK，并在 UI 数据模型中给出明确诊断。

3. M1：Desktop Shell 与基础体验

3.1 应用外壳

M1-001 P0 实现 Top App Bar、Navigation Rail、Workspace、Inspector、Bottom Panel。
M1-002 P0 实现可调整宽度的树/内容/Inspector 分栏。
M1-003 P0 保存窗口尺寸、位置、分栏和面板展开状态。
M1-004 P0 建立统一的 Command Palette/快捷操作模型。
M1-005 P0 建立全局 Snackbar、Dialog、错误边界和 loading 状态。
M1-006 P1 添加键盘快捷键帮助页。
M1-007 P1 支持紧凑密度设置，但不破坏 Material 最小点击区域。
M1-008 P1 应用启动窗口适配当前显示器完整可用工作区，多显示器不越界。
M1-009 P1 接入统一 SVG 品牌源并生成 Windows/macOS/Linux 应用图标。

3.2 首页与项目入口

M1-020 P0 首页显示 Create、Open、Recent Projects。
M1-021 P0 选择目录后判断为空目录、有效项目或未知目录。
M1-022 P0 空目录显示创建表单，非空目录默认显示打开/导入预览。
M1-023 P0 Recent Projects 记录路径、显示名、最后打开时间和失效状态。
M1-024 P0 支持从系统文件关联或命令行路径打开项目。
M1-025 P1 支持拖入项目目录。
M1-026 P0 最近项目不存在或无权限时提供移除/重新定位。

3.3 中英文国际化

M1-040 P0 建立 en、zh-CN 翻译资源和 typed translation keys。
M1-041 P0 首次启动跟随系统语言。
M1-042 P0 设置中可即时切换语言，无需重启。
M1-043 P0 日期、数值、单位和复数使用 Intl API。
M1-044 P0 增加测试，阻止缺失 key 和 Renderer 硬编码用户文本。
M1-045 P1 检查中英文文本长度变化下的布局。

3.4 设置与编辑器

M1-060 P0 设置页保存主题、语言、项目默认值和日志级别。
M1-061 P0 检测 WPILib VS Code、VS Code、IntelliJ IDEA、Cursor。
M1-062 P0 支持自定义可执行文件和参数模板。
M1-063 P0 支持 {file}、{line}、{column}、{project} 占位符。
M1-064 P0 验证 executable，使用数组参数和 shell: false。
M1-065 P0 建立“测试打开”功能。
M1-066 P1 支持每项目覆盖默认编辑器。
M1-067 P0 AdvantageScope、PathPlanner 支持自动检测与每应用自定义路径。
M1-068 P0 支持 Windows Microsoft Store PathPlanner 与 macOS .app 选择。

M1 验收场景： 用户首次启动无需教程，能从首页选择文件夹、理解创建/打开状态、切换语言，并从设置测试打开外部 IDE。

4. M2：Project Model、YAML 与事务引擎

4.1 Schema 与模型

M2-001 P0 定义 schemaVersion: 1 顶层 JSON Schema。
M2-002 P0 定义 Project、Robot、Subsystem、Mechanism、Device、Controls、Commands、NT、Docs 实体。
M2-003 P0 每个实体使用稳定 UUID，Java symbol 作为可变属性。
M2-004 P0 为参数定义 type、unit、default、range、condition、source。
M2-005 P0 实现 YAML parse/stringify，输出顺序和注释策略稳定。
M2-006 P0 友好显示 Schema 错误到 YAML 路径和 UI 对象。
M2-007 P0 建立未知字段保留策略，避免新版本数据被旧版本静默丢弃。
M2-008 P0 实现 Schema migration runner 和备份。
M2-009 P0 生成 project.schema.json 供外部编辑器提示。

4.2 领域命令与历史

M2-020 P0 所有结构化修改通过 typed domain command 执行。
M2-021 P0 实现 add/remove/move/rename/update/batch commands。
M2-022 P0 每个命令返回 touched entities 和预计输出文件。
M2-023 P0 实现 undo/redo，跨 YAML 和生成文件保持一致。
M2-024 P0 保存当前 session 的操作历史和 clean checkpoint。
M2-025 P1 支持将多个 Inspector 修改合并为一个可撤销操作。

4.3 Diff 与事务写入

M2-040 P0 建立候选输出目录，不直接覆盖项目。
M2-041 P0 计算新增、修改、删除、重命名文件 Diff。
M2-042 P0 实现行级 Diff viewer 和文件筛选。
M2-043 P0 高亮 Managed、Recognized、Custom 区域。
M2-044 P0 实现临时文件、fsync/close、同目录原子 rename。
M2-045 P0 写入前保存事务 manifest 和可恢复备份。
M2-046 P0 模拟写到一半进程退出并验证下次启动恢复。
M2-047 P0 实现事务应用失败的完整 rollback。
M2-048 P1 实现“自动应用安全修改”设置，仍写入历史。

4.4 文件监听与并发修改

M2-060 P0 用 Chokidar 监听 YAML、Java、Gradle、vendordeps 和 docs。
M2-061 P0 区分应用自身写入和外部写入。
M2-062 P0 合并短时间内的编辑器临时文件/rename 事件。
M2-063 P0 当前 UI 有未保存候选变更时，外部修改触发冲突提示。
M2-064 P0 提供 reload、compare、keep external、regenerate 四类明确操作。
M2-065 P0 测试 VS Code、IntelliJ 常见安全保存模式。

4.5 项目授权与锁

M2-080 P0 Main 保存当前授权项目根目录。
M2-081 P0 所有文件 IPC 使用 canonical path 校验，防止 .. 和 symlink 越界。
M2-082 P0 建立应用实例/项目写锁，检测同项目被两个窗口修改。
M2-083 P0 支持只读打开和“取得写入权”。
M2-084 P1 检测项目是否位于网络盘或同步盘并提示原子性风险。

M2 验收场景： 修改模型后能先看 Diff，再同时更新 YAML 和一个 fixture 文件；强制杀掉应用后重新打开能恢复或回滚到一致状态。

5. M3：优化 Base 与生成器

5.1 分析现有代码资产

M3-001 P0 记录 frc-code-base 的包结构、IronPulse 封装、Gradle 和 vendordeps。
M3-002 P0 记录 2026-offseason-robot-10541 的 Robot 生命周期、Container、OI、Auto、Telemetry、Subsystem 模式。
M3-003 P0 列出可直接复用、需重构、不可进入 Base 的文件。
M3-004 P0 确认所有复用代码的版权和许可。
M3-005 P0 为新 Base 写结构 ADR。

5.2 Base 工程

5.3 创建向导

M3-040 P0 收集 project name、team number、package、WPILib year。
M3-041 P0 检查空目录并防止覆盖现有文件。
M3-042 P0 实例化 Base 中的模板变量。
M3-043 P0 生成初始 project.yaml 和 Schema 引用。
M3-044 P0 生成唯一 AGENTS.md 和核心英文 docs。
M3-045 P0 创建完成自动运行 validation、Spotless、compile。
M3-046 P0 失败时显示日志并完整撤销已创建文件。

5.4 确定性生成器

M3-060 P0 建立 TypeScript generator API 和 template context。
M3-061 P0 固定文件、import、字段、方法和 YAML 输出顺序。
M3-062 P0 生成前检查 Java identifier 和 package path。
M3-063 P0 生成后运行 Spotless 并重新计算最终 Diff。
M3-064 P0 同一模型连续生成两次，第二次必须零 Diff。
M3-065 P0 建立 golden snapshots 和 Gradle compile 测试。

M3 验收场景： 在空目录创建项目，生成代码肉眼清晰，RobotContainer 保持精简，不安装 FRC Framework 也能用 WPILib 工具构建。

6. M4：结构化 Robot、Subsystem 与硬件

6.1 双项目树

M4-001 P0 实现逻辑树和源码树切换。
M4-002 P0 逻辑树支持 Robot → Subsystem → Mechanism → Device/Command/State。
M4-003 P0 支持 Superstructure 和非硬件 helper 节点。
M4-004 P0 支持搜索、折叠、键盘导航和右键/更多菜单。
M4-005 P0 支持拖动调整 Mechanism/Device 层级，显示合法落点。
M4-006 P0 源码树标记 Managed/Recognized/Custom、外部修改和问题数量。
M4-007 P1 保存每项目的树展开状态。

6.2 IronPulse 组件目录

M4-020 P0 盘点 lib.ironpulse 可生成的所有 MotorIO、SubsystemConfig、Real/Sim 类。
M4-021 P0 为 TalonFX 主电机和 follower 建立 catalog definition。
M4-022 P0 为 Position/Velocity MotorSubsystem 建立 definition。
M4-023 P0 为 CANcoder、Gyro、BeamBreak、Indicator 等建立基础 definition。
M4-024 P0 每个参数记录类型、单位、范围、默认、依赖、互斥和生成映射。
M4-025 P0 建立组件目录 Schema 和版本号。
M4-026 P0 catalog 的每个 generator mapping 有 fixture 测试。
M4-027 P1 UI 显示对应 IronPulse 类型和说明链接。

6.3 Subsystem/Mechanism/Device 编辑器

6.4 首批参数覆盖

6.5 核心验证器

M4-080 P0 CAN/DIO/Analog/PWM/USB port 冲突。
M4-081 P0 Java name/package 冲突和非法字符。
M4-082 P0 参数单位、范围、上下限和 ratio 校验。
M4-083 P0 follower 环、主设备不存在和总线不一致。
M4-084 P0 NT path 冲突、类型冲突和非法路径。
M4-085 P0 Real 缺少 Sim fallback。
M4-086 P0 问题能定位到树节点、Inspector 字段和生成源码。
M4-087 P1 对确定性问题提供 Quick Fix。

M4 验收场景： 能表示 Shooter → Upper/Lower/Hood → 多个主从电机；修改任意设备参数后 YAML、Java、硬件文档同步，冲突会在写入前阻止。

7. M5：代码索引、导入与 IDE 协作

7.1 打开现有项目

M5-001 P0 检测 project.yaml 并优先加载。
M5-002 P0 校验 Schema/Base/Preset 版本并显示迁移预览。
M5-003 P0 无 YAML 时识别 GradleRIO、WPILib year、team、package、vendordeps。
M5-004 P0 建立 Java 索引并识别标准 IronPulse 结构。
M5-005 P0 生成导入预览：Recognized、Partial、Custom。
M5-006 P0 用户确认后只创建 YAML/docs，不重写未知 Java。
M5-007 P0 导入报告列出未识别内容和源码位置。
M5-008 P0 用 10541 完整项目建立回归 fixture。
M5-009 P0 重载 Command 使用参数签名生成唯一 ID，并提供旧导入修复脚本。

7.2 源码索引

M5-020 P0 索引文件、类型、字段、构造函数、方法、imports。
M5-021 P0 记录 AST range 到行/列的映射。
M5-022 P0 识别 managed regions 和文件所有权。
M5-023 P0 识别 Command 返回方法、requirements 和参数。
M5-024 P0 识别 Controller、Trigger 和 binding。
M5-025 P0 识别 enum Goal/State 与简单 setter。
M5-026 P0 增量解析变更文件，不全项目重复扫描。
M5-027 P0 Parser error 不影响其他文件使用。

7.3 代码操作

7.4 外部修改适配

M5-060 P0 Recognized 标准变更可建议同步回 YAML。
M5-061 P0 复杂表达式显示源码摘要和“在代码中调试”。
M5-062 P0 修改 Managed 文件时显示模型/代码双向冲突。
M5-063 P0 支持 keep code and unmanage。
M5-064 P0 支持 regenerate from model，但必须二次确认 Diff。
M5-065 P0 测试用户在 managed region 外增加方法不会丢失。

M5 验收场景： 打开无 YAML 的 10541 fixture 后能显示 Shooter 层级和 Custom 内容；给一个 Subsystem 添加另一个类引用时生成正常 import/构造注入，并能一键跳 IDE。

8. M6：Controls、Commands 与装配

8.1 输入设备

M6-001 P0 支持 Xbox、PS4/PS5、Joystick、GenericHID。
M6-002 P0 支持 Button Board 和自定义按钮/轴布局。
M6-003 P1 支持 Sim Keyboard 和 NT input。
M6-004 P0 每设备保存 port、role、deadband、axis transform、rumble。
M6-005 P0 Driver/Operator/Technician 只是默认 role，允许自定义。
M6-006 P0 检测 USB port 冲突。
M6-007 P0 允许同一 Trigger/Event 合法绑定多个 Command，仅报告 requirement 冲突。

8.2 绑定编辑器

M6-020 P0 支持 button、axis threshold 和 POV。
M6-021 P0 支持 onTrue/onFalse/whileTrue/toggleOnTrue。
M6-022 P0 支持 chord 和简单 AND/OR/NOT 条件。
M6-023 P0 支持 Command 参数、超时和中断行为。
M6-024 P0 Command 选择器显示来源、参数、requirements。
M6-025 P0 检测重复绑定、互斥冲突和潜在 requirement 冲突。
M6-026 P0 生成清晰 OperatorInterface Java。
M6-027 P0 自定义 Java Trigger 以只读摘要显示并可跳转。
M6-028 P1 可视化显示一个按钮的完整触发序列。

8.3 Command 与 RobotCommands

M6-040 P0 发现 public Command factory methods。
M6-041 P0 区分 Command instance 与 Command factory，避免组合后复用。
M6-042 P0 支持 sequence、parallel、race、deadline、either 等常见组合。
M6-043 P0 跨 Subsystem 组合默认生成到 RobotCommands。
M6-044 P0 RobotContainer 只完成顶层构建和 wiring。
M6-045 P0 生成代码显示明确依赖和 requirements。
M6-046 P0 对复杂 Custom Command composition 降级为源码摘要。

8.4 Auto 基础

M6-060 P0 AutoManager 读取 chooser 和可用 routines。
M6-061 P0 识别/管理 PathPlanner named commands。
M6-062 P0 检查缺失路径和 named command。
M6-063 P1 显示 Auto routine 结构摘要和外部打开入口。
M6-064 P1 与 AdvantageScope/PathPlanner GUI 提供快捷打开，不重复实现其编辑器。

M6 验收场景： 用户可添加不同类型主/副操设备，将按钮绑定到跨 Subsystem Command；生成的 OI/RobotCommands/RobotContainer 代码清晰且通过编译。

9. M7：预制模块

9.1 Preset 基础设施

M7-001 P0 定义 preset manifest、schema、version、dependencies、outputs。
M7-002 P0 定义 Base/Preset/App 兼容范围。
M7-003 P0 实现 preset 向导、预览和实例化事务。
M7-004 P0 实例化后记录 preset 来源和版本，但输出普通 Java。
M7-005 P0 用户修改后标记 customized files/regions。
M7-006 P0 升级使用 base/old/new 三方 Diff，不静默覆盖。
M7-007 P0 preset 可附带 validator、docs、calibration steps。
M7-008 P0 preset fixture 必须 Real/Sim compile。

9.2 Swerve Preset

9.3 Limelight Preset

M7-040 P0 配置设备名、NT table、pipeline 和 stream mode。
M7-041 P0 配置 robot-to-camera Transform 和坐标约定。
M7-042 P0 生成目标/位姿读取、时间戳、延迟和有效性处理。
M7-043 P0 生成无目标、断线和 Sim fallback。
M7-044 P0 生成可选 localization/aiming 接口，不强制具体策略。
M7-045 P0 生成英文安装、标定和坐标文档。
M7-046 P0 验证 transform、设备名和 pipeline 范围。

9.4 后续常用预制

M7-060 P1 单电机 Percent Output 机制。
M7-061 P1 Velocity Flywheel + followers。
M7-062 P1 Position mechanism + zero/limits。
M7-063 P1 BeamBreak conveyor/indexer。
M7-064 P2 LED Indicator。

M7 验收场景： 从空 Base 添加 Swerve 和 Limelight 后，设备树、代码、Sim、依赖、NT 和 docs 一次生成并编译；用户手改后升级不会丢失修改。

10. M8：NetworkTables 调参与回写

10.1 连接管理

M8-001 P0 支持 team number、hostname、IPv4 和 localhost/simulator 地址。
M8-002 P0 实现 NT4 connect/disconnect/auto reconnect。
M8-003 P0 显示 connecting/connected/stale/error 和最后更新时间。
M8-004 P0 仅订阅项目声明 prefix，支持低带宽策略。
M8-005 P0 连接失败给出地址、防火墙、机器人状态建议。
M8-006 P0 连接信息和日志不得泄露不必要的网络数据。

10.2 参数声明

M8-020 P0 参数支持 publish、tunable、path、type、unit、tolerance。
M8-021 P0 自动路径 /Tuning/<Subsystem>/<Mechanism>/<Parameter>。
M8-022 P0 支持全局 root、模块 path 和单参数完整 path 覆盖。
M8-023 P0 生成对应 Java NT 发布/调节代码。
M8-024 P0 路径修改同步 YAML、Java、docs。
M8-025 P0 检测重复 path、不同 type 和越界值。

10.3 差异页面

M8-040 P0 表格显示参数、Code Default、Live NT、Delta、unit、path。
M8-041 P0 默认只显示有差异的值。
M8-042 P0 支持 subsystem、类型、更新时间和搜索筛选。
M8-043 P0 浮点使用 tolerance，数组/结构值有明确比较规则。
M8-044 P0 stale、type mismatch、out of range 单独显示且不可回写。
M8-045 P0 支持逐项和批量勾选。

10.4 写回闭环

M8-060 P0 “Write NT values to code” 创建一个 domain batch command。
M8-061 P0 更新 YAML 默认值和对应 Java Builder/constant。
M8-062 P0 显示完整 Diff，不直接部署。
M8-063 P0 写入后运行 Spotless 和 compile。
M8-064 P0 compile 失败回滚或明确保留为未通过状态。
M8-065 P0 compile 成功后提供独立 Deploy 按钮。
M8-066 P0 操作历史记录回写来源、时间和旧值。
M8-067 P1 支持将一组现场参数保存为命名 snapshot。

M8 验收场景： 在 simulator 改变 PID/FF/limit 等多个值，应用只显示真实差异；选中后 YAML 和 Java 同步更新，编译通过且无需手工复制数字。

11. M9：Docs、验证、构建与诊断闭环

11.1 唯一 AGENTS.md 与英文 docs

11.2 Problems 中心

M9-020 P0 聚合 Schema、模型、Java parser、build、preset、NT 问题。
M9-021 P0 severity：error、warning、info。
M9-022 P0 每项关联对象、文件、行列和解释。
M9-023 P0 点击定位树节点/Inspector/源码或外部 IDE。
M9-024 P0 对安全的修复提供 Quick Fix 和 Diff。
M9-025 P0 相同问题去重，外部修复后实时消失。
M9-026 P1 导出诊断报告用于 Issue。

11.3 Build/Format/Test/Simulate/Deploy

M9-040 P0 Toolchain 页显示 WPILib JDK、Gradle、年份和状态。
M9-041 P0 实现 Spotless、compile、test、simulate、deploy 命令。
M9-042 P0 任务输出流式显示并可取消。
M9-043 P0 解析 Java/Gradle error 并可点击打开 IDE。
M9-044 P0 防止重复启动互斥 Gradle 任务。
M9-045 P0 Deploy 前显示 team、目标、Git/文件未保存状态和构建结果。
M9-046 P0 危险/真实机器人操作需要明确确认。
M9-047 P1 保存最近任务输出和耗时。
M9-048 P1 提供“Open in AdvantageScope/PathPlanner”快捷入口。

11.4 Auto 与 Telemetry 完善

M9-060 P0 Auto chooser、routine、path 和 named command 验证完整。
M9-061 P1 显示当前 Auto 摘要和缺失资源。
M9-062 P0 RobotTelemetry 聚合关键状态，不把逻辑散落在 Container。
M9-063 P1 FieldPublisher/RobotStateRecorder 文档和配置入口。

11.5 校准和安全诊断

M9-080 P1 Swerve offset/direction 检查向导。
M9-081 P1 Pigeon mount orientation 检查。
M9-082 P1 Mechanism zero/home 和 limit 检查。
M9-083 P1 Limelight transform 检查。
M9-084 P1 单设备低功率方向测试，带安全确认和自动停止。
M9-085 P1 SysId 入口和结果文件定位。
M9-086 P1 校准结果通过标准事务写回项目。

M9 验收场景： 一个新 AI 只读根 AGENTS.md 和 docs 就能找到硬件、控制、状态和安全规则；用户能从问题定位到代码并完成 build/sim/deploy。

12. M10：质量、跨平台与 Beta 发布

12.1 测试矩阵

12.2 性能目标

M10-020 P0 冷启动、打开项目、首次索引和增量索引建立基准。
M10-021 P0 10541 规模项目打开期间 UI 不阻塞。
M10-022 P0 大树使用增量渲染或虚拟化，不重绘全部节点。
M10-023 P0 Parser/generator 任务移出 Renderer 主线程。
M10-024 P0 NT 更新批处理，避免高频刷新整个页面。
M10-025 P1 记录内存占用和长期运行泄漏测试。

建议 Beta 性能门槛：

桌面壳可交互时间小于 3 秒（目标开发机）；
10541 级项目首次索引小于 5 秒；
单文件外部修改刷新小于 500 ms；
普通 Inspector 编辑到 Diff 预览小于 300 ms，不含 Spotless/Gradle。

12.3 打包与发布

M10-040 P0 Windows installer 和 portable/zip artifact。
M10-041 P0 macOS DMG/zip artifact（GitHub Actions macOS runner 已验证）。
M10-042 P0 Linux deb/rpm 和 zip artifact（GitHub Actions Linux runner 已验证）。
M10-043 P0 每个平台生成 SHA-256 校验值和 SBOM/许可文件。
M10-044 P0 版本号、release notes、Schema/Base/Preset 版本写入 About。
M10-045 P0 迁移前自动备份并测试降级提示。
[!] M10-046 P1 Windows code signing（已接入可选签名配置，缺少用户证书与密码）。
[!] M10-047 P1 macOS Developer ID signing/notarization（已接入配置，缺少 Apple 身份与凭据）。
M10-048 P1 GitHub Releases 更新检查。
M10-049 P2 在签名与回滚成熟后评估自动更新。

12.4 Beta 验收

M10-060 P0 用真实 10541 FRC 项目完成创建、导入和持续编辑回归。
M10-061 P0 生成项目脱离软件后通过独立 Gradle 编译、测试与交接文档验收。
[!] M10-062 P0 至少一次机器人/模拟器 NT 调参回写测试（协议与回写自动测试已通过，需真实 robot/simulator 会话）。
[!] M10-063 P0 至少一次 Swerve 和 Limelight preset 实战测试（生成与真实 WPILib 编译已通过，需真实机器人验收）。
[!] M10-064 P0 收集新手与有经验队员的首次使用观察，不提供教程提示（需外部队员参与）。
M10-065 P0 修复已发现的数据丢失、静默覆盖、路径越界和错误部署类问题。
M10-066 P0 发布已知限制和恢复说明。

13. 跨阶段持续任务

13.1 每年 WPILib 与厂商库适配

CONT-001 P0 Base、Schema、Catalog、Preset 使用独立版本。
CONT-002 P0 为当前支持的 WPILib 2026 维护真实 Gradle 编译矩阵。
CONT-003 P0 未验证年份被模型与创建 UI 明确阻止，先更新 fixture 和兼容报告才能开放。
CONT-004 P0 Phoenix/PathPlanner/AdvantageKit/IronPulse 版本显式固定，不兼容 Base/Preset 明确阻止升级。
CONT-005 P1 About 与创建 UI 显示项目年份支持状态，已知问题独立发布。

13.2 数据安全

CONT-020 P0 任何删除/覆盖前解析并显示准确目标。
CONT-021 P0 所有 materially destructive 操作可恢复或有明确二次确认。
CONT-022 P0 事务临时备份完成后清理；Schema 迁移备份只保留最新 5 份。
CONT-023 P0 诊断与崩溃输出不记录 Java 源码全文或网络密钥。
CONT-024 P0 错误报告默认本地保存，上传需用户明确选择。

13.3 UX 与可访问性

CONT-040 P0 新功能包含 empty、loading、error、disabled 状态。
CONT-041 P0 主要操作通过键盘与 Playwright 验收。
CONT-042 P0 状态同时使用文本、图标或形状，不只依赖颜色。
CONT-043 P0 危险操作、真实机器人和 simulator 有明显区分与确认。
CONT-044 P0 高级参数默认折叠但可以搜索发现。
CONT-045 P0 UI 隐藏内部 UUID 和无需理解的生成细节。

13.4 文档与决策

CONT-060 P0 长期兼容性决策写入 ADR。
CONT-061 P0 每个 milestone 完成时更新本 TODO 和总体规划偏差。
CONT-062 P0 用户文档与自动生成机器人 docs 分开维护。
CONT-063 P0 公开文件格式变更带 migration、备份和测试示例。

13.5 GitHub 发布前收尾

14. 首批开发迭代建议

Iteration 1：可以启动的安全桌面壳

完成 M0-001 至 M0-047。
完成 M1-001 至 M1-045。
形成 Material 3 黑灰白工作区和中英文首页。

Iteration 2：不会丢数据的项目内核

完成 M2 Schema、domain command、Diff、transaction、watcher。
建立一个简单文本 fixture 做崩溃恢复测试。

Iteration 3：第一个真实 FRC 输出

完成现有两个机器人仓库结构分析。
重写空 Base。
从空目录创建项目并用 WPILib JDK 编译。

Iteration 4：第一个可视化电机机制

实现逻辑树、Subsystem/Mechanism/Motor。
支持 TalonFX 主从、常用配置、PID/FF/limit 和 Sim。
YAML、Java、硬件 docs 同步并带 Diff。

Iteration 5：代码协作而非代码封闭

导入无 YAML 项目。
实现 Recognized/Custom 显示、IDE 跳转、import/reference、Goal scaffold。
验证任意 Custom Java 不会被结构化修改覆盖。

完成这五个迭代后再扩大到 Controls、Presets 和 NT，避免在项目模型、事务和代码边界尚未稳定时同时开发过多表面功能。

15. Release Gate

Alpha Gate

M0–M5 的全部 P0 完成。
可以创建、打开、导入、编辑一个电机 Subsystem。
无已知静默覆盖或无法恢复的数据丢失问题。
Windows packaged build 可运行。

Preview Gate

M6–M8 的全部 P0 完成。
Swerve、Limelight、Controls 和 NT 写回通过真实 fixture。
Windows、macOS、Linux packaged smoke test 均已通过对应 CI runner。

Beta Gate

M9–M10 的全部 P0 完成。
真实机器人项目试用通过。
安全、迁移、恢复、跨平台和无软件交接测试通过。
所有 P0/P1 数据安全问题关闭；其他已知问题有清晰说明。

FilesExpand file tree

TODO.md

Latest commit

History