中文说明 | English README

ProcessFrame Studio 是一个本地运行的图片与视频处理工作台，面向素材预处理、透明背景导出、逐帧水印清除、视频片段剪辑和帧提取等工作流。项目默认在本机处理文件，后端使用 FFmpeg 与 Sharp，前端提供画布编辑、时间线和可视化操作面板。

• 图片处理：缩放、裁剪、旋转、镜像、套索/吸附套索、扣色、后端高分辨率导出。
• 图片水印：一键“消除Gemini水印”，优先走后端处理，失败时回退到浏览器引擎。
• 视频处理：多素材资源池、多片段时间线、剪切、删除、移动、镜像、扣色、保留/混合音轨。
• Gemini视频水印清除：按设定 FPS 提取帧，逐帧调用图片水印清除算法，多线程处理后重新合成视频。
• 帧工具：默认 30fps 预览帧条、按时间提取帧、批量导出帧 ZIP、合成帧动画图。
• AI 辅助：支持 OpenAI 兼容、Claude、GLM、DeepSeek、Kimi、MiniMax、Gemini 等供应商，也支持第三方 Base URL + API Key。未填写 Key 时，AI 选区/抹除按钮不可用。
• 缓存管理：网页内可清理上传缓存、历史输出和 data 运行时缓存。

项目介绍视频位于：

media/processframe-studio-intro.mp4

环境要求：

• Node.js 18 或更高版本
• npm
• 现代浏览器，推荐 Chrome 或 Edge

安装依赖：

npm install

启动服务：

npm start

打开浏览器访问：

http://127.0.0.1:8717

Windows 用户也可以双击 start.bat。

1. 在顶部“图片素材”区域拖入或选择图片。
2. 使用移动、裁剪、变形、拉伸、套索、吸附套索或取色工具编辑图片。
3. 需要扣色时，先取色，再调节容差、羽化、精度、净边和去溢色。
4. 需要水印清除时，点击“消除Gemini水印”。
5. 需要保留原图分辨率时，使用后端导出。

1. 在顶部“视频素材”区域拖入或选择视频。
2. 在预览区使用 30fps 帧条定位画面，也可以拖动时间线截取片段。
3. 在片段时间线中添加、删除、复制、移动片段，设置轨道、淡入淡出、音量和镜像。
4. 点击“导出视频”生成普通处理结果。
5. 点击“Gemini视频水印清除”时，后端会按指定 FPS 提取帧，逐帧清除水印后再合成 MP4。

1. 在“谨慎专业画图 Agent”中选择供应商。
2. 填写第三方或官方 Base URL。
3. 填写 API Key，并选择或远程获取模型。
4. 保存到本机浏览器后，AI选区抠图 和 AI抹除填补 才会启用。

说明：API Key 不会写入仓库；前端“保存到本机”使用浏览器 localStorage。不要把真实 Key 写入代码或提交到 Git。

.
├─ src/                         # Node.js 后端入口与水印处理桥接
│  ├─ server.js                 # Express API、FFmpeg、缓存、导出和任务进度
│  └─ gemini-watermark-node.js  # Node 环境加载前端水印引擎并处理图片/帧
├─ public/                      # 前端页面、样式和浏览器端处理引擎
│  ├─ index.html
│  ├─ app.js
│  ├─ styles.css
│  ├─ assets/
│  └─ vendor/
├─ images/                      # README 引用图片，含捐款码
├─ media/                       # 项目介绍视频
├─ scripts/                     # 辅助脚本
├─ tests/                       # 自包含验证脚本
├─ data/                        # 运行时上传与输出缓存，已被 .gitignore 排除
├─ logs/                        # 本地日志，已被 .gitignore 排除
├─ package.json
├─ package-lock.json
├─ start.bat
├─ README.md
└─ README.en.md

浏览器端负责交互和低延迟预览，Node 后端负责大文件、原始分辨率和视频处理。

图片水印清除流程：

图片上传/画布内容
  -> 后端或浏览器水印引擎检测水印区域
  -> 基于内置 alpha/位置目录与自适应评分进行修复
  -> 输出 PNG 或回写画布

视频水印清除流程：

视频上传
  -> FFprobe 读取尺寸、时长、FPS、音轨
  -> FFmpeg 按目标 FPS 提取帧
  -> 多线程逐帧调用图片水印清除算法
  -> 检查缺帧与残留评分
  -> FFmpeg 合成 MP4，可选择保留音频

任务进度通过后端 job 记录，前端轮询 /api/jobs/:id 展示处理百分比，并支持取消。

# 启动
npm start

# 语法检查
npm run check

# 水印引擎自包含烟测
npm run test:watermark

• node_modules/、data/、logs/、.env*、临时输出和本地大视频默认不会提交。
• 上传文件与导出结果只保存在本机 data/ 目录。
• AI Key 只在浏览器 localStorage 中保存，仓库不包含任何 Key。
• 请仅处理你有权处理的图片和视频素材。

如果这个项目节省了你的时间，可以扫码支持后续维护。

微信	支付宝

MIT