# aishipbox Agent 使用说明

这是昇腾 / ModelArts 技能目录。所有以 / 开始的 URL 均相对于当前服务的 origin 解析；不要把相对路径拼接到 /agents/ 下。先读取 /registry/v1/index.json，再读取选定技能的 record。目录无需执行 JavaScript。

1. 确认用户任务、目标环境和已有本地技能。只选择适用的技能。
2. 固定 record 中的 id 与 version，检查 requirements 和 verification。归档校验不代表硬件行为已验证。
3. artifacts 包含 ZIP、sha256、size_bytes、文件列表和 GitHub 来源地址。另读取 record.distribution 的镜像目录，以 id、version、sha256 三项匹配同一包；优先使用该目录中的地址，最后回退到 artifacts.urls。镜像目录可以更新，版本记录保持不变。按顺序尝试同一 artifact 的地址；每个地址最多一次，建议超时 20 秒。失败后不要切换版本或忽略校验。
4. 下载到临时位置，验证归档 SHA-256 和文件清单，拒绝绝对路径、..、符号链接等不安全成员。保持 SKILL.md、references/、assets/ 相对结构。
5. 根据当前客户端约定安装到用户选择的位置。保留已修改的本地副本，发生冲突时说明情况。不要仅复制 SKILL.md，不直接执行下载脚本。
6. 读取 SKILL.md；按需读取配套文件。先满足前置条件，部署等动作遵循用户授权。
7. relations 中 recommended 为可选关联，next-step 为后续方向。按目标 ID 从目录重新解析确定版本，记录本次所选版本；避免循环读取与重复安装。首版没有 required 依赖。
8. 仅使用镜像目录中已收录的地址，OBS 地址只有经公开下载校验后才加入。生产构建不在网站存放 ZIP；本地预览可提供本地包。全部失败时报告原因，使用已校验的离线包。不要自动更换版本。

核心格式是完整技能目录；客户端安装与真实硬件执行尚未由本站逐项验证。选择训练技能后，仅当需要镜像构建时再获取关联镜像技能；它不是必装依赖。