Files
flypic/README.md
T

162 lines
9.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 牛仔库(FlyPic 飞图,Docker 独立部署版)
> **2026-11-18 起正式更名为「牛仔库」**(原名:牛图 / FlyPic 飞图)。仓库地址、镜像名、数据目录 `.flypic` 保持不变。
本仓库是 [ZangXincz/FlyPic](https://github.com/ZangXincz/FlyPic) 的 Docker 化分支(上游已归档停更)。**本文档只介绍本分支修改过的功能与部署方式**,上游原有功能不再重复。
- 访问:`http://<主机IP>:15002`(首次打开设置管理员密码,随后添加素材库)
## ✨ 本分支修改的功能
### 1. Docker 独立部署(新增)
- 多阶段 `Dockerfile` + `docker-compose.yml`,`docker compose up -d --build` 一键启动
- **不依赖飞牛 fnOS 应用框架**,任意 Linux 主机可跑
- **中文路径直接可用**:容器内路径与宿主机一致,素材库目录中文名原样挂载
- 支持素材库目录**只读(`:ro`)挂载**(移除了原写权限校验,只验证可读)
- apt 已换清华镜像源,修复 Docker Hub / Debian 官方源超时导致的构建失败
### 2. OCR 图片内文字搜索(新增)
- 扫描图片时用系统 `tesseract`(`chi_sim` + `eng` 中英双语)提取图片内文字
- 文字存入索引库 `ocr_text` 列(带索引),**搜索时文件名和图片内文字同时匹配**
- OCR 失败不影响扫描主流程;镜像内已预装 tesseract 及中英文语言包
### 3. 设置页(新增)
- 右上角 ⚙ **设置** 打开「左菜单 + 右参数」弹窗:
- **OCR 识别**:识别方式二选一(本地 tesseract / 线上视觉模型),线上默认已填 `https://ai.88531.cn/v1` + 模型 `mimo-v2.6-flash`(可改),再填 `API Key`,支持**一键测试识别**(返回耗时与识别文字),留空密钥 = 保持原值
- **关于**:当前版本号、开源地址
- 配置持久化在 `config/settings.json`,保存后**立即生效**,无需重启
### 4. 右上角:开源地址 / 版本号 / 通知(新增)
- 🔗 **开源地址**:一键打开 `gitea.88531.cn/jinghui/flypic`
- 🔔 **通知公告**:铃铛带未读红点,下拉展示授权系统推送的公告与在线人数
- **版本号徽标**:显示当前运行版本(`v1.2.0`)
- 搜索框提示已标明支持 **OCR 图内文字搜索**
### 5. 授权系统接入(CardAuth,新增)
- **最新版本推送**:服务端定时比对授权中心,发现新版本时铃铛面板出现「发现新 vX,去更新」
- **公告推送**:管理后台发布公告 → 铃铛 60 秒内同步展示(删除公告即同步消失)
- **在线人数统计**:服务端 30 分钟一次心跳上报,管理后台可看本项目在线数
- **失败开放**:授权中心不可达时只降级显示,**不阻塞任何功能**;机器码只存服务端,不下发浏览器
### 6. Bug 修复
- 修复添加素材库报 `Internal server error`(`LibraryService.js` 使用 `logger` 但未 require)
- 修复中文路径素材库提示 `Path does not exist`
- `.gitignore` 排除 `config/`(含 JWT 密钥与管理员密码哈希,禁止入库)
### 7. 交互保持原样
- 图片区保持原交互:**单击选中、Ctrl/Shift 多选、双击放大预览**(未改动)
### 8. 重新扫描按钮与 OCR 补扫(v1.2.1 新增)
- 右上角刷新按钮旁新增**「重新扫描」图标**(移动端同样提供):确认后对当前素材库全量重新索引并补跑 OCR 文字识别,进度条复用现有扫描进度显示,扫描期间按钮自动禁用防重复触发
- 修复 **OCR 文字搜索不到**:OCR 功能上线前已入库的图片文字索引一直为空,且旧扫描逻辑对"文件没变"的记录永远跳过、不补识别;现在新增 `ocr_done` 标记列,重新扫描时自动为这些旧图片补跑 OCR(识别为空也记为已完成,不会反复重试)
- 扫描统计新增 `ocr`(OCR 补扫张数)计数
### 9. 图片编辑器 / 批量水印 / AI 生图 / 收藏(v1.3.0 新增)
- **图片编辑器**:右键「编辑图片」进入,提供 PS 常用功能 —— **裁剪**(拖拽选区 + 四角把手 + 三分线,自由/1:1/4:3/3:2/16:9/9:16 比例锁定,按原图分辨率烘焙)、**旋转翻转**(左右 90°/180°/水平/垂直)、**图像大小**(等比缩放 16~12000 px)、**调色**(亮度/对比度/饱和度/色相/模糊滑杆实时预览 + 黑白/反色/复古/自动色阶 + 一键还原),文字与贴图图层随裁剪/旋转同步变换,保存前自动按原分辨率烘焙
- **批量水印**:右键菜单「批量加水印…/批量去水印…」,弹窗对选中图片批量处理
- **AI 生图**:设置页「AI 生图设置」可配生图渠道 —— 默认走内置 NewAPI(Pollinations / Cloudflare Workers AI 两大量产模型开箱即用),也可切换到自己的 OpenAI 兼容 `/v1/images/generations` 接口(地址/模型/Key),并提供提示词预设库
- **收藏体系**:图片**左上角星标**一键收藏/取消,侧边栏「我的收藏」视图 + Header 筛选项,右键菜单同步提供收藏入口
- **图片右上角「在新窗口打开」**:悬停图片右上角出现外链按钮,点击在**新标签页打开原图**,不打断当前浏览(非图片类型的文件类型标识自动左移让位)
- **合拼拼图**与**返回顶部按钮**
### 10. 视频功能:目录导入 / 播放 / 常用编辑 / AI 一键成片(v1.4.0 新增)
- **素材库兼容视频目录**:扫描时识别视频文件(mp4 等),瀑布流卡片显示 **MP4 类型徽标**与**时长角标**(如 `0:09`),与图片混排、同一套搜索/收藏/回收站体系
- **单击播放**:点击视频卡弹出全屏播放器(原片直接播放,可暂停/进度/音量),右上角可新窗口打开原片
- **常用视频编辑**(右键「编辑视频(水印/字幕声音)…」,弹窗四选一 + 开始处理,后端 ffmpeg):
- **加水印**:文字水印(内容/位置/字号/透明度/颜色),可叠加时间戳
- **去水印**:框选区域模糊/填充去除
- **加字幕声音**:外挂字幕轨烧录进画面(支持 SRT 字幕文件),可同时合成朗读音轨
- **去字幕声音**:移除画面字幕区与原音轨
- 处理完自动入库,新文件可在瀑布流直接看到
- **AI 一键生成视频**(多选 ≥2 张图片 → 右键「AI 生成视频…」):
- 表单:**视频标题**(AI 按此写分镜旁白,成片同名)+ **模型 KEY**(OpenAI 兼容,留空用服务器已配 KEY)+ **朗读音色**(晓晓/云希/云健/晓伊/云扬/晓臻 6 种)+ **画幅**(1920×1080 / 1080×1920 / 1280×720)+ 补充要求
- 流程全自动:**AI 写分镜脚本 → 逐段朗读配音 → 图片逐段配字幕合成 → 拼接成片入库**(约 10–60 秒/张),完成后成片出现在素材库
## 🚀 部署方式
### 方式一:Docker Compose(推荐)
```yaml
services:
flypic:
# 镜像公网可匿名拉取;内网镜像为 192.168.68.19:3200/jinghui/flypic:latest
image: jpccr.ccs.tencentyun.com/jinghui/flypic:latest
build:
context: .
dockerfile: Dockerfile
container_name: flypic
restart: unless-stopped
ports:
- "15002:15002"
volumes:
# 素材库目录(容器内路径与宿主机一致,中文路径直接填,按需增减)
- /vol2/1000/HD2/壁纸:/vol2/1000/HD2/壁纸
- /vol2/1000/HD2/我的文档:/vol2/1000/HD2/我的文档
# 持久化配置(素材库列表、管理员密码,不用改)
- /vol3/1000/HD3/docker/flypic/config:/root/.flypic
environment:
- PORT=15002
- FRONTEND_DIST=/app/backend/public
- NODE_ENV=production
# 授权系统(可选,留空/删除即关闭,不影响使用)
- HUB_URL=https://auth.88531.cn/api
- HUB_PROJECT_ID=15
- HUB_API_KEY=ak_xxx # 自己项目的密钥,写进 .env(已 gitignore)
```
```bash
# 首次部署(编辑 volumes 换成你的素材库目录)
docker compose up -d --build
# 新增素材库:volumes 加一行挂载后重启
docker compose up -d
# 更新代码
git pull && docker compose up -d --build
# 日志 / 重启 / 停止
docker compose logs -f
docker compose restart
docker compose down
```
### 方式二:docker run(单容器)
```bash
docker pull jpccr.ccs.tencentyun.com/jinghui/flypic:latest
docker run -d --name flypic --restart unless-stopped \
-p 15002:15002 \
-e PORT=15002 \
-e FRONTEND_DIST=/app/backend/public \
-e NODE_ENV=production \
-v /vol3/1000/HD3/docker/flypic/config:/root/.flypic \
-v /vol2/1000/HD2/壁纸:/vol2/1000/HD2/壁纸 \
jpccr.ccs.tencentyun.com/jinghui/flypic:latest
```
- 公网镜像 `jpccr.ccs.tencentyun.com/jinghui/flypic:latest`(匿名可拉);内网镜像 `192.168.68.19:3200/jinghui/flypic:latest`
- 没有镜像就本地构建:`docker build -t flypic:latest .`,替换上面的镜像名
- 素材库目录按需增减 `-v`(容器内路径与宿主机一致)
## 📝 使用注意
- **添加/更新素材库后需重新扫描**,图片内 OCR 文字才可被搜索到(旧索引无文字数据)——点击右上角**「重新扫描」图标**即可,扫描时会自动补齐历史图片的 OCR 文字索引
- 素材库全量 OCR 扫描逐张识别、耗时较长,建议在不用的时候执行
- 数据存储:素材目录下 `.flypic/`(缩略图 + SQLite 索引,含 `ocr_text` 列);应用配置在 `config/`(已 gitignore)
- 删除素材目录下的 `.flypic` 即可清除该库索引,重新扫描重建
## 📄 License
MIT License - 详见 [LICENSE](./LICENSE) 文件,衍生自 [ZangXincz/FlyPic](https://github.com/ZangXincz/FlyPic)。