Analysis topology from cuts
plan_film_analysisFREE deterministic. Turn shot-cut timestamps into the analysis topology every Film Protocol agent shares: numbered base shots (shot-000001), long-take windowing (shot-000017-w01of03 when a shot exceeds the profile cap), and greedy analysis units (≤20s / ≤8 shots per unit by default). Pass duration_sec + the cut timestamps you detected locally (e.g. ffmpeg scene filter, threshold 0.30 — see get_film_contract section="media_recipe"); you get back windows and units carrying both source-relative and clip-relative times to cut your analysis clips and label your observations with. No ffmpeg commands are returned (execution is your platform's business). 免费:切镜时间点 → 统一分析拓扑(长镜开窗 + ≤20s/≤8 镜单元)。
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"duration_sec": "<duration_sec>",
"cut_timestamps": "<cut_timestamps>"
},
"name": "plan_film_analysis"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| duration_sec | Yes | Total duration of the film/video in seconds | |
| cut_timestamps | Yes | Shot-cut timestamps in seconds (ascending; 0 and duration are implied) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| tool | No | ||
| state | No | ||
| reason | No | ||
| message | No | ||
| recovery | No | ||
| topology | No | ||
| conflicts | No | ||
| windowing | No | ||
| request_id | No | ||
| diagnostics | No | ||
| contract_version | No | ||
| analysis_profile_version | No |