开始使用

Getting started

VuuPix 是 VuuMake 里的生图与修图工作台。描述你想要的画面，选一个引擎，点「开始生成」。

VuuPix is the image generation and editing workbench inside VuuMake. Describe the picture you want, choose an engine, and press Generate.

1. 点顶部的路径条，选择当前工作目录 —— 保存下来的图片会放在这里。
2. 在「生成画面」框里描述画面。
3. 需要的话选一个风格、加一张参考图。
4. 点「开始生成」。出图会出现在下方的「最近作品」。

1. Click the path bar at the top and choose a working folder — saved pictures go there.
2. Describe the picture in the Generate box.
3. Optionally pick a style or add a reference image.
4. Press Generate. Results appear under Recent works below.

左侧三个按钮分别是：工作台（生成）、灵感（现成提示词）、作品（历史工作目录里的图片）。

The three buttons on the left rail are Workbench (generate), Inspiration (ready-made prompts), and Works (pictures from folders you have worked in).

写提示词

Writing prompts

图像模型最吃这种顺序：主体 → 场景 → 光线 → 镜头 → 氛围，用逗号分隔。例如 a lantern-lit alley at night, wet cobblestones, warm rim light, 35mm, quiet mood。

Image models read this order best: subject → setting → light → lens → mood, comma separated. For example a lantern-lit alley at night, wet cobblestones, warm rim light, 35mm, quiet mood.

提示词增强

Enhance prompt

点「提示词增强」，Agent 会把你写的一句话改写成更密的视觉描述，并在需要时翻译成英文。结果会写回输入框 —— 你能看到实际送给模型的是什么，也能继续改。旁边的撤销按钮可以还原原文。

Press Enhance prompt and the Agent rewrites your sentence into a denser visual description, translating it when needed. The result is written back into the box, so you can see exactly what will be sent and keep editing. The undo button beside it restores your original.

风格

Styles

「探索风格」下面的卡片不是装饰：选中一张，它代表的镜头、光线、色调会加到你的提示词后面，同时把对应的负向词一起带上。卡片上的图就是这个风格实际出图的样子。

The cards under Explore styles are not decoration. Selecting one appends the lens, light, and grade it stands for to your prompt, and brings its negative terms along. The picture on each card is what that style actually produces.

• 你的描述在前，风格在后 —— 主体不会被风格盖过去。
• 再点一次选中的卡片即可取消，回到「无风格」。
• 把鼠标停在卡片上，可以看到它实际加的那段文字。

• Your words lead and the style follows, so the subject is never overpowered.
• Click the selected card again to clear it and go back to no style.
• Hover a card to see the exact text it adds.

参考图（图生图）

Reference images (image to image)

提示词框下面那排控件最左边的 + 就是加参考图。也可以直接按 Ctrl+V 把截图或复制的图片文件贴进来。

The + at the left of the control row under the prompt adds a reference image. You can also press Ctrl+V to paste a screenshot or a copied image file.

只要有参考图，生成就会自动切到图生图，不需要另外切换模式。参考强度滑杆控制结果可以离参考图多远：调低保住原来的构图，调高更听提示词。

With a reference attached, generation switches to image to image automatically — there is no mode to remember. The strength slider controls how far the result may drift: lower keeps the reference's composition, higher follows the prompt.

作品卡片和「作品」页里的每张图都有「用作参考图」按钮，可以把上一张出图直接拿来接着改。

Every picture in Recent works and on the Works page has a Use as reference button, so you can carry a result straight into the next round.

生图引擎

Image engines

在宿主设置 → 生图引擎里选择，三选一：

Choose one of three in Host settings → Image engine:

使用 GenPack

Using a GenPack

1. 在宿主设置 → 生图引擎 → VuMos GenPack 点「添加 GenPack 目录」，选择含 vuu_gen_pack.json 的包目录。
2. 如果缺模型文件，点「下载缺少的模型」；大文件支持断点续传，中断了不会白下。
3. 用左边的圆点选中这个包，并选择工作流（文生图 / 图生图）。
4. 回到工作台，引擎选择器前面的 ▶ 可以直接启动引擎；开着「生成时自动启动引擎」的话，直接点生成也会自动拉起。

1. In Host settings → Image engine → VuMos GenPack, click Add GenPack folder and pick the pack folder containing vuu_gen_pack.json.
2. If model files are missing, press Download the missing models. Large files resume where they stopped, so an interrupted download is not lost.
3. Select the pack with the dot on its left and choose a workflow (text-to-image or image-to-image).
4. Back on the workbench, the ▶ in front of the engine selector starts the engine. With Start the engine when generating on, pressing Generate starts it as well.

作品与分享

Works and sharing

本次会话：最近作品

This session: Recent works

每生成一张都会加到工作台下方，可以并排比较。每张卡片上有四个操作：保存、用作参考图、复制、丢弃。

Every generated picture is added under the workbench so results can be compared side by side. Each card offers four actions: save, use as reference, copy, and discard.

要留下的图记得点保存。没保存的都是临时文件，关掉 VuuPix 就没了。

Press save on anything you want to keep. Everything else is a temporary file and is gone when VuuPix closes.

分享

Share

右上角的「分享」作用于最新的一张图，提供四个动作：复制图片（可以粘贴到 VuuNote、资源管理器等任何地方）、另存副本、在文件夹中显示、复制文件路径。

The Share button at the top right acts on the newest picture and offers four actions: copy the picture (paste it into VuuNote, Explorer, anywhere), save a copy, show it in the folder, and copy the file path.

作品页

The Works page

左侧第三个按钮。它列出 VuuPix 待过的每一个工作目录里的图片，不只是当前这个，按目录分组。删掉的图会自动消失 —— 它读的是目录，不是一份索引。

The third button on the left rail. It lists pictures from every folder VuuPix has worked in, not just the current one, grouped by folder. Deleting a file elsewhere makes it disappear here too — the page reads folders, not an index.

灵感

Inspiration

左侧第二个按钮。内置一批写好的提示词，每条都配一张用 VuuPix 自带的模型实际生成的样图 —— 你看到的就是你能得到的。点「使用这条提示词」会填进生成框并选好对应风格，然后回到工作台。

The second button on the left rail. It ships a set of written prompts, each with a sample rendered by the model VuuPix ships with — what you see is what this app makes. Use this prompt fills the generate box, selects the matching style, and returns you to the workbench.

下面还有几个外部提示词图库的入口（Lexica、Civitai、PromptHero），会在你的浏览器里打开。在那边复制一条提示词，回来点「粘贴提示词」就能直接带进生成框。

Below them are links to external prompt galleries (Lexica, Civitai, PromptHero) that open in your browser. Copy a prompt there, come back, and press Paste a prompt to bring it straight into the generate box.

共享 Agent

Shared Agent

右侧面板是 VuuMake 的共享 Agent，与其它子 App 使用同一套设置、模型和会话能力。它可以读取当前工作目录，也可以直接替你生成图片。

The panel on the right is VuuMake's shared Agent, using the same settings, models, and session capabilities as the other sub-apps. It can read your working folder and generate pictures for you.

• 面板宽度可以拖 —— 拖两栏之间的分隔条，双击复位。
• 「提示词增强」用的就是这个 Agent；它没配置好时增强会保留你的原文并说明原因。
• 问 VuuPix 怎么用时，Agent 会优先参考本指南。

• The panel can be resized — drag the divider between the two columns, double-click to reset.
• Enhance prompt uses this Agent. If it is not configured, enhancement keeps your original text and says why.
• For questions about operating VuuPix, the Agent refers to this guide first.

设置与外观

Settings and appearance

左下角齿轮进入宿主设置。

The gear at the bottom left opens host settings.

• 主题：深色 / 浅色 / 跟随系统，作用于整个宿主，包括设置页和 Agent 面板。
• 界面语言：中文 / English / Español / Français。界面文字和引擎报错都会跟着切换。
• 背景图：内置若干张，也可以选自己的图片；可选填充方式。
• 面板不透明度：顶栏 / 画布 / 侧栏三条滑杆，决定背景图能透出来多少。调低背景更明显，但文字会更难读。

• Theme: dark, light, or follow the system — applies to the whole host, including this settings page and the Agent panel.
• Interface language: 中文, English, Español, Français. Both the UI and engine messages follow it.
• Wallpaper: several built in, or choose your own picture, with a fit mode.
• Surface opacity: three sliders (top bar, canvas, side rail) control how much of the wallpaper shows through. Lower shows more picture but makes text harder to read.

更新与模型下载

Updates and model downloads

宿主设置最下方的版本与更新：显示当前版本，点「检查更新」会通过 VuuMake 共享的发布通道下载安装包 —— 和其它子 App 是同一套，不是 VuuPix 单独维护。

Version and updates at the bottom of host settings shows the current version. Check for updates downloads an installer through VuuMake's shared release channel — the same one every sub-app uses, not a VuuPix-specific mechanism.

模型下载在 GenPack 那一栏。生成包只发布清单和工作流，模型权重以链接声明，缺什么在这里一键下载。文件很大（通常几 GB 到几十 GB），支持断点续传；没下完的文件带 .part 后缀，下完才会改成正式名字。

Model downloads live in the GenPack section. A pack publishes only its manifest and workflows; the model weights are declared as links and fetched on demand. These files are large (gigabytes to tens of gigabytes) and resume after an interruption. An unfinished file carries a .part suffix and is renamed only once complete.

常见问题

FAQ

中文提示词好像没起作用？

My prompt seems to be ignored

当前模型可能只认英文。输入框下方有橙色提示时就是这种情况：模型读不到中文，出图由随机种子决定。点「提示词增强」翻译并优化，或者直接用英文写。

The model may be English-only. That is what the orange notice under the box means: it reads nothing from other languages and the seed decides the picture. Press Enhance prompt to translate and sharpen, or write in English.

点生成后提示引擎未启动

Generate says the engine is not running

到宿主设置的 GenPack 一栏点 ▶ 启动，或打开「生成时自动启动引擎」。引擎第一次启动要加载模型，可能要几十秒。

Start it with ▶ in the GenPack section of host settings, or turn on Start the engine when generating. The first start loads the model and can take tens of seconds.

提示端口被占用

It says the port is busy

那个端口上有别的程序，而且不是可用的生成引擎（ComfyUI Desktop 默认用 8188，最容易撞）。关掉占用的程序，或改包清单里的 port。

Something else holds that port and it is not a usable engine — ComfyUI Desktop defaults to 8188 and is the usual culprit. Close it, or change port in the pack's manifest.

提示缺少节点

It says nodes are missing

通常是连到了另一个 ComfyUI，或者工作流用到的插件没装。确认那个端口上跑的是这个包自己的 Core。

Usually you are connected to a different ComfyUI, or the plugin providing those nodes is not installed. Check that the port is running the pack's own Core.

我生成的图不见了

My picture disappeared

没点保存的图是临时文件，关掉 VuuPix 会清空。保存过的在工作目录里，也会出现在「作品」页。

Pictures you did not save are temporary files and are cleared when VuuPix closes. Saved ones are in your working folder and also appear on the Works page.

关掉 VuuPix 后显存还被占着

VRAM is still held after closing VuuPix

正常关闭窗口时，VuuPix 会关掉它自己启动的引擎。如果 VuuPix 是被强制结束的（任务管理器、断电），引擎会留下来 —— 下次启动 VuuPix 会认出这是自己上次留下的，退出时一并清理。别的宿主启动的引擎不归 VuuPix 管。

Closing the window normally shuts down any engine VuuPix started. If VuuPix was force-killed (Task Manager, power loss) the engine survives — the next VuuPix run recognises it as its own and cleans it up on exit. Engines started by another host are not VuuPix's to stop.

下载模型中断了要重来吗

Do I have to restart an interrupted download?

不用。再点一次下载会从断点继续。

No. Pressing download again continues where it stopped.