KopiTehnik Print

English | Русский | Español | 简体中文 | 繁體中文 | Deutsch | Français | Português | 日本語 | 한국어 | Türkçe | Bahasa Indonesia | العربية | हिन्दी | Italiano | Polski | Українська | Tiếng Việt | ไทย | Татарча

KopiTehnik Print

兼容墨水也能打印出照片级画质。 适用于 Windows 的打印软件：色彩精准、无边距打印、智能裁切，并为小型复印店、照相柜台和专业打印机准备订单。每次打印都能省钱。

免费、合法，无破解，无恶意软件。 可供个人使用，也可在一台工作站上免费使用：复印店、工作室、工作坊或独立打印业务。下载 Windows 版 · 支持 15 种界面语言 · 无需 Python

安装

方式	内容	命令
安装程序	开始菜单快捷方式和卸载程序入口	下载安装程序
便携版	单个 exe，不会写入注册表	下载便携版
Scoop	安装在 ~/scoop 的便携版，可通过 scoop update 更新	scoop bucket add ildargiv https://github.com/ildargiv/scoop-bucket then scoop install kopitehnik-print
AI Agent（MCP）	由 Claude Desktop 或任何 MCP 客户端驱动的同一款程序	uvx kopitehnik-print-mcp

应用本身无需 Python：下载内容是可直接使用的 Windows 版本。PyPI 软件包只是 MCP 客户端使用的轻量启动器，会查找已安装的 Agent。

KopiTehnik Print 的优势

• 屏幕所见，即打印所得。 通过打印机的 ICC 配置文件进行打印，呈现自然色彩，无需手动猜测调整。
• 为你的墨水配置文件。 兼容墨水和纸张会改变色彩。无需从头重新制作配置文件：只需修正现有配置文件，并用测试页进行验证。
• 精准无边距打印。 照片不会被过度裁切，减少因打印失败而浪费的纸张和墨水。
• 为喷墨打印做好优化。 自动调整亮度、对比度和阴影，让照片打印出来更明亮。
• 智能裁切。 人脸、人物和动物都会保留在画面中，不会裁掉重要瞬间。
• 连接你自己的 AI Agent。 它接收客户订单、准备照片并通过 KopiTehnik Print 打印：你的 Agent 负责对话和订单，程序负责准备和打印。
• 在一个窗口中处理照片和文档：PDF、Word、Excel、PowerPoint，并为每台打印机单独设置配置文件。
• 打印张数计数器，按打印机和纸张尺寸统计，支持密码保护和 CSV 导出。

许可：可供个人免费使用；也可供在一个地点使用一台工作站的企业免费使用；更多工作站、连锁经营和转售则需要商业许可证。请参阅 LICENSE。

截图

阿拉伯语（从右向左）	日语

功能

• 打印尺寸：10×15、9×13、13×18、15×21、20×30、30×40 cm、A5、A4、A3、A3+、A2（裁剪以填满纸张，或适应整张照片）。
• 智能裁剪：人脸检测（YuNet）、人物和宠物（YOLOX）、姿势模型；也可以手动设置边框。
• 单张照片色彩校正：亮度、对比度、伽马、阴影/高光、饱和度、色温/色调、RGB、自动、黑白、棕褐色、降噪、锐化。
• 色彩管理：打印机 ICC 配置文件和 Windows ICM 开关。
• 打印规划：每张纸打印多张照片、各边出血、每张纸单独一个打印任务并在任务间暂停、打印前检查（DPI、适配情况）。
• 导出为 JPEG、TIFF、PNG 和 PDF。
• 文档模式（顶部的 PHOTO / DOCUMENT 开关）：使用专属打印机配置文件和纸张设置、页码范围、份数以及适应或填满纸张等选项，打印 PDF、Word、Excel 和 PowerPoint 文件。编辑和文本识别（OCR）会在独立的 KopiTehnik Converter 中打开（需单独安装；程序会自动找到它）。
• 每张纸的照片数量：1 至 30（快捷按钮可选 1、2、3、4、6、8、9、12、16、24，也可输入任意数量）；自动检测每张照片的方向。
• 更新：程序会检查 GitHub 上的最新版本（可在 Settings 中切换），并提供打开下载页面的选项。
• 打印计数器（Settings）：统计所有用户当天打印的纸张数（照片和文档分别统计）；详细日志（按打印机、照片和文档分别按纸张尺寸、来源、最近 14 天统计，并可导出 CSV）受管理员密码保护，并提供恢复密钥。日志可检测篡改。它会统计通过程序和 AI Agent 发送到打印机的纸张数。
• 无边距测试页（无边距打印检查），附有五种语言的说明文字。
• AI Agent 模式：每个步骤都是一个返回 JSON 的命令（命令行或用于 Claude Desktop 的 MCP 服务）。请参阅 AGENT.md（俄语）。
• Qt 版本的界面语言：Русский、English、日本語、한국어、Türkçe、Bahasa Indonesia、العربية、हिन्दी、Italiano、Polski、Українська、Tiếng Việt、ไทย、繁體中文、Татарча（在 Settings 中选择；默认使用系统语言，系统语言为俄语时使用俄语，否则使用英语；阿拉伯语界面从右向左显示）。翻译涵盖主要界面，均由机器翻译，尚未经母语人士审核；未翻译的字符串会显示为英语。

安装

• 最简单的方法：从 Releases 页面 下载 KopiTehnikPrint-Setup-<version>.exe（安装程序）、KopiTehnikPrint-Portable-<version>.exe（图形界面，无需安装）或 PhotoCropAgent.exe（AI Agent / MCP），然后运行。无需安装 Python。
• Windows 搭配 Python 3.9+（勾选“Add python.exe to PATH”），或运行 install.bat：它会安装 Python（如尚未安装）、所需软件包并创建快捷方式。需要联网。
• 手动安装：pip install -r requirements.txt。

运行 Qt 版本

双击 run_qt.bat（安装 Pillow、pillow-heif、PySide6 并启动 photo_crop_qt.py）。自检：selftest_qt.bat。较旧的 Tkinter 窗口：python photo_crop.py。

检测模型

仓库中不包含 YuNet / YOLOX 模型（约 36 MB）；首次使用时会下载模型（也可运行 python smart_crop.py setup 下载）到 %APPDATA%\PhotoCrop\models。

内置 MCP 服务：让你的 AI Agent 操作打印台

KopiTehnik Print 内置了 MCP 服务。连接 Claude Desktop（或其他 MCP 客户端）后，你的 Agent 就可以打开照片文件夹、设置打印格式、裁剪、校正颜色、排版、运行打印前检查并打印。也支持文档（PDF、Word、Excel、PowerPoint）。

Agent 会在你看到的同一个窗口中工作：更改会实时显示，按 Ctrl+Z 可撤销更改，徽章会显示 AI Agent 正在工作。你自己的 Agent 负责对话和订单；程序负责准备和打印。

**连接 Claude Desktop：**安装程序会提供将 AI Agent（MCP）连接到 Claude Desktop 的选项，也可以稍后在程序设置中完成。然后重启 Claude Desktop。

**其他 MCP 客户端：**运行 mcp_config.bat（或 python photo_crop.py mcp-config）以获取配置块，并将其添加到客户端的配置中（对于 Claude Desktop：%APPDATA%\Claude\claude_desktop_config.json）。对于已构建的 exe，mcpServers.photocrop 块如下所示：

{
  "mcpServers": {
    "photocrop": {
      "command": "C:\\path\\to\\PhotoCropAgent.exe",
      "args": ["mcp"]
    }
  }
}

**从 PyPI 安装（适用于任何 MCP 客户端）：**同一个 Agent 也以 kopitehnik-print-mcp 的名称发布，因此支持运行 stdio 服务的客户端只需使用 uvx kopitehnik-print-mcp 即可——该软件包只负责定位已安装的 Agent 并为其提供 stdio，不会重新实现任何功能。官方 MCP Registry：io.github.ildargiv/kopitehnik-print。如需一键设置 Agent，请参阅 llms-install.md。

**由你掌控。**在设置中，你可以选择是否允许 Agent 打印、每个打印任务的最大张数，以及打印前是否必须征求你的同意。PHOTOCROP_AGENT_DRYRUN=1 会禁止实际打印，PHOTOCROP_AGENT_ROOTS 则会限制 Agent 可使用的文件夹。Agent 打印的纸张也会计入打印计数器。

提示词示例：“打开文件夹 Client_Ivanov，设置为 10x15，检查照片，然后每张打印 3 份。” / “将此 PDF 打印到 A4 纸上。”

主要命令：open_folder、set_format、auto_crop、set_crop、set_adjust、select_printer、plan_print、render_sheet、preflight、print。完整列表见 AGENT.md（俄语）。

命令行：python photo_crop.py agent set_format format=10x15；python photo_crop.py agent --list 会列出所有命令。状态存储在 %APPDATA%\PhotoCrop\agent_state.json。

构建 exe 文件

build_exe.bat 使用 PyInstaller 构建 PhotoCrop.exe（Tkinter 窗口）和 PhotoCropAgent.exe（用于 MCP 的控制台程序）。注意：该脚本之后会删除 build\ 和 .spec 文件。Qt 版本通过 pyinstaller PhotoCropQt.spec → dist\PhotoCropQt.exe 构建。推送 v* 标签会运行 GitHub Actions 工作流（.github/workflows/build.yml），构建 PhotoCropQt.exe 和 PhotoCropAgent.exe，并将它们附加到 GitHub Release。

许可证

许可证：KopiTehnik Print Licence：可免费用于个人用途，以及在一个地点使用一台工作站的企业；使用更多工作站、连锁经营和转售则需要商业许可证。