美团热敏打印机 (meituan-printer)
通过 TCP Socket + ESC/POS 协议，向美团热敏打印机发送带格式的任务单/检查单。
两种配置管理方式
推荐首选 Web 管理界面，浏览器操作更直观；不方便时再通过对话方式。
方式一：Web 管理界面（推荐）
用户可通过浏览器管理所有打印机、定时任务和打印模板，无需终端操作。
启动方式（三种）：
- 双击启动脚本：macOS 双击
scripts/start.command，Windows 双击scripts/start.bat - 对话启动：直接告诉 AI "启动打印机管理界面"或"打开 web 后台"，AI 会帮你启动
- 终端命令：
cd scripts && python3 web_admin.py（macOS）或python web_admin.py（Windows）
启动后访问 http://localhost:5000（如果 5000 被占用则自动使用 5001）。
功能：
- 打印机管理：添加/编辑/删除打印机、连通性测试、类型自定义
- 定时任务：创建/编辑/启停定时打印任务、立即执行、导出到系统级定时任务
- 模板管理：预设打印模板、自定义模板
💡 如果用户说"管理打印机"、"添加打印机"、"配置打印机"、"定时打印"、"打开管理界面"等，AI 应主动引导用户使用 Web 管理界面，或直接帮用户启动。
方式二：对话式配置
不方便打开浏览器时，AI 可直接通过对话完成打印机配置。
对话式配置流程
AI 直接与用户对话，按以下步骤收集信息并完成配置：
meituan-printer/
├── SKILL.md # 本文件（AI 指引）
├── scripts/
│ ├── print_to_printer.py # 核心打印脚本
│ ├── check_printer.py # 连通性检测工具（非交互式）
│ ├── web_admin.py # Web 管理界面后端（Flask + APScheduler）
│ ├── platform_utils.py # 跨平台工具层（macOS/Windows 兼容）
│ ├── start.command # macOS 启动脚本
│ ├── start.bat # Windows 启动脚本
│ ├── config.json # 打印机配置
│ ├── tasks.json # 定时任务配置
│ └── templates/
│ ├── index.html # Web 管理界面前端
│ └── task_templates.json # 预设打印模板
├── references/
│ ├── printer-config.md # 打印机配置参考（IP/类型映射）
│ └── onboarding.md # 新手指南（面向用户）
└── config.json # 用户配置（运行时生成）
核心流程：两步走
第一步：配置打印机（对话式，一次性）
用户首次使用或需要添加/管理打印机时，通过对话完成配置，不需要用户运行任何脚本。
对话式配置流程
AI 直接与用户对话，按以下步骤收集信息并完成配置：
1. 询问基本信息
向用户提问（自然语言即可，不需要一次性问完）：
- IP 地址：打印机的局域网 IP（如
192.168.3.172） - 端口：默认
9100，如果不是标准端口才需要用户说明 - 别名：中文别名，方便日常称呼（如"后厨"、"素菜"、"前厅酒水"）
- 类型：打印机用途（荤菜岗/备货岗/前台收银/其他）
- 备注：选填，如"梅林店前厅"
💡 AI 可以根据
references/printer-config.md中已有的信息主动提示，减少用户输入。
2. 连通性检测（AI 后台执行）
收集到 IP 和端口后，AI 在后台运行检测脚本：
python3 scripts/check_printer.py --ip <IP> --port <端口>
返回 JSON：{"reachable": true/false, "ip": "...", "port": ..., "error": null/"错误信息"}
根据结果告知用户：
reachable: true→ "✅ 打印机连接成功"reachable: false→ "⚠️ 无法连接，请确认 IP/端口和打印机电源"
3. 写入配置
检测通过后，AI 直接将新打印机追加到 scripts/config.json：
{
"alias": "前厅",
"ip": "192.168.3.172",
"port": 9100,
"type": "前厅收银",
"remark": "梅林店"
}
config.json 完整格式：
{
"version": "1.0",
"printers": [...],
"created_at": "2026-04-24",
"updated_at": "2026-04-24"
}
⚠️ 如果别名已存在，AI 应提示用户并确认是否覆盖。
配置管理
用户也可以通过对话请求：
- 查看已配置打印机：读取 config.json 并以表格形式展示
- 删除打印机：确认别名后从 config.json 的 printers 数组中移除
- 修改打印机：确认要修改的字段后更新对应条目
第二步：发起打印（日常使用）
python3 scripts/print_to_printer.py --name <别名> --title "<标题>" --content "<内容>"
AI 工作流（当用户请求打印时）
步骤 1：确认打印目标
按以下优先级确定目标打印机：
| 用户说法 | 对应参数 |
|---|---|
| "后厨"、"素菜"、"前厅" | --name 后厨 等 |
| "荤菜岗"、"素菜岗"、"前台" | --name <对应别名> |
| "IP 是 xxx" / "地址是 xxx" | --ip <IP> |
| 未指定 | 查 config.json；无配置则引导用户先通过对话配置 |
步骤 2：确认任务类型
必须询问用户：
"这个打印任务是定时任务还是一次性打印？"
- 一次性：立即发送到打印机
- 定时任务：记录下来，协助用户创建自动化（cron/任务计划程序）
步骤 3：确认内容
- 标题（title）：任务单名称，如"早班A任务单"、"素菜岗检查单"
- 内容（content）：具体工作事项，多行用
\n分隔- 时间节点用
-------HH:MM-------格式 - 示例：
"-------09:30-------\\n打卡拍照\\n解冻冻货"
- 时间节点用
步骤 4：执行打印
立即打印：调用 print_to_printer.py，捕获结果并告知用户
定时打印：
- 记录：打印机别名 + 标题 + 内容 + 触发时间
- 告诉用户定时任务的创建方式（crontab / 任务计划程序）
- 必要时协助生成 crontab 条目
步骤 5：输出确认
打印完成后，向用户反馈：
✅ 已发送至【后厨】(192.168.3.172:9100)
📄 标题：早班A任务单
⏰ 时间：2026-04-23 14:30
打印格式说明
打印输出包含：
- 大标题（居中 + 双倍大小）：任务单名称
- 时间戳（居中 + 倍高）：打印时间
- 分隔线：32 个
= - 正文（倍高）：具体工作内容，时间节点加粗+倍宽
- 结尾提示："请按时完成各项工作"
- 自动切纸
注意事项
- Python 环境：使用
python3（macOS/Linux 默认）或python（Windows 默认） - 配置文件：
scripts/config.json（AI 直接读写，用户无需手动编辑） - 默认端口：
9100（美团热敏打印机标准端口，99% 适用） - 中文编码：GB18030，确保打印机支持中文热敏纸
- 网络要求：打印机与电脑在同一局域网内
- 超时设置：连接超时 5 秒
Web 管理界面
概述
提供一个本地 Web 管理界面，用户可通过浏览器管理打印机和定时任务，无需终端操作。
启动方式
macOS：双击 scripts/start.command 或终端执行 bash scripts/start.command
Windows：双击 scripts/start.bat 或 CMD 执行 scripts/start.bat
启动脚本会自动检测 Python 环境、安装依赖（flask, apscheduler），然后启动 Web 服务。
访问地址：http://localhost:5000（如果 5000 被占用则自动使用 5001）
功能模块
- 打印机管理：添加/编辑/删除打印机、连通性测试
- 定时任务：创建/编辑/启停定时打印任务、立即执行、导出到系统级定时任务
- 模板管理：预设打印模板（早班检查单、晚班收尾单、周报表、月度盘点单）、自定义模板
定时任务频率
支持三种频率：
- 每天：每天固定时间执行（如每天 09:00）
- 每周：每周几固定时间（如每周一 09:00）
- 每月：每月几号固定时间（如每月 1 号 08:00）
系统级定时任务导出
定时任务默认在 Web 服务进程内调度（APScheduler）。支持导出为系统级定时任务：
- macOS：导出为 launchd plist，安装到
~/Library/LaunchAgents/ - Windows：通过
schtasks /create注册到 Windows 任务计划程序
导出后即使 Web 服务关闭，定时任务仍会按时执行。