Line Desktop Skill

LINE Desktop Skill (Python)

透過 GUI 自動化操控 LINE Desktop 應用程式（Windows）。 本 Skill 是 dtwang/line-desktop-mcp 的 Python 重寫版本， 以 pyautogui + pygetwindow + pyperclip 取代 AutoHotkey。

⚠️ 使用注意事項

• 透過已登入的 LINE Desktop 視窗進行 GUI 自動化操作。
• 自動化執行期間請勿操作滑鼠，以免干擾。
• LINE Desktop 須使用「展開聊天視窗」模式（聊天視窗固定在右側）。
• 多螢幕環境下，LINE Desktop 須放在主螢幕。
• DPI 縮放已自動偵測，支援高 DPI 螢幕。

系統需求

安裝

cd d:\line-desktop-skill
pip install -r requirements.txt

依賴套件：pyautogui, pyperclip, pygetwindow, psutil, Pillow

工具清單 (Tools)

本 Skill 提供 5 個工具，全部已完成實作：

Tool 1: is_line_running

功能：檢查 LINE Desktop 程序是否正在執行。

回傳：{"running": true/false}

python {SKILL_PATH}\line_desktop is_line_running

Tool 2: activate_line

功能：將 LINE Desktop 視窗帶到前景（如果最小化則還原）。

回傳：{"success": true/false, "error": null/"錯誤訊息"}

python {SKILL_PATH}\line_desktop activate_line

Tool 3: get_chat_history

功能：讀取指定 LINE 聊天室的歷史訊息。

回傳：{"chatName", "date", "messageLimit", "mode", "history", "chatRoomUpdatedAt"}

python {SKILL_PATH}\line_desktop get_chat_history --chat_name "專案討論"
python {SKILL_PATH}\line_desktop get_chat_history --chat_name "專案討論" --mode long
python {SKILL_PATH}\line_desktop get_chat_history --chat_name "專案討論" --date 2026-04-01

Tool 4: get_recent_chats

功能：讀取 LINE 聊天列表中最前面的 N 個聊天室名稱（透過 Windows UI Automation）。

回傳：{"chats": ["群組A", "好友B", ...], "count": N}

python {SKILL_PATH}\line_desktop get_recent_chats
python {SKILL_PATH}\line_desktop get_recent_chats --n 20

Tool 5: list_contacts

功能：切換至 LINE 好友/群組頁籤並列出聯絡人清單（透過 Windows UI Automation）。

回傳：{"contacts": ["好友A", "群組B", ...], "count": N, "type": "all"}

python {SKILL_PATH}\line_desktop list_contacts
python {SKILL_PATH}\line_desktop list_contacts --contact_type groups
python {SKILL_PATH}\line_desktop list_contacts --contact_type friends

Tool 6: send_message

功能：在指定 LINE 聊天室中發送訊息。預設直接送出。

回傳：{"success", "chatName", "message", "autoSend", "timestamp", "error"}

# 直接送出（預設）
python {SKILL_PATH}\line_desktop send_message --chat_name "專案討論" --message "Hello!"

Tool 5: select_chat

功能：搜尋並選取指定的 LINE 聊天室（不讀取也不發送）。

回傳：{"success": true/false, "chatName": "..."}

python {SKILL_PATH}\line_desktop select_chat --chat_name "專案討論"