前言¶
DeepSeek Harness (DSH) 的插件生態允許在會話頭部直接擴展功能。sage-reminder 是一個時間模塊，顯示現在時間、距上次發消息時間，並提供提醒與倒計時功能。它與需要跨會話持久化的長期工具不同，定位是“會話內的短期時間提醒”，僅管理“此刻這臺機器上的計時”。
核心功能¶
- 會話頭部的時間模塊：展開面板後，自上而下顯示現在時間、距你上次發消息時間、提醒列表、倒計時列表。收起時只佔一小條，右側膠囊顯示最近一個到期的計時。
- 純前端插件：數據存儲於瀏覽器
localStorage。Host 半不註冊工具、服務、文件、進程或網絡連接。 - 兩種提醒模式：
- 提醒：設定一天內的一個鐘點（時/分），到點響一次後留在列表中，等待下一個鐘點。
- 倒計時：設定一段時長（天/時/分/秒），跑完自動從列表清理。
- 操作支持：支持啓動、關閉、暫停、繼續、編輯、刪除操作。
- 到點喚醒會話：提醒到點時向當前會話發消息，把空閒會話叫醒（默認關閉）。
安裝與啓用¶
在 profile 的 package.json 中添加依賴，並配置 bundles。
// profile 的 package.json
"dependencies": {
"sage-reminder": "link:<你的路徑>/sage-reminder" // 本地目錄用 link:，發佈版寫版本號
},
"dsh": { "profile": { "bundles": [ ..., "sage-reminder" ] } }
在該 profile 目錄運行 pnpm install，重啓 DSH（或刷新頁面）。
典型用法¶
- 基礎交互：點模塊展開面板，Esc 或點擊外部收起。時間選擇使用滾輪（24/60 進制），不接受文字輸入，支持鼠標滾輪或鍵盤
↑↓PageUpPageDown。 - 創建提醒：點擊
+ 新建，輸入名稱，使用滾輪設定時和分，保存即啓動。列表中▶啓動、⏸關閉、⋯編輯（編輯頁左下角有刪除）。 - 創建倒計時：點擊
+ 新建，輸入名稱，使用滾輪設定天、時、分、秒，點擊開始。跑完自動清理。列表中⏸暫停/繼續、×刪除。 - 到點喚醒會話：面板底部有開關（默認關），僅提醒可用。到點時會話正在跑時不發，空閒時會話發署名消息。面板會顯示狀態（如“已投遞”或“跳過：會話正在跑”）。
注意事項¶
- 數據隔離：數據存儲於瀏覽器
localStorage，隔離鍵包含端口。桌面殼每次啓動使用隨機端口（--port 0），重啓後 origin 變化，數據無法讀取。刷新頁面不影響。 - 接口依賴：“距你上次發消息”依賴 DSH 客戶端內部接口（
sessions.binding），接口變更會導致該行消失。 - 無系統通知：到點提示僅通過界面呼吸燈與浮條展示，不含系統通知，頁面不在前臺會錯過。
- Host 半留空：Host 半故意留空（
lib/index.js只有一個apply()），不讀寫文件、不建網絡連接。
結語¶
sage-reminder 將複雜度壓到最小，專注於會話內的短期時間管理。如果你需要的是“關了也不會忘”的長期提醒，需要考慮其他方案。
