美团熱敏プリンター (meituan-printer)

TCP Socket + ESC/POS プロトコルを通じて、美団熱敏プリンターにフォーマットされたタスクシート/チェックシートを送信します。

2種類の構成管理方法

Web 管理インターフェースを推奨します。ブラウザ操作の方が直感的です。不便な場合は、対話方式を使用してください。

方法1：Web 管理インターフェース（推奨）

ユーザーは、ブラウザを通じてすべてのプリンター、定期タスク、および印刷テンプレートを管理できます。ターミナル操作は不要です。

起動方法（3種類）：

1. 起動スクリプトをダブルクリック：macOS では scripts/start.command をダブルクリック、Windows では scripts/start.bat をダブルクリック
2. 対話起動：AI に「プリンター管理インターフェースを起動」または「Web バックエンドを開く」と伝えると、AI が起動を支援します
3. ターミナルコマンド：cd scripts && python3 web_admin.py（macOS）または python web_admin.py（Windows）

起動後、http://localhost:5000 にアクセスします（5000 が使用中の場合は、自動的に 5001 が使用されます）。

機能：

• プリンター管理：プリンターの追加/編集/削除、接続テスト、タイプのカスタム定義
• 定期タスク：定期印刷タスクの作成/編集/開始/停止、即時実行、システムレベルの定期タスクへのエクスポート
• テンプレート管理：プリセット印刷テンプレート、カスタムテンプレート

💡 ユーザーが「プリンターを管理」、「プリンターを追加」、「プリンターを構成」、「定期的に印刷」、「管理インターフェースを開く」などと言う場合、AI は Web 管理インターフェースの使用を積極的に促すか、ユーザーの代わりに直接起動する必要があります。

方法2：対話式構成

ブラウザを開くのが不便な場合、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                       # ユーザー構成（実行時に生成）

コアフロー：2段階

ステップ1：プリンターの構成（対話式、1回限り）

ユーザーが初めて使用する場合、またはプリンターを追加/管理する必要がある場合は、対話を通じて構成を完了します。ユーザーがスクリプトを実行する必要はありません。

対話式構成フロー

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 配列から削除します
• プリンターを変更：変更するフィールドを確認した後、対応するエントリを更新します

ステップ2：印刷の開始（日常的な使用）

python3 scripts/print_to_printer.py --name <別名> --title "<タイトル>" --content "<内容>"

AI ワークフロー（ユーザーが印刷を要求した場合）

ステップ1：印刷ターゲットの確認

次の優先順位に従って、ターゲットプリンターを決定します。

ステップ2：タスクタイプの確認

ユーザーに必ず質問してください：

「この印刷タスクは定期タスクですか、それとも1回限りの印刷ですか？」

• 1回限り：プリンターにすぐに送信します
• 定期タスク：記録し、ユーザーが自動化（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

印刷形式の説明

印刷出力には以下が含まれます。

1. 大見出し（中央揃え + 2倍のサイズ）：タスクシート名
2. タイムスタンプ（中央揃え + 倍の高さ）：印刷時間
3. 区切り線：32 個の =
4. 本文（倍の高さ）：具体的な作業内容。時間ノードは太字+倍の幅
5. 最後のヒント：「请按时完成各项工作」
6. 自動カット

注意事項

• 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 が使用されます）

機能モジュール

1. プリンター管理：プリンターの追加/編集/削除、接続性テスト
2. 定期タスク：定期印刷タスクの作成/編集/開始/停止、即時実行、システムレベルの定期タスクへのエクスポート
3. テンプレート管理：プリセット印刷テンプレート（早班检查单、晚班收尾单、周报表、月度盘点单）、カスタムテンプレート

定期タスクの頻度

3つの頻度をサポートします。

• 毎日：毎日固定時間に実行します（例：毎日 09:00）
• 毎週：毎週何曜日の固定時間に実行します（例：毎週月曜日 09:00）
• 毎月：毎月何日の固定時間に実行します（例：毎月 1 日 08:00）

システムレベルの定期タスクのエクスポート

定期タスクは、デフォルトで Web サービスプロセス内でスケジュールされます（APScheduler）。システムレベルの定期タスクとしてエクスポートすることをサポートします。

• macOS：launchd plist としてエクスポートし、~/Library/LaunchAgents/ にインストールします
• Windows：schtasks /create を使用して Windows タスクスケジューラに登録します

エクスポート後、Web サービスが閉じられても、定期タスクは時間通りに実行されます。