Skip to content

PaperFlow v0.4.0

Choose a tag to compare

@06-month 06-month released this 11 Jun 01:18
· 10 commits to main since this release

PaperFlow v0.4.0

PaperFlow v0.4.0 focuses on making the Zotero Reader sidebar more useful as a paper-context-aware AI workspace.

This release introduces chat attachments, better translation recovery, safer intermediate storage, improved reliability for long Korean translations, and a more secure Gemini API request path.


Highlights

Chat attachments

PaperFlow chat now supports richer context input.

  • Drag-selected text from PDF, Summary, or Translation views is automatically attached to the chat composer.
  • Attached text keeps its source label, such as PDF Original, Summary, or Translation.
  • The + button opens the file picker for attaching images, PDFs, and text files.
  • Clipboard image paste with ⌘V is supported.
  • Pasted images are shown as thumbnails before sending.
  • Multiple images are displayed horizontally.
  • Sent images are rendered inline inside the chat bubble.
  • Selection attachments are automatically removed when the selection is cleared.

Translation UX improvements

Long translations are now easier to manage.

  • The translation progress dialog now has a close button.
  • Closing the dialog does not stop translation; the job continues in the background.
  • Interrupted translations can be resumed.
  • Completed chunks are reused instead of being translated again.

Reliability improvements

This release significantly improves translation robustness.

  • Translation results are saved section by section.
  • Completed chunks are preserved even if the job is cancelled or fails.
  • pt-meta.json is now treated as the single source of truth for translated text.
  • HTML output is treated as a derived view.
  • Truncated responses, safety blocks, and empty model responses are detected before saving.
  • Broken JSON results are prevented from being stored.
  • Chunk size was reduced from 2000 to 1500 tokens.
  • maxOutputTokens was increased from 4096 to 8192 to reduce Korean translation truncation.
  • Daily rate-limit counters now persist across Zotero restarts.
  • Quota reset timing is aligned with Google quota reset behavior.
  • Non-retryable errors, such as safety blocks and output truncation, now fail immediately instead of consuming all retry attempts.

Security

  • Gemini API keys are now sent through the x-goog-api-key header instead of URL query parameters.

Other changes

  • Removed the initial chat greeting bubble.
  • Fixed a bug where the sidebar panel order could reset on every Zotero startup.
  • Prevented custom element conflicts after plugin updates by using versioned element names.
  • Centralized model names and version values in constants.js.

Why this release matters

PaperFlow v0.4.0 moves the project closer to a Zotero-native AI reading workflow.

Instead of only generating summaries or translations, PaperFlow can now accept selected paper text, files, and clipboard images as chat context. Translation jobs are also more resilient, resumable, and less likely to lose completed work.

This makes PaperFlow more practical for deep reading, translation review, figure discussion, and paper-specific follow-up questions inside Zotero Reader.