callie0313/dylan-heartbeat

解決的問題

Dylan Heartbeat 是 Kelivo AI 伴侶的執行時外掛程式，將其從被動回應的聊天機器人轉變為主動實體。它解決了 AI 在使用者沉默期間『遺忘』使用者的問題，讓 AI 能夠維持持續的時間感與脈絡記憶，並在使用者未發送訊息時，仍能透過行動通知主動聯繫使用者。

工作原理

本專案實作一個由兩個主要元件組成的閘道架構：

1. 閘道（server.js）：作為 Kelivo 客戶端與 LLM API 之間的代理。它維護一個「AI 世界時間軸」（enhanced_messages.json），記錄真實對話與 AI 自身的主動行為（如發送通知），確保 AI 能記得自己的主動行動。
2. 喚醒執行時（wake_up.js）：一個定時執行的程序，定期喚醒 AI。根據可設定的閾值（白天與夜晚不同），AI 決定是否發送通知或保持沉默。

它使用 時間戳記憶庫 來追蹤訊息的原始時間，即使客戶端移除了時間戳，也能將主動通知插入對話歷史的正確時序位置。

適用對象

希望 AI 角色透過主動溝通、長期時間感知與自動日記功能，顯得更『活潑』且真實存在的 Kelivo AI 伴侶應用使用者。

主要特色

• 主動喚醒：根據上次使用者互動以來經過的時間，自動觸發 AI 思考與主動聯繫。
• 行動推送通知：與 Bark（iOS）及 ntfy（Android/Desktop）整合，提供即時提醒。
• 時間感知：持續維護時間軸與上次聯繫使用者的記憶。
• 天氣整合：在喚醒事件期間，可選擇性地將即時本地天氣資料注入 AI 的上下文。
• 自動日記：當 AI 輸出特定標籤時，可自動儲存私人日記（Markdown 格式）。
• Web 管理控制台：內建管理員面板，支援即時設定與服務重啟。