diff --git a/README.md b/README.md index c26ffcc..954589a 100644 --- a/README.md +++ b/README.md @@ -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