77 lines
2.7 KiB
Markdown
77 lines
2.7 KiB
Markdown
|
---
|
|||
|
|
title: 车辆旧伤检测 Skill
|
|||
|
|
created: 2026-05-07
|
|||
|
|
updated: 2026-05-07
|
|||
|
|
type: entity
|
|||
|
|
tags: [skill, agent, backend]
|
|||
|
|
sources: [packages/backend/skills/vehicle-damage-inspection/, packages/backend/test/skill_process_events.test.ts, docs/superpowers/plans/2026-05-06-tool-process-events.md]
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 车辆旧伤检测 Skill
|
|||
|
|
|
|||
|
|
`vehicle-damage-inspection` 是 2026-05-07 从 RZYX 迁入的多模态 compute-entry Skill，用于汽车环车视频旧伤检测。用户上传车辆环车视频并要求检查划痕、凹陷、掉漆、裂纹、锈蚀时，Agent 应通过 [[skill-runtime]] 的 `execute_skill` 调用它，而不是直接用图片识别工具分析整段视频。
|
|||
|
|
|
|||
|
|
## Skill 结构
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
packages/backend/skills/vehicle-damage-inspection/
|
|||
|
|
├── SKILL.md
|
|||
|
|
├── README.md
|
|||
|
|
├── skill.config.yaml
|
|||
|
|
├── prompts/
|
|||
|
|
│ ├── best_frame.md
|
|||
|
|
│ ├── damage_detect.md
|
|||
|
|
│ ├── damage_review.md
|
|||
|
|
│ └── grounding.md
|
|||
|
|
└── scripts/
|
|||
|
|
├── index.cjs
|
|||
|
|
└── lib/
|
|||
|
|
├── frame_extractor.cjs
|
|||
|
|
├── damage_detector.cjs
|
|||
|
|
├── damage_grounding.cjs
|
|||
|
|
├── damage_reviewer.cjs
|
|||
|
|
├── best_frame_selector.cjs
|
|||
|
|
├── image_marker.cjs
|
|||
|
|
├── json_utils.cjs
|
|||
|
|
├── vision_client.cjs
|
|||
|
|
└── workspace.cjs
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 输入与输出
|
|||
|
|
|
|||
|
|
主要输入：
|
|||
|
|
|
|||
|
|
- `videoUrl`：本地路径、`/upload/...` 或本机可访问 URL。
|
|||
|
|
- `fps`、`quality`、`batchSize`、`concurrency`：抽帧和检测吞吐控制。
|
|||
|
|
- `groundingWindow`、`groundingFrameLimit`：候选旧伤定位窗口。
|
|||
|
|
- `reviewConcurrency`、`topN`：复核和最佳证据帧数量。
|
|||
|
|
- `mode`：`full`、`frames-only`、`detect-only`。
|
|||
|
|
|
|||
|
|
输出包含 `summary`、`vehicleInfo`、`damages`、`bestFrameImages`、`reviewImages` 和 `artifacts`。最终产物写入 dataDir 下的 `workspace/vehicle-damage-inspection/{taskId}`。
|
|||
|
|
|
|||
|
|
## 执行流程
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
execute_skill(vehicle-damage-inspection)
|
|||
|
|
-> 抽帧
|
|||
|
|
-> 旧伤候选检测
|
|||
|
|
-> grounding 定位标注
|
|||
|
|
-> 不确定区域裁剪/放大复核
|
|||
|
|
-> 选择最佳证据帧
|
|||
|
|
-> 输出 damages / bestFrameImages / reviewImages
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Skill 明确区分 `damages` 和 `candidates`：`damages` 是最终旧伤结论，`candidates` 只是中间候选，不应直接呈现为结论。
|
|||
|
|
|
|||
|
|
## 过程事件
|
|||
|
|
|
|||
|
|
该 Skill 迁入时同步接入了 [[runtime-process-events]]。长耗时阶段会通过 process events 暴露抽帧、检测、定位、复核等阶段进度，前端可用 `tool-process-timeline.vue` 展示，而不需要只等最终 JSON。
|
|||
|
|
|
|||
|
|
## 相关页面
|
|||
|
|
|
|||
|
|
- [[skill-system]]
|
|||
|
|
- [[skill-runtime]]
|
|||
|
|
- [[runtime-process-events]]
|
|||
|
|
- [[frontend-architecture]]
|
|||
|
|
- [[tool-system]]
|