Jetson 目标知识库生成

问题背景

在 Jetson BSP 定制工作流里，Claude 会话或工程师经常要问「这个 BSP 里的 X 在哪？」——rootfs/、bootloader/、源码子树、与 SKU 匹配的 nvpmodel 配置、设备树文件路径，以及 YAML 里登记的文档引用是否还在磁盘上。每次靠 find 或人工翻目录既慢，也容易和活动目标配置文件脱节。

技能如何工作

jetson-generate-kb 在 target-platform/<配置名>.md 写入一份可重复生成的快照（头部带日期），与对应 .yaml 同级。它只解析当前活动目标（见 target-platform-contract.md），并在磁盘上做浅层发现，不递归遍历整个 BSP：

• BSP 镜像布局：在 bsp_image.root_path 下列一级目录，标记 rootfs/、bootloader/、kernel/、source/ 等规范子树是否存在；检查活动 flash_config；从 rootfs/etc/nvpmodel/ 过滤 nvpmodel_<module>_<sku>.conf。
• 源码树布局（可选）：若配置了 source.root_path，列出规范子树（如 kernel-jammy-src/、nvidia-oot/、kernel-devicetree/），并按模块 ID 推导芯片系列，枚举匹配的 tegra*.dts（最多 30 条）。
• 文档：渲染 documents.* 字段；URL 原样记录且不发起网络请求；本地路径做 exists 检查，缺失则标 (missing)。

每次运行直接覆盖旧知识库；底层 BSP、源码或 YAML 变更后应重新执行。

适用边界

• 必需 bsp_image.root_path 且目录真实存在；否则拒绝生成（避免把 YAML 复述成「知识库」）。
• 知识库是快照，不是实时视图；头部日期与今天不一致时，应重新运行。
• 未知 module.id 时芯片系列记为 unknown，设备树前缀过滤会跳过；文档深度索引不在 v0.1 范围。