版本与验证范围

版本说明

项目接入功能已在仓库提交 62307d8 中实现；发布 tag、CLI 版本和 kernel schemaVersion 是独立版本层。首次安装必须选择包含接入功能的可取得版本，不能把 README 的 V0.1.1 文案当作有效 tag。

已知限制

硬规则与软建议应区分：接入参数、版本一致性、避免覆盖用户内容是工程保护；只有适用范围明确、可可靠判定的代码规范才适合硬检查。命名、架构、调参经验等当前多数是 soft。

当前 5 条生效规则带硬检查。跨赛季 global.test-utility-layout 硬拦截确定的错误 TeamCode 路径和 JUnit 新增（退出码 1）：机器人侧 OpMode 在 TeamCode/src/main/java/org/firstinspires/ftc/teamcode/tests/，可复用工具在 TeamCode/src/main/java/org/firstinspires/ftc/teamcode/utils/。完整 Agent instruction 仍负责无法由路径可靠判定的语义分类；此规则不禁止 Knowledge Bank 自身的 Kotlin/CLI JUnit 测试。official.keep-customizations-in-teamcode 只对 build.common.gradle 保持 hard 保护；global.vendor-documented-build-dependencies 对 build.dependencies.gradle 的任何触及（含删除/重命名）输出跨赛季条件式 soft，要求 Agent 提供第一方厂商文档或固定 commit、精确依赖版本和 diff 逐项对应。规则引擎不联网鉴别来源、不验证证据真伪，soft 不代表机器已证明合规，也不是静默放行。两条 approved Limelight validity/freshness 规则没有 hard checks，而是 reviewTriggers 驱动的条件式 soft：相机类型或结果读取的新增行命中触发条件才进入 soft；无关 Java 不产生 Limelight soft。触发 soft 时 check 仍是退出码 0（没有其他硬违规时），只要求人工/模型复核，不是机器已证明违规或硬件安全；Agent 必须向用户报告该 soft，且不得插入无意义的 isValid()/时间戳代码。check 仍是静态文本检查，不是完整 Java 语义分析，也不能证明硬件安全。

开发验收记录

以下是现有文档记录的验收结果，不代表文档站构建时重新运行机器人或核心测试。

PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests/integration -v
# 显式启用较重的固定源码构建 + 真实 CLI 验收：
FTCKB_REAL_INTEGRATION=1 PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests/integration -k test_real_cli_from_pinned_source -v
# 核心/CLI 全套（不拉取 Android Studio 插件测试平台）：
./gradlew :modules:domain:test :modules:knowledge:test :modules:model-provider:test \
  :modules:model-provider-openai-compatible:test :modules:repository-analysis:test \
  :modules:tooling-git:test :modules:agent-runtime:test :modules:standardizer:test \
  :modules:session-shell:test :apps:knowledge-cli:test :apps:knowledge-cli:installDist

普通 Python 用例使用真实 Git、隔离构建/CLI 夹具检验安装行为。真实 CLI 与发布验证结果单独记录，不把夹具成功或 Windows launcher 参数测试称为 Windows 实机通过。

历史基线（不是 V0.5.0 当前验收），2026-09-08 验收：Python 常规 22 项通过（含已安装项目 dry-run 不刷新 index 回归）；单独开启的真实源码安装测试 1 项通过（临时 Git 源仓库固定 SHA→真实 Gradle installDist→validate/resolve→故意违规的 check exit 1），在最终 Git dry-run 修复后再次通过。Kotlin 核心与 CLI 422 项，421 通过、1 项原有 installDist 预期路径假设检查跳过；无失败。10 份 kernel JSON fixtures 均通过 jsonschema；两份 Skill 通过结构校验；本知识库 validate/resolve/check 通过。./gradlew test 全仓库尝试长时间无输出后中止，因此 Android Studio 插件全量测试未完成；Windows 原生环境、部署和真机运行未验证。