dsh-notebook-studio

Usage

The workbench opens from NotebookStudio above "Plugins" in the dsh sidebar: library on the left, editor / PDF preview in the middle, authoring settings on the right, models and APIs in the gear settings. "Back to chat" returns to the session without switching it.

1. Select a dsh session, then click NotebookStudio; with no session you are asked to pick or create one. To switch projects, choose another session in the host sidebar.
2. Add papers from the library (multiple files or a folder; non-PDFs are skipped). Up to 30 per project, each non-empty and strictly under 30,000,000 bytes (30 MB), deduplicated by content hash; scans are not OCR'd. Leaving the workbench cancels unfinished uploads, while indexed papers and running tasks continue.
3. In "Model settings" choose a loaded dsh text model (DeepSeek Flash by default) or enter a standalone API's Base URL, model and key. The image model is off by default; when enabled it needs an endpoint compatible with /v1/images/generations (leave the key empty for a local Qwen). One image waits 600 s by default, configurable to 30–1800 s.
4. Once papers show "indexed", tick the ones this run uses and write the goal. "Add web search references" sends prompt keywords only, never PDF text; web sources are listed as [Wn] with URL and time and never count as [n] PDF p.x paper evidence.
5. Choose DOCX or PDF and click "Generate full report", or PPTX or PDF and click "Generate full deck". A deck builds a cited outline first, then drafts every page from PDF excerpts (conclusion, argument, speaker notes) and typesets; the outline can be generated, edited and saved before building.
6. Illustrations follow the body: 0–2 per report section, one main visual per deck page — figures for results, flowcharts for mechanisms, tables for comparisons, AI illustrations for abstract concepts. Generation is serial, and a failure falls back to that section's or page's flowchart instead of passing it off as a paper result.
7. "Preview document" shows the PDF, "Export" downloads the chosen format, and "Files and sources" lists real paths and provenance. Deliverables land in notebook-studio/// inside the current session workspace; re-typesetting writes a new directory and never overwrites an edited copy.
8. "Open body editor" edits titles, summaries, paragraphs, table findings and per-page text; "Save and re-typeset" applies them without a text-model rewrite and rejects changes to citation IDs or asset sources, so edited conclusions still need manual evidence checking.
9. Within one browser page, leaving and re-entering NotebookStudio keeps this session's prompt, paper selection and drafts; sessions stay isolated, and unsaved drafts are lost on refresh.
10. Use studio_search in Chat for Q&A; answers carry evidence IDs, paper names and PDF pages. The left column also searches evidence, lists task records and retries failed papers.

Host compatibility

The plugin uses public host slots only (sidebar.panellist, main, the session-maybe sub-slot, layout.selectPanel(null)), with no private routes, core-layout changes or simulated clicks. Verified on dsh 0.1.7-rc.2: npm run check, profile composition, and host-side mounting in a running dsh web.