LINE Daily Assistant

第 1 步：建立 LINE 官方帳號與 Provider

1. 前往 LINE Developers 主頁 並登入。
2. 點擊「Create New Provider」建立一個服務提供者名稱（例如：生活助理服務）。
3. 在該 Provider 下「Create a Messaging API channel」建立官方帳號，填寫機器人名稱、描述、分類等必要資訊。

第 2 步：取得 Key 並填入設定

1. Channel Secret：在 「Basic settings」 頁籤下方，找到並複製它，貼到本控制台的「⚙️ 系統設定」的「LINE Channel Secret」欄位中。
   本機目前狀態：🔴 載入中...
2. Channel Access Token：在 「Messaging API」 頁籤最下方，點選 「Issue」 產生一組長字串，貼到本控制台的「⚙️ 系統設定」的「LINE Channel Access Token」欄位中。
   本機目前狀態：🔴 載入中...
3. 💡 Docker 部署提示：若是使用 Docker 部署，除了可以在控制面板填寫外，亦可直接將這兩組 Key 填入根目錄下的 .env 檔案中（對應 LINE_CHANNEL_SECRET 與 LINE_CHANNEL_ACCESS_TOKEN 變數），重啟容器後將會自動載入生效！

第 3 步：設定 Webhook 串接行程指令

為了能讓機器人聽懂您的訊息並幫您「新增行程」，您需要啟用 Webhook：

1. 因為機器人在本地電腦運行，您需要使用工具把本地 Port 3000 暴露到外網。系統已為您配置使用自定義防斷線 localtunnel 排程指令。
2. 若您需要重新啟動外網通道，請在系統根目錄下執行以下指令： powershell -ExecutionPolicy Bypass -File .\run-tunnel.ps1
3. 本系統目前的 Webhook URL 網址為（請複製此網址）： [載入中，請確保本機 run-tunnel.ps1 正在運行...]
4. 在 LINE Developer 的 「Messaging API」 頁籤（或 LINE 官方帳號管理後台）：
   • 將 Webhook 網址 (Webhook URL) 設定為上述複製的網址：[載入中，請確保本機 run-tunnel.ps1 正在運行...]
   • 特別注意：填寫完新網址後，必須點選欄位右側綠色的「儲存 (Save)」按鈕才能生效！
   • 開啟 Use webhook 選項（設定為開啟狀態）。
5. 關閉自動回覆與設定啟用 Webhook：在 Messaging API 頁籤下方的「LINE Official Account features」區塊，點擊「Auto-reply messages」右側的「Edit」連結進入 LINE 官方帳號管理後台（回應設定頁面），進行以下調整：
   • 將「回應模式」設定為「聊天機器人」。
   • 將「Webhook」設定為「啟用」（使 Webhooks 狀態顯示為 Enabled）。
   • 將「自動回應訊息」設定為「停用」（使 Auto-reply messages 狀態顯示為 Disabled）。
   • 將「加入好友歡迎訊息」設定為「停用」（使 Greeting messages 狀態顯示為 Disabled），以防止重複發送系統歡迎詞。

第 4 步：獲取您的 User ID 並測試

1. 在 LINE Developer 頁籤掃描 QR Code 加您的機器人為好友。
2. 發送任意訊息給它（如「哈囉」）。
3. 您的 User ID 會自動被系統捕獲並填寫在設定中！
   您的 LINE User ID：🔴 尚未偵測到（請對機器人傳送任意訊息）
4. 回到控制台首頁，點選右側的「立即測試推送」即可收到第一份晨間簡報！

第 5 步：設定 Google Sheets 行程自動同步（選用）

為了方便您出門在外隨時使用手機管理待辦事項，您可以將 Google 試算表同步至本助理系統：

1. 打開您的 Google 試算表（或建立一個新試算表），格式應包含以下欄位：日期、時間、行程名稱、行程描述（首行為標題行）。
2. 在 Google 試算表選單中點選 【檔案】➡【共用】➡【發布到網路】。
3. 在彈出的視窗中：
   • 將「整個文件」下拉選單旁的格式，從「網頁」修改為 「逗號分隔值 (.csv)」。
   • 點選 「發布」，並複製產生的網址。
4. 來到控制台的 「⚙️ 系統設定」 頁籤，將該網址貼入「雲端 Google Sheets CSV 網址」欄位中，然後點擊「儲存設定」。
5. 回到 「📅 行程管理」 頁籤，您會看到右上方出現了 「☁️ 同步雲端行程」 按鈕，點擊即可手動同步；系統亦會在每日推播時自動於背景進行同步，並自動清理已過期的舊行程。