diff --git a/README.md b/README.md index a867fe7..a41e3be 100644 --- a/README.md +++ b/README.md @@ -465,6 +465,7 @@ The API also exposes authenticated management endpoints used by the plugin and s - `GET /api/caption/status` — report routing/caption/model/frame/sync progress. - `POST /api/caption/pause` — cooperatively pause routing/captioning at the next safe boundary. - `POST /api/caption/resume` — continue the same in-memory caption job. +- `POST /api/caption/stop` — cooperatively stop at the next safe boundary while keeping captions already saved in SQLite. Only one indexing job can run at a time. Search requests return a temporary 503 while that job owns the shared embedding model. @@ -527,7 +528,7 @@ Library removal is targeted. **Apply selection only** (or saving the plugin sett Use **Apply library selection / index** to apply the same authoritative set and start a backend indexing job. An empty selection is allowed only after an explicit confirmation and removes all Jellyfin-backed Scene Search data. The plugin shows an overall percentage/progress bar across all selected libraries as well as the current library, item and frame progress, and polls until the job completes. When ingestion finishes, the backend automatically rebuilds Meilisearch, so newly indexed vectors are searchable without a separate `sync-meili` command. The completed summary also exposes drill-down buttons for **Failed**, **Removed** and **Indexed** items. Those details are written to `data/last-index-report.json`, are paged on demand instead of being included in the 2-second status polling payload, and survive a dashboard refresh or container restart. Unchanged items are counted but intentionally not persisted individually because large libraries can contain tens of thousands of them. -The same page also has **Start / resume captioning** and **Pause**. Pause finishes the currently active routing batch or Ollama frame request, then waits before starting the next unit; Resume continues the same in-memory job without rebuilding its queues. Every successful caption is committed immediately, so a process/container interruption can still be recovered by pressing Start / resume and continuing from uncaptained frames. **Force recaption existing frames** deliberately regenerates captions, but reuses saved routing decisions while the routing policy is still current. +The caption control is stateful: **Start / resume captioning** becomes **Pause** while work is active and **Resume** when paused or a pause is pending. A separate **Stop** button cooperatively ends the job at the next safe boundary. If Ollama is already processing a frame, that frame finishes and is saved first; stopping a paused job wakes it only long enough to terminate. Every successful caption is committed immediately, so Start / resume later continues from the remaining uncaptained frames. Stop deliberately does not begin the expensive final Meilisearch rebuild; the saved captions are incorporated when a later caption run completes. **Force recaption existing frames** deliberately regenerates captions, but reuses saved routing decisions while the routing policy is still current. Captioning first runs the local routing classifier, then sends frames to the configured general or specialist Ollama model. Search is blocked only while the local routing GPU is in use and while Meilisearch is rebuilt; it remains available during the long remote Ollama caption phase.