功能說明書
了解日記助理的完整功能與使用方式
每日記錄
直接在 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 格式,描述你希望的日記結構與風格。
快速連結
常用服務的連結,點擊即可跳轉
GitHub 原始碼
github.com/chahababa/telegram-diary-bot
Google Drive 備份資料夾
載入中...
Google Calendar
calendar.google.com
OpenAI 用量監控
platform.openai.com/usage