Files
it-tools-pro/README.md
T

243 lines
19 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.
# IT-TOOLS-PRO - 高级定制版工作者工具站:12个原创实用工具+卡密授权系统
基于开源项目 [IT-Tools](https://github.com/CorentinTh/it-tools)(GPLv3)深度定制的开发者/办公工具站,新增 **12 个原创实用工具**、**卡密授权系统**与数十项体验优化,全部功能持续更新中。
在线体验:https://it.88531.cn | 更多应用:https://nav.88531.cn
## 新增功能
### 原创工具(8 个)
| 工具 | 说明 |
|---|---|
| 📊 批量条码生成 | EAN/UPC/Code128/Code39/DataMatrix 等 12 种码制,批量生成打包下载,尺寸颜色字号可调 |
| 🔍 二维码条码识别 | 上传/拖拽/粘贴图片一键识别,多码混合批量输出,本地 WASM 解码不上传图片 |
| 🌐 在线翻译 | 中英日韩等 16 种语言互译,双线路自动切换,粘贴即译自动识别源语言 |
| 📷 图片OCR文字识别 | 本地 OCR 引擎,中文识别准确率 99%+,截图/扫描件文字一键提取 |
| 📄 PDF文字识别 | 逐页 OCR 中英文 PDF,每页预览翻页,一键复制或导出 TXT |
| 🏷️ 面单设计 | 快递面单模板开箱即用,支持 PDF 面单二次编辑(遮盖改字),300dpi 高清导出 |
| 🎨 AI修图 | 去水印/修复(涂抹智能填充)、抠图去背景、4x 超分辨率、人脸修复,本地 AI 模型秒级出图 |
| 🗂️ IT网站收藏 | 内置 91 个精选开发站点,数据存用户本地,支持自选目录同步 |
### 深度改造(3 个)
- **JSON 美化和格式化**:双栏专业工作台,左侧行号编辑、右侧树视图/语法高亮切换,含 Dict/Get参数/XML/CSV 等 7 种转换
- **PDF 工具**:合并/拆分/旋转/重排/压缩/加密/解密/水印/提取文本/页码/转图片,11 功能全程浏览器本地处理
- **图片工具**:压缩/转换/尺寸/裁剪/旋转/滤镜/打码/EXIF/二维码生成识别/水印/拼接,12 功能本地处理
### 授权与体验
- **卡密授权系统**:对接自建 CardAuth,高级功能每天免费试用 30 分钟,卡密激活全站通用,支持换卡密/自助撤销
- **授权介绍页**(/pricing):功能清单、购买优势、一键购买与机器码复制
- **生成记录**:翻译/OCR/修图/转换等 9 个工具自动留痕,数据存本地
- **体验优化**:全站中文默认、收藏与最近使用、菜单一键展开/收起、宽屏自适应、品牌页脚等数十项细节
### 留言反馈(2026.11 新增)
- **访客提交**:顶栏「留言反馈」按钮打开弹窗 —— 类型(功能建议/意见建议/Bug 反馈/其他)+ 内容(上限 1000 字)+ 联系方式(可选),图形验证码防刷,同一 IP 一小时内限提交 1 次
- **用户列表**:`/admin`「总览与用户」标签展示用户名/角色/状态/文件数/文件占用/设备/授权/注册/**最后登录**(relay `users.last_login`,登录与注册时写入,从未登录显示「未登录」),支持文件管理、改密、升降级、禁用/删除
- **管理后台**:`/admin` 切到「留言反馈」标签(`X-Admin-Token` 鉴权,令牌存本地 `it-tools-admin-token`),列出时间/类型/内容/联系方式/真实 IP,支持状态流转(未处理→已处理→已回复)与删除,导航标签带未处理数角标;窄屏下表格容器内横向滚动不撑破页面
- **链路**:公开页 → relay `POST /feedback`(验证码校验 + IP 限频)落盘 `data/feedback.json`;管理接口经 nginx `location /admin/` 反代到 `it-tools-relay:8091`。公网入口 https://it.88531.cn/
### 在线统计与公告推送(2026.11 新增)
- **右上角常驻**:🔔 公告铃铛(未读红点)+ `v2026.11.12` 版本徽标(源码常量 `SITE_VERSION`,与 Gitea Release tag 同步,发版时更新)
- **公告推送**:铃铛下拉面板列出授权系统公告(标题/时间/正文,未读带红条,点击已读、支持全部已读);`is_popup` 类型公告进站即弹一次(每条只弹一次,已读记录存 localStorage `it-tools-ann-read`)
- **在线统计**:打开页面即经 relay `POST /relay/hub/report` 向授权系统(auth.88531.cn 项目 6)登记安装并上报版本号(机器码复用 license 的 `getMachineId()`),每 30 分钟心跳一次;公告每 15 分钟拉取一次(`GET /relay/hub/announcements`),授权系统后台据此展示安装数/在线数/趋势
- **失败开放**:授权系统不可达时静默降级,不影响站点任何功能
- **实现注意**:公告面板与推送弹窗均 `<Teleport to="body">`——实测 top-nav 内 v-if 子树挂载会触发 Vue `insertBefore null` 崩溃;CardAuth 的 heartbeat 会清空 `client_version/device_info`,relay 侧先心跳后 check-update 保证版本号落库
### MCP 接入(2026.11 新增)
- **功能页 `/mcp-connect`**(顶栏 Plug 图标直达):连接信息、令牌管理、接入后怎么使用(三步上手 + 13 场景示例话术 + 成功自检 + 排错速查)、可调用工具清单与注意事项
- **授权即站内卡密**:与站点卡密体系同一套,购买并激活后即自动可用,无需单独开通 MCP;已授权设备打开页面直接显示主令牌,客户端配置示例自动带真实令牌(复制即用),无令牌自动创建「默认」
- **端点**:`https://<站点>/mcp`(MCP Streamable HTTP / JSON-RPC 2.0),`initialize`、`tools/list` 免鉴权,`tools/call` 必须 `Authorization: Bearer mcpt_…`
- **13 个 AI 工具**:translate_text / translate_doc / ocr / gen_image / remove_bg / upscale_image / tts / speech_to_text / extract_subtitle / video_process / convert_doc / copywriting / vision_qa(文件类入参传服务器可读绝对路径,二进制结果返回下载 URL)
- **调用记录**:Admin 左侧「MCP 调用」页(近 7 天总览 / 工具排行 / 调用流水),relay 侧 `mcp_usage` 表逐条落库
- **客户端接入**:Hermes(`config.yaml` 的 `mcp_servers`)、任意支持 HTTP 传输的 MCP 客户端、curl;配置片段在功能页 ③ 区一键复制
### AI 生图:自定义提供商 + 生成历史(2026.11 新增)
- **中文提示词自动转英文**(2026-11-13 新增):生成时检测到中文提示词,relay 自动用 LLM(mimo-v2.6-flash)转成高质量英文生图提示词再发上游(Flux/SDXL 系对英文理解最好),翻译失败回退原文绝不阻断;结果图操作行显示「🌐 已自动转英文发送(悬停查看)」,悬停可看完整英文;同词有缓存;生成历史存用户原文。
- **首页「近期新功能」清单**(2026-11-13 补齐):把最新开发完的功能(AI 生图、AI 接入 MCP、管理后台升级)加进 `Home.page.vue` 的 `NEW_FEATURES` 顶部(新→旧),★铁规则:以后每完成一批新功能必须在此清单最前面加条目,否则首页看不到。
- **生图页默认选中第一个模型**(2026-11-13 修复):打开 `/ai-gen` 页面,模型下拉与标签默认选中列表第一个(dall-e-3);原逻辑初始固定选 pollinations-flux(列表第 7 个),已改为列表加载后取 `j.data[0]` 并加空值兜底。
- **示例提示词四组分类**(2026-11-13 新增,同日四次改版定稿):「尝试这些示例」区选项卡切换——**通用(14) / 自媒体(30) / 电商(18) / 软件类(24),共 86 个**即点即填的场景提示词。第四版全组扩容 +32 词热门题材(2026-11 实时热词):通用加人形机器人/智能眼镜/芯片晶圆/脑机接口/AI陪伴玩具/情绪治愈/低碳出行/露营户外;自媒体加 AI办公智能体/Token囤货/AI导购比价/具身智能/演唱会神器/情绪价值/后屏幕交互/科普热词;电商加双12年终/虚拟试衣/国补换新/囤货清单/直播秒杀/情绪好物/年货节/跨境出海;软件类加智能体办公/大模型对话/开源生态/机器人编程/词元Token/语音助手/云同步/无代码搭建。词多时示例区出现区域内滚动条(max-height 172px 细条滚动、切组回顶,放得下则不出现)。软件类=电脑软件+手机软件合并(办公桌面、AI 概念、手持 APP、通勤办公等 16 词,覆盖软件推荐文章配图);电商=促销主图/大促 Banner/秒杀/直播带货等 10 词;自媒体=好物开箱、测评天平、拆箱瞬间等种草内容 6 词;每词带文章配图的画幅/构图/配色关键词;1024×768 与 1600×800 双断言无溢出。
- **模型来源与免费说明**:站内 10 个生图模型全部经自建 NewAPI 网关聚合——5 个 `pollinations-*` 走 Pollinations.ai(站主 API Key 预算制、对使用者免费),4 个 `flux*` + `dall-e-3` 走 Cloudflare Workers AI(站主账号免费额度,官方 10,000 Neurons/天 ≈ **173 张/天**),**对使用者全部免费但共享池有限**;模型列表由后端从网关实时拉取,下拉标注各上游配额。
- **我的提供商**:左侧「或使用自己的提供商 / API KEY」展开,填写 OpenAI 兼容接口地址 + KEY,点「连接并拉取模型」自动拉取上游模型列表;与站内模型合并展示(下拉分组「站内免费模型 / 我的模型」,自定义模型胶囊为紫色虚线框)。支持手动输入模型名回车添加、单个移除、一键清除。
- **KEY 只存本地**:接口地址与 KEY 仅保存在浏览器 localStorage(`it-tools-ai-provider`),生成时临时发给后端转发,**不入库、不落盘**(已 grep 宿主与容器数据目录验证零残留)。
- **生成历史**:每次生成成功自动落盘服务端(按机器隔离,每机上限 100 张、超限自动清理最旧),页面右侧新增 50×50 缩略图竖排历史列;点击任意缩略图回看大图,「下载图片」带 `?dl=1` 触发附件下载,「新窗口打开」直连原图,刷新后历史仍在。
- **新增端点**:`POST /relay/ai/custom-models`(测试连接并拉取模型)、`POST /relay/ai/gen-image` 扩展可选 `provider` 字段(自定义提供商转发)、`GET /relay/ai/img-history?machine=`(历史列表)、`GET /relay/ai/img/<machine>/<id>[?dl=1]`(图片文件/下载)。
- **内置免费每日次数 + 上游真实免费配额**(2026.11 新增;2026.11.13 按上游官方/实测补真实数字):「模型」区右侧实时显示、模型下拉每个选项标注上游配额、鼠标悬停显示出处——
- **机器限额**:未授权每日 **10 次**(`DAILY_FREE_LIMIT` 环境变量可调,北京时间 0 点重置,**生成成功才扣次**;自带提供商/KEY 生成不计次)。
- **上游免费池(全站共享,已授权同样受保护)**——内置模型上游是站主账号的免费额度,不存在「无限次」:
- `flux*` / `dall-e-3`(5 个)→ Cloudflare Workers AI:**官方免费 10,000 Neurons/天**,proxy 固定 1024×1024/4 步 = 57.6 Neurons/张 → **约 173 张/天**(`CF_DAILY_LIMIT` 默认 173,北京时间约 08:00 重置,账号级共享,超出 Free plan 直接报错);服务端按 `daily_gen_cf.json` 全站计数保护,池尽返回 403 并提示。
- `pollinations-*`(5 个)→ Pollinations.ai:站主 **API Key 预算制(pollen 余额)**,无固定每日张数(官方匿名档才是 45 秒/张按 IP);上游错误透传。
- **界面文案**(按所选模型联动):未授权 `免费10次·剩N · CF池剩X/173张` / `… · Pollinations按Key余额`;已授权 `已授权 · CF池剩X/173张`;CF 池尽红色 `CF免费池已用完 · 08:00重置`。
- 额度查询端点 `POST /relay/ai/quota`(带 `model` 返回 `authorized/limit/used/remaining` + `upstream/upstream_daily/upstream_used/upstream_remaining/upstream_note/cf_daily`;`remaining=-1` 表示机器维度不限,仍受共享池约束)。次数用完点「或使用自己的提供商 / API KEY」用自己的 KEY 继续生成,403 提示文案同步引导。
### AI 换脸(2026.11 新增)
- 上传源人脸照片 + 目标照片,本机 CPU 一键换脸(insightface buffalo_l 人脸检测,多脸自动取最大 + inswapper_128 换脸模型,模型 855MB 预置于镜像内)。
- 接口 `POST /relay/ai/face-swap`(multipart:`source`/`target`/`consent`),需勾选授权承诺,结果走站内 `/relay/ai/img` 图链路,支持下载。
- 授权应用:未授权用户每天可免费试用 3 次,卡密激活后不限次。
### AI 海报生成(2026.11 新增)
- 25 套热门海报模板、9 大分类(促销/节日/活动/美食/教育/健身/招聘/生日/封面),模板画布 1080×1440。
- 选中模板后可:**修改文字**(内容/字号/颜色/粗细/对齐/行高/斜体,预览与导出换行一致)、**替换图片**(本地上传 或 AI 生成,圆角可调)、拖动移动图层、图层排序/删除、添加文字与图片框、一键切换背景渐变、AI 生成整屏背景。
- AI 配图复用 `/relay/ai/gen-image` 与每日免费生图额度,按图框宽高比自动匹配上游尺寸档位。
- 完成后一键导出 1080×1440 PNG。授权应用,支持每日免费试用。
## 优势
- **一次激活,全站通用**:输入一次卡密,全部授权功能解锁,无需逐个购买
- **先用后买**:每个授权功能每天免费试用 30 分钟,觉得好用再付费
- **隐私友好**:PDF/图片/OCR 工具全程浏览器本地处理,文件不上传服务器
- **自建服务稳定**:翻译、OCR、AI 修图、文档转换均为自建服务,不依赖第三方接口
- **永久套餐**:买断制授权,不按次、不按月
- **免费工具持续更新**:20+ 基础工具永久免费,新工具不断增加
## 部署(Docker,三条命令跑起来)
### 第一步:构建前端镜像
需要装好 [Docker](https://docs.docker.com/engine/install/) 和 [Node.js 18+](https://nodejs.org/)(Node 只在构建时用,装完可以卸载)。Windows/Mac 装 Docker Desktop 就自带一切。
```sh
git clone https://github.com/personal82555/it-tools-pro.git
cd it-tools-pro
pnpm install # 没装 pnpm 的话先执行:npm i -g pnpm
pnpm build
docker build -t it-tools:custom .
```
### 第二步:启动工具站
```sh
docker network create ittools-net
docker run -d --name it-tools --restart always --network ittools-net -p 8080:80 it-tools:custom
```
打开浏览器访问 `http://服务器IP:8080` —— **20+ 免费工具已全部可用**(条码、二维码、JSON、PDF、图片工具、网站收藏等,PDF/图片处理全在浏览器本地完成,无需任何后端)。
### 第三步(可选):启动授权/翻译/格式转换后端
需要在线翻译、OCR、AI 修图、文档转换等功能时再启动(依赖自建的 CardAuth 授权服务):
```sh
# 1) 先启动 relay(授权/翻译/格式转换后端)
cd docker/it-tools-relay
cp .env.example .env # 编辑 .env 填入你的 CardAuth 地址和密钥
docker build -t it-tools-relay .
docker run -d --name it-tools-relay --restart always --network ittools-net \
-p 8091:8091 --env-file .env -v relay-data:/app/data it-tools-relay
# 2) relay 就绪后重启工具站(nginx 需能按容器名 it-tools-relay 访问它)
docker rm -f it-tools
docker run -d --name it-tools --restart always --network ittools-net -p 8080:80 it-tools:custom
```
**不启动第三步也完全能用**,只是翻译/OCR/格式转换这几个高级功能会显示试用/授权提示,免费工具不受任何影响。
> 注意:relay 与工具站必须在同一 Docker 网络(ittools-net),且先启动 relay 再启动工具站。
### 方式二:Docker Compose部署
上面三步 `docker run` 的等价编排(含全部参数)。前置要求不变:先 `pnpm install && pnpm build` 生成 `dist/`;`docker/it-tools-relay` 的 Dockerfile 需要 `hf-cache/`、`piper-models/`、`ai-models/`、`waifu2x/` 四个模型目录(未入库),没有的话把 relay 的 `build:` 换成现成镜像 `image: 192.168.68.19:3200/jinghui/it-tools-relay:latest`。
```yaml
services:
it-tools-relay:
build: ./docker/it-tools-relay
image: it-tools-relay:latest
container_name: it-tools-relay
restart: always
ports:
- "8091:8091"
env_file:
- ./docker/it-tools-relay/.env
volumes:
- relay-data:/app/data
networks:
- ittools-net
it-tools:
build: .
image: it-tools:custom
container_name: it-tools
restart: always
depends_on:
- it-tools-relay
ports:
- "8080:80"
extra_hosts:
# nginx 反代宿主机上的 rapidocr(5000) / iopaint(8060) 需要
- "host.docker.internal:host-gateway"
networks:
- ittools-net
# 可选:本地 OCR 加速(不部署则图片OCR/PDF文字识别不可用)
# rapidocr:
# image: rapidocr/rapidocr:latest
# container_name: rapidocr
# restart: always
# ports:
# - "5000:5000"
#
# 可选:AI 修图(去水印/抠图/超分/人脸修复)
# iopaint:
# image: sanster/iopaint:latest
# container_name: iopaint
# restart: always
# ports:
# - "8060:8060"
# volumes:
# - iopaint-models:/root/.cache
volumes:
relay-data:
# iopaint-models:
networks:
ittools-net:
driver: bridge
```
```bash
git clone http://192.168.68.19:3200/jinghui/it-tools-pro.git
cd it-tools-pro
pnpm install && pnpm build # 生成 dist/(Dockerfile 不做前端构建)
cd docker/it-tools-relay && cp .env.example .env && cd ../.. # 填 CardAuth 地址与密钥
docker compose up -d --build
```
打开 `http://服务器IP:8080`。只起工具站、不要 relay 时用 `docker compose up -d it-tools`(翻译/OCR/格式转换会显示试用提示,免费工具不受影响)。
### 可选:本地 OCR / AI 修图模型后端
| 服务 | 端口 | 用途 |
|---|---|---|
| [rapidocr](https://github.com/RapidAI/RapidOCR) | 5000 | 图片OCR / PDF 文字识别加速 |
| [iopaint](https://github.com/Sanster/iopaint) | 8060 | AI 修图(去水印/抠图/超分/人脸修复) |
未部署时对应功能不可用,其余功能不受影响。
### 授权体系(进阶)
授权校验三层生效:前端 LicenseGate(试用计时浮条)→ nginx auth_request(服务端强制)→ relay /check(CardAuth 实时查询,fail-open 不锁死已付费用户)。受控功能清单见 `src/tools/license/license.ts` 与 `docker/it-tools-relay/server.py` 的 `PROTECTED_TOOLS`。
## 开发
```sh
pnpm install # 安装依赖
pnpm dev # 开发服务器(热更新)
pnpm build # 类型检查 + 生产构建
pnpm test # 单元测试(Vitest)
pnpm run script:create:tool my-tool-name # 新工具脚手架
```
推荐 VSCode + Volar 插件开发。
## 致谢与许可
本项目基于 [CorentinTh/it-tools](https://github.com/CorentinTh/it-tools)(GNU GPLv3 License)开发,感谢原作者 [Corentin Thomasset](https://corentin.tech) 的开源贡献。本项目遵循 GPLv3 开源许可。