Explain specialist video summaries, model overrides and safe regeneration

This commit is contained in:
Sleeps
2026-10-08 16:18:26 +01:00
parent 8eb65309c0
commit cd8413a4d4
+34 -6
View File
@@ -657,6 +657,8 @@ a short, natural-language description and append it to Jellyfin's **Overview**
metadata field. It uses **one text-only Ollama chat request** with up to 64
time-spaced caption segments from throughout the video — **no extra Trickplay
downloads, image captioning, visual embeddings, or Meilisearch indexing**.
The input now reserves space for each selected time segment rather than silently
dropping the later scenes when captions are long.
It is a **visual description**, not a reliable official movie synopsis:
frames can be ambiguous, it may contain spoilers, and the model may still make
mistakes.
@@ -688,12 +690,38 @@ overwrite later manual edits to Jellyfin's Overview. If a title is duplicated
(e.g. two editions of a film), use `--media-id` instead.
To generate a new draft after caption coverage improves, use `--regenerate`
before publishing; if already published, `--restore` first. Generated drafts
are cached so a normal preview reuses the same wording unless the sampled
captions change. Set `OVERVIEW_MODEL` to a suitable **text** Ollama model if
you don't want to use your existing general caption model, and optionally
increase `OVERVIEW_TIMEOUT_SECONDS`. The Ollama model must be accessible from
the same container that already performs captioning.
before publishing; if already published, `--restore` first. Drafts are
cached by caption evidence **and** summary style/model/prompt version, so a
new specialist style automatically regenerates outdated drafts without
requiring extra captioning.
For videos with a substantial share of captions routed through the specialist
captioner, `jellyfin-overview` automatically uses a dedicated **neutral,
non-graphic but concrete** summarisation prompt. It describes the broad
visible adult context and setting instead of obscuring them with vague
euphemisms, while avoiding invented events and graphic details. The command
prints the automatically selected style and the routing counts. You can
force the specialist style when routing metadata is incomplete:
```bash
docker compose exec -T scene-search python -m scene_search.cli \
jellyfin-overview --title "Exact Film Title" --style specialist --regenerate
```
If the video's current AI Overview is **already published**, run `--restore`
first (which preserves your original synopsis), then preview again and
`--apply` only after reviewing the new draft. You can also use
`--style general` for a mixed film where automatic detection chooses poorly.
Set `OVERVIEW_MODEL` to a suitable **text** Ollama model if you don't
want to use your existing general caption model. Optionally set
`OVERVIEW_SPECIALIST_MODEL` to another **text-capable** model specifically
for sensitive/adult caption summaries; when empty, the general Overview
model is reused with the specialist summarisation prompt. Avoid assuming
that the image-captioning specialist model itself is necessarily good at
text-only summaries. `--model` overrides either choice for a one-off
preview. `OVERVIEW_TIMEOUT_SECONDS` controls the HTTP timeout. Both
models must be accessible from the scene-search container.
This edits **Jellyfin's metadata record, not the video file**; Jellyfin
metadata-refresh providers may change the field again unless it is protected