更新日志
Plumshot 的每一次更新，逐版本记录。
发布说明目前以英文撰写。
Added
- Licenses for 2 or 5 Macs. Besides the single-Mac license ($9.90), one key can now be activated on up to 2 Macs ($14.90) or 5 Macs ($29.90) at a time. Settings › License lists all three. When a key is already active on every Mac it covers, Plumshot tells you how to free one instead of showing the license server's error.
Changed
- The first Capture Text or Auto Redact after installing Plumshot or updating macOS no longer waits up to a minute: shortly after launch, Plumshot prepares macOS's text recognition in the background, once per macOS version. If recognition still takes more than 2 seconds, the OCR Result window opens right away and says it is recognizing text.
- For AI agents: the command-line tools and the MCP server now support the 2026-07-28 MCP protocol, report errors with fixed codes and hints, and add
manifest and describe commands. capture-text prints a notice when recognition is slow.
Fixed
- In the annotation editor, selection handles that reach past the edge of the image can be grabbed again, and clicking the area around the image deselects and ends text editing.
Added
- Plumshot is now available in Traditional Chinese, using the same terms as macOS itself (螢幕錄影, 檔案, 儲存). Macs set to Chinese for Taiwan, Hong Kong or Macau get it automatically, permission prompts included.
- The annotation editor has a Copy button, and ⌘C copies the annotated picture. While you are typing a text label, ⌘C still copies the selected text.
- Auto Redact in the annotation editor: with the Pixelate tool selected, one click finds email addresses, links, phone numbers and faces in the screenshot and covers each with the current obscure style. The new redactions arrive selected, so you can delete a false positive, and a single Undo takes them all back. The first check after installing or updating can take a minute or more while macOS prepares its text recognition.
- Annotations stay editable. When you press Done on a screenshot that is in Capture History, whether you annotated it right after capturing, from its Quick Access thumbnail or from the History window, Plumshot keeps your annotations. Open it again from Capture History or with the Annotate button on the thumbnail that comes back, and its arrows, lines, shapes, highlights, numbers, text, freehand strokes, crop and background return as objects you can move, restyle or delete; number markers carry on from the highest one. Pixelate, blur and black-out are applied for good when you press Done, together with anything you drew underneath them, so neither the original under a redaction nor what you covered is kept. A screenshot stays editable as long as Capture History keeps its full-size image: your 10 most recent captures, plus pinned and Quick Access items. Copy, Save, drag and share always give the finished picture. A capture taken while Capture History is off or paused isn't added to it, so its edits live only in the thumbnail that comes back, as before.
Changed
- Plumshot now picks its language the way other Mac apps do, from the order in System Settings › General › Language & Region: whichever of English, Simplified Chinese and Traditional Chinese comes first (Cantonese gets the Chinese written in the same script), or English otherwise. On an English Mac that means everything is in English, including the permission prompts and the system panels Plumshot opens (Save, Open, the shortcut recorder), which used to appear in Chinese. A Mac that lists English above Chinese now gets English where it used to get Simplified Chinese.
- Freehand strokes in the annotation editor are drawn as smooth curves. A fast stroke used to show as a chain of short straight segments; it is now smoothed the way Apple's PencilKit smooths ink, keeping the line width you picked.
Fixed
- In English, the All-in-One capture bar and the Crop panel's aspect-ratio presets no longer cut off their labels, the selection size fields read "W" and "H", and counts read naturally ("1 day left", "1 second").
- Annotation tools can now be switched with VoiceOver and Full Keyboard Access. Choosing a tool in the editor's toolbar without the mouse used to highlight it while the canvas kept drawing with the previous tool.
- The Blur background no longer gives away what you redacted. It used to be made from the original screenshot, so text you had pixelated, blurred or blacked out could show through, enlarged and blurred, in the margin around the image. The background is now a blurred copy of the image as it appears in the frame, with your redactions and other annotations in place, both in the editor and in what you save, copy or share. The Blur card's thumbnail in the Background panel follows your redactions too.
- Pixelate and blur no longer let the original show through. A box that touched the edge of the screenshot could leave a thin strip of the original untouched along that edge, and on a window capture, content next to the window's transparent shadow or rounded corners stayed partly readable under the blur. Redactions now cover their whole box with solid pixels, and if a mosaic can't be rendered the box is blacked out instead of lightly tinted.
- Done in the annotation editor (and Save in its "Save changes before closing?" prompt) no longer throws your annotations away when the image did not come straight from a capture. A screenshot opened from Capture History, or from a Quick Access thumbnail that came back after a restart or was added by a link, is updated in your history with the annotations (the thumbnail comes back too); a file opened with
plumshot://open-annotate is saved back to that file, or Plumshot asks where to save it if it can't; an image opened from the clipboard is copied back to the clipboard. - Opening another image while the annotation editor has unsaved annotations no longer discards them silently. Plumshot asks whether to save them first, discard them, or keep editing. A minimized editor is brought back instead of a second one opening.
- A pin you made from Capture History or from a Quick Access thumbnail, and an open Quick Access thumbnail, now show the annotated picture after you press Done in the editor, instead of the picture from before your edits.
- A Quick Access thumbnail stays on screen until the editor actually opens its screenshot, so choosing Cancel when the editor asks about unsaved changes no longer makes it disappear.
- Pausing Capture History while you annotate a screenshot it already holds no longer leaves the unannotated original in your history; Done saves the annotated picture into it.
Fixed
- Activating a license in 1.3.0 always failed with "Purchases are not configured yet", whether the key was new or moved from another Mac. Activation works again; Macs that were already licensed were never affected.
- Plumshot now re-checks its license in the background as you use it, at most about once a day. Before, it checked only at launch, so a Mac that kept Plumshot running for more than two weeks was suddenly asked to verify its license.
Added
- The annotation editor gains a sidebar with a Layers panel and a Crop panel. Layers lists every mark, top-most first: click a row to select it on the canvas, drag to reorder, hide it with the eye (a hidden mark is not drawn, exported or hit), bring it forward or send it back from the context menu, and press Delete to remove it. Crop offers aspect presets (free, original, 1:1, 4:3, 3:2, 16:9, 9:16, 4:5) and common pixel sizes, with corner and edge handles, rule-of-thirds guides and a live size readout; it is non-destructive, undoable with ⌘Z, and Copy, Save As and Done export the cropped picture.
- The annotation editor gains a Background panel in its sidebar. Put the screenshot on a solid color, a gradient, an image of your own, or a blurred copy of the screenshot itself, then set the padding around it, its corner radius and its drop shadow. While a background is on, the whole framed picture is scaled to fit the window and follows it when resized, with no scrolling. The result is what Copy, Save As and Done export; every change is undoable with ⌘Z. Gradient, color, image and blur cards all sit in one scrolling panel, so switching is a single click, and a switch in the panel header turns the background off and back on. Every section of the sidebar panels can be collapsed from its header; the app remembers which ones you folded away.
- Settings › Screenshots gains Freeze screen when taking a screenshot, on by default. All-in-One now takes its picture the moment it opens: the screen holds still under the selection overlay and the capture is cut from that frozen frame, so hover states, animations and fast-moving content can be framed at leisure. Capture Area uses the macOS selector and is unaffected.
Changed
- The annotation editor's toolbar no longer carries Undo and Redo buttons; use ⌘Z and ⇧⌘Z instead. Save As and Done now sit as two separate buttons rather than one grouped control.
Fixed
- The annotation editor's style controls lost their text on recent macOS releases: the obscure-type and size menus showed a bare chevron with no wording, and a screen reader announced the obscure menu as "chevron.pulldown". Both now read out their current setting again, e.g. "Mosaic" and "Size: 28".
Changed
- Every on-screen capture control bar now shares one look. The recording bar, the scrolling-capture bar, the scrolling-capture selection bar and the countdown HUD are rebuilt on the All-in-One capture toolbar's dark glass, with the same buttons, spacing and type. The recording bar in particular no longer turns into a pale grey strip in Light Mode, and selecting a region for a scrolling capture now offers the same width / height fields as the other selections instead of a lone Start button.
- The buttons on a pinned screenshot now use that same dark glass.
- The annotation editor now sets the screenshot on a softly textured backdrop with a hairline border and a light shadow, so a pale screenshot no longer melts into the editor background. The border and shadow stay one pixel thin at every zoom level.
- A selected text annotation now carries the same handles as every other shape: four corner handles that scale the whole text, and left / right edges you can drag to change where it wraps. Editing text no longer switches to a different dashed outline — typing simply puts a caret inside the same selection you were already looking at.
Fixed
- Fixed the first click on the recording and scrolling control bars doing nothing when Plumshot was not the frontmost app; the buttons also highlight on hover now.
- Fixed the square corners on the "Drag to capture an area" hint bubble.
- Fixed the screenshot drifting off-centre after zooming out in the annotation editor: it is centred again whenever the whole image fits in the window.
- Fixed text appearing to jump the moment you double-click it: the selection handles used to sit on top of the first and last character, which clipped a corner off each of them until editing started.
- Fixed a stale outline being left behind around a text annotation you had just started typing into, and the handles vanishing while you typed.
- Fixed the font size in the toolbar not following along while you scale a text annotation by its corner handle.
Added
- Duplicate annotations while editing: hold Option and drag a shape, arrow, text or marker to leave the original in place and drag off a copy — press or release Option mid-drag to switch between moving and copying. ⌘D duplicates the selection in place. Duplicated number markers continue the sequence instead of repeating the same digit.
Changed
- Text annotations are edited in place now, in the font, size and colour they will actually have. The box grows as you type and takes multiple lines. Clicking empty canvas commits and exits, Esc commits and leaves the annotation selected, Return starts a new line, and double-clicking existing text puts the caret where you clicked.
Fixed
- Fixed several ways text annotations went wrong: clicking away left a trail of empty boxes, double-clicking replaced the box it had just opened, switching tools mid-edit silently dropped what you had typed, ⌘Z with the box open copied the text into a second annotation, and Esc did nothing.
- Fixed the keyboard going dead after finishing a text annotation — Esc, Delete and the tool shortcuts now work without clicking the canvas first.
- The annotation editor no longer paints annotations onto the area around the image. Whatever you drag past the edge is now cut off on screen exactly the way it is cut off when you save or copy, so what you see is what you export.
Fixed
- License keys from the store can now be activated: the app is wired to the production store, so "Purchases are not configured yet" is gone.
Added
- The menu bar menu and Settings → About now show a badge when an update is ready, so you notice new versions without checking manually.
- Haptic feedback when a selection lands or you drag a capture out of Quick Access (Settings → General to turn it off).
- The auto-scroll setting now shows Accessibility permission status live — it flips the moment you grant access in System Settings, no relaunch needed.
Changed
- Settings sidebar is grouped into sections (Preferences / Screen Capture / Data / Application) for quicker scanning.
- Capturing a screenshot no longer switches focus away from the app you are working in when the Quick Access thumbnail appears.
- The recording preview now reliably comes to the front when a recording ends, instead of occasionally appearing behind whatever app you were recording.
- Pinned screenshots and Quick Access thumbnails now move back onto a connected display when a monitor is unplugged or the resolution changes.
- "Capture Previous Area" now remembers the region relative to its display, so it still points at the right spot after you rearrange monitors. On multi- display setups, clicks and captures near screen edges land on the correct display more reliably.
- Capture failures now show clear, specific messages (permission missing, no display available) instead of raw system errors, and transient glitches are retried once automatically.
- Launching Plumshot while it is already running now hands off cleanly to the new instance — no more duplicate menu bar icons after an update.
plumshot://capture-text with a region now behaves like every other capture: it waits its turn if a capture is already running, lands in capture history, and counts toward the trial. It previously took a private shortcut past all three.plumshot://scrolling-capture?autoscroll=0 now really turns auto-scroll off for that capture (the parameter was read and then dropped).plumshot capture-scrolling now returns as soon as the page stops growing instead of always running out the clock. --max-seconds stays the hard cap; the new --idle-seconds (default 3) is how long it waits for new content before wrapping up. With --no-auto-scroll it previously always ran the full duration, because "reached the end" was only ever reported by the auto-scroller.- A single bad frame no longer aborts a headless scrolling capture; it is skipped and the capture continues, matching the on-screen one.
- A region that falls outside the target display is now clamped into it by the CLI too, matching what
plumshot:// links already did, instead of being handed to the capture engine as-is. plumshot://all-in-one no longer accepts x/y/width/height, plumshot://record-screen no longer accepts a region, and plumshot://scrolling-capture no longer accepts start=. All three were parsed and then ignored — the selection overlay decides the area in each case.- Pinned screenshots now survive quitting and relaunching — they reappear where you left them. A new "Restore Recently Closed" menu item (and
plumshot://restore-recently-closed) brings back the last pin you closed. - Desktop-icon control via URL scheme:
plumshot://hide-desktop-icons, show-desktop-icons, and toggle-desktop-icons clean up the desktop before a capture (restarts Finder to apply). - Self-timer via URL scheme:
plumshot://self-timer?x=…&y=…&width=…&height=…&seconds=N runs the countdown HUD, then captures the region (was previously a no-op; also fixes the all-in-one timer action, which never resumed after the countdown). plumshot capture-previous-region and the capture_previous_region MCP tool: repeat the last region captured (shared with the app's "capture previous area"), so agents can iterate on the same panel without re-passing coordinates.plumshot capture-text and the capture_text MCP tool: extract text from a screen region, an app window, or an image file via on-device OCR — agents get the words directly instead of shipping pixels to a vision model.- Pick a display by its stable identifier instead of a position-dependent index:
--display-id on the CLI, display_id on the MCP tools, and display-id= in plumshot:// links. The value is the displayID field plumshot list-targets already prints, so it keeps pointing at the same monitor after you rearrange them. The old --display / display= index still works. action=ocr now works on the plumshot:// capture commands (e.g. plumshot://capture-area?x=…&action=ocr), extracting the text instead of leaving an image. It was accepted and silently ignored before.- New "Confirm actions from links" setting (off by default): when enabled, captures or recordings triggered via
plumshot:// links ask for confirmation first. - The CLI can be confined to a directory by setting
PLUMSHOT_SANDBOX_ROOT; paths outside it are rejected (off by default, nothing changes unless set).
Fixed
- Fixed copied screenshots not pasting into some apps: the clipboard now carries PNG (what most apps expect), not just a large uncompressed TIFF.
- Fixed the Copy and Save buttons on the capture preview sometimes doing nothing when clicked.
- Fixed an empty "No Screenshot Selected" annotation window occasionally opening on its own.
- Fixed
plumshot:// links not opening the app in some configurations. - Fixed Undo in the annotation editor removing the wrong annotation after deleting an older text annotation or a multi-selection.
- Fixed Undo skipping two kinds of edit entirely: rewriting an existing text annotation's content, and typing a new number on a selected marker. Both recorded nothing, so Cmd-Z after either one undid an unrelated earlier edit. Typing a multi-digit marker number is one undo step.
- Exported annotations are now guaranteed to sit where the editor showed them. The editor and the exporter each worked out the image's placement separately and only agreed because the canvas happens to be laid out at the image's aspect ratio; they now share one value. Mosaic and blur regions are mapped through the same rect, so a redaction can't land on the wrong pixels.
- Fixed rapid captures silently overwriting each other when saved within the same second.
- Fixed capture history keeping a "Pinned" badge on items whose pin no longer exists — e.g. after a crash between the two saves. Launch now reconciles the two against each other.
- Fixed a pin that fails to save leaving a window on screen that quietly disappears on the next launch; the failure is now reported and cleaned up.
- Fixed deleting or clearing capture history leaving its pinned windows behind with nothing left to manage them.
plumshot://capture-text?filepath=… on a file it can't open now says so, instead of reporting it as an OCR failure.- Fixed window detection under the cursor picking the wrong window in multi-display setups (scrolling capture and window recording).
- Fixed captures and recordings triggered via
plumshot:// links starting while another capture was already in progress: links now follow the same one-at-a-time rule as the menu and keyboard shortcuts. plumshot:// region parameters (x/y/width/height) now use the same top-left-pixel convention as the CLI's --rect, so the same numbers target the same screen region on every agent surface (they were previously interpreted bottom-left in points).
Improved
- Smoother annotation editing: dragging and resizing annotations now redraws only the affected region.
- Clearer CLI errors,
--flag=value argument support, and output directories are created automatically. - Faster localized-text lookups across the settings and menu UI.
First public release.
Added
- Capture full screen, a single window, a selected area, or scrolling content taller than the display.
- All-in-One capture and "capture previous area" for fast repeats.
- Built-in annotation — arrows, rectangles, circles, freehand, text, and highlights — applied the moment you capture.
- Extract text from any screenshot with OCR and copy it to the clipboard.
- Screen recording with optional microphone audio, plus a video editor.
- Global keyboard shortcuts for every capture mode.
- Floating thumbnail and Quick Access previews after each capture.
- Self-timer, capture presets, and configurable default image format.
- First-launch setup guide.
Plumshot