line-ext-msg 1.0.0__tar.gz

line_ext_msg-1.0.0/.gitignore

@@ -0,0 +1,17 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Generated debug/output files
+line_dom.html
+line_room.html
+rooms.json
+messages_*.json
+media/

line_ext_msg-1.0.0/.python-version

@@ -0,0 +1 @@
+3.14

line_ext_msg-1.0.0/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+## 1.0.0
+
+First stable release: OOP facade, extended schema, filters, search, media.
+
+- `Message.media_data`: opt-in data URI (`include_media_data=True`) for MCP/AI image analysis
+- Download image bubbles to `media/` via in-page blob fetch; `Message.media` holds the path
+- CLI shows `[รูปภาพ: path]` / `[สติกเกอร์]` instead of blank lines
+
+- Filters: `date_from/date_to`, `time_from/time_to` (`HH:MM`), `sender`, `keyword` in `get_messages`/`save_messages`/CLI
+- `search_all()` keyword search grouped per room, `unread_full()` unread rooms + today's messages
+- `sender_stats()` pure per-sender counts; `apply_filters()` unit-tested without browser
+
+- Explicit save: `get_*`/`list_*` never write files; only `save_rooms`/`save_messages` do
+- CLI `--save` flag (default prints to screen only)
+- Removed `export_room` (use `save_messages`)
+
+- OOP rewrite: `LineClient` facade owns lifecycle (context manager)
+- Models: `Room{index,id,name,unread,last_preview,last_time}`,
+  `Message{id,date,ts,sender,from_me,type,text,read_count}`, `StepResult`
+- Typed errors: `LoginRequired`, `ExtensionMissing`, `RoomNotFound`, ...
+- `Settings` dataclass (env `LINE_EXT_MSG_*`) replaces config constants
+- `open_room` accepts index, data-mid, name substring, or Room
+- `get_messages(room?, limit, date?)`, `unread_digest()`, `export_room()`
+- CLI flags: `--date`, `--unread`; `Steps` supports `quiet`
+- Removed: `browser.py`, `chrome_launcher.py`, `config.py` (now `session.py`, `chrome.py`, `settings.py`)
+
+## 0.1.0
+
+- Restructured to `src/line_ext_msg` package with `line-ext-msg` CLI entry point
+- Checklist startup: Chrome debug, CDP attach, extension, render, login
+- Room listing, latest-N message export to JSON (timestamp + sender + text)
+- Library API for MCP reuse: `list_rooms`, `get_latest_messages`

line_ext_msg-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ITC6910120
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

line_ext_msg-1.0.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.5
+Name: line-ext-msg
+Version: 1.0.0
+Summary: Pull messages from LINE Chrome Extension via Playwright CDP (own account, read-only)
+Project-URL: Homepage, https://github.com/onlygummy/line-ext-msg
+Author: ITC6910120
+License: MIT
+License-File: LICENSE
+Keywords: cdp,chrome-extension,line,playwright
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: playwright>=1.40
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# line-ext-msg
+
+ดึงข้อความ (เวลา + คนส่ง + ข้อความ + วันที่ + สถานะ) จาก LINE Chrome Extension ผ่าน Playwright แบบเกาะ Chrome ตัวจริง บัญชีของตัวเอง อ่านอย่างเดียว
+
+## ติดตั้ง
+
+```powershell
+pip install line-ext-msg
+```
+
+ต้องมี Google Chrome ในเครื่อง ไม่ต้องรัน `playwright install` เพราะโปรแกรมเกาะ Chrome ที่มีอยู่ผ่าน CDP ไม่ได้ใช้ bundled chromium
+
+## ใช้งาน CLI
+
+```powershell
+line-ext-msg                       # เลือกห้องใน Terminal → พิมพ์จออย่างเดียว ไม่สร้างไฟล์
+line-ext-msg --save                # + เขียน rooms.json + messages_{index}.json
+line-ext-msg --unread               # แสดงเฉพาะห้องที่ไม่อ่าน
+line-ext-msg --limit 10 --date 2026-09-12
+line-ext-msg --date-from 2026-09-01 --date-to 2026-09-12 --keyword "ใบแจ้งหนี้"
+line-ext-msg --search "ใบแจ้งหนี้"  # ค้นทุกห้อง สรุปห้องที่เจอ
+```
+
+ครั้งแรก: โปรแกรมเปิด Chrome โปรไฟล์แยก `%LOCALAPPDATA%\line-chrome-debug` ให้เอง ติดตั้ง LINE + ล็อกอินครั้งเดียวในหน้าต่างนั้น หลังจากนั้น auto หมด (Chrome 136+ บล็อก `--remote-debugging-port` บนโปรไฟล์หลักโดยตรง จึงต้องใช้โปรไฟล์แยก)
+
+## หน้าตาไฟล์ JSON ที่ได้
+
+```json
+{
+  "room": { "index": 0, "id": "CXX...", "name": "ครอบครัว", "unread": 3,
+            "last_preview": "กินข้าวยัง", "last_time": "8:13 AM" },
+  "fetched_at": "2026-09-12T01:00:00+00:00",
+  "messages": [
+    { "id": "0178...", "date": "2026-09-12", "ts": "2026-09-12T08:13:00",
+      "sender": "แม่", "from_me": false, "type": "text",
+      "text": "กินข้าวยัง", "read_count": null }
+  ]
+}
+```
+
+## ข้อจำกัดที่ควรรู้
+
+- อ่านได้เฉพาะแถวที่ render บนจอ (virtualized list) ประวัติย้อนหลังลึกต้อง scroll เพิ่ม (ยังไม่ทำ)
+- ได้เฉพาะที่ UI แสดง ไม่มี API สถานะอ่านรายข้อความ
+- `from_me` เป็น heuristic (ไม่มี username = เราส่ง) ยังไม่ยืนยันด้วย dump ที่มีข้อความของตัวเอง
+
+## dev
+
+```powershell
+uv sync
+uv run pytest
+uv build
+```
+
+## ถ้าอ่านห้องไม่ได้ (LINE อัปเดต UI)
+
+```powershell
+line-ext-msg --dump              # DOM หน้า chats → line_dom.html
+line-ext-msg --dump-room 0       # DOM ในห้อง → line_room.html
+# ส่งไฟล์มาเพื่อจูน selector ใน src/line_ext_msg/settings.py
+```

line_ext_msg-1.0.0/README.md

@@ -0,0 +1,61 @@
+# line-ext-msg
+
+ดึงข้อความ (เวลา + คนส่ง + ข้อความ + วันที่ + สถานะ) จาก LINE Chrome Extension ผ่าน Playwright แบบเกาะ Chrome ตัวจริง บัญชีของตัวเอง อ่านอย่างเดียว
+
+## ติดตั้ง
+
+```powershell
+pip install line-ext-msg
+```
+
+ต้องมี Google Chrome ในเครื่อง ไม่ต้องรัน `playwright install` เพราะโปรแกรมเกาะ Chrome ที่มีอยู่ผ่าน CDP ไม่ได้ใช้ bundled chromium
+
+## ใช้งาน CLI
+
+```powershell
+line-ext-msg                       # เลือกห้องใน Terminal → พิมพ์จออย่างเดียว ไม่สร้างไฟล์
+line-ext-msg --save                # + เขียน rooms.json + messages_{index}.json
+line-ext-msg --unread               # แสดงเฉพาะห้องที่ไม่อ่าน
+line-ext-msg --limit 10 --date 2026-09-12
+line-ext-msg --date-from 2026-09-01 --date-to 2026-09-12 --keyword "ใบแจ้งหนี้"
+line-ext-msg --search "ใบแจ้งหนี้"  # ค้นทุกห้อง สรุปห้องที่เจอ
+```
+
+ครั้งแรก: โปรแกรมเปิด Chrome โปรไฟล์แยก `%LOCALAPPDATA%\line-chrome-debug` ให้เอง ติดตั้ง LINE + ล็อกอินครั้งเดียวในหน้าต่างนั้น หลังจากนั้น auto หมด (Chrome 136+ บล็อก `--remote-debugging-port` บนโปรไฟล์หลักโดยตรง จึงต้องใช้โปรไฟล์แยก)
+
+## หน้าตาไฟล์ JSON ที่ได้
+
+```json
+{
+  "room": { "index": 0, "id": "CXX...", "name": "ครอบครัว", "unread": 3,
+            "last_preview": "กินข้าวยัง", "last_time": "8:13 AM" },
+  "fetched_at": "2026-09-12T01:00:00+00:00",
+  "messages": [
+    { "id": "0178...", "date": "2026-09-12", "ts": "2026-09-12T08:13:00",
+      "sender": "แม่", "from_me": false, "type": "text",
+      "text": "กินข้าวยัง", "read_count": null }
+  ]
+}
+```
+
+## ข้อจำกัดที่ควรรู้
+
+- อ่านได้เฉพาะแถวที่ render บนจอ (virtualized list) ประวัติย้อนหลังลึกต้อง scroll เพิ่ม (ยังไม่ทำ)
+- ได้เฉพาะที่ UI แสดง ไม่มี API สถานะอ่านรายข้อความ
+- `from_me` เป็น heuristic (ไม่มี username = เราส่ง) ยังไม่ยืนยันด้วย dump ที่มีข้อความของตัวเอง
+
+## dev
+
+```powershell
+uv sync
+uv run pytest
+uv build
+```
+
+## ถ้าอ่านห้องไม่ได้ (LINE อัปเดต UI)
+
+```powershell
+line-ext-msg --dump              # DOM หน้า chats → line_dom.html
+line-ext-msg --dump-room 0       # DOM ในห้อง → line_room.html
+# ส่งไฟล์มาเพื่อจูน selector ใน src/line_ext_msg/settings.py
+```

line_ext_msg-1.0.0/examples/01_list_rooms.py

@@ -0,0 +1,20 @@
+"""01 - List all LINE chat rooms.
+
+Prerequisites: Chrome + LINE Extension installed + logged in
+(profile %LOCALAPPDATA%\\line-chrome-debug).
+
+Run: uv run python examples/01_list_rooms.py
+"""
+from line_ext_msg import LineClient
+
+
+def main() -> None:
+    with LineClient() as line:
+        line.status()
+        for room in line.list_rooms():
+            unread = f" ({room.unread} ไม่อ่าน)" if room.unread else ""
+            print(f"[{room.index}] {room.name}{unread}")
+
+
+if __name__ == "__main__":
+    main()

line_ext_msg-1.0.0/examples/02_latest_messages.py

@@ -0,0 +1,23 @@
+"""02 - Export latest messages of one room to JSON.
+
+Run: uv run python examples/02_latest_messages.py --room "ครอบครัว" --limit 5
+"""
+import argparse
+
+from line_ext_msg import LineClient
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--room", required=True, help="Room name substring")
+    parser.add_argument("--limit", type=int, default=5)
+    args = parser.parse_args()
+
+    with LineClient() as line:
+        line.status()
+        out = line.save_messages(args.room, limit=args.limit)
+        print(f"บันทึก {out}")
+
+
+if __name__ == "__main__":
+    main()

line_ext_msg-1.0.0/examples/03_mcp_style.py

@@ -0,0 +1,40 @@
+"""03 - MCP-style function: no CLI, no input(), returns dict.
+
+This is the shape an MCP server (separate repo) can import directly:
+    from line_ext_msg import LineClient
+
+Run: uv run python examples/03_mcp_style.py
+"""
+from dataclasses import asdict
+
+from line_ext_msg import LineClient
+from line_ext_msg.errors import LineError
+
+
+def get_messages(room_name: str, limit: int = 5) -> dict:
+    """Return latest messages of the first room matching room_name."""
+    try:
+        with LineClient(quiet=True) as line:
+            line.status()
+            room = line.open_room(room_name)
+            msgs = line.get_messages(limit=limit)
+            return {"ok": True, "room": asdict(room),
+                    "messages": [asdict(m) for m in msgs]}
+    except LineError as e:
+        return {"ok": False, "error": f"{type(e).__name__}: {e}"}
+
+
+def unread_digest() -> dict:
+    """Rooms with unread messages plus latest preview."""
+    try:
+        with LineClient(quiet=True) as line:
+            line.status()
+            return {"ok": True, "rooms": line.unread_digest()}
+    except LineError as e:
+        return {"ok": False, "error": f"{type(e).__name__}: {e}"}
+
+
+if __name__ == "__main__":
+    import json
+
+    print(json.dumps(get_messages("ครอบครัว"), ensure_ascii=False, indent=2))

line_ext_msg-1.0.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "line-ext-msg"
+version = "1.0.0"
+description = "Pull messages from LINE Chrome Extension via Playwright CDP (own account, read-only)"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "ITC6910120" }]
+keywords = ["line", "chrome-extension", "playwright", "cdp"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+]
+dependencies = ["playwright>=1.40"]
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[project.scripts]
+line-ext-msg = "line_ext_msg.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/onlygummy/line-ext-msg"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/line_ext_msg"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

line_ext_msg-1.0.0/src/line_ext_msg/__init__.py

@@ -0,0 +1,34 @@
+"""line-ext-msg: pull messages from LINE Chrome Extension via Playwright CDP."""
+
+__version__ = "1.0.0"
+
+from .client import LineClient
+from .messages import sender_stats
+from .errors import (
+    AppNotReady,
+    AttachFailed,
+    ChromeNotReady,
+    ExtensionMissing,
+    LineError,
+    LoginRequired,
+    RoomNotFound,
+)
+from .models import Message, Room, StepResult
+from .settings import Settings
+
+__all__ = [
+    "__version__",
+    "LineClient",
+    "sender_stats",
+    "Room",
+    "Message",
+    "StepResult",
+    "Settings",
+    "LineError",
+    "ChromeNotReady",
+    "AttachFailed",
+    "ExtensionMissing",
+    "AppNotReady",
+    "LoginRequired",
+    "RoomNotFound",
+]

line_ext_msg-1.0.0/src/line_ext_msg/auth.py

@@ -0,0 +1,58 @@
+"""Login check: distinguish 'not logged in' from 'selector mismatch'."""
+
+from playwright.sync_api import Page
+
+from .settings import SELECTORS
+
+# Fast login-screen locators (CSS-module hashes change, so match stable parts).
+LOGIN_LOCATORS = [
+    "[class*='loginPage']",
+    "text=QR code login",
+    "text=Log in",
+]
+
+# Fallback text markers when locators miss (checked on small scope only).
+LOGIN_MARKERS = [
+    "qr code", "qr login", "email address",
+    "เข้าสู่ระบบ", "ล็อกอิน",
+]
+
+
+def _has_login_ui(page: Page) -> bool:
+    """True if any login marker is visible (cheap locator checks)."""
+    for sel in LOGIN_LOCATORS:
+        try:
+            if page.locator(sel).count() > 0:
+                return True
+        except Exception:
+            continue
+    return False
+
+
+def check_login(page: Page, timeout_ms: int = 10000) -> tuple[bool, str]:
+    """Poll chat UI vs login UI; return as soon as either appears.
+
+    Return (logged_in, reason): 'chat' / 'login' / 'unknown'.
+    Caller must ensure the app finished rendering (wait_for_app_ready).
+    """
+    # Poll room rows (not the container: it may not exist as one element).
+    rows = [s.strip() for s in SELECTORS["room_item"].split(",")]
+    # Poll every 500ms; worst case only when page genuinely stuck.
+    for _ in range(max(1, timeout_ms // 500)):
+        for sel in rows:
+            try:
+                if page.locator(sel).count() > 0:
+                    return True, "chat"
+            except Exception:
+                continue
+        if _has_login_ui(page):
+            return False, "login"
+        page.wait_for_timeout(500)
+    # Final text fallback on rendered body before giving up.
+    try:
+        text = (page.inner_text("body") or "").lower()
+    except Exception:
+        text = ""
+    if any(m in text for m in LOGIN_MARKERS):
+        return False, "login"
+    return False, "unknown"

line_ext_msg-1.0.0/src/line_ext_msg/chrome.py

@@ -0,0 +1,94 @@
+"""Chrome lifecycle: ensure a debuggable instance on the isolated profile."""
+
+import os
+import subprocess
+import time
+import urllib.request
+
+from .settings import Settings
+
+
+def expand(path: str) -> str:
+    """Expand %VAR% on Windows and ~ on all platforms."""
+    return os.path.expandvars(os.path.expanduser(path))
+
+
+def find_chrome_exe() -> str | None:
+    """Search common install locations, return exe path or None."""
+    candidates = [
+        r"C:\Program Files\Google\Chrome\Application\chrome.exe",
+        r"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe",
+        expand(r"%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe"),
+    ]
+    for path in candidates:
+        if path and os.path.isfile(path):
+            return path
+    return None
+
+
+def is_debug_ready(settings: Settings, timeout_sec: int = 2) -> bool:
+    """Check CDP endpoint responds with valid Browser field."""
+    try:
+        with urllib.request.urlopen(f"{settings.cdp_endpoint}/json/version", timeout=timeout_sec) as res:
+            return "Browser" in res.read().decode("utf-8", errors="ignore")
+    except Exception:
+        return False
+
+
+def is_headless(settings: Settings, timeout_sec: int = 2) -> bool:
+    """Detect a headless instance squatting the debug port (no visible window)."""
+    try:
+        with urllib.request.urlopen(f"{settings.cdp_endpoint}/json/version", timeout=timeout_sec) as res:
+            return "Headless" in res.read().decode("utf-8", errors="ignore")
+    except Exception:
+        return False
+
+
+def _is_profile_locked(data_dir: str) -> bool:
+    """Detect SingletonLock (profile in use by a normal window)."""
+    return any(
+        os.path.exists(os.path.join(data_dir, name))
+        for name in ("SingletonLock", "SingletonSocket", "SingletonCookie")
+    )
+
+
+def start_chrome_debug(settings: Settings) -> None:
+    """Start detached Chrome on the isolated profile.
+
+    Chrome 136+ ignores --remote-debugging-port on the default profile,
+    hence the isolated dir. Login + install persist there after first setup.
+    """
+    from .errors import ChromeNotReady
+
+    exe = find_chrome_exe()
+    if exe is None:
+        raise ChromeNotReady("ไม่พบ chrome.exe กรุณาติดตั้ง Chrome ก่อน")
+    data_dir = expand(settings.profile_dir)
+    if _is_profile_locked(data_dir):
+        raise ChromeNotReady("โปรไฟล์ Chrome ถูกใช้อยู่ ปิดหน้าต่าง debug เก่าก่อนแล้วรันใหม่")
+    os.makedirs(data_dir, exist_ok=True)
+    subprocess.Popen(
+        [exe, f"--remote-debugging-port={settings.port}", f"--user-data-dir={data_dir}"],
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+        creationflags=getattr(subprocess, "DETACHED_PROCESS", 0),
+    )
+    for _ in range(30):
+        if is_debug_ready(settings, timeout_sec=1):
+            return
+        time.sleep(0.5)
+    raise ChromeNotReady("เปิด Chrome แล้วแต่พอร์ต debug ไม่ตอบใน 15 วิ")
+
+
+def ensure_chrome(settings: Settings) -> None:
+    """Ensure headed debug Chrome is running; start it if the port is closed."""
+    from .errors import ChromeNotReady
+
+    if is_debug_ready(settings):
+        if is_headless(settings):
+            raise ChromeNotReady(
+                "พอร์ต debug ถูกโปรแกรมอื่น (headless) ใช้อยู่ ไม่มีหน้าต่างให้เห็น "
+                "รัน: Get-Process chrome | Stop-Process -Force แล้วรันใหม่"
+            )
+        return
+    start_chrome_debug(settings)

line_ext_msg-1.0.0/src/line_ext_msg/cli.py

@@ -0,0 +1,99 @@
+"""Thin CLI over LineClient: parse args, print results."""
+import argparse
+
+from .client import LineClient
+from .errors import LineError
+from .models import Room
+
+
+def _display(m) -> str:
+    """Readable line: text, or media label when the bubble has no text."""
+    if m.text:
+        return m.text[:80]
+    if m.type == "image":
+        return f"[รูปภาพ: {m.media or 'โหลดไม่สำเร็จ'}]"
+    if m.type == "sticker":
+        return "[สติกเกอร์]"
+    if m.type == "system":
+        return m.text
+    return f"[{m.type}]"
+
+
+def pick_room(rooms: list[Room]) -> Room:
+    """Show rooms in terminal and return user choice."""
+    print("\nห้องแชททั้งหมด:")
+    for r in rooms:
+        unread = f" ({r.unread} ไม่อ่าน)" if r.unread else ""
+        print(f"  [{r.index}] {r.name}{unread}")
+    while True:
+        raw = input("พิมพ์เลขห้อง > ").strip()
+        if raw.isdigit() and any(r.index == int(raw) for r in rooms):
+            return next(r for r in rooms if r.index == int(raw))
+        print("เลขไม่ถูกต้อง ลองใหม่")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="ดึงข้อความล่าสุดจาก LINE Extension")
+    parser.add_argument("--limit", type=int, default=5, help="จำนวนข้อความล่าสุด")
+    parser.add_argument("--date", default=None, help="กรองเฉพาะวันที่ YYYY-MM-DD")
+    parser.add_argument("--date-from", default=None, help="ตั้งแต่วันที่ YYYY-MM-DD")
+    parser.add_argument("--date-to", default=None, help="ถึงวันที่ YYYY-MM-DD")
+    parser.add_argument("--time-from", default=None, help="ตั้งแต่เวลา HH:MM")
+    parser.add_argument("--time-to", default=None, help="ถึงเวลา HH:MM")
+    parser.add_argument("--sender", default=None, help="กรองชื่อคนส่ง (บางส่วน)")
+    parser.add_argument("--keyword", default=None, help="ค้นคำในข้อความ")
+    parser.add_argument("--search", default=None, metavar="KEYWORD",
+                        help="ค้นทุกห้อง แล้วสรุปห้องที่เจอ")
+    parser.add_argument("--unread", action="store_true", help="แสดงเฉพาะห้องที่ไม่อ่าน")
+    parser.add_argument("--save", action="store_true", help="เขียน rooms.json + messages ลงไฟล์ (default พิมพ์จออย่างเดียว)")
+    parser.add_argument("--dump", action="store_true", help="บันทึก DOM ดิบเพื่อจูน selector")
+    parser.add_argument("--dump-room", type=int, default=None, metavar="INDEX",
+                        help="เปิดห้องลำดับ INDEX แล้วบันทึก DOM เพื่อจูน selector ข้อความ")
+    args = parser.parse_args()
+
+    try:
+        with LineClient() as line:
+            if args.dump:
+                state = line.dump_page()
+                print(f"บันทึก line_dom.html แล้ว (state={state}) ส่งไฟล์นี้มาเพื่อจูน selector")
+                return
+            line.status()
+            if args.dump_room is not None:
+                room = line.dump_room(args.dump_room)
+                print(f"บันทึก line_room.html แล้ว (ห้อง {room.name}) ส่งไฟล์นี้มาเพื่อจูน selector ข้อความ")
+                return
+            rooms = line.list_rooms(unread_only=args.unread)
+            if not rooms:
+                print("อ่านรายชื่อห้องไม่ได้ รัน --dump แล้วส่ง line_dom.html มา")
+                return
+            if args.save:
+                path = line.save_rooms(unread_only=args.unread)
+                print(f"บันทึก {path} ({len(rooms)} ห้อง)")
+            if args.search:
+                for hit in line.search_all(args.search, date_from=args.date_from,
+                                           date_to=args.date_to or args.date):
+                    print(f"\n== {hit['room']['name']} ({len(hit['messages'])} ข้อความ) ==")
+                    for m in hit["messages"]:
+                        print(f"[{m['date']} {m['ts']}] {m['sender']}: {m['text'][:80]}")
+                return
+            chosen = pick_room(rooms)
+            filt = dict(limit=args.limit, date=args.date, date_from=args.date_from,
+                        date_to=args.date_to, time_from=args.time_from, time_to=args.time_to,
+                        sender=args.sender, keyword=args.keyword, media_dir="media")
+            if args.save:
+                out = line.save_messages(chosen, **filt)
+                print(f"บันทึก {out}")
+            print(f"กำลังเปิดห้อง {chosen.name} ...", flush=True)
+            msgs = line.get_messages(chosen, **filt)
+            if not msgs:
+                print("เปิดห้องได้แต่อ่านข้อความไม่ได้")
+                print(f"รัน uv run line-ext-msg --dump-room {chosen.index} แล้วส่ง line_room.html มา")
+                return
+            for m in msgs:
+                print(f"[{m.date} {m.ts}] {m.sender}: {_display(m)}")
+    except LineError as e:
+        print(e)
+
+
+if __name__ == "__main__":
+    main()