KopiTehnik Converter

KopiTehnik Converter

语言： English · Русский · Deutsch · Español · Français · Português · Türkçe · 中文

面向照相馆和印刷店的免费 Windows 软件：批量转换、色彩校正、打印排版、鼠标裁剪、带扫描识别功能的 PDF 编辑器，以及打印预览。可由人工或 AI Agent 驱动。

将照片和文档转换为 JPG/PNG/TIFF/PDF，排版多张照片的打印版面（10x15、证件照、联系表），编辑 PDF 并打印。它也是 MCP 服务，因此 AI Agent（Claude、Hermes、Cursor 等）可以通过工具执行整个工作流。许可证：AGPL-3.0。

主窗口	带裁切标记的 10x15 打印版面

截图使用生成的测试图像制作。

3.0 版新增内容

• 在 PDF 编辑器中识别扫描件。 按下“识别扫描件”（也支持 JPG、PNG、TIFF）。扫描件会被拉正、裁切至页面并去除噪点和阴影；系统会识别文字行（支持俄语和英语，本地运行，无需互联网或云服务，内置 RapidOCR 和 PaddleOCR 模型），并将其转换为普通编辑器块，可供编辑、移动和添加。在文字行未修改时，会显示扫描图像，文字则作为不可见的可搜索图层；修改后的文字行会以白色覆盖原文。
• 信息核验。 以黄色标出看起来可疑的内容：通过校验和检查俄罗斯税务和注册号码、银行代码和账户、无效日期、数字金额与文字金额不符、拉丁字母与西里尔字母混用、用字母代替数字。“可疑”按钮和 Tab 键可逐项查看，点击“全部正确”可清除标记。
• 保存文本。 可从编辑器导出到 Word（.docx，扫描件中的表格会转换为真正的 Word 表格）、Excel（.xlsx，每页对应一个工作表，数字保留为数值）或纯文本。
• 全屏编辑器（F11）：Ctrl+滚轮缩放，中键平移，“适应宽度”。
• 鼠标裁剪： 在照片上拖动即可绘制带控制点的框；所选格式（10x15 等）会保持比例。方向键可将裁剪框移动 1 像素（Shift：10 像素），Ctrl+方向键可调整其大小。
• 精准全屏裁剪框： 照片铺满窗口，最高可放大 24 倍；可用鼠标、方向键或像素值设置裁剪框。
• 倾斜 ±45°（校正地平线），并自动裁掉空白角落。
• 撤销和重做（Ctrl+Z、Ctrl+Y），适用于裁剪框、裁切、倾斜和旋转。
• MCP： 修复了 print_files 中 color: "gray" 的问题，并支持通过 pdf_find_text 搜索由 pdf_edit 写入的文本。

为什么照相馆需要它

普通的一天：顾客带着一个闪存盘，里面有手机拍摄的 HEIC、PSD、扫描件、Word 和 PDF 文件。所有文件都需要统一格式、校正色彩、排版到 10x15 照片纸或证件照纸上、添加裁切线，然后发送到打印机。Converter 可以在一个程序中一次性处理整个文件夹。

• 支持各种输入： JPG、PNG、WebP、BMP、GIF、TIFF、HEIC、PSD、PDF、SVG、TXT、HTML、XLSX、ZIP 压缩包（安装了 7-Zip 或 WinRAR 后也支持 RAR 和 7z），以及通过 Microsoft Office 或 LibreOffice 处理的 Word、PowerPoint 和 Excel。
• 色彩： 自动校正、白平衡取色器、亮度、对比度、饱和度、中间调，以及红、绿、蓝、青、洋红和黄色的独立调节。保留嵌入的 ICC 配置文件，并转换为 sRGB。
• 打印排版： 现成布局（A4 纸上的 10x15 和 9x12 照片、3x4、3.5x4.5 和 4x6 证件照、联系表），自定义网格或尺寸、边距、间距、份数、旋转以适应单元格、裁切线、说明文字。
• 裁剪： 3:2、4:3、5:4、7:5、1:1、16:9、A4，以及以 cm、mm 或英寸为单位的自定义尺寸；鼠标框选、倾斜、旋转、镜像。
• 打印： 纸张上的打印布局预览、打印机选择及属性、A3、A4、A5、A6、10x15、13x18、15x21、20x30、Letter 纸张，边距、份数、页码范围、彩色或黑白、“适应页面”、“无边距填充”或按 dpi 指定实际尺寸。
• PDF 编辑器： 插入文本，选中一行或一个段落并修正或移动，擦除区域，识别扫描件（本地处理），将文本保存为 Word 或 Excel。源文件绝不会被修改。
• 批量处理支持多线程和命令行：Converter.exe --convert <folder> <output>。

由 AI Agent 控制（MCP）

程序以 MCP 服务运行：AI Agent 可以通过带文本参数的工具使用所有功能。无需窗口或视觉识别：可通过数值（尺寸、亮度、对比度）、PDF 文本，以及（如有需要）预览图片来检查结果。例如：“将文件夹中的照片排版到 10x15 照片纸上，检查亮度，统计纸张数量，并在我确认后打印”。

• stdio 传输。服务仅在你的计算机上运行，不会监听网络。
• 兼容 Claude Desktop、Claude Code、Hermes Agent、Cursor、Cline 和任何 MCP 客户端。
• 工具：app_info、list_files、inspect_file、convert、make_sheet、preview、pdf_info、pdf_get_text、pdf_find_text、pdf_edit、pdf_pages、list_printers、print_files。
• 打印安全可靠：print_files 支持 dry_run（仅统计纸张数量）和 printer: "pdf"（写入文件）。源文件绝不会被修改。

使用 Converter.exe --mcp 连接。可在“关于”中的“连接 AI Agent”找到现成配置。各客户端的详细说明和示例见：MCP.md。

安装

下载 KopiTehnik-Converter-Setup.exe（Releases）：无需管理员权限，包含快捷方式，可从“应用”中卸载。新版本会在 https://vk.ru/icc_profil 上发布。程序启动时会检查 GitHub 并提示更新；下载的安装程序会根据该版本的 SHA-256 值进行验证。

界面支持 8 种语言（俄语、英语、西班牙语、德语、法语、葡萄牙语、土耳其语、中文；自动检测 Windows 语言，默认使用英语），并提供深色和浅色主题。程序名称也会随界面一同翻译。

验证文件

安装程序由 GitHub Actions 根据开源代码构建（工作流）；发布版本附带 SHA256SUMS.txt 和构建证明。检查哈希值：certutil -hashfile KopiTehnik-Converter-Setup.exe SHA256。文件目前尚未签名（正在准备免费的 SignPath 申请），因此 SmartScreen 可能会显示“未知发布者”：点击“更多信息”，然后点击“仍要运行”。

从源代码运行

需要 Python 3.10 或更高版本。

pip install PySide6 pillow pillow-heif openpyxl "pymupdf<2" rapidocr opencv-python
python app.py

构建 exe

pip install pyinstaller
pyinstaller converter.spec        # 结果位于 dist\Converter.exe

构建包含独立 LibreOffice 的完整版本（可在未安装 Office 的电脑上运行；文件夹约 850 MB，压缩包约 380 MB）：

python tools/make_full.py [LibreOffice folder]   # 结果位于 dist\Converter-full 和 dist\Converter-full.zip

不带参数时会使用这台电脑上安装的 LibreOffice。也可使用便携版 LibreOffice：提供其 App\libreoffice 文件夹。

结构

• core/loaders.py 将任意格式的文件读取为页面；core/office.py 查找 Microsoft Office 和 LibreOffice，并将文档转换为 PDF
• core/imaging.py 负责色彩、旋转、裁剪和保存；core/sheet.py 负责在一张纸上排版多张照片
• core/batch.py 负责文件搜索、压缩包、多线程批处理和 PDF 输出
• ui/main_window.py 主窗口；ui/programs.py 程序窗口；ui/printing.py 打印；ui/pdf_editor.py PDF 编辑器；ui/crop_dialog.py 精确取景框
• ui/widgets.py、ui/theme.py、ui/i18n.py（+ ui/i18n_<lang>.py）负责控件、主题和界面文本
• core/ocr.py 扫描件预处理和识别（RapidOCR）；core/requisites.py 检查税号、日期和金额；core/textexport.py 将文本保存为 Word、Excel 和 txt
• tools/make_test_scan.py 生成一份虚构合同扫描件，用于测试识别
• core/mcp_server.py、core/mcp_tools.py、core/pdftools.py、core/printjob.py 负责 MCP 服务、其工具、PDF 编辑和无窗口打印
• tools/make_full.py 构建包含 LibreOffice 的完整版本

添加语言

创建 ui/i18n_<code>.py，其中包含 TEXTS = {...}（复制 ui/i18n_de.py 并翻译其中的值；缺少的键会回退到英语），然后在 ui/i18n.py 的 LANGUAGES 中添加语言代码和其原生名称。将 app_title 设置为翻译后的程序名称。

许可证

版权所有 (C) Ildar Gaisin (Gaisin Ildar Vilsurovich)。采用 GNU Affero General Public License v3（文件 LICENSE）发布的自由软件：可自由使用、学习、修改和分发；源代码必须保持开源。第三方许可证：THIRD_PARTY_NOTICES.txt。

作者

Ildar Gaisin (Gaisin Ildar Vilsurovich)，KopiTehnik Converter 的开发者；该公司是一家照片冲印和专业打印公司。 新闻、版本发布和联系方式：VK 群组 https://vk.ru/icc_profil