Dflow

# DFlow 本地 Danbooru 与 Pixiv 瀑布流画廊及 AI 提示词工作流套件。 **当前版本：`0.2.1`** · [查看更新记录](CHANGELOG.md) 本项目默认将收藏、高清缓存、登录凭据、翻译配置和自定义预设保存在本地 `data/` 目录；这些运行数据不会作为项目文件提交到 Git。 > **一句话使用**：双击运行根目录下的 `start.bat`（或执行 `npm install && npm start`），在浏览器打开 `http://127.0.0.1:4173` 即可直接使用。 --- ## 功能有什么 - **双画站漫游与检索**：支持 Danbooru 与 Pixiv 随时切换，提供日榜、周榜、月榜、收藏榜、高分榜、标签检索与年龄分级筛选。 - **智能防限流与图片代理**：服务端内置请求节流（Danbooru 速率控制与 429 退避）及 Pixiv 防盗链图片代理，保障稳定浏览与防封。 - **四引擎智能翻译**：内置 DeepL、腾讯云 TMT、火山引擎、Google 翻译通道，支持二次元及成人/NSFW 词汇，支持首选与自动容灾降级。 - **本地收藏与提示词反推工作流**： - **原始收藏**：一键收藏喜欢的画作，所有数据保存在本地。 - **待反推队列**：移入后后台自动串行下载并缓存高清原图，支持设置反推与扩写两阶段预设。 - **已完成归档**：反推完成的高清原图与最终提示词永久沉淀归档，支持一键复制提示词。 - **本机 MCP 协议支持**：内置 stdio MCP 服务（`mcp-server.js`），支持视觉 AI Agent 自动读取待反推本地原图并写回扩写提示词。 - **ComfyUI / SD 原图元数据解析**：秒级解析原生 PNG 格式图片，自动提取底模 Checkpoint、LoRA 名称与权重、采样器、步数、Seed 及正反向提示词。 - **局域网多端同步**：同一 Wi-Fi 下手机、平板输入电脑局域网 IP（`http://<电脑IP>:4173`）即可同步浏览与操作。 --- ## 怎么用 ### 1. 启动服务 - **Windows 一键启动**：双击运行 `start.bat`。 - **命令行启动**： ```bash npm install npm start ``` 启动后在浏览器打开 `http://127.0.0.1:4173`。 ### 2. 浏览与检索 - 点击左上角 `D` / `P` 按钮切换当前站台（Danbooru / Pixiv）。 - 顶部搜索框直接输入标签（Tag）或画师名进行搜索。 - 点击导航栏榜单按钮可按日热门、周热门、月热门或最新作品浏览。 ### 3. 收藏与提示词反推 1. **收藏画作**：点击卡片上的心形图标存入「原始收藏」。 2. **移入待反推**：点击卡片上的 `AI` 按钮，后台会自动下载高清原图并加入待反推队列。 3. **执行反推**： - **通过 MCP**：在支持 MCP 的 Agent 中配置本机 MCP（详见 [MCP.md](MCP.md)），Agent 可自动逐张读取待反推高清图并写回提示词。 - **通过命令行**：使用 `node scripts/reverse-cli.mjs` 领取任务并写回。 - **手动填写**：在待反推卡片中直接编辑正向提示词。 4. **释放归档**：提示词就绪后点击 `→` 按钮释放至「已完成」，高清原图与提示词永久归档。 ### 4. ComfyUI 图片参数提取 1. 进入顶部「元数据库」页面。 2. 点击「导入 ComfyUI PNG」或拖入由 ComfyUI / WebUI 生成的原始 PNG 图片。 3. 系统自动提取模型、LoRA、生图参数及正反向提示词，点击即可一键复制。 ### 5. 账号凭据与翻译配置 点击顶部导航栏右上角的「登录/设置」图标： - **画站凭据**：填入 Danbooru API Key 或 Pixiv Session Token，解锁免登录与高清浏览限制。 - **翻译配置**：填入 DeepL / 腾讯云 / 火山引擎的 API Key（Google 翻译免密直接可用）。 - **MCP 与预设管理**：查看已连接的 Agent，管理反推预设与扩写预设。 ### 6. 常用快捷键 - `Ctrl + 滚轮`：自由调整卡片排列列数 - `Ctrl + Z`：快速撤销操作 - `鼠标左键`：呼出高清大图预览 - `鼠标右键`：呼出操作菜单（创建卡片、复制原图、复制直链、删除等） - `Esc`：关闭大图预览浮层