LangBot/plugins/misc/DailyLimitPlugin/readme/README_ja_JP.md

1日の会話制限プラグイン

LangBot でセッションごとの1日の会話回数を制限し、制限の確認・設定・リセットができる 組み込みの管理ページを提供します。本番環境対応。

機能

• セッションごとの1日制限 — 各個人チャット／グループを個別にカウント
• 管理ページ（LangBot 管理画面内）で以下が可能：
  • 追跡中の全セッションを本日の使用量とプログレスバー付きで表示
  • 新規セッションの既定上限を設定
  • セッションごとに上限を上書き
  • 1つのセッションのカウンターを手動リセット、または一括リセット
  • セッションの追跡を停止（削除）
  • 上限メッセージ、サイレントモード、リセットのタイムゾーン・時刻を編集（再起動不要）
• サイレントモード — 上限超過メッセージを返信せず破棄
• タイムゾーン対応リセット — 日次ロールオーバーの UTC オフセットと時刻を設定可能
• 永続化 — すべての状態はプラグインストレージに保存され、再起動後も保持

コンポーネント

パス	種類	役割
main.py	Plugin	共有状態、カウント／制限／リセットのロジック、永続化
components/event_listener/	EventListener	各会話をカウントし、上限到達時にブロック
components/pages/manage/	Page	管理 UI（セッション、既定値、手動リセット）

設定

以下は初期既定値です。すべて管理ページからリアルタイムで編集できます。

オプション	型	既定値	説明
daily_limit	integer	50	セッションごとの1日の既定上限。0 = 無制限。
limit_message	string	您今天的对话次数已达上限，请明天再来吧~	上限超過時に表示されるメッセージ。
reset_timezone_offset	integer	8	日次リセットの UTC オフセット（時間）。
reset_hour	integer	0	カウンターがリセットされる時刻（設定タイムゾーン基準）。
silent_mode	boolean	false	有効にすると上限超過メッセージを静かに破棄。

仕組み

セッションは {種類}:{ID} — 特定の個人チャットまたはグループです。EventListener は PersonNormalMessageReceived と GroupNormalMessageReceived をフックし、各メッセージで セッションのカウンターを有効上限（セッション個別の上書き、またはグローバル既定値）と照合します。 上限に達すると、上限メッセージを返信するか静かに破棄（サイレントモード）し、既定の LLM パイプラインをブロックします。

カウンターは設定タイムゾーンの設定時刻でロールオーバーします。管理ページはプラグインの handle_api を通じて同じメモリ内＋永続化された状態を読み書きするため、変更は即座に反映されます。