Files
it-tools-pro/README.md
T

16 KiB
Raw Blame History

IT-TOOLS-PRO - 高级定制版工作者工具站:12个原创实用工具+卡密授权系统

基于开源项目 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 新增,同日两次改版定稿):「尝试这些示例」区选项卡切换——通用(6) / 自媒体(6) / 电商(10) / 软件类(16),共 38 个即点即填的场景提示词。软件类=电脑软件+手机软件合并(办公桌面、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 提示文案同步引导。

优势

  • 一次激活,全站通用:输入一次卡密,全部授权功能解锁,无需逐个购买
  • 先用后买:每个授权功能每天免费试用 30 分钟,觉得好用再付费
  • 隐私友好:PDF/图片/OCR 工具全程浏览器本地处理,文件不上传服务器
  • 自建服务稳定:翻译、OCR、AI 修图、文档转换均为自建服务,不依赖第三方接口
  • 永久套餐:买断制授权,不按次、不按月
  • 免费工具持续更新:20+ 基础工具永久免费,新工具不断增加

部署(Docker,三条命令跑起来)

第一步:构建前端镜像

需要装好 Docker 和 Node.js 18+(Node 只在构建时用,装完可以卸载)。Windows/Mac 装 Docker Desktop 就自带一切。

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 .

第二步:启动工具站

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 授权服务):

# 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。

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
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 5000 图片OCR / PDF 文字识别加速
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。

开发

pnpm install          # 安装依赖
pnpm dev              # 开发服务器(热更新)
pnpm build            # 类型检查 + 生产构建
pnpm test             # 单元测试(Vitest)
pnpm run script:create:tool my-tool-name   # 新工具脚手架

推荐 VSCode + Volar 插件开发。

致谢与许可

本项目基于 CorentinTh/it-tools(GNU GPLv3 License)开发,感谢原作者 Corentin Thomasset 的开源贡献。本项目遵循 GPLv3 开源许可。