# 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`),授权系统后台据此展示安装数/在线数/趋势 - **失败开放**:授权系统不可达时静默降级,不影响站点任何功能 - **实现注意**:公告面板与推送弹窗均 ``——实测 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//[?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 开源许可。