Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.
TypeScript cross-platformelectronffmpegopen-sourceproduct-demorustscreen-capturescreen-recorderscreen-recordingscreen-studioscreencastspeech-to-texttypescriptvideo-editingvideo-editorwaylandwgpuwhisper
refactor(update): one update flow, installed only by a click
EtienneLescotfa728ae66bf4
diff --git a/AGENTS.md b/AGENTS.mdindex 67b03a1b7..2a8faf340 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -132,14 +132,14 @@ This section is the *mechanics*. **What to actually run is [`technical-documenta**The tray icon** (notification area on Windows, menu bar on macOS, the desktop's indicator area on Linux)- Because the HUD skips the taskbar and can be minimized/hidden, the **system-tray icon is the reliable way to refocus the app**: **a click or double-click brings back the app's window** (`showMainWindow`: the HUD, or the editor while it is open), and so does its menu's *Open*. Its icon swaps to a red dot while recording.-- **Right-click → context menu**: when idle, *Open*, *Update to <version>* (only while a background check has found one; the same click as the HUD's and the editor's blue update button), *Check for Updates* (not on a Store, Flathub, Snap or Nix install), *Update Settings* (packaged builds that update themselves), *About OpenScreen*, *Save Diagnostics*, *Permissions…* (macOS), *Quit*; while recording, only ***Stop Recording*** (mirrors the HUD's stop). Tooltip shows `OpenScreen` or `Recording: <source>`. Use this to stop a recording if the HUD isn't reachable.+- **Right-click → context menu**: when idle, *Open*, *Update to <version>* (only while a background check has found one; the same click as the HUD's and the editor's blue update button), *Check for Updates* (not on a Store, Flathub, Snap or Nix install), *About OpenScreen*, *Save Diagnostics*, *Permissions…* (macOS), *Quit*; while recording, only ***Stop Recording*** (mirrors the HUD's stop). Tooltip shows `OpenScreen` or `Recording: <source>`. Use this to stop a recording if the HUD isn't reachable.**Updates**- **Run the update pass on every release candidate and after any change to the update path.** A build with a broken updater can only be left through that updater, so a defect here strands every user who installs it. What to run, and how to get a newer version to update to: [Updating in place](technical-documentation/testing/manual-e2e-checklist.md#updating-in-place--post-212), in the checklist.-- **It needs an installed build.** The background check, the blue update button and the install on quit all require `app.isPackaged`: a dev build shows none of them, and that absence proves nothing. The Store package does not apply either; the Store updates it.+- **It needs an installed build.** The background check and the blue update button both require `app.isPackaged`: a dev build shows neither, and that absence proves nothing. The Store package does not apply either; the Store updates it.- **On macOS, only the RC path works:** install `rc.N`, publish `rc.N+1`. Editing `app-update.yml` inside a signed `.app`, which is how the local feed works on Windows and Linux, breaks the bundle's seal, and Squirrel then refuses the update.-- **The agent session check is the one that matters most to you.** In the default mode the app installs on quit, and the Windows installer ends every `Openscreen.exe`, an `openscreen mcp` session included. Keep one running while you quit OpenScreen and confirm it survives and nothing installs.+- **Only the click installs.** Quitting with the button showing must install nothing. If an update installs on its own, at quit or at any other moment, that is a defect, not a feature to note.**End-to-end flow (record → edit)**diff --git a/electron/auto-updater.test.ts b/electron/auto-updater.test.tsindex 80fdb4570..3f60a2ec2 100644--- a/electron/auto-updater.test.ts+++ b/electron/auto-updater.test.ts@@ -1,15 +1,10 @@-import { mkdtempSync, readdirSync, rmSync } from "node:fs";-import os from "node:os";-import path from "node:path";-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";+import { beforeEach, describe, expect, it, vi } from "vitest";import {blockedFromInstalling,checkForSelfUpdate,downloadSelfUpdate,type InstallReadiness,- installNeedsElevation,installSelfUpdate,- setInstallOnQuit,} from "./auto-updater";const mocks = vi.hoisted(() => ({@@ -160,64 +155,4 @@ describe("self-update flow", () => {await installSelfUpdate();expect(mocks.autoUpdater.quitAndInstall).toHaveBeenCalledWith(false, true);});-- // electron-updater only registers its quit handler if the flag is on when the download ends,- // and only installs if it is still on at quit. Both halves have to follow the switch.- it("applies install-on-quit at the next call and flips it live once loaded", async () => {- mocks.autoUpdater.checkForUpdates.mockResolvedValue({ updateInfo: { version: "1.9.2" } });- try {- setInstallOnQuit(true);- await checkForSelfUpdate("nsis");- expect(mocks.autoUpdater.autoInstallOnAppQuit).toBe(true);- // From before-quit: synchronous, no updater call in between.- setInstallOnQuit(false);- expect(mocks.autoUpdater.autoInstallOnAppQuit).toBe(false);- } finally {- setInstallOnQuit(false);- }- });-});--describe("installNeedsElevation", () => {- const dirs: string[] = [];- afterEach(() => {- for (const dir of dirs) rmSync(dir, { recursive: true, force: true });- dirs.length = 0;- });- function installDir(): string {- const dir = mkdtempSync(path.join(os.tmpdir(), "os-install-"));- dirs.push(dir);- return dir;- }-- it("always needs it for a package the system package manager installed", () => {- for (const channel of ["deb", "rpm", "pacman"] as const) {- expect(installNeedsElevation(channel, path.join(installDir(), "openscreen"))).toBe(true);- }- });-- it("never asks on macOS, where Squirrel installs", () => {- expect(installNeedsElevation("dmg", "/nonexistent/Openscreen.app/Contents/MacOS/x")).toBe(- false,- );- });-- it("needs none where the install directory is writable, and leaves nothing behind", () => {- const dir = installDir();- expect(installNeedsElevation("nsis", path.join(dir, "Openscreen.exe"))).toBe(false);- expect(readdirSync(dir)).toEqual([]);- });-- it("needs it where the install directory cannot be written", () => {- const missing = path.join(installDir(), "gone", "Openscreen.exe");- expect(installNeedsElevation("nsis", missing)).toBe(true);- });-- it("probes the AppImage's own folder, not the mount it runs from", () => {- const dir = installDir();- const mount = path.join(dir, "missing-mount", "openscreen");- expect(installNeedsElevation("appimage", mount, path.join(dir, "Openscreen.AppImage"))).toBe(- false,- );- });});diff --git a/electron/auto-updater.ts b/electron/auto-updater.tsindex 36a03a0c8..fdee80d2b 100644--- a/electron/auto-updater.ts+++ b/electron/auto-updater.ts@@ -8,10 +8,7 @@// bundle and come along. What does NOT come along is anything under userData — recordings,// projects, and the ~500 MB STT model — which is exactly what we want.-import { mkdtempSync, rmdirSync } from "node:fs";-import path from "node:path";import { app } from "electron";-import type { AppUpdater } from "electron-updater";import type { InstallChannel } from "./install-channel";import { ownsItsUpdates } from "./install-channel";@@ -39,59 +36,24 @@ export function blockedFromInstalling(state: InstallReadiness): string | null {return null;}-/** Whether a downloaded update installs as the app quits. Off unless the user's update mode asks- * for it, and main turns it back off at quit when `shouldInstallOnQuit` says not now. */-let installOnQuit = false;-/** Set once electron-updater has been imported, so `setInstallOnQuit` can reach it synchronously- * from `before-quit` without importing it there. */-let loadedUpdater: AppUpdater | null = null;--/** electron-updater reads the flag twice. At download, where only a `true` registers its quit- * handler (and, on macOS, hands the update to Squirrel, which then installs on any quit), and at- * quit, where the handler skips the install if it is `false` by then. */-export function setInstallOnQuit(enabled: boolean): void {- installOnQuit = enabled;- if (loadedUpdater) loadedUpdater.autoInstallOnAppQuit = enabled;-}-/** Loaded lazily: importing electron-updater costs startup time on every launch, and the* channels that cannot use it must not pay for it at all. */async function getUpdater() {const { autoUpdater } = await import("electron-updater");- // Never download behind the user's back from here: every download is an explicit- // `downloadSelfUpdate`, made by the update mode or by a click.+ // Never surprise the user with a 240 MB download or an install they did not ask for.+ // `window-all-closed` quits this app, and the HUD is a window — with the default+ // `autoInstallOnAppQuit` simply closing the HUD would kick off an installer.//// Reapplied on every call rather than set once behind a flag: these are three property// writes, so memoising them buys nothing measurable, and a "configured" flag would mean// anything that later reset them is never corrected — while making the guarantee hold only// for whichever caller happened to come first.autoUpdater.autoDownload = false;- autoUpdater.autoInstallOnAppQuit = installOnQuit;+ autoUpdater.autoInstallOnAppQuit = false;autoUpdater.logger = null;- loadedUpdater = autoUpdater;return autoUpdater;}-/** Would replacing this install prompt for rights the user has to grant? deb, rpm and pacman always- * go through pkexec. For NSIS and AppImage the install directory is probed by writing into it,- * because on Windows `fs.access` ignores ACLs and calls Program Files writable. macOS is not- * asked: Squirrel installs there. */-export function installNeedsElevation(- channel: InstallChannel,- execPath: string = process.execPath,- appImage: string | undefined = process.env.APPIMAGE,-): boolean {- if (channel === "deb" || channel === "rpm" || channel === "pacman") return true;- if (channel === "dmg") return false;- const dir = path.dirname(channel === "appimage" && appImage ? appImage : execPath);- try {- rmdirSync(mkdtempSync(path.join(dir, ".update-probe-")));- return false;- } catch {- return true;- }-}-/** Is an update available, and can this install apply it itself? */export async function checkForSelfUpdate(channel: InstallChannel): Promise<UpdateOutcome> {if (!ownsItsUpdates(channel) || !app.isPackaged) return { kind: "unsupported" };diff --git a/electron/background-update.test.ts b/electron/background-update.test.tsindex 61d82a158..336b81410 100644--- a/electron/background-update.test.ts+++ b/electron/background-update.test.ts@@ -1,8 +1,6 @@import { describe, expect, it, vi } from "vitest";import {- planBackgroundUpdate,runUnblockedDownloadAndInstall,- shouldInstallOnQuit,shouldQuitAndInstallAfterRestartPrompt,shouldStartBackgroundUpdateTimer,} from "./background-update";@@ -18,31 +16,6 @@ describe("background update policy", () => {expect(shouldStartBackgroundUpdateTimer({ isPackaged: true, ownsItsUpdates: true })).toBe(true);});- it("does not plan a current-version dialog on the background path", () => {- expect(planBackgroundUpdate({ outcome: { kind: "current" }, mode: "notify" })).toEqual({- action: "none",- });- expect(- planBackgroundUpdate({ outcome: { kind: "unsupported" }, mode: "download-and-install" }),- ).toEqual({ action: "none" });- });-- it("plans notify / download / download-and-install from an available update", () => {- const outcome = { kind: "downloaded" as const, version: "1.10.0" };- expect(planBackgroundUpdate({ outcome, mode: "notify" })).toEqual({- action: "notify-available",- version: "1.10.0",- });- expect(planBackgroundUpdate({ outcome, mode: "download" })).toEqual({- action: "download",- version: "1.10.0",- });- expect(planBackgroundUpdate({ outcome, mode: "download-and-install" })).toEqual({- action: "download-and-install",- version: "1.10.0",- });- });-it("does not call quitAndInstall until Restart Now returns 0", async () => {const install = vi.fn();const cancelled = await runUnblockedDownloadAndInstall({@@ -66,19 +39,6 @@ describe("background update policy", () => {expect(shouldQuitAndInstallAfterRestartPrompt(0)).toBe(true);});- // The NSIS installer ends every process of this executable, so an install nobody clicked for- // must not cut an agent's `openscreen mcp` session short, nor raise a UAC or pkexec prompt on- // the way out.- it("installs on quit only in its mode, without elevation and with no CLI run alive", () => {- const clear = { needsElevation: false, cliSessionAlive: false };- expect(shouldInstallOnQuit({ ...clear, mode: "download-and-install" })).toBe(true);- expect(shouldInstallOnQuit({ ...clear, mode: "download" })).toBe(false);- expect(shouldInstallOnQuit({ ...clear, mode: "notify" })).toBe(false);- const auto = { ...clear, mode: "download-and-install" as const };- expect(shouldInstallOnQuit({ ...auto, needsElevation: true })).toBe(false);- expect(shouldInstallOnQuit({ ...auto, cliSessionAlive: true })).toBe(false);- });-it("hands the download error back so the dialog can show its message", async () => {const error = new Error("ECONNRESET mid-download");const failed = await runUnblockedDownloadAndInstall({diff --git a/electron/background-update.ts b/electron/background-update.tsindex d1ce9ed36..e078f8f8f 100644--- a/electron/background-update.ts+++ b/electron/background-update.ts@@ -1,15 +1,10 @@import type { UpdateOutcome } from "./auto-updater";-/** How far a background-discovered update may go on its own. None of them opens a dialog: a- * background find only ever becomes the update button (`UpdateBadge`). `download-and-install`- * also installs the downloaded update when the app quits, silently and without relaunching,- * unless `shouldInstallOnQuit` says not now. Closing the last window quits this app, so that- * quit is an ordinary one, and the installer is already on disk by then. */-export type UpdateMode = "notify" | "download" | "download-and-install";+// One behaviour, the one Codex and VS Code have: check in the background, download in the+// background, then show an update button. Nothing installs until the user clicks it, so no update+// ever interrupts a take, an export or an agent's `openscreen mcp` session on its own, and no+// install ever asks for an admin password on the way out.-/** Keeping users current is the point, so the default goes all the way. A mode the user picked in- * the tray is stored and wins. */-export const DEFAULT_UPDATE_MODE: UpdateMode = "download-and-install";/** A minute after launch, then every six hours. Most sessions end long before 24 hours, so a check* that only ran once a day of uptime almost never ran at all. */export const BACKGROUND_UPDATE_FIRST_CHECK_MS = 60 * 1000;@@ -17,30 +12,13 @@ export const BACKGROUND_UPDATE_INTERVAL_MS = 6 * 60 * 60 * 1000;/** What a background find shows: a button in the HUD and the editor, and a tray item. */export interface UpdateBadge {- /** `available`: found, not downloaded, so the click downloads it (or opens the release page,- * when only the release lookup worked). `ready`: downloaded, so the click restarts into it. */+ /** `ready`: downloaded, so the click restarts into it. `available`: the background download+ * failed, so the click downloads it again; or the self-updater failed and only the release+ * lookup found it, so the click opens the release page. */state: "available" | "ready";version: string;}-/** May the downloaded update install while the app quits? Only in the mode that says so; only- * where it needs no rights the user would be prompted for on the way out (UAC for a per-machine- * NSIS install, pkexec for deb/rpm/pacman); and never while a CLI run is alive, because the NSIS- * installer ends every process of this executable, `openscreen mcp` driven by an agent included.- * The update button does not ask this: a click is the user deciding. */-export function shouldInstallOnQuit(input: {- mode: UpdateMode;- needsElevation: boolean;- cliSessionAlive: boolean;-}): boolean {- return input.mode === "download-and-install" && !input.needsElevation && !input.cliSessionAlive;-}--export function parseUpdateMode(raw: unknown): UpdateMode {- if (raw === "notify" || raw === "download" || raw === "download-and-install") return raw;- return DEFAULT_UPDATE_MODE;-}-export function shouldStartBackgroundUpdateTimer(input: {isPackaged: boolean;ownsItsUpdates: boolean;@@ -48,28 +26,6 @@ export function shouldStartBackgroundUpdateTimer(input: {return input.isPackaged && input.ownsItsUpdates;}-export type BackgroundUpdatePlan =- | { action: "none" }- | { action: "notify-available"; version: string }- | { action: "download"; version: string }- | { action: "download-and-install"; version: string };--/** Background path: never plan a "you are current" dialog. */-export function planBackgroundUpdate(input: {- outcome: UpdateOutcome;- mode: UpdateMode;-}): BackgroundUpdatePlan {- if (input.outcome.kind !== "downloaded") return { action: "none" };- switch (input.mode) {- case "notify":- return { action: "notify-available", version: input.outcome.version };- case "download":- return { action: "download", version: input.outcome.version };- case "download-and-install":- return { action: "download-and-install", version: input.outcome.version };- }-}-export function shouldQuitAndInstallAfterRestartPrompt(response: number): boolean {return response === 0;}diff --git a/electron/cli/sessionData.test.ts b/electron/cli/sessionData.test.tsindex dffd84251..d770b6a66 100644--- a/electron/cli/sessionData.test.ts+++ b/electron/cli/sessionData.test.ts@@ -1,8 +1,5 @@-import fs from "node:fs";-import os from "node:os";-import path from "node:path";-import { afterEach, describe, expect, it } from "vitest";-import { hasLiveCliSession, isAbandonedSession, type SessionOwner } from "./sessionData";+import { describe, expect, it } from "vitest";+import { isAbandonedSession, type SessionOwner } from "./sessionData";const DAY = 24 * 60 * 60 * 1000;const self: SessionOwner = { host: "box", pidNamespace: "pid:[1]", pid: 100 };@@ -34,38 +31,3 @@ describe("isAbandonedSession", () => {expect(isAbandonedSession({ ...self, host: "other" }, 8 * DAY, self, alive)).toBe(true);});});--describe("hasLiveCliSession", () => {- const dirs: string[] = [];- afterEach(() => {- for (const dir of dirs) fs.rmSync(dir, { recursive: true, force: true });- dirs.length = 0;- });- function userData(): string {- const dir = fs.mkdtempSync(path.join(os.tmpdir(), "os-cli-sessions-"));- dirs.push(dir);- return dir;- }- function addRun(root: string, owner: SessionOwner | null) {- const run = path.join(root, "cli-sessions", "200-abc");- fs.mkdirSync(run, { recursive: true });- if (owner) fs.writeFileSync(path.join(run, "owner.json"), JSON.stringify(owner));- }-- it("finds none when no CLI run ever started", () => {- expect(hasLiveCliSession(userData(), alive, self)).toBe(false);- });-- it("sees an agent's `openscreen mcp` run while its pid lives, and not after", () => {- const root = userData();- addRun(root, { ...self, pid: 200 });- expect(hasLiveCliSession(root, alive, self)).toBe(true);- expect(hasLiveCliSession(root, dead, self)).toBe(false);- });-- it("does not count a folder whose run never wrote its owner", () => {- const root = userData();- addRun(root, null);- expect(hasLiveCliSession(root, alive, self)).toBe(false);- });-});diff --git a/electron/cli/sessionData.ts b/electron/cli/sessionData.tsindex 2d3ed303d..0d2ade872 100644--- a/electron/cli/sessionData.ts+++ b/electron/cli/sessionData.ts@@ -64,37 +64,6 @@ function isProcessAlive(pid: number): boolean {}}-/**- * Whether a CLI run is alive: `openscreen mcp` started by an agent, an export, anything that- * went through `isolateCliSessionData`. The app asks before installing an update on quit, since- * the NSIS installer ends every process of this executable. A folder with no readable owner- * counts as no run: it is one that died before writing it, or one a few milliseconds old.- */-export function hasLiveCliSession(- userData: string,- isAlive: (pid: number) => boolean = isProcessAlive,- self: SessionOwner = currentOwner(),-): boolean {- const root = path.join(userData, CLI_SESSIONS_DIR);- let entries: fs.Dirent[];- try {- entries = fs.readdirSync(root, { withFileTypes: true });- } catch {- return false;- }- return entries.some((entry) => {- if (!entry.isDirectory()) return false;- const ownerPath = path.join(root, entry.name, OWNER_FILE);- try {- const owner = JSON.parse(fs.readFileSync(ownerPath, "utf8")) as SessionOwner;- const ageMs = Date.now() - fs.statSync(ownerPath).mtimeMs;- return !isAbandonedSession(owner, ageMs, self, isAlive);- } catch {- return false;- }- });-}-async function readOwner(dir: string): Promise<{ owner: SessionOwner | null; ageMs: number }> {const ownerPath = path.join(dir, OWNER_FILE);try {diff --git a/electron/main.ts b/electron/main.tsindex bb5ad40e9..2f8965c65 100644--- a/electron/main.ts+++ b/electron/main.ts@@ -26,24 +26,18 @@ import {blockedFromInstalling,checkForSelfUpdate,downloadSelfUpdate,- installNeedsElevation,installSelfUpdate,- setInstallOnQuit,type UpdateOutcome,} from "./auto-updater";import {BACKGROUND_UPDATE_FIRST_CHECK_MS,BACKGROUND_UPDATE_INTERVAL_MS,- planBackgroundUpdate,runUnblockedDownloadAndInstall,- shouldInstallOnQuit,shouldStartBackgroundUpdateTimer,type UpdateBadge,- type UpdateMode,} from "./background-update";import { parseCliArgs } from "./cli/args";import { runCli } from "./cli/cliMain";-import { hasLiveCliSession } from "./cli/sessionData";import { disableHttpCacheForDevServer } from "./dev-http-cache";import { mainLogBuffer } from "./diagnostics/main-log-buffer";import { buildEditMenuSubmenu, type EditorUndoRedoChannel, routeEditorUndoRedo } from "./edit-menu";@@ -79,7 +73,6 @@ import { RecordingsDirManager } from "./recording/recordingsDirManager";import { offersStarPrompt, REPO_URL, storeReviewUrl } from "./star-prompt";import { registerSttIpc, shutdownStt } from "./stt";import { checkLatestRelease } from "./update-checker";-import { loadUpdateMode, saveUpdateMode } from "./update-settings";import {doNotTrack,loadUsagePingState,@@ -669,7 +662,6 @@ function runSaveDiagnostics() {* and on Windows it physically cannot, because the capture helpers spawn from inside the* install directory and NSIS cannot overwrite a running .exe. */let isRecording = false;-let currentUpdateMode: UpdateMode = "notify";let backgroundUpdateTimer: ReturnType<typeof setInterval> | null = null;/** The update button, shown by the HUD, the editor and the tray; null hides it. Only a background* check and the downloads it leads to set it: the manual check keeps its own dialogs. */@@ -679,17 +671,6 @@ let updateBadge: UpdateBadge | null = null;let updateReleasePage: string | null = null;let applyUpdateInFlight = false;-function showUpdateSettingsMenu(): boolean {- return app.isPackaged && ownsItsUpdates(getInstallChannel());-}--function persistUpdateMode(mode: UpdateMode) {- currentUpdateMode = mode;- saveUpdateMode(app.getPath("userData"), mode);- setInstallOnQuit(mode === "download-and-install");- updateTrayMenu(isRecording);-}-function setUpdateBadge(badge: UpdateBadge | null, releasePage: string | null = null) {updateBadge = badge;updateReleasePage = releasePage;@@ -804,23 +785,23 @@ async function runBackgroundUpdateCheck() {}return;}- // A translocated Mac cannot install: it gets the button alone, whose click says why.- const mode = installBlock() === "not-in-applications" ? "notify" : currentUpdateMode;- const plan = planBackgroundUpdate({ outcome, mode });- if (plan.action === "none") return;- if (updateBadge?.state === "ready" && updateBadge.version === plan.version) return;- if (plan.action === "notify-available") {- setUpdateBadge({ state: "available", version: plan.version });+ if (outcome.kind !== "downloaded") return;+ const { version } = outcome;+ if (updateBadge?.state === "ready" && updateBadge.version === version) return;+ // A translocated Mac cannot install, so there is no point fetching: it gets the button+ // alone, whose click says to move the app.+ if (installBlock() === "not-in-applications") {+ setUpdateBadge({ state: "available", version });return;}const downloaded = await downloadSelfUpdate();if (downloaded.kind === "failed") {console.warn("[updates] background download failed", downloaded.error.message);// The click downloads it again, through the dialogs that can report a second failure.- setUpdateBadge({ state: "available", version: plan.version });+ setUpdateBadge({ state: "available", version });return;}- setUpdateBadge({ state: "ready", version: plan.version });+ setUpdateBadge({ state: "ready", version });} catch (error) {console.error("[updates] background check failed", error);} finally {@@ -828,8 +809,8 @@ async function runBackgroundUpdateCheck() {}}-/** The update button. A click is the user deciding, so a live CLI run does not stop it, unlike- * the install on quit; a take or a translocated Mac still does, with the dialog that says why. */+/** The update button, the only thing that installs an update. A click is the user deciding, so a+ * live CLI run does not stop it; a take or a translocated Mac does, with the dialog that says why. */async function applyUpdate() {const badge = updateBadge;if (!badge || applyUpdateInFlight) return;@@ -1023,29 +1004,6 @@ function updateTrayMenu(recording: boolean = false) {},]: []),- ...(showUpdateSettingsMenu()- ? [- {- label: mainT("common", "actions.updateSettings") || "Update Settings",- submenu: (- [- ["notify", "updateModeNotify", "Notify when an update is available"],- ["download", "updateModeDownload", "Download updates automatically"],- [- "download-and-install",- "updateModeDownloadAndInstall",- "Download and install updates automatically",- ],- ] as const- ).map(([mode, key, fallback]) => ({- label: mainT("common", `actions.${key}`) || fallback,- type: "radio" as const,- checked: currentUpdateMode === mode,- click: () => persistUpdateMode(mode),- })),- },- ]- : []),...(showUsagePingToggle()? [{@@ -1270,17 +1228,6 @@ app.on("before-quit", (event) => {// quit is deferred below: the user asked to leave, and a check they can re-run from the// tray is not worth holding the helper's teardown behind.updateCheckAbort?.abort();- // Decided here rather than when the download finished: a CLI run can start or end, and the- // mode can change, while the update waits. The last before-quit is the one that counts.- if (updateBadge?.state === "ready") {- setInstallOnQuit(- shouldInstallOnQuit({- mode: currentUpdateMode,- needsElevation: installNeedsElevation(getInstallChannel()),- cliSessionAlive: hasLiveCliSession(app.getPath("userData")),- }),- );- }if (sttShutdownFinished) return;event.preventDefault();if (sttShutdownPromise) return;@@ -1512,8 +1459,6 @@ appReady?.then(async () => {// startup time and the channels that cannot use it must not pay for it at// all (see auto-updater.ts getUpdater) — every real update path applies// its settings lazily on first use.- currentUpdateMode = loadUpdateMode(app.getPath("userData"));- setInstallOnQuit(currentUpdateMode === "download-and-install");usagePingEnabled = loadUsagePingState(app.getPath("userData")).enabled;createTray();updateTrayMenu();diff --git a/electron/update-settings.test.ts b/electron/update-settings.test.tsdeleted file mode 100644index 9e977e27a..000000000--- a/electron/update-settings.test.ts+++ /dev/null@@ -1,48 +0,0 @@-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";-import os from "node:os";-import path from "node:path";-import { afterEach, describe, expect, it } from "vitest";-import { DEFAULT_UPDATE_MODE, parseUpdateMode } from "./background-update";-import { loadUpdateMode, saveUpdateMode, updateSettingsPath } from "./update-settings";--const temps: string[] = [];--afterEach(() => {- for (const dir of temps) rmSync(dir, { recursive: true, force: true });- temps.length = 0;-});--function tmp(): string {- const dir = mkdtempSync(path.join(os.tmpdir(), "os-update-settings-"));- temps.push(dir);- return dir;-}--describe("update settings", () => {- // Saved as something other than the default, or a load that ignored the file would pass too.- it("round-trips a saved mode through load", () => {- const dir = tmp();- saveUpdateMode(dir, "notify");- expect(loadUpdateMode(dir)).toBe("notify");- });-- // Keeping users current is what the setting is for, so a user who never opened it gets the- // mode that downloads and installs on its own.- it("defaults to download-and-install when nothing was ever saved", () => {- expect(DEFAULT_UPDATE_MODE).toBe("download-and-install");- expect(loadUpdateMode(tmp())).toBe("download-and-install");- });-- it("falls back to the default on a corrupt settings file instead of throwing", () => {- const dir = tmp();- writeFileSync(updateSettingsPath(dir), '{"mode": not-even-json !!}');- expect(loadUpdateMode(dir)).toBe(DEFAULT_UPDATE_MODE);- });-- it("refuses garbage mode values rather than trusting the file", () => {- for (const garbage of ["install-silently", "", 42, null, { mode: "download" }]) {- expect(parseUpdateMode(garbage)).toBe(DEFAULT_UPDATE_MODE);- }- expect(parseUpdateMode("download")).toBe("download");- });-});diff --git a/electron/update-settings.ts b/electron/update-settings.tsdeleted file mode 100644index 9e78b2c30..000000000--- a/electron/update-settings.ts+++ /dev/null@@ -1,26 +0,0 @@-import { existsSync, readFileSync, writeFileSync } from "node:fs";-import path from "node:path";-import { DEFAULT_UPDATE_MODE, parseUpdateMode, type UpdateMode } from "./background-update";--export function updateSettingsPath(userData: string): string {- return path.join(userData, "update-settings.json");-}--export function loadUpdateMode(userData: string): UpdateMode {- const file = updateSettingsPath(userData);- if (!existsSync(file)) return DEFAULT_UPDATE_MODE;- try {- const raw = JSON.parse(readFileSync(file, "utf8")) as { mode?: unknown };- return parseUpdateMode(raw.mode);- } catch {- return DEFAULT_UPDATE_MODE;- }-}--export function saveUpdateMode(userData: string, mode: UpdateMode): void {- try {- writeFileSync(updateSettingsPath(userData), `${JSON.stringify({ mode })}\n`, "utf8");- } catch {- // Best-effort; a failed write must not block the tray click.- }-}diff --git a/src/components/ai-edition/v4/EditorTopBar.test.tsx b/src/components/ai-edition/v4/EditorTopBar.test.tsxindex 71d83d96b..b9d920cb5 100644--- a/src/components/ai-edition/v4/EditorTopBar.test.tsx+++ b/src/components/ai-edition/v4/EditorTopBar.test.tsx@@ -562,7 +562,7 @@ describe("the update button", () => {const stub = stubUpdateBadge(null);try {renderTopBar("Demo Project");- await act(async () => {});+ await act(() => Promise.resolve());expect(screen.queryByRole("button", { name: /actions\.updateTo/ })).not.toBeInTheDocument();} finally {stub.restore();@@ -584,7 +584,7 @@ describe("the update button", () => {const stub = stubUpdateBadge(null);try {renderTopBar("Demo Project");- await act(async () => {});+ await act(() => Promise.resolve());stub.push({ state: "available", version: "2.2.0" });expect(screen.getByRole("button", { name: /actions\.updateTo/ })).toBeInTheDocument();stub.push(null);diff --git a/src/i18n/locales/ar/common.json b/src/i18n/locales/ar/common.jsonindex 8a66a7be7..9a96befda 100644--- a/src/i18n/locales/ar/common.json+++ b/src/i18n/locales/ar/common.json@@ -9,12 +9,8 @@"done": "تم","open": "فتح","checkForUpdates": "التحقق من وجود تحديثات",- "updateSettings": "إعدادات التحديث","update": "تحديث","updateTo": "التحديث إلى {{version}}",- "updateModeNotify": "إشعار عند توفر تحديث",- "updateModeDownload": "تنزيل التحديثات تلقائيًا",- "updateModeDownloadAndInstall": "تنزيل التحديثات وتثبيتها تلقائيًا","usagePing": "إرسال إحصاء استخدام مجهول الهوية","viewRelease": "عرض الإصدار","downloadUpdate": "تنزيل التحديث",diff --git a/src/i18n/locales/cs/common.json b/src/i18n/locales/cs/common.jsonindex d6e5104e9..4326ddedb 100644--- a/src/i18n/locales/cs/common.json+++ b/src/i18n/locales/cs/common.json@@ -9,12 +9,8 @@"done": "Hotovo","open": "Otevřít","checkForUpdates": "Zkontrolovat aktualizace",- "updateSettings": "Nastavení aktualizací","update": "Aktualizovat","updateTo": "Aktualizovat na {{version}}",- "updateModeNotify": "Upozornit na dostupnou aktualizaci",- "updateModeDownload": "Stahovat aktualizace automaticky",- "updateModeDownloadAndInstall": "Stahovat a instalovat aktualizace automaticky","usagePing": "Odesílat anonymní počet použití","viewRelease": "Zobrazit vydání","downloadUpdate": "Stáhnout aktualizaci",diff --git a/src/i18n/locales/de/common.json b/src/i18n/locales/de/common.jsonindex 7bfd52e37..c107c3a05 100644--- a/src/i18n/locales/de/common.json+++ b/src/i18n/locales/de/common.json@@ -9,12 +9,8 @@"done": "Fertig","open": "Öffnen","checkForUpdates": "Nach Updates suchen",- "updateSettings": "Update-Einstellungen","update": "Aktualisieren","updateTo": "Auf {{version}} aktualisieren",- "updateModeNotify": "Benachrichtigen, wenn ein Update verfügbar ist",- "updateModeDownload": "Updates automatisch herunterladen",- "updateModeDownloadAndInstall": "Updates automatisch herunterladen und installieren","usagePing": "Anonyme Nutzungszählung senden","viewRelease": "Release ansehen","downloadUpdate": "Update herunterladen",diff --git a/src/i18n/locales/en/common.json b/src/i18n/locales/en/common.jsonindex 41c89db28..b1c38c465 100644--- a/src/i18n/locales/en/common.json+++ b/src/i18n/locales/en/common.json@@ -9,12 +9,8 @@"done": "Done","open": "Open","checkForUpdates": "Check for Updates",- "updateSettings": "Update Settings","update": "Update","updateTo": "Update to {{version}}",- "updateModeNotify": "Notify when an update is available",- "updateModeDownload": "Download updates automatically",- "updateModeDownloadAndInstall": "Download and install updates automatically","usagePing": "Send Anonymous Usage Count","viewRelease": "View Release","downloadUpdate": "Download Update",diff --git a/src/i18n/locales/es/common.json b/src/i18n/locales/es/common.jsonindex 2f05649a7..feae8a724 100644--- a/src/i18n/locales/es/common.json+++ b/src/i18n/locales/es/common.json@@ -9,12 +9,8 @@"done": "Listo","open": "Abrir","checkForUpdates": "Buscar actualizaciones",- "updateSettings": "Ajustes de actualización","update": "Actualizar","updateTo": "Actualizar a {{version}}",- "updateModeNotify": "Avisar cuando haya una actualización",- "updateModeDownload": "Descargar actualizaciones automáticamente",- "updateModeDownloadAndInstall": "Descargar e instalar actualizaciones automáticamente","usagePing": "Enviar recuento de uso anónimo","viewRelease": "Ver versión","downloadUpdate": "Descargar actualización",diff --git a/src/i18n/locales/fr/common.json b/src/i18n/locales/fr/common.jsonindex d1384e357..98ce3a133 100644--- a/src/i18n/locales/fr/common.json+++ b/src/i18n/locales/fr/common.json@@ -9,12 +9,8 @@"done": "Terminer","open": "Ouvrir","checkForUpdates": "Rechercher des mises à jour",- "updateSettings": "Paramètres de mise à jour","update": "Mettre à jour","updateTo": "Mettre à jour vers la version {{version}}",- "updateModeNotify": "Notifier lorsqu'une mise à jour est disponible",- "updateModeDownload": "Télécharger les mises à jour automatiquement",- "updateModeDownloadAndInstall": "Télécharger et installer les mises à jour automatiquement","usagePing": "Envoyer le comptage d'utilisation anonyme","viewRelease": "Voir la version","downloadUpdate": "Télécharger la mise à jour",diff --git a/src/i18n/locales/it/common.json b/src/i18n/locales/it/common.jsonindex 5316e4c63..07ee03eeb 100644--- a/src/i18n/locales/it/common.json+++ b/src/i18n/locales/it/common.json@@ -9,12 +9,8 @@"done": "Fatto","open": "Apri","checkForUpdates": "Controlla aggiornamenti",- "updateSettings": "Impostazioni aggiornamento","update": "Aggiorna","updateTo": "Aggiorna alla versione {{version}}",- "updateModeNotify": "Notifica quando è disponibile un aggiornamento",- "updateModeDownload": "Scarica gli aggiornamenti automaticamente",- "updateModeDownloadAndInstall": "Scarica e installa gli aggiornamenti automaticamente","usagePing": "Invia conteggio di utilizzo anonimo","viewRelease": "Visualizza versione","downloadUpdate": "Scarica aggiornamento",diff --git a/src/i18n/locales/ja-JP/common.json b/src/i18n/locales/ja-JP/common.jsonindex 068f0e5b0..6ae6dd114 100644--- a/src/i18n/locales/ja-JP/common.json+++ b/src/i18n/locales/ja-JP/common.json@@ -9,12 +9,8 @@"done": "完了","open": "開く","checkForUpdates": "アップデートを確認",- "updateSettings": "アップデート設定","update": "アップデート","updateTo": "{{version}} にアップデート",- "updateModeNotify": "アップデートが利用可能になったら通知",- "updateModeDownload": "アップデートを自動でダウンロード",- "updateModeDownloadAndInstall": "アップデートを自動でダウンロードしてインストール","usagePing": "匿名の利用カウントを送信","viewRelease": "リリースを表示","downloadUpdate": "アップデートをダウンロード",diff --git a/src/i18n/locales/ko-KR/common.json b/src/i18n/locales/ko-KR/common.jsonindex ac110e934..f33702243 100644--- a/src/i18n/locales/ko-KR/common.json+++ b/src/i18n/locales/ko-KR/common.json@@ -9,12 +9,8 @@"done": "완료","open": "열기","checkForUpdates": "업데이트 확인",- "updateSettings": "업데이트 설정","update": "업데이트","updateTo": "{{version}}(으)로 업데이트",- "updateModeNotify": "업데이트가 있으면 알림",- "updateModeDownload": "업데이트 자동 다운로드",- "updateModeDownloadAndInstall": "업데이트 자동 다운로드 및 설치","usagePing": "익명 사용 집계 보내기","viewRelease": "릴리스 보기","downloadUpdate": "업데이트 다운로드",diff --git a/src/i18n/locales/pt-BR/common.json b/src/i18n/locales/pt-BR/common.jsonindex 26c99168e..571d8d763 100644--- a/src/i18n/locales/pt-BR/common.json+++ b/src/i18n/locales/pt-BR/common.json@@ -9,12 +9,8 @@"done": "Concluir","open": "Abrir","checkForUpdates": "Verificar atualizações",- "updateSettings": "Configurações de atualização","update": "Atualizar","updateTo": "Atualizar para {{version}}",- "updateModeNotify": "Avisar quando houver uma atualização",- "updateModeDownload": "Baixar atualizações automaticamente",- "updateModeDownloadAndInstall": "Baixar e instalar atualizações automaticamente","usagePing": "Enviar contagem de uso anônima","viewRelease": "Ver versão","downloadUpdate": "Baixar atualização",diff --git a/src/i18n/locales/ru/common.json b/src/i18n/locales/ru/common.jsonindex 47ec8ceef..aa43af4f3 100644--- a/src/i18n/locales/ru/common.json+++ b/src/i18n/locales/ru/common.json@@ -9,12 +9,8 @@"done": "Готово","open": "Открыть","checkForUpdates": "Проверить обновления",- "updateSettings": "Настройки обновления","update": "Обновить","updateTo": "Обновить до {{version}}",- "updateModeNotify": "Уведомлять, когда доступно обновление",- "updateModeDownload": "Загружать обновления автоматически",- "updateModeDownloadAndInstall": "Загружать и устанавливать обновления автоматически","usagePing": "Отправлять анонимный счётчик использования","viewRelease": "Открыть выпуск","downloadUpdate": "Загрузить обновление",diff --git a/src/i18n/locales/tr/common.json b/src/i18n/locales/tr/common.jsonindex 56f92ce90..9e3d9dd9d 100644--- a/src/i18n/locales/tr/common.json+++ b/src/i18n/locales/tr/common.json@@ -9,12 +9,8 @@"done": "Tamam","open": "Aç","checkForUpdates": "Güncellemeleri denetle",- "updateSettings": "Güncelleme ayarları","update": "Güncelle","updateTo": "{{version}} sürümüne güncelle",- "updateModeNotify": "Güncelleme olduğunda bildir",- "updateModeDownload": "Güncellemeleri otomatik indir",- "updateModeDownloadAndInstall": "Güncellemeleri otomatik indir ve yükle","usagePing": "Anonim kullanım sayımı gönder","viewRelease": "Sürümü görüntüle","downloadUpdate": "Güncellemeyi indir",diff --git a/src/i18n/locales/vi/common.json b/src/i18n/locales/vi/common.jsonindex 8e2d6cf93..cbdeedeff 100644--- a/src/i18n/locales/vi/common.json+++ b/src/i18n/locales/vi/common.json@@ -9,12 +9,8 @@"done": "Hoàn tất","open": "Mở","checkForUpdates": "Kiểm tra bản cập nhật",- "updateSettings": "Cài đặt cập nhật","update": "Cập nhật","updateTo": "Cập nhật lên {{version}}",- "updateModeNotify": "Thông báo khi có bản cập nhật",- "updateModeDownload": "Tự động tải bản cập nhật",- "updateModeDownloadAndInstall": "Tự động tải và cài đặt bản cập nhật","usagePing": "Gửi số liệu sử dụng ẩn danh","viewRelease": "Xem bản phát hành","downloadUpdate": "Tải bản cập nhật",diff --git a/src/i18n/locales/zh-CN/common.json b/src/i18n/locales/zh-CN/common.jsonindex 4358dfc03..8e70555ab 100644--- a/src/i18n/locales/zh-CN/common.json+++ b/src/i18n/locales/zh-CN/common.json@@ -9,12 +9,8 @@"done": "完成","open": "打开","checkForUpdates": "检查更新",- "updateSettings": "更新设置","update": "更新","updateTo": "更新到 {{version}}",- "updateModeNotify": "有更新时通知",- "updateModeDownload": "自动下载更新",- "updateModeDownloadAndInstall": "自动下载并安装更新","usagePing": "发送匿名使用计数","viewRelease": "查看版本","downloadUpdate": "下载更新",diff --git a/src/i18n/locales/zh-TW/common.json b/src/i18n/locales/zh-TW/common.jsonindex 36b16d75e..15e29d4ae 100644--- a/src/i18n/locales/zh-TW/common.json+++ b/src/i18n/locales/zh-TW/common.json@@ -9,12 +9,8 @@"done": "完成","open": "開啟","checkForUpdates": "檢查更新",- "updateSettings": "更新設定","update": "更新","updateTo": "更新至 {{version}}",- "updateModeNotify": "有更新時通知",- "updateModeDownload": "自動下載更新",- "updateModeDownloadAndInstall": "自動下載並安裝更新","usagePing": "傳送匿名使用計數","viewRelease": "檢視版本","downloadUpdate": "下載更新",diff --git a/technical-documentation/architecture/mcp-server.md b/technical-documentation/architecture/mcp-server.mdindex 7165ec2b0..7264d7734 100644--- a/technical-documentation/architecture/mcp-server.md+++ b/technical-documentation/architecture/mcp-server.md@@ -64,7 +64,7 @@ The server's one resource, `openscreen://effects/contract` ([`effects-contract.tEvery text a client reads must be true on the server that serves it, so the texts are composed rather than shared verbatim. `McpToolDeps.transport` (`"http"` or `"stdio"`) selects them:- **Instructions** (`mcpInstructions`): the media tools' capability block (`mediaPreamble`), then the projects-and-checkpoints rules of the transport, then how long checkpoints live there, then `buildSystemPrompt`. The checkpoint rule is in both. Over HTTP the media block says a take goes through the app's recording bar and opens in the editor, and the rules speak of the editor and its undo stack; while **MCP edits** is off, a line says `startRecording`, `exportVideo` and `createProject` are refused too. Over stdio the media block says the takes land in the app's project list, and the rules say that calls go through the app while it runs (the open project live, with `Ctrl/Cmd+Z`), and to the files when it does not.-- **A newer OpenScreen** (`update-notice.ts`), stdio only, and only on an install that updates itself (a Store, Flathub, Snap or Nix copy is kept current by its package manager). A user who reaches OpenScreen only through an agent never sees the app's update button, so `openscreen mcp` looks the latest release up on GitHub, at most every six hours, in the background and cached in `mcp-update-check.json`. When the cache names a newer version, a line opens the instructions: tell the user once that opening the app installs it, and never update OpenScreen yourself. The process itself updates nothing: its stdout is the protocol, its lifetime is the client's, and the NSIS installer would end it. The lookup never holds the handshake back, so the session that finds a release says nothing and the next one does.+- **A newer OpenScreen** (`update-notice.ts`), stdio only, and only on an install that updates itself (a Store, Flathub, Snap or Nix copy is kept current by its package manager). A user who reaches OpenScreen only through an agent never sees the app's update button, so `openscreen mcp` looks the latest release up on GitHub, at most every six hours, in the background and cached in `mcp-update-check.json`. When the cache names a newer version, a line opens the instructions: tell the user once that they can install it by opening the app, and never update OpenScreen yourself. The process itself updates nothing: its stdout is the protocol, its lifetime is the client's, and the NSIS installer would end it. The lookup never holds the handshake back, so the session that finds a release says nothing and the next one does.- **`buildSystemPrompt`** takes the transport's facts as options: `editsSetting` names the switch its consent block points to (the MCP server's **MCP edits**, not the in-app agent's **Agent edits**), and `canExport` drops "exporting" from its examples of a request with no tool, since both serve `exportVideo`.- **Tool descriptions**: `projectId` is "omit it for the open project" over HTTP and "omit it only for the open project, while the app runs" over stdio. `startRecording` and `stopRecording` say how each server makes a take ([below](#the-media-tools)), and the paths of `exportVideo` and `getFrames` must be absolute over HTTP: the app has no working directory of the client's.- **Messages**: no project to fall back on, a checkpoint required, an unknown checkpoint, edits turned off. Each has a version per transport, or exists only on the one that can produce it. The stdio versions are only met with no app answering, and say so.diff --git a/technical-documentation/testing/manual-e2e-checklist.md b/technical-documentation/testing/manual-e2e-checklist.mdindex e0677f047..79ec493cb 100644--- a/technical-documentation/testing/manual-e2e-checklist.md+++ b/technical-documentation/testing/manual-e2e-checklist.md@@ -693,9 +693,6 @@ The inspector's rail holds five facets: Composition (background, format, frame,- [ ] Repeat that in Media mode, in Record mode, and in Edit mode with the chat panel collapsed — the three states in which the dialog had no owner before, and the reason the row must not be Edit-only.- [ ] Connect or disconnect a provider from the menu's dialog while the chat panel is open behind it, close the dialog, and confirm the composer and the model pill follow without reopening the panel.- [ ] Open the wordmark menu, then press Escape, click elsewhere in the top bar, and click the wordmark again — confirm each closes it and that the window does not start dragging instead of registering the click.-- [ ] **post-1.10.0** — In a **packaged** build on a channel that owns its updates, right-click the tray icon and confirm an **Update Settings** submenu offers "Notify when an update is available", "Download updates automatically", and "Download and install updates automatically".-- [ ] **post-1.10.0** — Pick a mode, restart, and confirm it is still selected; `update-settings.json` in `userData` carries it.-- [ ] **post-1.10.0** — Confirm the submenu is absent in a dev build and in a build on a channel that does not own its updates (`app.isPackaged && ownsItsUpdates`), rather than present and inert.- [ ] **post-1.10.0** — Confirm a background check that finds nothing shows no dialog at all — the background path never reports "you are current".- [ ] **post-1.10.0** — Confirm a failed or unavailable download stops short of the restart prompt rather than offering to restart into an installer that was never fetched.- [ ] **post-1.10.0** — Reach **Save Diagnostics** from the tray context menu while idle, and from the Help menu on Windows and Linux (Alt) or the app menu on macOS; confirm each writes a bundle. It is deliberately not in the wordmark menu.@@ -713,9 +710,9 @@ The inspector's rail holds five facets: Composition (background, format, frame,### Updating in place — post-2.1.2-**Why this section is never skipped on a candidate.** An update is the one path a release cannot fix after the fact: a build whose updater is broken can only be left through that broken updater, so everyone who installs it stays on it. Run this section for every release candidate, on every platform, and for any change to `auto-updater.ts`, `background-update.ts`, `install-channel.ts`, `update-checker.ts`, `mcp/update-notice.ts`, the `before-quit` handler in `main.ts`, the NSIS or publish config in `electron-builder.json5`, or the feed scripts (`scripts/mac-update-feed.mjs`).+**Why this section is never skipped on a candidate.** An update is the one path a release cannot fix after the fact: a build whose updater is broken can only be left through that broken updater, so everyone who installs it stays on it. Run this section for every release candidate, on every platform, and for any change to `auto-updater.ts`, `background-update.ts`, `install-channel.ts`, `update-checker.ts`, `mcp/update-notice.ts`, the update code in `main.ts`, the NSIS or publish config in `electron-builder.json5`, or the feed scripts (`scripts/mac-update-feed.mjs`).-**A dev build cannot run it.** The background check, the button and the install on quit all require `app.isPackaged`, so `npm run dev` shows none of them. Test an installed build, on a channel that updates itself: NSIS, DMG, AppImage, deb, rpm or pacman. Never the Store package, which is kept current by the Store.+**A dev build cannot run it.** The background check and the update button both require `app.isPackaged`, so `npm run dev` shows none of them. Test an installed build, on a channel that updates itself: NSIS, DMG, AppImage, deb, rpm or pacman. Never the Store package, which is kept current by the Store.**Getting a newer version to update to.** Two ways, both against an installed build of the code under test.@@ -744,16 +741,15 @@ The inspector's rail holds five facets: Composition (background, format, frame,**How to tell an install happened.** The installed version may not move: a CI artifact carries the version in `package.json`, often the same as the last release. The tell is `app-update.yml`: the installer writes its own, so once an update went through, the file is back to `provider: github`.-**Before each run, and to clean up.** Empty the updater's cache, or a download from the previous run is reused without being fetched: `%LOCALAPPDATA%\openscreen-updater`, `~/Library/Caches/openscreen-updater` or `~/.cache/openscreen-updater`. Delete `update-settings.json` in `userData` to start from the default mode. Afterwards, restore the saved `app-update.yml` or reinstall, delete `mcp-update-check.json` from `userData`, and stop the local server.+**Before each run, and to clean up.** Empty the updater's cache, or a download from the previous run is reused without being fetched: `%LOCALAPPDATA%\openscreen-updater`, `~/Library/Caches/openscreen-updater` or `~/.cache/openscreen-updater`. Afterwards, restore the saved `app-update.yml` or reinstall, delete `mcp-update-check.json` from `userData`, and stop the local server.**What to watch.** The first check runs a minute after launch, so wait at least that, plus the download. Nothing logs the updater itself; a failed check or download logs one `[updates]` line, which tray → *Save Diagnostics* keeps.-- [ ] **post-2.1.2** — Launch the installed build and wait. Confirm no dialog opens at any point. A blue update button appears in the HUD bar, just before the language button, and in the editor's top bar, just before Export, and the tray gains *Update to <version>*. In the two download modes it appears once the download has finished; in "Notify" at once.+- [ ] **post-2.1.2** — Launch the installed build and wait. Confirm no dialog opens at any point. Once the download has finished, a blue update button appears in the HUD bar, just before the language button, and in the editor's top bar, just before Export, and the tray gains *Update to <version>*.- [ ] **post-2.1.2** — Start a recording and confirm the button is gone for the length of the take, then back.-- [ ] **post-2.1.2** — Click the button. In the two download modes the app restarts into the update; in "Notify" it downloads, then asks to restart.-- [ ] **post-2.1.2** — In "Download and install updates automatically", quit with the button showing (*Quit OpenScreen* on the HUD, or tray → *Quit*). Confirm no installer window and no relaunch, and that the update is installed when you next launch.-- [ ] **post-2.1.2** — Same mode, on a per-machine Windows install and on a deb, rpm or pacman install: quit with the button showing and confirm nothing installs and no UAC or password prompt appears. There the button is the only way, and clicking it does raise the prompt.-- [ ] **post-2.1.2** — Same mode, with an agent's session open: start `Openscreen mcp` in a terminal and leave it waiting on its input, or connect Claude Code or Codex to it. Quit OpenScreen and confirm nothing installs and the `mcp` process is still alive. Stop it, launch and quit again, and confirm the update installs.+- [ ] **post-2.1.2** — Quit with the button showing (*Quit OpenScreen* on the HUD, or tray → *Quit*), then relaunch. Confirm nothing installed on the way out: no installer, no UAC or password prompt, `app-update.yml` unchanged. The button is back a minute later. Only a click installs.+- [ ] **post-2.1.2** — Click the button. Confirm the app restarts into the update. On a per-machine Windows install, and on deb, rpm or pacman, the system asks for an administrator first (UAC, or the password dialog), and the update installs once granted.+- [ ] **post-2.1.2** — With an agent's session open (`Openscreen mcp` started in a terminal and left waiting on its input, or Claude Code or Codex connected to it), click the button. On Windows the update ends that session, as the installer replaces every running copy. That is expected: the click is the user's decision. The agent's client gets the new version the next time it starts the server.- [ ] **post-2.1.2** — Stop the local server, or point `url` at a port nothing serves, and relaunch. Confirm the button still appears and opens the release page in the browser: when the self-updater fails, the release lookup on GitHub is the way out. This needs a GitHub release newer than the installed version, so run it on an RC whose stable successor is not out yet, or on any build older than the latest release.- [ ] **post-2.1.2** — The agent-only user. On the installed build, write `{"latestVersion":"9.9.9","checkedAt":<now in ms>}` to `mcp-update-check.json` in `userData`, then start `Openscreen mcp` and send it an `initialize` request. Confirm the `instructions` in the answer open with "OpenScreen 9.9.9 is available" and tell the agent never to update OpenScreen itself. Delete the file, and confirm a Store install, or a dev build, says nothing even with it present. No computer-use is needed: a client that prints the `initialize` answer is enough, such as a short Node script that spawns the process, writes one JSON-RPC line and reads the first non-blank line back. On Windows the first line Electron writes is blank.diff --git a/website/docs/faq.md b/website/docs/faq.mdindex b9a200c8b..d5894ce8e 100644--- a/website/docs/faq.md+++ b/website/docs/faq.md@@ -34,7 +34,7 @@ OpenScreen is a free, MIT-licensed screen recorder and video editor for Windows,- **huggingface.co, once.** The first transcription downloads the Whisper model, about 264 MB, and a voice-detection model under 1 MB, each checked against a SHA-256 hash. After that, transcription needs no connection.- **github.com, once per language.** On a machine with a GPU, the first English or French transcription also downloads the model that re-times each word: about 110 MB for English, 350 MB for French.-- **github.com and api.github.com.** Builds that update themselves check for a new release a minute after launch, then every six hours, and when you ask. By default they download it in the background and install it when you quit OpenScreen; **Update Settings** in the tray menu can make them only tell you instead.+- **github.com and api.github.com.** Builds that update themselves check for a new release a minute after launch, then every six hours, and when you ask. They download it in the background and show an update button; nothing is installed until you click it.- **fonts.googleapis.com, only for a font added in 1.x.** A custom annotation font added in an earlier version is still fetched at launch, though 2.x no longer draws it.- **PostHog, once a day.** An anonymous count of active installs, sent to PostHog's EU servers. It holds the app version, the operating system, the processor architecture, how the app was installed, whether it was used directly or through its MCP server by an AI agent, and whether it is the first count of the week and of the month. That is all: no installation identifier (each count gets a new random ID), no IP address kept, nothing about your recordings. Untick **Send Anonymous Usage Count** in the tray menu to turn it off, or set `DO_NOT_TRACK=1`.- **Your AI provider, only if you connect one.** Chat editing sends your messages and the project data it reads, such as the timeline and transcript. Caption translation sends the caption text. Both stay off until you connect a provider. See [AI editing](./ai-editing.md).diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/faq.md b/website/i18n/de/docusaurus-plugin-content-docs/current/faq.mdindex b7c9af2db..8781c949a 100644--- a/website/i18n/de/docusaurus-plugin-content-docs/current/faq.md+++ b/website/i18n/de/docusaurus-plugin-content-docs/current/faq.md@@ -34,7 +34,7 @@ OpenScreen ist ein kostenloser Bildschirmrekorder und Videoeditor unter MIT-Lize- **huggingface.co, einmalig.** Die erste Transkription lädt das Whisper-Modell herunter, etwa 264 MB, und ein Modell zur Spracherkennung unter 1 MB, jedes gegen einen SHA-256-Hash geprüft. Danach braucht die Transkription keine Verbindung mehr.- **github.com, einmal pro Sprache.** Auf einem Rechner mit GPU lädt die erste englische oder französische Transkription zusätzlich das Modell herunter, das jedes Wort neu zeitlich ausrichtet: etwa 110 MB für Englisch, 350 MB für Französisch.-- **github.com und api.github.com.** Builds, die sich selbst aktualisieren, suchen eine Minute nach dem Start, dann alle sechs Stunden und auf deine Anfrage nach einer neuen Version. Standardmäßig laden sie sie im Hintergrund herunter und installieren sie, wenn du OpenScreen beendest; mit **Update-Einstellungen** im Tray-Menü melden sie stattdessen nur, dass eine verfügbar ist.+- **github.com und api.github.com.** Builds, die sich selbst aktualisieren, suchen eine Minute nach dem Start, dann alle sechs Stunden und auf deine Anfrage nach einer neuen Version. Sie laden sie im Hintergrund herunter und zeigen eine Update-Schaltfläche; installiert wird erst, wenn du darauf klickst.- **fonts.googleapis.com, nur für eine in 1.x hinzugefügte Schrift.** Eine eigene Schrift für Annotationen, die in einer früheren Version hinzugefügt wurde, wird beim Start weiterhin geladen, obwohl 2.x sie nicht mehr zeichnet.- **PostHog, einmal täglich.** Eine anonyme Zählung aktiver Installationen, gesendet an die EU-Server von PostHog. Sie enthält die App-Version, das Betriebssystem, die Prozessorarchitektur, die Art der Installation, ob die App direkt oder über ihren MCP-Server von einem KI-Agenten genutzt wurde, und ob es die erste Zählung der Woche und des Monats ist. Mehr nicht: keine Installationskennung (jede Zählung erhält eine neue Zufalls-ID), keine gespeicherte IP-Adresse, nichts über deine Aufnahmen. Entferne im Menü des Symbols im Infobereich das Häkchen bei **Anonyme Nutzungszählung senden**, um sie abzuschalten, oder setze `DO_NOT_TRACK=1`.- **Dein KI-Anbieter, nur wenn du einen verbindest.** Die Chat-Bearbeitung sendet deine Nachrichten und die Projektdaten, die sie liest, etwa Zeitleiste und Transkript. Die Untertitelübersetzung sendet den Untertiteltext. Beides bleibt aus, bis du einen Anbieter verbindest. Siehe [KI-Bearbeitung](./ai-editing.md).diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/faq.md b/website/i18n/es/docusaurus-plugin-content-docs/current/faq.mdindex baa60908b..b6301d94b 100644--- a/website/i18n/es/docusaurus-plugin-content-docs/current/faq.md+++ b/website/i18n/es/docusaurus-plugin-content-docs/current/faq.md@@ -34,7 +34,7 @@ OpenScreen es un grabador de pantalla y editor de video gratis, con licencia MIT- **huggingface.co, una vez.** La primera transcripción descarga el modelo Whisper, de unos 264 MB, y un modelo de detección de voz de menos de 1 MB, cada uno verificado con un hash SHA-256. Después, la transcripción no necesita conexión.- **github.com, una vez por idioma.** En un equipo con GPU, la primera transcripción en inglés o en francés también descarga el modelo que vuelve a sincronizar cada palabra: unos 110 MB para el inglés, 350 MB para el francés.-- **github.com y api.github.com.** Las compilaciones que se actualizan solas buscan una nueva versión un minuto después de abrirse, luego cada seis horas, y cuando tú lo pides. De forma predeterminada, la descargan en segundo plano y la instalan cuando cierras OpenScreen; con **Ajustes de actualización**, en el menú de la bandeja, puedes hacer que solo te avisen.+- **github.com y api.github.com.** Las compilaciones que se actualizan solas buscan una nueva versión un minuto después de abrirse, luego cada seis horas, y cuando tú lo pides. La descargan en segundo plano y muestran un botón de actualización; no se instala nada hasta que haces clic en él.- **fonts.googleapis.com, solo para una fuente añadida en 1.x.** Una fuente personalizada para anotaciones añadida en una versión anterior se sigue descargando al iniciar, aunque la 2.x ya no la dibuja.- **PostHog, una vez al día.** Un recuento anónimo de instalaciones activas, enviado a los servidores de PostHog en la UE. Contiene la versión de la app, el sistema operativo, la arquitectura del procesador, cómo se instaló la app, si se usó directamente o a través de su servidor MCP por un agente de IA, y si es el primer recuento de la semana y del mes. Nada más: ningún identificador de instalación (cada recuento recibe un ID aleatorio nuevo), ninguna dirección IP conservada, nada sobre tus grabaciones. Desmarca **Enviar recuento de uso anónimo** en el menú de la bandeja para desactivarlo, o define `DO_NOT_TRACK=1`.- **Tu proveedor de IA, solo si conectas uno.** La edición por chat envía tus mensajes y los datos del proyecto que lee, como la línea de tiempo y la transcripción. La traducción de subtítulos envía el texto de los subtítulos. Ambas permanecen desactivadas hasta que conectas un proveedor. Consulta [Edición con IA](./ai-editing.md).diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/faq.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/faq.mdindex 99f0cb11e..f08d54095 100644--- a/website/i18n/fr/docusaurus-plugin-content-docs/current/faq.md+++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/faq.md@@ -34,7 +34,7 @@ OpenScreen est un enregistreur d'écran et éditeur vidéo gratuit, sous licence- **huggingface.co, une fois.** La première transcription télécharge le modèle Whisper, environ 264 Mo, et un modèle de détection de la voix de moins de 1 Mo, chacun vérifié à l'aide d'une empreinte SHA-256. Ensuite, la transcription n'a plus besoin de connexion.- **github.com, une fois par langue.** Sur une machine dotée d'un GPU, la première transcription en anglais ou en français télécharge aussi le modèle qui recale chaque mot dans le temps : environ 110 Mo pour l'anglais, 350 Mo pour le français.-- **github.com et api.github.com.** Les versions qui se mettent à jour d'elles-mêmes vérifient la présence d'une nouvelle version une minute après le lancement, puis toutes les six heures, et quand vous le demandez. Par défaut, elles la téléchargent en arrière-plan et l'installent quand vous quittez OpenScreen ; **Paramètres de mise à jour**, dans le menu de la barre système, permet de vous contenter d'un signalement.+- **github.com et api.github.com.** Les versions qui se mettent à jour d'elles-mêmes vérifient la présence d'une nouvelle version une minute après le lancement, puis toutes les six heures, et quand vous le demandez. Elles la téléchargent en arrière-plan et affichent un bouton de mise à jour ; rien n'est installé tant que vous n'avez pas cliqué dessus.- **fonts.googleapis.com, seulement pour une police ajoutée en 1.x.** Une police d'annotation personnalisée ajoutée dans une version précédente est encore téléchargée au lancement, bien que la 2.x ne l'affiche plus.- **PostHog, une fois par jour.** Un comptage anonyme des installations actives, envoyé aux serveurs de PostHog dans l'UE. Il contient la version de l'application, le système d'exploitation, l'architecture du processeur, le mode d'installation de l'application, si elle a servi directement ou à un agent IA via son serveur MCP, et s'il s'agit du premier comptage de la semaine et du mois. C'est tout : aucun identifiant d'installation (chaque comptage reçoit un nouvel identifiant aléatoire), aucune adresse IP conservée, rien sur vos enregistrements. Décochez **Envoyer le comptage d'utilisation anonyme** dans le menu de l'icône de la zone de notification pour le désactiver, ou définissez `DO_NOT_TRACK=1`.- **Votre fournisseur d'IA, seulement si vous en connectez un.** Le montage par chat envoie vos messages et les données du projet qu'il lit, comme la timeline et la transcription. La traduction des sous-titres envoie le texte des sous-titres. Les deux restent désactivés tant que vous n'avez pas connecté de fournisseur. Voir [Montage par IA](./ai-editing.md).diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/faq.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/faq.mdindex f01843783..43a7dad22 100644--- a/website/i18n/ja/docusaurus-plugin-content-docs/current/faq.md+++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/faq.md@@ -34,7 +34,7 @@ OpenScreen は、Windows、macOS、Linux に対応した、MIT ライセンス- **huggingface.co(一度だけ)。** 最初の文字起こしで約 264 MB の Whisper モデルと、1 MB 未満の音声検出モデルをダウンロードし、それぞれ SHA-256 ハッシュで検証します。それ以降、文字起こしに接続は必要ありません。- **github.com(言語ごとに一度だけ)。** GPU を搭載したマシンでは、英語またはフランス語の最初の文字起こしで、各単語のタイミングを付け直すモデルもダウンロードします。英語は約 110 MB、フランス語は約 350 MB です。-- **github.com と api.github.com。** 自動でアップデートするビルドは、起動の 1 分後、その後は 6 時間ごと、そしてユーザーが求めたときに、新しいリリースを確認します。既定では、バックグラウンドでダウンロードし、OpenScreen を終了したときにインストールします。トレイメニューの **アップデート設定** で、知らせるだけにもできます。+- **github.com と api.github.com。** 自動でアップデートするビルドは、起動の 1 分後、その後は 6 時間ごと、そしてユーザーが求めたときに、新しいリリースを確認します。バックグラウンドでダウンロードしてアップデートボタンを表示し、ボタンをクリックするまでは何もインストールしません。- **fonts.googleapis.com(1.x で追加したフォントのみ)。** 以前のバージョンで追加したカスタムの注釈フォントは、2.x では描画されませんが、起動時に引き続き読み込まれます。- **PostHog(1 日 1 回)。** アクティブなインストール数の匿名カウントで、PostHog の EU サーバーに送信されます。内容は、アプリのバージョン、OS、プロセッサのアーキテクチャ、アプリのインストール方法、アプリが直接使われたか AI エージェントが MCP サーバー経由で使ったか、そしてその週とその月で最初のカウントかどうかです。それ以外は何もありません。インストールを識別する ID はなく(カウントごとに新しいランダム ID が付きます)、IP アドレスは保持されず、録画に関する情報も一切含みません。無効にするには、トレイメニューの**匿名の利用カウントを送信**のチェックを外すか、`DO_NOT_TRACK=1` を設定します。- **AI プロバイダー(接続した場合のみ)。** チャット編集では、あなたのメッセージと、エージェントが読み取るプロジェクトのデータ(タイムラインや文字起こしなど)が送信されます。字幕の翻訳では、字幕のテキストが送信されます。どちらも、プロバイダーを接続するまではオフです。[AI 編集](./ai-editing.md)を参照してください。diff --git a/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/faq.md b/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/faq.mdindex b38c45de5..e092ad336 100644--- a/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/faq.md+++ b/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/faq.md@@ -34,7 +34,7 @@ O OpenScreen é um gravador de tela e editor de vídeo gratuito, com licença MI- **huggingface.co, uma vez.** A primeira transcrição baixa o modelo Whisper, de cerca de 264 MB, e um modelo de detecção de voz com menos de 1 MB, cada um conferido com um hash SHA-256. Depois disso, a transcrição não precisa de conexão.- **github.com, uma vez por idioma.** Em uma máquina com GPU, a primeira transcrição em inglês ou em francês também baixa o modelo que reajusta o tempo de cada palavra: cerca de 110 MB para o inglês, 350 MB para o francês.-- **github.com e api.github.com.** Os builds que se atualizam sozinhos procuram uma nova versão um minuto depois de abrir, depois a cada seis horas, e quando você pede. Por padrão, eles a baixam em segundo plano e a instalam quando você fecha o OpenScreen; em **Configurações de atualização**, no menu da bandeja, você pode fazer com que só avisem.+- **github.com e api.github.com.** Os builds que se atualizam sozinhos procuram uma nova versão um minuto depois de abrir, depois a cada seis horas, e quando você pede. Eles a baixam em segundo plano e mostram um botão de atualização; nada é instalado até você clicar nele.- **fonts.googleapis.com, só para uma fonte adicionada na 1.x.** Uma fonte personalizada de anotação adicionada numa versão anterior ainda é baixada na inicialização, embora a 2.x não a desenhe mais.- **PostHog, uma vez por dia.** Uma contagem anônima de instalações ativas, enviada aos servidores do PostHog na UE. Ela contém a versão do app, o sistema operacional, a arquitetura do processador, como o app foi instalado, se foi usado diretamente ou pelo seu servidor MCP por um agente de IA, e se é a primeira contagem da semana e do mês. Só isso: nenhum identificador de instalação (cada contagem recebe um ID aleatório novo), nenhum endereço IP guardado, nada sobre suas gravações. Desmarque **Enviar contagem de uso anônima** no menu da bandeja para desativá-la, ou defina `DO_NOT_TRACK=1`.- **Seu provedor de IA, somente se você conectar um.** A edição por chat envia suas mensagens e os dados do projeto que ela lê, como a linha do tempo e a transcrição. A tradução de legendas envia o texto das legendas. As duas ficam desativadas até você conectar um provedor. Veja [Edição com IA](./ai-editing.md).diff --git a/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/faq.md b/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/faq.mdindex 23015732a..e0ebd7aef 100644--- a/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/faq.md+++ b/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/faq.md@@ -34,7 +34,7 @@ OpenScreen 是一款免费的录屏与视频剪辑软件,采用 MIT 许可证- **huggingface.co,仅一次**。第一次转录时会下载约 264 MB 的 Whisper 模型,以及一个不到 1 MB 的语音检测模型,每个都用 SHA-256 哈希值进行校验。此后转录无需联网。- **github.com,每种语言一次**。在带 GPU 的电脑上,第一次进行英语或法语转录时,还会下载为每个词重新计时的模型:英语约 110 MB,法语约 350 MB。-- **github.com 和 api.github.com**。能够自动更新的版本在启动一分钟后检查一次新版本,之后每六小时检查一次,你手动检查时也会连接。默认情况下,它们会在后台下载新版本,并在你退出 OpenScreen 时安装;在托盘菜单的 **更新设置** 中,可以改为只通知你。+- **github.com 和 api.github.com**。能够自动更新的版本在启动一分钟后检查一次新版本,之后每六小时检查一次,你手动检查时也会连接。它们会在后台下载新版本并显示更新按钮;在你点击之前不会安装任何内容。- **fonts.googleapis.com,仅限 1.x 中添加的字体**。在早期版本中添加的自定义标注字体仍会在启动时加载,尽管 2.x 已不再绘制它。- **PostHog,每天一次**。活跃安装数的匿名计数,发送到 PostHog 位于欧盟的服务器。它包含应用版本、操作系统、处理器架构、应用的安装方式、应用是被直接使用还是由 AI 智能体通过其 MCP 服务器使用,以及这是否为当周和当月的首次计数。仅此而已:没有安装标识符(每次计数都使用新的随机 ID),不保留 IP 地址,不涉及你的录制内容。要关闭它,请在托盘菜单中取消勾选**发送匿名使用计数**,或设置 `DO_NOT_TRACK=1`。- **你的 AI 提供方,仅在你连接之后**。聊天编辑会发送你的消息以及它读取的项目数据,例如时间轴和转录文本。字幕翻译会发送字幕文本。在你连接提供方之前,这两项功能都处于关闭状态。请参阅 [AI 编辑](./ai-editing.md)。diff --git a/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/faq.md b/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/faq.mdindex 5bb6f9394..7297b65d3 100644--- a/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/faq.md+++ b/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/faq.md@@ -34,7 +34,7 @@ OpenScreen 是一款採用 MIT 授權的免費螢幕錄影與影片剪輯軟體- **huggingface.co,只有一次。** 第一次轉錄時會下載 Whisper 模型(約 264 MB)與一個小於 1 MB 的語音偵測模型,每個都以 SHA-256 雜湊值驗證。之後轉錄就不再需要網路連線。- **github.com,每種語言一次。** 在有 GPU 的電腦上,第一次進行英文或法文轉錄時,還會下載為每個字詞重新對時的模型:英文約 110 MB,法文約 350 MB。-- **github.com 與 api.github.com。** 會自行更新的版本在啟動一分鐘後檢查一次新版本,之後每六小時檢查一次,你手動要求時也會檢查。預設會在背景下載新版本,並在你結束 OpenScreen 時安裝;在系統匣選單的 **更新設定** 中,可以改為只通知你。+- **github.com 與 api.github.com。** 會自行更新的版本在啟動一分鐘後檢查一次新版本,之後每六小時檢查一次,你手動要求時也會檢查。它們會在背景下載新版本並顯示更新按鈕;在你點擊之前不會安裝任何內容。- **fonts.googleapis.com,僅限 1.x 中加入的字體。** 在先前版本中加入的自訂標註字體仍會在啟動時載入,儘管 2.x 已不再繪製它。- **PostHog,每天一次。** 活躍安裝數的匿名計數,會送到 PostHog 位於歐盟的伺服器。內容包括應用程式版本、作業系統、處理器架構、應用程式的安裝方式、應用程式是直接使用還是由 AI 代理透過其 MCP 伺服器使用,以及這是否為當週與當月的第一次計數。僅此而已:沒有安裝識別碼(每次計數都使用新的隨機 ID),不保留 IP 位址,也不含任何與你錄影有關的資訊。若要關閉,請在系統匣選單中取消勾選**傳送匿名使用計數**,或設定 `DO_NOT_TRACK=1`。- **你的 AI 提供者,僅在你連接時。** 聊天剪輯會送出你的訊息,以及它讀取的專案資料,例如時間軸與逐字稿。字幕翻譯會送出字幕文字。在你連接提供者之前,這兩項功能都保持關閉。請參閱 [AI 剪輯](./ai-editing.md)。