feat: add step instructions to ingest, greyscale always, OCR progress indicator

smoke_signal_tab.py

@@ -2075,20 +2075,13 @@ def run_ocr(page_selection: str = "", page_exclusion: str = "", replace_book_que
                     else:
                         page = doc[page_num - 1]
                         render_start = time.time()
-                        if surya is None:
-                            pix = page.get_pixmap(
-                                dpi=render_dpi,
-                                alpha=False,
-                                annots=False,
-                                colorspace=fitz.csGRAY,
-                            )
-                        else:
-                            pix = page.get_pixmap(
-                                dpi=render_dpi,
-                                alpha=False,
-                                annots=False,
-                                colorspace=fitz.csRGB,
-                            )
+                        # Always render greyscale — better OCR, consistent review display
+                        pix = page.get_pixmap(
+                            dpi=render_dpi,
+                            alpha=False,
+                            annots=False,
+                            colorspace=fitz.csGRAY,
+                        )
                         render_dir = RENDERS_DIR / book_id
                         render_dir.mkdir(exist_ok=True)
                         render_path = render_dir / f"{book_id}_page_{page_num:04d}_{render_dpi}dpi.png"
@@ -2722,6 +2715,13 @@ def smoke_signal_tab():
                     <div class="ss-panel-icon">📥</div>
                     <div><p class="ss-panel-title">Source Registry</p>
                     <p class="ss-panel-sub">Upload PDFs · Register · Auto-profile · Rights class</p></div>
+                </div>
+                <div style="background:#1a2535;border:1px solid #30363d;border-radius:8px;padding:14px 18px;margin:12px 0;font-size:13px;color:#8b949e;line-height:2.0">
+                    <b style="color:#e6edf3">&#9654; How to run OCR — follow this order:</b><br>
+                    <span style="color:#3fb950">1.</span> Drop your PDF &nbsp;·&nbsp; set <b style="color:#e6edf3">Rights Class</b> &nbsp;·&nbsp; enter <b style="color:#e6edf3">Book Code</b> + <b style="color:#e6edf3">Year</b> &nbsp;·&nbsp; click <b style="color:#f0883e">Register + Auto-Profile</b><br>
+                    <span style="color:#3fb950">2.</span> Enter <b style="color:#e6edf3">Story Pages Include</b> (e.g. 7-27) and <b style="color:#e6edf3">Story Pages Exclude</b> (e.g. 1,2,3) &nbsp;·&nbsp; click <b style="color:#f0883e">Save Book Pages</b><br>
+                    <span style="color:#3fb950">3.</span> Go to tab <b style="color:#e6edf3">③ OCR</b> &nbsp;·&nbsp; click <b style="color:#f0883e">Run OCR</b> &nbsp;·&nbsp; wait for the log to complete (may take 1-2 min)<br>
+                    <span style="color:#3fb950">4.</span> Go to tab <b style="color:#e6edf3">④ Review</b> &nbsp;·&nbsp; click <b style="color:#f0883e">↻ Load Review Queue</b> &nbsp;·&nbsp; accept / edit / reject pages
                 </div>""")
 
                 ingest_status = gr.HTML(_ingest_status_html("idle"))
@@ -2891,7 +2891,7 @@ def smoke_signal_tab():
                     label="Replace existing review queue entries for processed books",
                     value=True,
                 )
-                ocr_btn = gr.Button("Run OCR →", elem_classes=["ss-btn-run"])
+                ocr_btn = gr.Button("Run OCR →", elem_classes=["ss-btn-run"], interactive=True)
                 ocr_log = gr.Textbox(label="Log", lines=10, interactive=False, elem_classes=["ss-log"])
                 ocr_copy_log_btn = gr.Button("Copy Log", size="sm")
                 ocr_copy_log_btn.click(
@@ -2905,7 +2905,7 @@ def smoke_signal_tab():
                     run_ocr,
                     inputs=[ocr_page_selection, ocr_page_exclusion, ocr_replace_queue],
                     outputs=[ocr_status, ocr_log],
-                    show_progress="hidden",
+                    show_progress="minimal",
                     trigger_mode="once",
                 )
                 ocr_tab.select(