# Zoetrope

一个本地生图工作台，把对话、生成计划、队列、参考图和图库放到一起

Source: https://works.im0o.top/projects/zoetrope/
Date: 2026-05-19
End date: present
Tags: AI, 桌面应用, Electron, TypeScript, 桌面开发


我经常要拿同一组参考图反复试构图、角色和模型。网页里单独生成一张很方便，数量多了以后，提示词、参考图和结果就散在聊天记录和文件夹里。过几天看到一张不错的图，又不容易找回当时怎么做的。

Zoetrope 是一个本地桌面生图工作台。对话可以用来准备一批图片，Workspace 管理输入和任务，Gallery 看结果，Collections 留下想继续使用的生成记录。

## 一句话可以准备一批图

我希望可以直接交代：“用这组参考图，分别试几个构图，再换一个模型对比。”Agent 整理出生成计划，列清模型、提示词、参考图和数量，确认后再进入队列。

我后来把多模型请求改成只需确认一次：一个生成计划里可以有多项生成内容，每项对应一个 provider/model，用户确认整份计划后，再分别创建任务。

计划确认前可以继续修改，后端检查版本、处理重复确认，再创建任务。确认时的模型、提示词和参考图会随任务保存，之后继续聊天，也不会改掉已经提交的输入。

![修改待确认计划后的界面，画面使用脚本测试模型](https://image.im0o.top/2026/20261117104701216.webp "修改待确认计划后的界面，画面使用脚本测试模型")

## 从一张结果回到它的来处

在图库里看到一张图，我可以找回原始输入、实际发给模型的提示词、参考图顺序和生成参数。每项任务下的生成与修改会话（Session）保存消息，再关联原图、参考图与生成图。

收藏的也是 Session。好图后面往往还有几次修改，我希望留下的是这段可继续的记录，而不只是复制一张成图到另一个文件夹。

Provider 的差异在接入层处理，任务状态、队列和结果管理共用同一套服务。队列里可以看到等待、执行和失败状态，需要时重试；应用重开后，已经保存的计划和任务仍然在。

![收藏集中保存会话，画面使用桌面验收时的示例内容](https://image.im0o.top/2026/20261117104655081.webp "收藏集中保存会话，画面使用桌面验收时的示例内容")

## 复用风格、角色和参考图

固定风格、角色和参考图组合反复使用后，我开始把这些整理成 Skill。Skill 可以带提示词和图片资源，按目录安装、更新和卸载；坏的内容包会单独隔离，不影响其他 Skill。

历史消息会固定当时使用的内容版本。后来更新某个 Skill，再回看旧图时，不能拿新版本去解释旧输入。

应用中现有的 provider、任务流程、媒体等能力也逐步整理成插件。它们与用户提供的 Skill 分开：Skill 是可编辑的创作材料，Agent 自身的行为和任务执行规则仍由应用维护。

## 本地保存与桌面调试

数据用 SQLite 保存，图片落在本地文件系统里。曾经为了让 Node 测试和 Electron 开发共用数据库驱动，反复遇到原生二进制 ABI 不匹配，后来改用了 `node:sqlite`。

调试时还需要知道：Agent 正在处理哪轮对话，任务到底有没有创建，界面当前停在哪一步。我为开发环境加了独立诊断插件，MCP 和 HTTP 共用同一个受控入口，可以读取业务状态、观察界面、截图，并执行有限的输入操作。做桌面验收时，能把任务记录和屏幕上的状态对起来。

核心生成流程、图库和本地 Skill 已经做出来，真实模型与 Windows 安装包还在继续验收。

