Skip to content

Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.

fix(mcp): report a failed sidecar write as a partial edit, document checkpoint eviction

EtienneLescotd6599950c9dd
diff --git a/electron/mcp/media-tools.test.ts b/electron/mcp/media-tools.test.ts
index 67390b7a4..ef69bfd07 100644
--- a/electron/mcp/media-tools.test.ts
+++ b/electron/mcp/media-tools.test.ts
@@ -454,6 +454,20 @@ describe("setPointerTrack", () => {
expect(await sidecarFile(take.videoPath)).toBe(first);
});
+ it("says the edit is partial when the project saved but the track could not be written", async () => {
+ await fs.rm(`${videoPath}.cursor.json`);
+ const take = await recordTake();
+ // A directory where the sidecar goes: the save succeeds, the sidecar write cannot.
+ await fs.mkdir(`${take.videoPath}.cursor.json`);
+ const set = await call("setPointerTrack", {
+ projectId: take.projectId,
+ events: clickAt(take, 0.2),
+ });
+ expect(set.isError).toBe(true);
+ expect(textOf(set)).toContain("The project was saved, but the pointer track");
+ expect(textOf(set)).not.toContain("Tool failed");
+ });
+
it("refuses a project whose take this server did not record", async () => {
const other = await documents.createProject("Imported");
const refused = await call("setPointerTrack", {
diff --git a/electron/mcp/openscreen-mcp-server.ts b/electron/mcp/openscreen-mcp-server.ts
index 1fb7e1971..f9cef6cce 100644
--- a/electron/mcp/openscreen-mcp-server.ts
+++ b/electron/mcp/openscreen-mcp-server.ts
@@ -370,17 +370,31 @@ export function createToolRunner(deps: McpToolDeps) {
return false;
}
- /** Writes an edit's sidecars, first keeping what each held for the project's checkpoints. */
- async function writeSidecars(projectId: string, writes: readonly SidecarWrite[]) {
- for (const { path, content } of writes) {
- const before = await readSidecar(path);
- for (const checkpoint of checkpoints.values()) {
- if (checkpoint.document.project.id === projectId && !checkpoint.sidecars.has(path)) {
- checkpoint.sidecars.set(path, before);
+ /**
+ * Writes an edit's sidecars, first keeping what each held for the project's checkpoints.
+ * Runs once the document is saved, so a failure here is a partial edit, said as one.
+ */
+ async function writeSidecars(
+ projectId: string,
+ writes: readonly SidecarWrite[] = [],
+ ): Promise<CallToolResult | null> {
+ try {
+ for (const { path, content } of writes) {
+ const before = await readSidecar(path);
+ for (const checkpoint of checkpoints.values()) {
+ if (checkpoint.document.project.id === projectId && !checkpoint.sidecars.has(path)) {
+ checkpoint.sidecars.set(path, before);
+ }
}
+ if (content === null) await fs.rm(path, { force: true });
+ else await fs.writeFile(path, content, "utf8");
}
- if (content === null) await fs.rm(path, { force: true });
- else await fs.writeFile(path, content, "utf8");
+ return null;
+ } catch (error) {
+ return textResult(
+ `The project was saved, but the pointer track beside its video was NOT written: ${errorMessage(error)}. Call this tool again to write it, or restoreCheckpoint to take the project back.`,
+ true,
+ );
}
}
@@ -413,7 +427,8 @@ export function createToolRunner(deps: McpToolDeps) {
if (execution.document) {
const applied = await deps.host.apply(execution.document, snapshot.revision);
if (applied !== "applied") return textResult(APPLY_FAILURE_MESSAGES[applied], true);
- await writeSidecars(execution.document.project.id, execution.sidecars ?? []);
+ const partial = await writeSidecars(execution.document.project.id, execution.sidecars);
+ if (partial) return partial;
}
return textResult(execution.resultJson, !execution.ok);
}
@@ -444,7 +459,8 @@ export function createToolRunner(deps: McpToolDeps) {
return textResult(PROJECT_CHANGED_MESSAGE, true);
}
// After the save, so an edit refused above has written nothing at all.
- await writeSidecars(projectId, execution.sidecars ?? []);
+ const partial = await writeSidecars(projectId, execution.sidecars);
+ if (partial) return partial;
}
return textResult(execution.resultJson, !execution.ok);
}
diff --git a/skills/openscreen-demo/SKILL.md b/skills/openscreen-demo/SKILL.md
index c1a3d4911..94362b8f5 100644
--- a/skills/openscreen-demo/SKILL.md
+++ b/skills/openscreen-demo/SKILL.md
@@ -82,7 +82,7 @@ Use the document tools, always with the `projectId`. Read the project first with
- **Cut dead time:** the setup at the start, the stop at the end, any wait. Use `addTrims`, or `addSpeed` to fast-forward a wait instead of cutting it.
- **Zoom on the action:** clicks close in time and on screen share one zoom, and the first 2.5 s stay wide. Check them, then add or move zooms with `addZooms` and `setZoom` where a result deserves its own. Hold a zoom at least 1.5 s.
- **Callouts:** one `addAnnotation` per beat, short, placed clear of the action. Text sits on the output frame and stays put when the picture zooms. Use its look for hierarchy: a large title with `animation: "typewriter"`, step callouts with `animation: "pop"`. `setAnnotation` moves or restyles one.
-- **Undo:** `restoreCheckpoint` with the `checkpointId` takes the project back to the raw take in one step, the pointer track from `setPointerTrack` included.
+- **Undo:** `restoreCheckpoint` with the `checkpointId` takes the project back to the raw take in one step. It also puts back the take's own pointer track, undoing any `setPointerTrack` made since.
- **Open in the app:** while the user has this project open in the OpenScreen editor, every edit is refused, since the editor would save its own copy over yours. Reads still work. Ask them to close the project there, then retry.
Keep the rest as it is: the background, padding, shadow and cursor style are chosen to look good.
diff --git a/technical-documentation/architecture/mcp-server.md b/technical-documentation/architecture/mcp-server.md
index 97f5a6cc3..17fba1657 100644
--- a/technical-documentation/architecture/mcp-server.md
+++ b/technical-documentation/architecture/mcp-server.md
@@ -116,7 +116,7 @@ A client chains several edits in one turn, and each is its own undo step, so rev
`registerMediaTools` adds the tools that make a video around the edits. They share the runner the document tools use (`createToolRunner` in `stdio-server.ts`):
- `stopRecording` turns the take into a project and creates its checkpoint through the runner.
-- `setPointerTrack` gives a script-driven take a pointer track and plans zooms on its clicks. It computes the new sidecar and the zooms from the project the runner read, writes nothing itself, and hands both to the runner as a `RunnerEdit`. The runner then applies the same refusals as any edit (another process's editor, no checkpoint, a project changed mid-call) before writing anything, saves the project, and only then writes the sidecar, keeping its previous content for the checkpoints. Every refusal comes back as the tool's own text result.
+- `setPointerTrack` gives a script-driven take a pointer track and plans zooms on its clicks. It computes the new sidecar and the zooms from the project the runner read, writes nothing itself, and hands both to the runner as a `RunnerEdit`. The runner then applies the same refusals as any edit (another process's editor, no checkpoint, a project changed mid-call) before writing anything, saves the project, and only then writes the sidecar, keeping its previous content for the checkpoints. Every refusal comes back as the tool's own text result. A sidecar write that fails after the save is reported as a partial edit: the project was saved, the pointer track was not.
- `exportVideo` and `getFrames` read projects; they write none.
## Transport and security
diff --git a/website/docs/ai-editing.md b/website/docs/ai-editing.md
index 0a2d7e2b5..1882aa709 100644
--- a/website/docs/ai-editing.md
+++ b/website/docs/ai-editing.md
@@ -72,7 +72,7 @@ The tools are the ones the built-in agent uses. They act on the project open in
- **On the project open in the editor**, an edit is undone with `Ctrl/Cmd + Z`. Clients are told to save a checkpoint before a series of edits, so you can ask them to put the project back as it was in a single step, which `Ctrl/Cmd + Z` can itself undo.
- **On any other project**, an edit is saved to its file, where `Ctrl/Cmd + Z` cannot reach it. A client must save a checkpoint of that project before its first edit, and putting the project back from it is the only undo.
-Checkpoints are kept in OpenScreen's memory: they are lost when it quits or when the server restarts, which changing the port or regenerating the token does. **Regenerate** the token to disconnect every client set up with the old one.
+Checkpoints are kept in OpenScreen's memory: they are lost when it quits or when the server restarts, which changing the port or regenerating the token does. Only the 20 most recent checkpoints are kept, so an older one can be gone sooner. **Regenerate** the token to disconnect every client set up with the old one.
## Letting an agent make the whole video
@@ -94,7 +94,7 @@ codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscr
The executable on each system is listed in [Running the CLI](./cli.md#running-the-cli).
- **No port, no token, no setting.** The agent starts the process itself, with your rights, as it would run `openscreen record`. So it can record your screen and edit without the **MCP edits** switch.
-- **Each take becomes a new project** in your project list, zoomed on its clicks as a recording made in the app is: clicks close in time and on screen share one zoom, and the first seconds and the end stay on the whole screen. Every edit the agent makes is saved to the project's file. Its undo is the checkpoint the agent takes, which lasts until the agent's session ends.
+- **Each take becomes a new project** in your project list, zoomed on its clicks as a recording made in the app is: clicks close in time and on screen share one zoom, and the first seconds and the end stay on the whole screen. Every edit the agent makes is saved to the project's file. Its undo is the checkpoint the agent takes, which lasts until the agent's session ends. Only the 20 most recent checkpoints are kept, so an older one can be gone sooner.
- **A project open in the OpenScreen editor is off limits.** The agent can read it, but its edits are refused until you close the project there, since the editor would save its own copy over them.
- **A take driven by a script** (Playwright, for example) never moves the screen pointer. The agent hands OpenScreen its own log of the actions with `setPointerTrack`, and the video gets a cursor and its zooms all the same.
- **The `openscreen-demo` skill** teaches an agent the whole job, from the storyboard to the finished video. It then attaches the video to a pull request, so reviewers watch the change in place, or drafts a post on X that it publishes only once you say yes. Add it with `npx skills add getopenscreen/openscreen --skill openscreen-demo`. The recipe is [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/de/docusaurus-plugin-content-docs/current/ai-editing.md
index 6f64cf87f..d71a93389 100644
--- a/website/i18n/de/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/de/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -72,7 +72,7 @@ Die Werkzeuge sind die, die der eingebaute Agent nutzt. Sie wirken auf das im Ed
- **Am im Editor geöffneten Projekt** wird eine Änderung mit `Ctrl/Cmd + Z` rückgängig gemacht. Clients werden angewiesen, vor einer Reihe von Änderungen einen Wiederherstellungspunkt zu speichern. So kannst du sie bitten, das Projekt in einem einzigen Schritt wiederherzustellen, wie es war, und auch diesen Schritt kann `Ctrl/Cmd + Z` rückgängig machen.
- **An jedem anderen Projekt** wird eine Änderung in seiner Datei gespeichert, wo `Ctrl/Cmd + Z` sie nicht erreicht. Ein Client muss vor der ersten Änderung einen Wiederherstellungspunkt dieses Projekts speichern, und dorthin zurückzukehren ist der einzige Weg, sie rückgängig zu machen.
-Wiederherstellungspunkte liegen im Speicher von OpenScreen: Sie gehen verloren, wenn OpenScreen beendet wird oder der Server neu startet, was ein Wechsel des Ports oder ein neues Token bewirkt. Wenn du das Token mit **Regenerate** ersetzt, werden alle Clients getrennt, die mit dem alten eingerichtet wurden.
+Wiederherstellungspunkte liegen im Speicher von OpenScreen: Sie gehen verloren, wenn OpenScreen beendet wird oder der Server neu startet, was ein Wechsel des Ports oder ein neues Token bewirkt. Nur die 20 neuesten Wiederherstellungspunkte werden behalten, ein älterer kann also früher verschwinden. Wenn du das Token mit **Regenerate** ersetzt, werden alle Clients getrennt, die mit dem alten eingerichtet wurden.
## Einen Agenten das ganze Video erstellen lassen {#letting-an-agent-make-the-whole-video}
@@ -94,7 +94,7 @@ codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscr
Die ausführbare Datei für jedes System steht unter [Die CLI ausführen](./cli.md#running-the-cli).
- **Kein Port, kein Token, keine Einstellung.** Der Agent startet den Prozess selbst, mit deinen Rechten, so wie er `openscreen record` ausführen würde. Deshalb kann er deinen Bildschirm aufnehmen und bearbeiten, ohne den Schalter **MCP-Änderungen**.
-- **Jeder Take wird zu einem neuen Projekt** in deiner Projektliste, mit Zooms auf seine Klicks, wie eine in der App gemachte Aufnahme: Zeitlich und räumlich nah beieinanderliegende Klicks teilen sich einen Zoom, und die ersten Sekunden und das Ende bleiben auf dem ganzen Bildschirm. Jede Änderung des Agenten wird in der Projektdatei gespeichert. Rückgängig macht sie der Wiederherstellungspunkt, den der Agent anlegt und der bis zum Ende seiner Sitzung besteht.
+- **Jeder Take wird zu einem neuen Projekt** in deiner Projektliste, mit Zooms auf seine Klicks, wie eine in der App gemachte Aufnahme: Zeitlich und räumlich nah beieinanderliegende Klicks teilen sich einen Zoom, und die ersten Sekunden und das Ende bleiben auf dem ganzen Bildschirm. Jede Änderung des Agenten wird in der Projektdatei gespeichert. Rückgängig macht sie der Wiederherstellungspunkt, den der Agent anlegt und der bis zum Ende seiner Sitzung besteht. Nur die 20 neuesten Wiederherstellungspunkte werden behalten, ein älterer kann also früher verschwinden.
- **Ein im OpenScreen-Editor geöffnetes Projekt ist tabu.** Der Agent kann es lesen, aber seine Änderungen werden abgelehnt, bis du das Projekt dort schließt, denn der Editor würde seine eigene Kopie darüber speichern.
- **Ein per Skript gesteuerter Take** (zum Beispiel mit Playwright) bewegt nie den Zeiger auf dem Bildschirm. Der Agent übergibt OpenScreen mit `setPointerTrack` sein eigenes Protokoll der Aktionen, und das Video bekommt trotzdem einen Cursor und dessen Zooms.
- **Der Skill `openscreen-demo`** bringt einem Agenten die ganze Arbeit bei, vom Storyboard bis zum fertigen Video. Danach hängt er das Video an einen Pull Request, damit die Reviewer die Änderung direkt dort sehen, oder entwirft einen Post auf X, den er erst veröffentlicht, wenn du Ja sagst. Füge ihn mit `npx skills add getopenscreen/openscreen --skill openscreen-demo` hinzu. Das Rezept ist [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/es/docusaurus-plugin-content-docs/current/ai-editing.md
index 073eecc33..826252ba0 100644
--- a/website/i18n/es/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/es/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -72,7 +72,7 @@ Las herramientas son las que usa el agente integrado. Actúan sobre el proyecto
- **En el proyecto abierto en el editor**, una edición se deshace con `Ctrl/Cmd + Z`. A los clientes se les indica que guarden un punto de restauración antes de una serie de ediciones, así que puedes pedirles que dejen el proyecto como estaba en un solo paso, que el propio `Ctrl/Cmd + Z` puede deshacer.
- **En cualquier otro proyecto**, una edición se guarda en su archivo, fuera del alcance de `Ctrl/Cmd + Z`. Un cliente debe guardar un punto de restauración de ese proyecto antes de su primera edición, y volver a él es la única forma de deshacerla.
-Los puntos de restauración se guardan en la memoria de OpenScreen: se pierden cuando se cierra o cuando el servidor se reinicia, lo que ocurre al cambiar el puerto o regenerar el token. **Regenerar** el token desconecta a todos los clientes configurados con el anterior.
+Los puntos de restauración se guardan en la memoria de OpenScreen: se pierden cuando se cierra o cuando el servidor se reinicia, lo que ocurre al cambiar el puerto o regenerar el token. Solo se conservan los 20 puntos de restauración más recientes, así que uno más antiguo puede desaparecer antes. **Regenerar** el token desconecta a todos los clientes configurados con el anterior.
## Dejar que un agente haga todo el video {#letting-an-agent-make-the-whole-video}
@@ -94,7 +94,7 @@ codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscr
El ejecutable de cada sistema aparece en [Ejecutar la CLI](./cli.md#running-the-cli).
- **Sin puerto, sin token, sin ajuste.** El agente inicia el proceso él mismo, con tus permisos, como ejecutaría `openscreen record`. Así puede grabar tu pantalla y editar sin el interruptor **Ediciones por MCP**.
-- **Cada toma se convierte en un proyecto nuevo** en tu lista de proyectos, con zooms en sus clics, como una grabación hecha en la app: los clics cercanos en el tiempo y en la pantalla comparten un zoom, y los primeros segundos y el final se quedan en la pantalla completa. Cada edición del agente se guarda en el archivo del proyecto. Se deshace con el punto de restauración que toma el agente, que dura hasta que termina su sesión.
+- **Cada toma se convierte en un proyecto nuevo** en tu lista de proyectos, con zooms en sus clics, como una grabación hecha en la app: los clics cercanos en el tiempo y en la pantalla comparten un zoom, y los primeros segundos y el final se quedan en la pantalla completa. Cada edición del agente se guarda en el archivo del proyecto. Se deshace con el punto de restauración que toma el agente, que dura hasta que termina su sesión. Solo se conservan los 20 puntos de restauración más recientes, así que uno más antiguo puede desaparecer antes.
- **Un proyecto abierto en el editor de OpenScreen queda fuera de su alcance.** El agente puede leerlo, pero sus ediciones se rechazan hasta que cierres el proyecto ahí, porque el editor guardaría su propia copia encima.
- **Una toma controlada por un script** (Playwright, por ejemplo) nunca mueve el puntero de la pantalla. El agente le pasa a OpenScreen su propio registro de las acciones con `setPointerTrack`, y el video obtiene igualmente un cursor y sus zooms.
- **La skill `openscreen-demo`** le enseña a un agente todo el trabajo, desde el storyboard hasta el video terminado. Después adjunta el video a un pull request, para que los revisores vean el cambio ahí mismo, o redacta un post en X que solo publica cuando dices que sí. Agrégala con `npx skills add getopenscreen/openscreen --skill openscreen-demo`. La receta es [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/ai-editing.md
index 82198a338..bbb57d319 100644
--- a/website/i18n/fr/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -72,7 +72,7 @@ Les outils sont ceux qu'utilise l'agent intégré. Ils agissent sur le projet ou
- **Sur le projet ouvert dans l'éditeur**, une modification s'annule avec `Ctrl/Cmd + Z`. Les clients ont pour consigne d'enregistrer un point de restauration avant une série de modifications : vous pouvez donc leur demander de remettre le projet dans son état d'avant en une seule étape, que `Ctrl/Cmd + Z` peut lui-même annuler.
- **Sur tout autre projet**, une modification est enregistrée dans son fichier, hors de portée de `Ctrl/Cmd + Z`. Un client doit enregistrer un point de restauration de ce projet avant sa première modification, et y revenir est la seule façon de l'annuler.
-Les points de restauration sont gardés dans la mémoire d'OpenScreen : ils sont perdus quand il quitte ou quand le serveur redémarre, ce que provoque un changement de port ou la régénération du jeton. **Régénérer** le jeton déconnecte tous les clients configurés avec l'ancien.
+Les points de restauration sont gardés dans la mémoire d'OpenScreen : ils sont perdus quand il quitte ou quand le serveur redémarre, ce que provoque un changement de port ou la régénération du jeton. Seuls les 20 points de restauration les plus récents sont gardés : un plus ancien peut disparaître avant. **Régénérer** le jeton déconnecte tous les clients configurés avec l'ancien.
## Laisser un agent faire toute la vidéo {#letting-an-agent-make-the-whole-video}
@@ -94,7 +94,7 @@ codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscr
L'exécutable de chaque système est indiqué dans [Lancer la CLI](./cli.md#running-the-cli).
- **Ni port, ni jeton, ni réglage.** L'agent lance lui-même le processus, avec vos droits, comme il lancerait `openscreen record`. Il peut donc enregistrer votre écran et faire des modifications sans l'interrupteur **Modifications par MCP**.
-- **Chaque prise devient un nouveau projet** dans votre liste de projets, zoomé sur ses clics comme un enregistrement fait dans l'application : des clics rapprochés dans le temps et à l'écran partagent un zoom, et les premières secondes comme la fin restent sur l'écran entier. Chaque modification de l'agent est enregistrée dans le fichier du projet. Elle s'annule avec le point de restauration que prend l'agent, qui dure jusqu'à la fin de sa session.
+- **Chaque prise devient un nouveau projet** dans votre liste de projets, zoomé sur ses clics comme un enregistrement fait dans l'application : des clics rapprochés dans le temps et à l'écran partagent un zoom, et les premières secondes comme la fin restent sur l'écran entier. Chaque modification de l'agent est enregistrée dans le fichier du projet. Elle s'annule avec le point de restauration que prend l'agent, qui dure jusqu'à la fin de sa session. Seuls les 20 points de restauration les plus récents sont gardés : un plus ancien peut disparaître avant.
- **Un projet ouvert dans l'éditeur d'OpenScreen est hors de portée.** L'agent peut le lire, mais ses modifications sont refusées tant que vous ne l'avez pas fermé dans l'éditeur, qui enregistrerait sinon sa propre copie par-dessus.
- **Une prise pilotée par un script** (Playwright, par exemple) ne déplace jamais le pointeur de l'écran. L'agent transmet à OpenScreen son propre journal des actions avec `setPointerTrack`, et la vidéo a malgré tout un curseur et ses zooms.
- **La skill `openscreen-demo`** enseigne à un agent tout le travail, du storyboard jusqu'à la vidéo finie. Il joint ensuite la vidéo à une pull request, pour que les relecteurs voient le changement sur place, ou rédige un post sur X qu'il ne publie qu'une fois que vous avez dit oui. Ajoutez-la avec `npx skills add getopenscreen/openscreen --skill openscreen-demo`. La recette est [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/ai-editing.md
index ce236f14a..f02fd367b 100644
--- a/website/i18n/ja/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -72,7 +72,7 @@ Claude Code や Codex などの AI コーディングエージェントをすで
- **エディターで開いているプロジェクト**では、編集は `Ctrl/Cmd + Z` で元に戻せます。クライアントには一連の編集の前にチェックポイントを保存するよう指示されているため、プロジェクトを 1 回の操作で元の状態に戻すよう頼むことができ、その操作自体も `Ctrl/Cmd + Z` で取り消せます。
- **それ以外のプロジェクト**では、編集はそのファイルに保存され、`Ctrl/Cmd + Z` では元に戻せません。クライアントは最初の編集の前にそのプロジェクトのチェックポイントを保存する必要があり、そこへ戻すことが唯一の取り消し方法です。
-チェックポイントは OpenScreen のメモリーに保持され、OpenScreen を終了したときやサーバーが再起動したときに失われます。ポートを変更したりトークンを再生成したりすると、サーバーは再起動します。トークンを**再生成**すると、古いトークンで設定したクライアントはすべて切断されます。
+チェックポイントは OpenScreen のメモリーに保持され、OpenScreen を終了したときやサーバーが再起動したときに失われます。ポートを変更したりトークンを再生成したりすると、サーバーは再起動します。保持されるのは直近 20 個のチェックポイントだけなので、古いものはそれより前に消えることがあります。トークンを**再生成**すると、古いトークンで設定したクライアントはすべて切断されます。
## エージェントに動画全体を作らせる {#letting-an-agent-make-the-whole-video}
@@ -94,7 +94,7 @@ codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscr
各システムでの実行ファイルは、[CLI の実行](./cli.md#running-the-cli)に記載しています。
- **ポートも、トークンも、設定も不要。** エージェントは、`openscreen record` を実行するときと同じように、あなたの権限でプロセスを自分で起動します。そのため、**MCP による編集**スイッチなしで、画面を録画し、編集できます。
-- **テイクはそれぞれ新しいプロジェクトになり**、プロジェクト一覧に表示されます。アプリで作った録画と同じく、記録されたクリックにズームが付きます。時間的にも画面上でも近いクリックは1つのズームにまとめられ、最初の数秒と最後は画面全体のままです。エージェントによる編集はすべてプロジェクトのファイルに保存されます。元に戻すには、エージェントが作成するチェックポイントを使います。チェックポイントはエージェントのセッションが終わるまで有効です。
+- **テイクはそれぞれ新しいプロジェクトになり**、プロジェクト一覧に表示されます。アプリで作った録画と同じく、記録されたクリックにズームが付きます。時間的にも画面上でも近いクリックは1つのズームにまとめられ、最初の数秒と最後は画面全体のままです。エージェントによる編集はすべてプロジェクトのファイルに保存されます。元に戻すには、エージェントが作成するチェックポイントを使います。チェックポイントはエージェントのセッションが終わるまで有効です。保持されるのは直近 20 個のチェックポイントだけなので、古いものはそれより前に消えることがあります。
- **OpenScreen のエディターで開いているプロジェクトは編集できません。** エージェントは読み取れますが、そこでプロジェクトを閉じるまで編集は拒否されます。エディターが自分のコピーで上書きしてしまうためです。
- **スクリプトで操作するテイク**(たとえば Playwright)では、画面のポインターはまったく動きません。エージェントが `setPointerTrack` で自分の操作ログを OpenScreen に渡せば、動画には同じようにカーソルとそのズームが付きます。
- **`openscreen-demo` スキル**は、絵コンテから完成した動画まで、作業全体をエージェントに教えます。そのあとエージェントは、レビュアーがその場で変更を確認できるよう動画をプルリクエストに添付するか、X への投稿を下書きします。投稿は、あなたが了承してはじめて公開されます。`npx skills add getopenscreen/openscreen --skill openscreen-demo` で追加します。手順は [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md) にあります。
diff --git a/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/ai-editing.md
index 5f06017aa..db8782cb1 100644
--- a/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/pt-BR/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -72,7 +72,7 @@ As ferramentas são as que o agente integrado usa. Elas agem sobre o projeto abe
- **No projeto aberto no editor**, uma edição se desfaz com `Ctrl/Cmd + Z`. Os clientes são instruídos a salvar um ponto de restauração antes de uma série de edições, então você pode pedir a eles que deixem o projeto como estava em um único passo, que o próprio `Ctrl/Cmd + Z` pode desfazer.
- **Em qualquer outro projeto**, uma edição é salva no arquivo dele, fora do alcance de `Ctrl/Cmd + Z`. Um cliente precisa salvar um ponto de restauração desse projeto antes da primeira edição, e voltar a ele é a única forma de desfazê-la.
-Os pontos de restauração ficam na memória do OpenScreen: eles se perdem quando ele é fechado ou quando o servidor reinicia, o que acontece ao mudar a porta ou gerar um novo token. **Gerar novo** token desconecta todos os clientes configurados com o antigo.
+Os pontos de restauração ficam na memória do OpenScreen: eles se perdem quando ele é fechado ou quando o servidor reinicia, o que acontece ao mudar a porta ou gerar um novo token. Só os 20 pontos de restauração mais recentes são mantidos, então um mais antigo pode sumir antes. **Gerar novo** token desconecta todos os clientes configurados com o antigo.
## Como deixar um agente fazer o vídeo inteiro {#letting-an-agent-make-the-whole-video}
@@ -94,7 +94,7 @@ codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscr
O executável de cada sistema está listado em [Como executar a CLI](./cli.md#running-the-cli).
- **Sem porta, sem token, sem configuração.** O agente inicia o processo por conta própria, com as suas permissões, como faria ao rodar `openscreen record`. Por isso ele pode gravar a sua tela e editar sem o interruptor **Edições via MCP**.
-- **Cada tomada vira um novo projeto** na sua lista de projetos, com zooms nos seus cliques, como uma gravação feita no app: cliques próximos no tempo e na tela dividem um zoom, e os primeiros segundos e o final ficam na tela inteira. Cada edição do agente é salva no arquivo do projeto. Ela se desfaz com o ponto de restauração que o agente cria, que dura até o fim da sessão dele.
+- **Cada tomada vira um novo projeto** na sua lista de projetos, com zooms nos seus cliques, como uma gravação feita no app: cliques próximos no tempo e na tela dividem um zoom, e os primeiros segundos e o final ficam na tela inteira. Cada edição do agente é salva no arquivo do projeto. Ela se desfaz com o ponto de restauração que o agente cria, que dura até o fim da sessão dele. Só os 20 pontos de restauração mais recentes são mantidos, então um mais antigo pode sumir antes.
- **Um projeto aberto no editor do OpenScreen fica fora do alcance.** O agente pode lê-lo, mas as edições dele são recusadas até você fechar o projeto ali, porque o editor salvaria a própria cópia por cima.
- **Uma tomada conduzida por um script** (o Playwright, por exemplo) nunca move o ponteiro da tela. O agente passa ao OpenScreen o próprio registro das ações com `setPointerTrack`, e o vídeo ganha um cursor e seus zooms do mesmo jeito.
- **A skill `openscreen-demo`** ensina a um agente o trabalho inteiro, do storyboard até o vídeo pronto. Depois ele anexa o vídeo a um pull request, para que os revisores vejam a mudança ali mesmo, ou redige um post no X que só publica depois que você disser sim. Adicione-a com `npx skills add getopenscreen/openscreen --skill openscreen-demo`. A receita é [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md).
diff --git a/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/ai-editing.md
index d801a7756..5feedb032 100644
--- a/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/zh-CN/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -72,7 +72,7 @@ ChatGPT 和 GitHub Copilot 登录选项已**在 1.8.0 中移除**。它们的工
- **对编辑器中打开的项目**,编辑可用 `Ctrl/Cmd + Z` 撤销。客户端会被要求在进行一系列编辑之前保存一个检查点,因此你可以让它们一步把项目恢复原样,而这一步本身也可以用 `Ctrl/Cmd + Z` 撤销。
- **对其他任何项目**,编辑会保存到它的文件中,`Ctrl/Cmd + Z` 无法撤销。客户端必须在第一次编辑之前保存该项目的检查点,恢复到这个检查点是唯一的撤销方式。
-检查点保存在 OpenScreen 的内存中:OpenScreen 退出或服务器重启时就会丢失,而更改端口或重新生成令牌都会让服务器重启。**重新生成**令牌,即可断开所有使用旧令牌配置的客户端。
+检查点保存在 OpenScreen 的内存中:OpenScreen 退出或服务器重启时就会丢失,而更改端口或重新生成令牌都会让服务器重启。只保留最近的 20 个检查点,因此较早的检查点可能会更早失效。**重新生成**令牌,即可断开所有使用旧令牌配置的客户端。
## 让 AI 代理制作整段视频 {#letting-an-agent-make-the-whole-video}
@@ -94,7 +94,7 @@ codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscr
各系统上的可执行文件列在[运行 CLI](./cli.md#running-the-cli)中。
- **无需端口、令牌或设置**。AI 代理以你的权限自行启动进程,就像它运行 `openscreen record` 一样。因此,它无需**MCP 编辑**开关,就能录制你的屏幕并进行编辑。
-- **每次录制都会成为一个新项目**,出现在你的项目列表中,并且与在应用中录制的内容一样,在录制下来的点击处添加缩放:时间和位置都相近的点击共用一个缩放,开头几秒和结尾保持全屏。AI 代理的每项编辑都会保存到项目文件中。撤销它们要靠 AI 代理创建的检查点,检查点在代理的会话结束前一直有效。
+- **每次录制都会成为一个新项目**,出现在你的项目列表中,并且与在应用中录制的内容一样,在录制下来的点击处添加缩放:时间和位置都相近的点击共用一个缩放,开头几秒和结尾保持全屏。AI 代理的每项编辑都会保存到项目文件中。撤销它们要靠 AI 代理创建的检查点,检查点在代理的会话结束前一直有效。只保留最近的 20 个检查点,因此较早的检查点可能会更早失效。
- **在 OpenScreen 编辑器中打开的项目无法编辑。** AI 代理可以读取它,但在你于编辑器中关闭该项目之前,它的编辑都会被拒绝,因为编辑器会用自己的副本覆盖这些编辑。
- **由脚本驱动的录制**(例如 Playwright)永远不会移动屏幕指针。AI 代理通过 `setPointerTrack` 把它自己的操作日志交给 OpenScreen,视频照样会有光标及其缩放。
- **`openscreen-demo` 技能**会教 AI 代理完成整个工作,从分镜脚本到成品视频。之后,它会把视频附加到拉取请求中,让审阅者直接在那里看到改动;或者起草一条 X 帖子,而且只有在你同意之后,它才会发布这条帖子。使用 `npx skills add getopenscreen/openscreen --skill openscreen-demo` 添加它。具体步骤见 [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md)。
diff --git a/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/ai-editing.md b/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/ai-editing.md
index 2e9e6b1a6..3ac582023 100644
--- a/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/ai-editing.md
+++ b/website/i18n/zh-TW/docusaurus-plugin-content-docs/current/ai-editing.md
@@ -72,7 +72,7 @@ ChatGPT 與 GitHub Copilot 的登入選項已**在 1.8.0 中移除**。它們的
- **在編輯器中開啟的專案上**,編輯可用 `Ctrl/Cmd + Z` 復原。用戶端會被告知在進行一系列編輯之前先儲存檢查點,因此你可以請它們一步將專案還原成原本的樣子,而這一步本身也可以用 `Ctrl/Cmd + Z` 復原。
- **在其他任何專案上**,編輯會儲存到它的檔案中,`Ctrl/Cmd + Z` 無法復原。用戶端必須在第一次編輯之前儲存該專案的檢查點,還原到這個檢查點是唯一的復原方式。
-檢查點保存在 OpenScreen 的記憶體中:OpenScreen 結束或伺服器重新啟動時就會遺失,而變更連接埠或重新產生權杖都會讓伺服器重新啟動。**重新產生**權杖,即可中斷所有使用舊權杖設定的用戶端。
+檢查點保存在 OpenScreen 的記憶體中:OpenScreen 結束或伺服器重新啟動時就會遺失,而變更連接埠或重新產生權杖都會讓伺服器重新啟動。只會保留最近的 20 個檢查點,因此較早的檢查點可能會提早失效。**重新產生**權杖,即可中斷所有使用舊權杖設定的用戶端。
## 讓代理製作整支影片 {#letting-an-agent-make-the-whole-video}
@@ -94,7 +94,7 @@ codex mcp add openscreen -- "/Applications/Openscreen.app/Contents/MacOS/Openscr
各系統上的執行檔列在[執行 CLI](./cli.md#running-the-cli)中。
- **不需要連接埠、權杖或設定。** 代理會以你的權限自行啟動程序,就像它執行 `openscreen record` 一樣。因此,它不需要**MCP 編輯**開關,就能錄製你的螢幕並進行剪輯。
-- **每段錄影都會成為一個新專案**,出現在你的專案清單中,並和在應用程式中錄製的影片一樣,在錄下的點擊處加上縮放:時間與位置都相近的點擊共用一個縮放,開頭幾秒與結尾保持全螢幕。代理的每項編輯都會儲存到專案檔案中。要復原,就靠代理建立的檢查點,檢查點在代理的工作階段結束前都有效。
+- **每段錄影都會成為一個新專案**,出現在你的專案清單中,並和在應用程式中錄製的影片一樣,在錄下的點擊處加上縮放:時間與位置都相近的點擊共用一個縮放,開頭幾秒與結尾保持全螢幕。代理的每項編輯都會儲存到專案檔案中。要復原,就靠代理建立的檢查點,檢查點在代理的工作階段結束前都有效。只會保留最近的 20 個檢查點,因此較早的檢查點可能會提早失效。
- **在 OpenScreen 編輯器中開啟的專案無法編輯。** 代理可以讀取它,但在你於編輯器中關閉該專案之前,它的編輯都會被拒絕,因為編輯器會用自己的副本覆寫這些編輯。
- **由腳本驅動的錄影**(例如 Playwright)永遠不會移動螢幕上的指標。代理會用 `setPointerTrack` 把它自己的操作記錄交給 OpenScreen,影片照樣會有游標與其縮放。
- **`openscreen-demo` 技能**會教代理完成整個工作,從分鏡腳本到完成的影片。之後,它會把影片附加到拉取請求中,讓審閱者直接在那裡看到變更;或者草擬一則 X 貼文,而且只有在你同意之後,它才會發布這則貼文。使用 `npx skills add getopenscreen/openscreen --skill openscreen-demo` 加入它。完整步驟請見 [`skills/openscreen-demo/SKILL.md`](https://github.com/getopenscreen/openscreen/blob/main/skills/openscreen-demo/SKILL.md)。