会议（测试版）¶

Labs > Meetings switch (macOS)                       // meetings.opt-in; off by default
├── Off -> only the Labs switch -> Turn on -> meetings.enabled = true
├── On -> Meetings joins the sidebar; header switch Recordings | Settings;
│   menu-bar items, call detection, Option-Control-V
│   Settings view: Call recording, After a meeting, Calendar, Detected calls, Advanced ▸
│   ├── System Audio Recording                  // meetings.permission; asked only now
│   │   ├── Untrusted row shown / Allow -> retired Hex IDs cleared (`ScreenCapture` + `AudioCapture`)
│   │   ├── Allow -> macOS prompt the first time (tour's permission_control)
│   │   ├── Decided before -> Privacy pane + drag guide ("System Audio Recording Only")
│   │   ├── Asked -> pulse; TCC preflight re-read on each poll, no reopen needed
│   │   ├── Returned from System Settings still untrusted -> "Still grey? Fix it"
│   │   │   (`AudioCapture` reset on running bundle + retired IDs, re-prompt / guide)
│   │   └── Granted -> the Allow pill morphs into a green Allowed; moves to Advanced
│   ├── After a meeting -> Summaries, Keep meetings, Transcript folder
│   │   (~/Documents/Hex Meetings; Reveal / choose; its error shows here)
│   │   └── Summaries pop-up (meetings.summaries; one-time migration
│   │       "meeting-summaries-choice" from the two retired switches)
│   │       ├── Off -> "No titles or summaries"
│   │       ├── On this Mac (default) -> Apple Intelligence only; "Titles and
│   │       │   short summaries, written on this Mac"; never sends anything to
│   │       │   OpenCode, so the old OpenCode fallback is gone
│   │       │   └── Apple Intelligence unavailable -> the option stays chosen
│   │       │       but disabled ("Turn on Apple Intelligence in System
│   │       │       Settings"); the row's line turns amber "Turn on Apple
│   │       │       Intelligence in System Settings to write them on this Mac";
│   │       │       a meeting records notes_error as before
│   │       └── OpenCode -> "Sends the transcript to your OpenCode model";
│   │           Model nests under it: a searchable picker of the running
│   │           OpenCode's models (refreshed each time it opens; no Refresh),
│   │           "Hex picks a fast model" first (clears meetings.opencode_model
│   │           -> the ranked fast models); a pick is used alone, no fallback.
│   │           OpenCode missing or failing -> a notice with Check again /
│   │           Retry, the saved model kept and shown by its ID (#1107, #1301)
│   │       // checks: summaries_are_one_choice_with_opencode_s_model_under_it,
│   │       // on_this_mac_without_apple_intelligence_stays_chosen_with_the_fix
│   │       // (tests/panes.rs); scenes meetings-summaries,
│   │       // meetings-summaries-unavailable, meetings-summary-model
│   ├── Advanced -> Show recording indicator (on by default; corner-snapping
│   │   capsule) and the System Audio Recording row once allowed
│   ├── Calendar -> Connect calendar; reminders before meetings // meetings.calendar
│   └── Detected calls -> Ask / Always record / Never offer per provider // meetings.policy
│       ├── Slack huddles, Zoom, Google Meet, Microsoft Teams, FaceTime, WhatsApp,
│       │   Gather, Discord (always listed)
│       └── then each website or app chosen for from an offer's "…"
└── Off -> Controller idles; no microphone-activity inspection or shortcut;
           the pane leaves the sidebar

Debug builds -> Always in the sidebar (DEVELOPER_FEATURES_ENABLED)
Agents -> hex mcp (read-only MCP server; works whether or not Meetings is on)
Subtitles -> hex meetings show <id> --srt | --vtt   // Labs › Subtitle export, off by default (#633)
             one cue per transcript entry (You / Them), timed by entry offsets,
             not word timings; off -> refused naming hex labs on subtitle-export
             (docs/transcript-cli.md; no export button in the window yet)
Apps -> GET /meetings/events on the local API      // Labs › Meeting finished event, off by default (#964)
        one SSE event per meeting once its final transcript is written:
        {"type":"meeting.finished","id":"<id>"}, nothing else; one subscriber;
        off -> 404 labs-off (docs/streams.md, labs.md)
Recordings list icons                               // always on (#1290; graduated from Labs)
        each row's title gets a small faint icon: Zoom, Google Meet, Teams,
        Slack, or Webex when the meeting's app names it, else a neutral call
        icon (FaceTime, Discord, WhatsApp, manual recordings)
        (platform_icon in rune_ui/meetings.rs; CallProvider::from_meeting_app in
        calendar.rs; check: platform_icons_fall_back_to_a_neutral_one; goldens
        meetings light/dark show Zoom, FaceTime, and the neutral icon)
Live transcript scrolling                           // Labs › Follow live transcript, off by default (#1332)
        on -> while the selected meeting is Starting or Recording (no Stop
        pending), the detail card's scroll sticks to the bottom: new turns
        stay in view; scrolling up stops following, scrolling back to the
        bottom follows again. Finished meetings and off -> scroll by hand as before
        (follows_live_transcript in rune_ui/meetings.rs; not observed on a real call)

System audio                                      // meetings.system-audio
├── Linux -> pw-record of the default output's monitor (stream.capture.sink);
│   the session manager follows a changed default; no pw-record -> recording
│   refuses with "Install PipeWire's pw-record"
└── Windows -> WASAPI loopback of every active output (cpal), mixed into the
    one system track, so a call playing on a headset that isn't the default
    output is recorded (#1221; audio_on_any_output_reaches_the_system_track,
    unverified on a real call); silence while nothing plays is padded on
    resume; a change in the list of outputs reopens it; an output whose
    loopback fails is dropped while the others keep recording
Call detection                                    // meetings.detect
├── Linux -> one pw-dump --monitor: running Stream/Input/Audio nodes that are
│   not monitor captures, by application.process.binary (node or client)
└── Windows -> active IAudioSessionManager2 sessions on every capture device,
    by process image name
    └── executables map to the macOS keys (zoom -> us.zoom.xos, chrome ->
        com.google.Chrome, ms-teams.exe -> com.microsoft.teams2, ...)
Browser calls -> offered as "Call in <browser>": no site is read yet, so a
    call on any website (Teams on the web, a Teams web app/PWA, Meet, ...) is
    a browser call after 20 s, never the Microsoft Teams (or other service's)
    choice; Always record can't be set for it from an offer
    └── browsers: chrome, chromium, brave, firefox, msedge, vivaldi (vivaldi-bin,
        vivaldi-stable, vivaldi-snapshot; a Vivaldi web app runs in Vivaldi's
        process); others are not detected (#1105)
Permissions -> none asked; the System Audio Recording row is macOS-only
Calendar -> none (no Connect calendar row)
Notes and live chapters -> After a meeting › Summaries is a switch (off by
    default; on = OpenCode): "Titles and short summaries. Sends the transcript
    to your OpenCode model"; Model nests under it while on, as on macOS
    (migrated from Summarize with OpenCode)
    // check: summaries_are_a_switch_off_a_mac (tests/panes.rs)
    ├── Summarize -> "Writing a title and summary with OpenCode…" (never
    │   Apple Intelligence off a Mac that has it)
    └── No writer (OpenCode not running) -> "Notes could not be written." with
        the reason, recorded as notes_error (#1151: it was dropped silently)
Idle sleep -> systemd-inhibit idle:sleep (Linux),
    SetThreadExecutionState (Windows) while recording
Tray -> Record meeting, Stop & transcribe, Copy last meeting transcript
    while Meetings is on
Quit while recording or transcribing -> audio kept; the transcript finishes at
    the next launch
Offer capsule can't open (Linux; GNOME on Wayland opens no interactive
    overlay there, only the HUD on XWayland, #1271)
    -> 2 s after the offer Rune reports the overlay unavailable -> logged
       "meeting recording offer could not show", and the window opens on
       Meetings saying so with Rune's reason; its Start recording records;
       while Labs › Floating meeting capsules on GNOME is off, the note
       names it
    ├── Labs › Floating meeting capsules on GNOME on (off by default, #1274),
    │   layer-shell missing, this user's Xwayland already running (checked at
    │   each show; never started) -> offer and recording capsules float on
    │   XWayland: override-redirect, clicks on their buttons, never keyboard
    │   focus; if Rune still can't open them, the pane path above
    │   // checks: linux/meeting_capsules.rs gating tests; not run on GNOME
    └── not observed on a real GNOME session; no automated check
Files -> Reveal opens the folder (xdg-open, Explorer); Delete moves to the
    freedesktop Trash or the Recycle Bin

Zoom / Teams / Slack huddle / FaceTime / WhatsApp / Discord / browser call uses the microphone
  (WhatsApp: net.whatsapp.WhatsApp, the older desktop.WhatsApp, WhatsApp.exe or
  WhatsApp.Root.exe on Windows, web.whatsapp.com in a browser; 20 s, as voice
  notes also hold the microphone; Gather: com.gather.GatherV2 and its helpers,
  com.gather.Gather, Gather.exe, app.v2.gather.town and app.gather.town; 20 s,
  as sitting in a space can hold it; Discord: com.hnc.Discord and its helpers,
  its Canary and PTB builds, Discord.exe, the Linux discord binary and Flatpak,
  #1283)
  -> CoreAudio input process -> canonical host app   // parent PID + bundle ID
  -> On the microphone for 2 s by the monotonic clock // meetings.detect
     │   Google Meet and Banshee (banshee.app) in a browser count as known
     │   services; a slow watcher loop never stretches the time
     └── Browser on a page that is not a known call site -> 20 s,
         so voice notes and dictation fields are not offered
  -> Provider = the website when known, else the app; the website's choice
     when it has one, else the app's (a browser's choice covers its other
     sites), else Ask
     ├── Never offer -> nothing shown; an earlier offer stays snoozed
     ├── Always record -> starts recording, no offer   // meetings.auto-record
     │   └── recording capsule says "Started automatically" for 10 s; with the
     │       indicator off, a "Recording automatically" capsule with Stop
     │       and ✕ (✕ only hides it; the recording goes on, in the menu bar)
     └── Ask -> Capsule below the menu bar, focus-free  // meetings.offer
         ├── Title: "Google Meet call detected", "Call on meet.jit.si",
         │   "Call in Brave Browser" (site unknown), or the meeting's name
         ├── Record -> Start recording
         ├── Not now -> Close
         ├── … -> "<provider>" · "Change anytime in Settings" (capsule widens)
         │   ├── Never offer -> saved, close
         │   ├── Always record -> saved, records this call too
         │   │   └── not offered for a browser on an unknown page
         │   └── Cancel
         └── 20 s timeout -> Close                     // never records on timeout
             └── unanswered -> the snooze ends the moment the call app leaves
                 the microphone, so a call joined after its pre-join screen is
                 offered again when it retakes it (#1267; check
                 `a_timed_out_offer_is_offered_again_when_the_call_retakes_the_microphone`;
                 not observed on a real Meet call)
  -> Same call is snoozed by key and app until off the microphone for 60 s,
     offered or recorded; stopping an automatic recording does not restart it
     └── Absence counts from the last time the call app was on the microphone,
         a gap included (sleep, Meetings off, a recording): an app that left
         the microphone during a recording is not snoozed for another minute
     ├── A call whose page names a meeting code (Google Meet's, from the
     │   address or a code-only tab title) is snoozed by that code: another
     │   code in the same browser is a new call and is offered or recorded;
     │   a page without a code still counts as the snoozed call (#1113)
     └── Stopped by hand -> the snooze ends once the call app has been off
         the microphone for 3 s (seen while transcribing too), so the next
         call in the same app is offered; a dismissed offer keeps the minute
         for a muted call dropping off mid-call. Checks:
         `a_different_meet_call_in_the_same_browser_is_not_snoozed_by_the_first`,
         `a_stopped_call_s_app_is_snoozed_only_until_it_leaves_for_a_few_seconds`
  -> "Left the call" prompt after the call app is off the microphone for 3 s
  -> Times are wall-clock runs: observations more than 10 s apart (sleep, a
     stalled loop) start a stability run again instead of counting the gap
     └── A call off the microphone for at most 2 s (a missed check) keeps
         its run; a longer release starts it over

Choices persist as `meetings.providers` (`key`, `label`, `policy`:
`ask` / `always_record` / `never_offer`) in `settings.json`. Missing means Ask.
The older `meetings.never_offer` list reads as Never offer entries and is
rewritten as `providers` on the next load.

Meetings > Settings > Calendar                       // meetings.calendar (macOS)
├── Connect calendar -> macOS full-access prompt, on this click only
│   ├── Granted -> meetings.calendar.connected = true; reminders on, 1 min lead
│   │   └── trusts the prompt's answer: macOS keeps reporting "not determined"
│   │       to the asking process until it relaunches
│   └── Denied / Restricted / write-only -> "Calendar access is off"
│       └── Open settings -> Privacy & Security › Calendars
└── Connected
    ├── Remind me before meetings -> on by default
    ├── Remind me -> At start / 1 / 2 / 5 min
    ├── Calendars -> All calendars, or "2 of 3 calendars"; each switched in the menu
    └── Next 3 meetings: title, "Today · 2:30 PM", provider icon when it has a call link

Meeting = not all-day, declined, free, or cancelled, AND has other attendees or a
          Zoom / Google Meet / Teams / Slack huddle / Webex link (URL, location, notes)

Lead time reached (or Mac wakes within 5 min of the start)   // meetings.reminder
  -> Reminder capsule, offer-capsule placement, focus-free
     ├── "Design sync" · "Starts in 1 min · Zoom"
     │   ├── Not now -> close; this call is not offered when detected
     │   ├── Join & record (only with a link) -> open the link, then record
     │   └── Record -> recording titled "Design sync" with its attendees
     └── Service set to Always record: "Starts in 1 min · Hex records automatically"
         ├── Don't record -> close; the detected call neither offers nor auto-records
         └── Join (only with a link) -> open the link; Always record starts on detection
  -> Closes 60 s after the start (at least 30 s after showing); withdrawn if the
     meeting is cancelled, moved, or reminders are turned off. One at a time: an
     overlapping meeting's reminder waits until this one is answered or closes.
     Waits while Hex records; a recording that starts closes it.
Detected call during a calendar meeting on the same service
  -> recording takes the calendar title and attendees

Record (offer, menu bar "Record Meeting", Meetings pane, or voice command)
  -> Title: named meeting OR "<App> call — 2:30 PM" OR "Meeting — 2:30 PM"
  -> system.wav + microphone.wav, owner-only, Application Support/meetings/<id>
  -> No idle sleep; no dictation mute or media pause // meetings.record
  -> Menu bar: record symbol + elapsed time
     ├── "Recording · <title> · 12:34" -> Meetings pane
     │   └── title follows the provisional title (see Titles And Summary)
     └── Stop & Transcribe
     (Idle menu bar: "Record Meeting"; "Copy Last Meeting Transcript" sits
      under Paste Last Dictation; there is no Meetings… item, Settings… opens
      the same window)
  -> Floating recording indicator (when Show recording indicator is on) // meetings.indicator
     ├── Rune interactive overlay: a non-activating panel that never becomes key
     ├── Only the drawn pill takes the pointer (OverlayInput::Regions, the
     │   pill `.hit()`); the window is as wide as the open pill, and clicks
     │   in its transparent rest reach the app beneath (#1305; not observed
     │   on a real Mac)
     ├── In the saved recording_indicator_corner
     ├── Compact: pulsing red dot · title · mm:ss, plus "+N" when turns wait
     ├── Hover -> widens toward the screen with the actions below; pointer
     │   leaving -> eases back to compact (a held press keeps it open)
     ├── Drag -> follows the pointer; release -> snaps to the corner nearest
     │   its centre and saves recording_indicator_corner (window settings too)
     ├── Copy new (N) -> copies the turns not yet copied or pasted, through
     │   the click (see meetings.copy-through-now)
     │   ├── Shares Option-Control-V's cursor: either one advances both
     │   ├── N = speaker turns the ticker has seen; always enabled while
     │   │   recording, since the latest speech may not be counted yet
     │   ├── "Transcribing…" (disabled) while it waits, then copies; "Copied" for 1.5 s
     │   └── The wait runs on its own thread, never on the main thread
     ├── Copy all -> the in-call transcript so far as speaker-turn Markdown;
     │   disabled until there is text
     │   └── Both read the Parakeet in-call transcript (TranscriptReader) once a
     │       second on the ticker thread, never on the main thread
     ├── Open -> activates Hex, then opens the active meeting in the Meetings pane
     └── Stop -> Stop & Transcribe
  -> Settings window may stay closed

Detected app leaves the microphone for about 3 s     // meetings.call-ended
  -> "Zoom left the call" capsule: Keep recording / Stop & transcribe
  -> No timeout; nothing stops automatically

Labs › Movable meeting capsules (macOS, off by default; #1093) // meetings.panel-drag
  The panel capsules: offer, reminder, left the call, Meeting transcript
  ready, Recording automatically
  -> On: each opens in the saved recording_indicator_corner (read as it shows)
     ├── Drag its body -> follows the pointer; release -> snaps to the corner
     │   nearest its centre (by its own width) and saves it, so the recording
     │   capsule moves there too
     ├── Press on a button -> the button, as before
     └── Escape mid-drag -> back where it was, nothing saved
  -> Off: top right below the menu bar, no drag, exactly as before
  Checks: a_released_panel_snaps_by_its_own_size,
  each_corner_places_the_panel_at_its_edges, only_a_movable_panel_drags
  (rune_ui/meeting_capsules.rs); not observed on a real Mac. Every panel
  capsule takes the pointer only on its body, never the window's margin
  around it (#1305); a click on the body outside its buttons still stops
  there

Labs › Stop when the call ends (macOS, off by default; #835) // meetings.auto-stop
  Only a recording Hex started on its own (Always record); manual, offered,
  and calendar recordings are never stopped
  -> The call app counts as present while it holds the microphone OR any of
     its Core Audio processes plays output (WhatsApp keeps the microphone
     while muted; its output stays open until hang-up)
  -> Both off for about 3 s -> capsule says "Hex stops recording in 30 s
     unless you keep recording."
     ├── App back on the microphone or output within 30 s -> nothing stops
     ├── Keep recording -> nothing stops for this absence; leaving again re-arms
     ├── Stop & transcribe -> stops now
     └── 30 s pass -> Stop & Transcribe, as the menu bar's; logged
         "meeting recording stopped automatically after its call ended"
  -> Off -> exactly as above: microphone only, nothing stops

Capture sources (meeting/capture.rs)                // meetings.capture
├── Microphone -> dictation's input (saved device, else System default) via cpal, resampled to 16 kHz
│   ├── Detected call app (macOS 14+) -> the input that app records from, by
│   │   device UID, ahead of the saved device and the default (#1086)
│   │   ├── App switches input mid-call -> followed within 1 s, same track
│   │   ├── App reports no input (muted) -> keeps the one it followed
│   │   └── Not reported, not listed, Hex Microphone, or won't open -> as below
│   │      // a_meeting_follows_the_input_its_call_app_records_from,
│   │      // a_meeting_finds_the_input_its_call_uses_by_uid; unverified on a real call
│   ├── System default changes, the Settings microphone changes, or a missing
│   │   saved device returns, mid-meeting
│   │   -> New input opens before the old drops; same track, no retry gap
│   │      // macOS only (meetings are macOS); a failed open keeps the old input
│   └── Saved device listed but would not open -> System default stands in
│       -> tried again after 1, 2, 4, 8, 16, 30, 30, 30 s, then only on a change
└── System audio -> Core Audio process tap (global, excluding Hex) on a private
    aggregate device; no display dependency
    └── Tap not authorized + Screen Recording granted -> ScreenCaptureKit fallback

A source fails (display sleep ends SCStream, device unplugged, tap stalls 3 s)
  -> Only that source stops; the other keeps recording
  -> Retried every 0.5-5 s until it reopens or the meeting stops
  -> Resumes into the same track; silence fills the gap (>= 1 s) on the
     shared capture clock, recorded in the manifest as track `gaps`
  -> Rolling transcription restarts that source after the gap; the padded WAV
     keeps the final pass on the same timeline
``````

开始录音不再会打开设置窗口；失败时仍会打开。

失败时会在录音上方显示“Meeting could not be recorded.”，直到点击其关闭按钮将其消除（[#562](https://github.com/anomalyco/hex/issues/562)；检查 `a_meeting_recording_error_can_be_dismissed`）。

检查项：`call_end_is_reported_once_per_sustained_absence`、`an_ended_call_stops_after_the_grace_unless_it_comes_back_or_is_kept`（见 [meeting/detection.rs](https://atomgit.com/GitHub_Trending/hex19/hex/blob/dev/src/meeting/detection.rs)）、`only_automatic_recordings_stop_when_the_call_ends_and_only_with_the_lab_on` 和 `keep_recording_disarms_a_pending_automatic_stop`（见 [meeting/watcher.rs](https://atomgit.com/GitHub_Trending/hex19/hex/blob/dev/src/meeting/watcher.rs)）、`an_automatic_stop_says_so_and_keep_recording_cancels_it`（见 [meeting_capsules.rs](https://atomgit.com/GitHub_Trending/hex19/hex/blob/dev/src/rune_ui/meeting_capsules.rs)）（自动停止；尚未在真实 Mac 上观察到：其输出读取了 `microphone_activity::application_running_output`，并与实时 WhatsApp 通话、静音通话以及 Zoom 或 Teams 辅助进程进行了对照）、`paste_cursor_counts_coalesced_turns_and_advances_only_on_success`（见 [meeting/tests.rs](https://atomgit.com/GitHub_Trending/hex19/hex/blob/dev/src/meeting/tests.rs)）、`meeting_delta_coalesces_turns_in_time_order`（见 [parakeet.rs](https://atomgit.com/GitHub_Trending/hex19/hex/blob/dev/src/parakeet.rs)）、`paste_cursor_neither_repeats_nor_drops_text_when_the_transcript_is_rewritten`，以及 `meeting_menu_offers_one_action_per_state`（见 [macos_rune/status_item.rs](https://atomgit.com/GitHub_Trending/hex19/hex/blob/dev/src/macos_rune/status_item.rs)），还有 `mid_meeting_capture_loss_proceeds_to_transcription_when_audio_was_recorded`、`writer_fills_a_capture_gap_with_silence_and_records_it` 和 `a_source_that_resumes_after_an_outage_is_padded_back_onto_the_timeline`（见 [meeting/tests.rs](https://atomgit.com/GitHub_Trending/hex19/hex/blob/dev/src/meeting/tests.rs)）。菜单栏的 Record Meeting 和 Stop & Transcribe，以及录音和就绪胶囊按钮，已于 2026-10-22 在真实 Mac 上点击过；目前没有自动化测试覆盖它们。

这些胶囊是 [meeting_capsules.rs](https://atomgit.com/GitHub_Trending/hex19/hex/blob/dev/src/rune_ui/meeting_capsules.rs) 中的 Rune 覆盖层：位于每个 Space 状态层的交互式、非激活 `NSPanel`，由菜单栏 pump 接收到的控制器事件驱动（[macos_rune.rs](https://atomgit.com/GitHub_Trending/hex19/hex/blob/dev/src/macos_rune.rs)）。已移植了 offer（20 秒）、“left the call”、ready（15 秒，Copy / Reveal / ✕，笔记刷新）以及录音胶囊（标题、已用时间、Copy new、Copy all、Open、Stop，位于配置的角落，悬停前保持紧凑，可在角落之间拖动）。Copy new 和 Copy all 由 `the_recording_capsule_copies_the_in_call_transcript` 和 `copy_new_copies_the_transcript_read_through_the_click` 检查，并由 `capsule_snapshots`（`recording-empty`、`-live`、`-transcribing`、`-copied`、`-open`、`-left`）渲染；它们尚未在真实 Mac 上被点击过。悬停和角落吸附由 `the_recording_capsule_rests_compact_and_opens_under_the_pointer`、`dragging_the_recording_capsule_moves_it_and_snaps_to_a_corner` 和 `a_released_capsule_snaps_to_the_corner_nearest_its_centre` 检查；两者都尚未用真实指针尝试过。“Never offer”或“Always record”的选择会被保存，并同时写入窗口的实时设置中。2026-10-22，一台 MacBook Pro 上的签名构建显示了录音胶囊（Open 在继续录音的同时打开了会议；Stop 进行了转录）和 ready 胶囊（Copy 复制了 Markdown）。在那天的修复之前，录音胶囊从未出现：它在一个覆盖层批次中关闭并重新打开，而 hide 最后运行。offer、“left the call”、“…”选项以及自动录音胶囊在屏幕上仍未出现。ready 和自动录音胶囊的 ✕（#996）由 `dismissing_a_ready_transcript_only_closes_it` 和 `dismissing_an_automatic_recording_never_stops_it` 检查，并由 `panel_goldens`（`meeting-capsule-ready-*`、`-auto-started-*`）绘制；它尚未在真实 Mac 上被点击过。

### 转录 {#transcribe}

```ts
While recording                                      // meetings.rolling
  -> Each track -> one-second blocks -> bounded queue (about 10 minutes)
  -> 16 kHz streaming resampler -> chunker + echo envelope
     ├── First pause after 6 s (pause segmenter; never under 3 s) -> boundary
     ├── No pause by 10 s -> hard cut; next chunk repeats its last 2 s
     │   (so a chunk is at most 12 s of audio)
     └── Silent chunk (no 20 ms frame ≥ -60 dB) -> skipped, no inference
  -> Each chunk runs on dictation's loaded model, only while dictation is idle
     ├── No speech detected (Silero, once installed) -> empty transcript, no
     │   inference; coverage still advances
     └── A dictation request or live stream came first -> retried once idle
  -> Timed words joined word by word at a shared word near each overlap's middle
     -> sentences (punctuation or a 600 ms pause)
  -> transcript.rolling.ndjson: per-track coverage line, then entries
     ├── Only settled sentences: wholly before the next seam, so a later chunk
     │   never rewrites or retracts a published line
     ├── You entries publish only once the system track is transcribed past them,
     │   or once system capture is over 5 s behind the microphone (stalled)
     ├── Capture gap -> the track restarts after the gap; nothing is dropped
     ├── Backlog over 120 s of audio -> oldest chunks skipped, track marked
     │   incomplete; rebuilt from its WAV after Stop
     └── Model failure -> transcript.rolling.error.txt -> "Live transcript unavailable."
  -> Every in-call view reads it: Meetings pane, `hex meetings show`, MCP,
     provisional titles (TranscriptReader)

Copy new or Option-Control-V while recording       // meetings.copy-through-now
  -> The capture writer sends its partial blocks, then the request, in
     capture order, so the request covers every sample received
  -> The rolling worker answers it before any later audio:
     ├── Queued chunks as usual (published to the snapshot)
     ├── Each track's audio not yet in a chunk (no 6 s minimum), into a copy
     │   of its transcript: the snapshot and later chunks are unaffected
     ├── Waits for dictation like every meeting chunk; never a second model
     └── The same echo and You-waits-for-Them rules as the snapshot
     ├── Every sample up to the request, even 100 ms past a hard cut; the
     │   system track counts as transcribed through all its audio
  -> Each track remembers where the copy ended; its sentence ends there
     (between the words whose middles lie either side, as boundaries move
     when a later chunk hears more), so the copied part and the rest of it
     publish as separate entries and the paste cursor neither repeats nor
     drops either. A track rebuilt from its WAV after Stop keeps the cuts
  -> A copy pressed as capture ends is still answered; quitting ends the wait
  -> Up to 3 s (COPY_TRANSCRIBE_WAIT): usually under 1 s; past that, or with
     dictation holding the model, copies the in-call transcript as it is and
     logs a warning
  -> After Stop, or in another process: the in-call or final transcript

Stop & Transcribe
  -> Flush tails -> finish pending chunks           // usually seconds
  -> Any track that fell behind or failed -> stream its WAV in 1 s blocks
  -> Join on one timeline -> Echo suppression -> Final publication

Hex quits while recording                           // meetings.quit
  -> Capture stops; WAVs and manifest finalized; no chunk starts, no model loads
  -> Interrupted with its rolling draft + final.pending beside the manifest
Hex quits during Stop & Transcribe's final pass (#1284)
  -> Same: Interrupted + final.pending, never Failed with "Hex is quitting"
  -> Next launch, Meetings on, no recording, once the dictation engine is up
     (or 30 s without one) -> full-WAV final pass -> Complete + Markdown + notes
     ├── Quit again or model not installed -> stays pending
     └── Other failure -> stays Interrupted with the error and its draft

                            Moonshine draft +      Parakeet only,
                            30 s Parakeet chunks   3-12 s chunks
Meeting CPU                 105% of a core         4.4%
Footprint, idle ~830 MB     mean 1345, peak 1438   mean 854, peak 869 MB
Dictation release -> text   p50 80, p95 93 ms      p50 84, p95 89 ms
Speech end -> copyable      p50 16.5, p95 28.7 s   p50 6.3, p95 11.4 s
  (Parakeet; the draft showed in about 1 s)
Option-Control-V text       Moonshine, 17% WER     Parakeet, 5.6% mid-call
Pasted vs final, Them/You   16.7% / 14.9%          0.0% / 0.0%, no repeats
Final transcript            after flush            181 ms after Stop, 3.7% WER

Call on speakers -> the microphone hears the remote side tens of ms later
Each microphone segment                              // meetings.echo
├── Signal (meeting/echo): 20 ms energy of both tracks on one timeline
│   ├── Lag (-300..+600 ms) and coupling from envelope correlation over ±60 s,
│   │   cached per 10 s block once its audio is complete
│   │   └── Correlation < 0.2 (headphones) -> every sound is local
│   ├── Bleed gain = 35th percentile of mic − delayed system, before or after
│   └── Frame is local when mic > predicted bleed (decaying reverb) + 9 dB
│       ├── ≥ 50% local -> Local -> kept, even with matching words (double-talk)
│       ├── ≤ 20% local and no 0.5 s of local sound within 1 s -> Bleed -> dropped
│       └── otherwise   -> decided by words
└── Words: ≥ 60% match Them speech within ±1.5 s (60% edit similarity) -> echo

Rolling and final: segments are sentences, grouped into utterances
└── An echo utterance keeps its sentences of 3+ words that the signal shows local
Applied in: rolling snapshot (so every in-call view) and the final transcript

Pane as recorded (old code)          77 You entries, 49 echo-like
Draft only (rolling unavailable)     11 You, 2 echo-like, 2 of 6 local lost*
Pane, rolling caught up              10 You, 1 echo-like, 0 of 6 lost
Pane while recording, rolling 25-300 s behind: 25 ever shown, 3 echo-like
Final transcript                     10 You, 1 echo-like, 0 of 6 lost
* Moonshine lines that mix bleed with Kit's sentence stay hidden until
  rolling, which splits them into sentences, covers that time.

Final publication                                   // meetings.output
├── Internal: transcript.ndjson + transcript.md (atomic, owner-only)
└── Markdown copy -> <folder>/<YYYY-MM-DD HHMM> <title>.md
    ├── Title, date, duration, app, You / Them turns
    ├── Never overwrites; adds " (2)"
    └── Failure -> Meeting still Complete; "Markdown not saved: …"

Transcript ready capsule (15 s) -> Copy (Markdown or speaker turns fallback) / Reveal / ✕ closes
Meetings pane -> Copy icon on a completed row's hover, the card's Copy transcript icon, Reveal Markdown (or Reveal Files when none)
Menu bar (idle) -> Copy Last Meeting Transcript
Option-Control-V -> `MeetingPasteCursor` in `meeting/delta.rs` over the transcript
│   through the press (meetings.copy-through-now)
├── Pastes turns added since the last successful paste
├── Runs in order with dictation output: a dictation finished during its
│   wait (at most 3 s) pastes after it
├── Remembers, per source, the capture time spans it pasted (spans within 1.5 s
│   merge); an entry is new when its midpoint is outside them, so nothing
│   repeats or drops when the final transcript replaces rolling after Stop, and
│   text the final pass recovers for audio rolling skipped still pastes
└── Resets when Hex restarts

标题：开始录制（面板的唯一主按钮）/ 红点、已用时间及停止并转写（次要按钮），在右侧分组显示
列表（紧贴标题边缘，无分隔线；按今天/昨天/日期分组）
├── 搜索会议（标题、应用、笔记、最终转写文本）位于行上方
└── 行：标题（存在时生成）、右侧显示时间；元信息行
    “录音中 · Zoom” / “失败 · 2 分钟” / “Zoom · 38 分钟”（录音中或失败时显示为红色）；无悬停填充；
    已完成的行在悬停时（仅指针操作）于时间位置显示复制图标（显示“已复制”并带对勾）
详情（列表旁的凸起卡片）
├── 标题、状态标签（就绪状态不显示）、日期 · 时间 · 时长 · 应用
├── 右上角幽灵图标：复制转写文本、重命名（仅已完成）、省略号“…”菜单
│   └── 复制摘要（保持打开以显示“已复制”）、显示 Markdown、生成摘要 /
│       重新生成摘要（运行中显示“正在生成摘要…”并禁用）、分隔线、
│       删除…（仅对已完成会议的最后三项操作有效）
├── 滚动区域顶部的错误信息
├── 摘要：一段文字，至多两句
├── 章节（存在时）：开始时间、名称、分隔线及复制章节图标
└── 转写文本：逐条叠加显示，无气泡；“你”用文字颜色显示，“对方”用淡色显示，
    各带时间戳；合并的发言；30 秒以上停顿线；录音中显示“正在聆听…”
空状态：“暂无会议。”并附一行提示；搜索时显示“无匹配会议。”

重命名 -> 行内输入框；回车或保存       // meetings.rename
  -> 清单标题；仅当 Markdown 标题仍为旧标题时才更新标题
  -> 文件名不变；空标题将被拒绝
删除…（溢出菜单）-> “将录音与 Markdown 移入废纸篓”（或“将录音移入废纸篓”）
  / 取消，显示在标题下方以替代图标位置，直至做出选择
  -> 先处理导出的 Markdown，再处理 Application Support/meetings/<id>，均移入废纸篓
  -> 录音中、转写中或写入笔记时拒绝删除   // meetings.delete

会议 › 设置 -> 会议保留时长：24 小时 / 7 天 / 30 天 / 永久
│   `meetings.retention` 值为 day|week|month|forever，或未设置（未选择）
├── 未选择（默认）-> 自默认策略生效以来录制的会议
│   （清单中 `retention_applies`）保留 24 小时；更早的会议将一直保留
│   直至用户做出选择（`meeting-retention-default` 迁移会将
│   #604 保存为默认值的 `forever` 取消设置）
└── 已选择 -> 适用于所有已完成的会议，包括更早的会议
每张已完成卡片 -> “24 小时后删除”（或 7 天、30 天）
会议控制器，无论会议开启或关闭           // meetings.retention
├── 在启动时、每小时以及设置变更后不久执行
├── 年龄依据 ended_at_ms，否则依据 created_at_ms；超过保留期限
│   -> 录音文件夹（音频、转写文本、笔记和摘要、实时草稿）移入废纸篓，而非直接删除
│   -> 导出的 Markdown 仅在 SHA-256 仍与 Hex 最后写入的副本匹配时
│      才移入废纸篓（清单 `export_sha256`；Hex 自身的标题和笔记重写
│      会使其保持最新状态）；用户编辑过的副本将保留
├── 跳过录音中、转写中、笔记写入中以及存在 final.pending 的
│   会议；后续轮次会重试这些项目
└── Hex 未运行时不会过期任何项目
查询（`hex meetings`、`hex mcp`、面板）-> 立即排除已过期会议，
    早于后台清理任务处理；从未加载过设置的程序会
    直接读取 settings.json 中的 `meetings.retention` 而不写入

录音中、设置开启、模型可用                     // meetings.title.provisional
  -> meeting-title 线程，utility 服务质量；每 10 秒检查转写文本
     （滚动分块、回声过滤后）
  -> 语音达到 ≥ 90 秒（或 ≥ 600 个词；任一方向 ≥ 60 个词）
     -> 当听写繁忙时等待（≤30 秒）
     -> 对到目前为止的转写文本发起仅 1 次的仅标题调用（≤5,000 字符，30 秒超时）
  -> 录音器将 provisional_title 存入清单
     -> 菜单栏显示“录音中 · <标题>”，会议面板列表与详情中同样显示
  -> 语音达到 10 分钟时刷新一次；失败则在一分钟后重试；
     每次会议至多调用 3 次；停止操作会丢弃进行中的调用
  -> 导出的 Markdown 文件名与标题在标题先到时优先使用该标题

最终发布完成                                 // meetings.notes
  -> meeting-notes 线程，utility 服务质量；听写繁忙时等待（≤30 秒）
  -> 对受限摘录发起仅 1 次调用，不使用 map-reduce
     ├── 实验室 › 会议笔记词汇表 开启时（默认关闭；#1154）->
     │   在日历上下文之前加入“可能出现的名称和术语：…”（≤30 个词汇术语，
     │   每次生成时读取，包括重新生成）；其长度计入预算。关闭 -> 提示词不变
     ├── 行格式“[mm:ss] 你|对方：文本”（长句在 600 字符处拆分）
     ├── 整个转写文本可容纳时使用全部；否则使用开头 30 %、至多六段
     │   均匀分布的中间段落、结尾 20 %，段落间以“[ … ]”分隔
     ├── 预算 = min(12,000 字符,（上下文 − 1,000 token）× 3 字符)
     └── 上下文超出限制 -> 使用一半摘录重试一次
  -> 总时限 90 秒；调用时长 ≤60 秒
  -> 清单：notes { 标题 ≤8 个词, 摘要 ≤2 句 / 400 字符,
     excerpt_chars, transcript_chars, written_by }
     └── written_by: {"writer": "apple_intelligence"} 或 {"writer": "opencode",
         "model": "provider/model"}（OpenCode 默认模型应答时不含 model）；
         #1125 之前写入的笔记中该字段不存在
  -> Markdown 副本，同名文件，原子替换
     ├── 标题 -> 最终标题，仅在仍为 Hex 最后写入的标题时生效
     ├── <!-- hex:notes --> ## 摘要（一段）位于 ## 转写文本 之上
     │   └── 页脚注明写入方：“由 Apple Intelligence 在此 Mac 上撰写”，
     │       “由 <provider/model> 通过 OpenCode 撰写”，或者
     │       对于不含 written_by 的旧笔记，不显示写入方（#1125；
     │       检查项：the_notes_footer_names_the_writer_that_wrote_them）
     ├── 块外文本保留；写入中途发生变化 -> 不写入
     └── 文件缺失 -> 仅写入清单
  -> 失败 / 超时 -> notes_error；Markdown 保持原样；录音状态保持已完成
  -> OpenCode 未选择模型时：排序后的模型按服务缓存；
     任一模型失败即丢弃缓存（下次调用重新读取 OpenCode 目录），
     全部模型失败时则回退到 OpenCode 自身的默认模型；因此在 OpenCode
     仍在加载时读取的列表不再导致每次调用失败，直到重启才恢复
     （#1123；检查项：stale_ranked_models_fall_back_to_the_default_model）

不可用（不符合条件 / Apple Intelligence 关闭 / 模型未就绪 / macOS < 26）
  -> 设置行显示原因；不执行任何操作
会议面板 -> 列表与详情中显示标题；转写文本上方显示摘要段落；
  溢出菜单中显示“生成摘要” / “重新生成摘要” / “正在生成摘要…”
转写文本就绪胶囊 -> 存在临时或最终标题时显示“就绪 · <标题>”；
  副标题显示“正在使用 Apple Intelligence 生成摘要…”，随后显示摘要

Provisional title at 01:41 (261 words, 101 s of speech)  0.7 s (1.0 s first call)
Final title + summary, one call, 11,151-char excerpt     3.4–3.5 s (3 runs)
  └── budget 9,000 -> 2.6–3.4 s; 18,000 -> 5.7 s
Before: map-reduce over 8 chunks, 9 calls, 51-minute call  96 s