产品概览
提示词反推器是什么？
它是一款 Windows 本地桌面应用，把图片、视频关键帧、音频和创作要求转换成结构化的中文与英文生成提示词。它支持静态 Prompt、视频 Motion 指令、首尾帧、时间线、风格 DNA 和平台执行稿。
| 当前版本 | 1.2.0，开源基线版本 |
|---|---|
| 适合对象 | 图像生成、图生视频、镜头复现、风格迁移和提示词整理工作流 |
| 接口模式 | 由使用者配置支持图片输入的 OpenAI-compatible API |
| 本地数据 | 项目、历史、输出、素材索引、队列和预设保存在本机 |
| 许可证 | GNU AGPL v3.0 或更高版本 |
运行要求
- Windows 10 或更新版本。
- Python 3.10 或更新版本，并安装 Tkinter。
- 一个支持图片输入的 OpenAI-compatible API。
- 视频处理需要
ffmpeg和ffprobe；安装脚本会尝试自动下载。
只处理图片或已提取的关键帧时不需要 ffmpeg。1.2 版本的桌面控件仍以中文为主，仓库文档和生成结果支持中英文。
安装与启动
- 下载项目并解压到本地文件夹。
- 双击
一键安装.bat。 - 安装脚本会检查 Python、创建虚拟环境、安装依赖、检测 ffmpeg，并创建桌面快捷方式。
- 之后通过桌面快捷方式或
启动工作台.vbs启动。
也可以使用 PowerShell 手动安装：
python -m venv .venv .\.venv\Scripts\Activate.ps1 python -m pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple python app.py
API 与模型配置
可以在程序设置中添加接口，也可以使用临时环境变量。以下值仅为占位示例：
$env:OPENAI_BASE_URL = "https://api.example.com/v1" $env:OPENAI_API_KEY = "your-api-key" $env:VISION_MODEL = "your-vision-model" python app.py
不要把真实 API Key 写进公开仓库、截图或日志。Windows 下启用“保存 Key”后，密钥使用 DPAPI 加密并绑定当前 Windows 用户。
选择合适的工作流
图片反推
用于分析单张图片或多张参考图，输出主体、构图、光线、材质、色彩、镜头和负面约束。静态图片 Prompt 不应混入时间动作。
视频全量反推
用于关键帧筛选、镜头拆分、时间线、首尾帧和 Motion Prompt。系统会区分生成锚点和观察帧，避免把每一帧都当作必须生成的画面。
风格 DNA
提取可以迁移到其他主体的色彩、光线、构图、材质和成像特征，不把原图主体误当作风格。
平台编译
把结构化结果整理为即梦、可灵类工作流所需的执行稿。本项目与这些平台不存在官方合作或隶属关系。
隐私与数据边界
程序没有由本项目运营的遥测或统计服务。用户选择的图片、视频派生帧、提示词、Schema 和工作流指令可能发送给用户自己配置的 API 服务商；服务商的条款和隐私政策适用。
本地 ffmpeg 处理不会自动上传。只有明确加入 API 请求的媒体或派生帧会发送到外部服务。更完整的说明见隐私与密钥页面。
常见故障排查
找不到 Python
安装 Python 3.10 或更新版本，安装时勾选 Add python.exe to PATH，然后重新运行安装脚本。
Tkinter 无法启动
重新运行 Python 安装程序，选择 Modify 并启用 tcl/tk and IDLE。自备 Tcl/Tk 时可以设置 VPW_TCLTK_DIR。
视频功能不可用
重新运行安装脚本补充 ffmpeg，或确认 tools\ffmpeg\bin 中存在 ffmpeg.exe 和 ffprobe.exe。
图片预览不显示
当前解释器可能缺少 Pillow。重新执行安装脚本，或在虚拟环境中运行 pip install -e .。