Auto Backup & Exit（自动备份并退出）
Auto Backup & Exit - User Manual
Dragonfly Prototype Apps · Auto Backup & Exit...
版本 Version 1.0 · 2026-07-26
第一部分 中文手册
目录
1. 简介
2. 一次备份会包含什么
3. 两个按钮 / 退出与关机
4. 工作原理（技术路径）
5. 使用步骤
6. 环境需求
1. 简介
Auto Backup & Exit 提供一个“自动备份并退出 Dragonfly”的按钮：一键把当前会话的现场保存下来，然后退出 Dragonfly，甚至可选在退出后关机。
本功能由第三方（Prototype Labs / Prototype Apps）提供，非 Dragonfly 官方开发或支持。快速步骤全程在进程内完成，无需联网。关机功能默认关闭，需显式勾选并确认。
2. 一次备份会包含什么
勾选项 | 写入内容 |
会话快照 | 主窗口截图、各视图截图、已发布对象清单（objects.txt）、以及保存的会话文件 session.ORSSession |
对象关系图（PNG） | 复用 Show Connections 插件绘制的对象关系图，保存为 object_connections.png |
当前视图截图（PNG） | 当前激活视图的截图 current_view.png |
AI 工作日志 | 复用 WorkLog 插件与其本地大模型，把当天日志整理成 Markdown（仅在 WorkLog 已配置时运行） |
每次运行都会在你选定的备份文件夹下创建一个带时间戳的子文件夹（例如 backup_20260726_180000），上述文件都写入该子文件夹。
3. 两个按钮 / 退出与关机
- 仅备份（保持打开）：只执行勾选的备份步骤，完成后打开该文件夹以供查看，不退出 Dragonfly。
- 备份并退出 Dragonfly：先执行备份，弹出确认框，然后干净地退出 Dragonfly。因为刚刚已保存会话，退出时不会再弹保存提示。
- 退出后关机（可选）：勾选后，退出前会安排一次 Windows 关机（shutdown /s /t 60）。60 秒倒计时内可在命令行运行
shutdown /a取消。
4. 工作原理（技术路径）
- 复用而非重写：对象关系图直接调用 Show Connections 插件、AI 工作日志直接调用 WorkLog 插件；本插件在打包目录（GenericMenuItems）中自动定位这两个同级插件。
- 线程模型：快速步骤（截图/保存会话/对象图）在界面线程执行；较慢的 AI 工作日志（本地大模型）在后台线程执行，不冻结界面。
- 退出方式：使用事件循环的干净退出（QApplication.quit），而不是触发保存守卫的关闭流程——因为备份阶段已保存会话。
5. 使用步骤
1. 菜单 Prototype Apps ▸ Auto Backup & Exit… 打开面板。
2. 选择备份文件夹（默认 用户目录\DragonflyBackups）。
3. 勾选需要包含的内容（会话快照 / 对象关系图 / 当前视图截图 / AI 工作日志；是否退出后关机）。
4. 点“仅备份”只备份不退出；或点“备份并退出 Dragonfly”，确认后自动备份并退出（如勾选，再关机）。
6. 环境需求
快速步骤无需安装/联网/GPU/虚拟环境。对象关系图需随包安装 Show Connections 插件；AI 工作日志需随包安装 WorkLog 插件并完成其一次性配置（本地模型 + 虚拟环境），未配置时该步自动跳过。关机为 Windows 专用。
Part II English Manual
Contents
1. Introduction
2. What one backup contains
3. Two buttons / exit and shutdown
4. How it works (technical path)
5. How to use
6. Requirements
1. Introduction
Auto Backup & Exit gives you a single 'back up and quit Dragonfly' button: capture the current session's scene in one click, then quit Dragonfly — and optionally shut the computer down afterwards.
This feature is provided by a third party (Prototype Labs / Apps), not officially developed or supported by Dragonfly. The fast steps run entirely in-process with no internet. Shutdown is off by default and requires an explicit tick plus confirmation.
2. What one backup contains
Ticked option | What is written |
Session snapshot | main-window screenshot, per-view screenshots, a list of published objects (objects.txt), and a saved session file session.ORSSession |
Object-connections graph (PNG) | the relationship graph drawn by the Show Connections plugin, saved as object_connections.png |
Current view screenshot (PNG) | a screenshot of the currently active view, current_view.png |
AI Work Log | reuses the WorkLog plugin and its local LLM to turn the day's logs into Markdown (runs only if WorkLog is set up) |
Each run creates a timestamped subfolder under the backup folder you pick (e.g. backup_20260726_180000); all of the above are written into that subfolder.
3. Two buttons / exit and shutdown
- Backup now (keep open): runs only the ticked backup steps, then opens the folder for review; Dragonfly stays open.
- Backup & Exit Dragonfly: backs up, asks for confirmation, then quits Dragonfly cleanly. Because the session was just saved, quitting does not re-prompt to save.
- Shut down after exit (optional): when ticked, a Windows shutdown is scheduled before quitting (shutdown /s /t 60). Within the 60-second countdown you can cancel it by running
shutdown /a.
4. How it works (technical path)
- Reuse, not re-implement: the object-connections graph calls the Show Connections plugin and the AI Work Log calls the WorkLog plugin directly; this plugin locates those two sibling plugins automatically inside the packaged directory (GenericMenuItems).
- Threading: fast steps (screenshots / save session / object graph) run on the UI thread; the slower AI Work Log (local LLM) runs on a background thread so the UI never freezes.
- How it exits: a clean event-loop quit (QApplication.quit), rather than the close flow that triggers the save guard — because the session was already saved during the backup.
5. How to use
1. Menu Prototype Apps ▸ Auto Backup & Exit… to open the panel.
2. Choose a backup folder (default: your home\DragonflyBackups).
3. Tick what to include (session snapshot / object-connections graph / current-view screenshot / AI Work Log; and whether to shut down after exit).
4. Click 'Backup now' to back up without exiting; or click 'Backup & Exit Dragonfly' and confirm to back up and quit (then shut down, if ticked).
6. Requirements
The fast steps need no install/internet/GPU/venv. The object-connections graph requires the Show Connections plugin to be installed alongside; the AI Work Log requires the WorkLog plugin plus its one-time setup (local model + venv), and is skipped when not set up. Shutdown is Windows-only.