功能說明書

了解日記助理的完整功能與使用方式

每日記錄

直接在 Telegram 輸入任何文字,Bot 就會自動儲存為當天的記錄。不需要任何指令,隨時想到什麼就記什麼。

  • 文字記錄:直接輸入文字,Bot 回覆「✅ 已記錄!(今天第 N 筆)」
  • 語音記錄:傳送語音訊息,Bot 用 OpenAI Whisper 自動轉成文字後儲存
  • 歸屬日期:依設定時區,0:00 後的訊息歸屬今天,之前的歸屬昨天

每日問卷

每晚固定時間(預設 23:00)Bot 自動發送問卷,幫你回顧這一天,共 6 個步驟:

  • 今天最重要的一件事
  • 感恩的三件事(分三步輸入)
  • 心情評分(-2 很差 ~ +2 很好)
  • 其他補充

問卷資料會作為 AI 產出日記的重要素材。未完成的問卷在設定時間 +50 分鐘後自動結算。

日記自動產出

每天凌晨(預設 00:00),Bot 自動將昨天所有記錄和問卷交給 GPT-4o 整理成結構化 Markdown 日記,並:

  • 在 Telegram 傳送日記全文
  • 自動上傳到 Google Drive 指定資料夾備份
  • 若 Drive 上傳失敗,改為本地備份(backup_diaries/ 資料夾)

Google Calendar 整合

設定好 Calendar ID 後,使用 /calendar 查看當天行程。需先將日曆共享給 Service Account email(至少「查看所有活動詳情」權限)。

日記格式

預設日記包含以下章節(可在「設定」頁面自訂 Markdown 範本):

  • 時間軸(依序列出所有記錄)
  • 去過的地方 / 見過的人
  • 今天最重要的事
  • 感恩三件事
  • 心情評分
  • 其他筆記

指令說明

指令 說明
/start開始使用,顯示歡迎訊息與功能介紹
/today查看今天已記錄幾筆(文字 + 語音合計)
/score查看最近 7 天心情趨勢(Emoji 圖表)
/diary手動觸發今天的日記產出(可指定日期)
/backdiary補記過去某天的記錄(多步驟引導)
/editdiary修改已產出的日記內容
/calendar查看今日 Google Calendar 行程
/survey手動開始今日問卷
/status查看 Bot 運作狀態與排程資訊
/admin管理員設定選單(需先執行 /set_admin)
/set_admin將自己設為管理員(只能設定一次)
/set_reminder 9 12 18修改每日提醒時間(空格分隔)
/set_survey_time 22修改問卷開始時間
/set_template修改日記 Markdown 範本(後面接新範本內容)
/show_settings查看目前所有設定

狀態監控

Bot 運作概況與統計資料

今日記錄
累計日記
累計記錄
使用者數
服務狀態
Telegram Bot
與 Telegram 伺服器的連線
● 運行中
Google Drive
日記自動上傳備份
● 載入中
Google Calendar
行程讀取(/calendar 指令)
● 載入中
近 7 天心情趨勢
載入中...

設定

調整 Bot 的運作方式。排程相關設定(時間、時區)需要重啟 Bot 才會生效。

排程設定
每天幾點提醒記日記,用逗號分隔,範圍 0–23。例:9,12,15,18,21
每晚幾點觸發問卷(0–23)
每天幾點自動產出昨天的日記(0–23)
AI 設定
用於產出日記的語言模型
影響所有時間計算。例:Asia/Taipei、Asia/Tokyo、UTC
Google 整合
通常是你的 Gmail 信箱。需先將日曆共享給 Service Account(至少查看詳情權限)。
日記備份上傳的目標資料夾。從資料夾連結最後一段取得 ID。
日記範本
留空則使用預設範本。支援 GPT system prompt 格式,描述你希望的日記結構與風格。