技能介绍

要解决什么问题

在 Jetson / IGX 定制流程里，jetson-generate-kb、引脚复用、摄像头 / PCIe / UPHY 等下游技能都需要从活动目标平台配置里按字段名找到 BSP 手册、TRM、模块数据手册、载板原理图、Pinmux 表格等文件。若 documents: 块未登记或路径错误，下游会直接报「未记录文档」。本技能只做一件事：把磁盘上已经存在的文件路径写进当前活动配置的 documents: 块，不负责下载或拷贝。

如何工作

解析活动目标：按 target-platform-contract 约定加载当前 target-platform/*.yaml，并在内存中保留，供后续写回。
槽位模式：从 platform_template.yaml 读取 documents: 各字段及提示文案；无 custom_carrier: 时跳过自定义载板原理图与 Pinmux 槽位。
根路径：默认 /Documents；可沿用配置里已有的 documents.root_path，或让用户指定绝对路径；根路径缺失则跳过自动扫描，仍可手动填路径或 URL。
自动匹配：在根目录一级深度扫描，用 SKU（module.id / carrier.id 等）与产品令牌（来自 bsp-platforms-catalogue 或自定义载板名称派生的 glob）做不区分大小写的 glob；唯一命中需用户确认后才写入，多命中列编号供选择，从不静默绑定。
写回配置：用可往返的 YAML（如 ruamel.yaml）原地更新，保留其它顶级块与注释；跳过的字段不写；若全部跳过则删除整个 documents: 块。可重复运行并合并已有绑定。

边界与注意

必须先有活动配置文件（通常由 jetson-init-target 之后）；无活动目标应走 jetson-set-target / jetson-init-target。
归档目录若按子文件夹深嵌，v0.2 仅扫一级，零自动命中时需手动指定路径。
documents.* 为相对 root_path 的路径；产品令牌 glob 较宽，原理图 / Pinmux 等建议人工核对后再确认绑定。