前言¶
在 DeepSeek Harness（DSH）裏做日常事務，常見做法是把待辦寫在會話裏、依賴外部日曆或單獨開一個筆記應用。會話上下文會滾動，外部工具又和智能體割裂。若你希望在 DSH 桌面 Web GUI 裏直接看到整月格子、就地編輯每日記錄，並把 DSH 內已配置的定時提醒疊在同一視圖裏，社區客戶端插件 dsh-calendar-board（維護者 jy007）針對的正是這一點：月視圖看板、格內編輯、完成反饋，以及可選的本機日曆與 iCal 訂閱。
下面按定位、功能、安裝、用法與注意事項說明，事實以 GitHub 倉庫 README 爲準；社區目錄頁見 skillhub.cn。
這是什麼¶
dsh-calendar-board 是面向 DSH Desktop NEXT（desktop-next profile，Web GUI）的純前端客戶端插件（當前資料中 package.json 版本爲 1.5.2，MIT 許可證）。它在側欄註冊日歷圖標，在主區域展示以週一爲起點的整月網格：ISO 周號、通過 Intl 顯示的農曆、今日高亮、相鄰月份補格。自述條目落在頁面 localStorage 並與 Host 側存儲同步；DSH schedule 服務的提醒以只讀方式展開到日曆上。
插件不內置構建步驟、不聲明第三方依賴；頁面自述不做額外網絡請求（訂閱 iCal 由 Host 拉取並緩存）。DSH 生態裏插件由社區目錄收錄，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
月視圖與格內編輯¶
每個日期格最多展示前三條記錄及剩餘條數，顏色、下劃線、刪除線會保留。點擊某天即可在格內輸入：Enter 追加一行並保持光標，逐字保存；Esc 或點擊其他區域退出，未提交的草稿仍會持久化。清空一行即刪除該條。
單條操作與進度¶
勾選表示完成（刪除線並變暗，可取消）。懸停行尾可用 U 切換下劃線、● 循環文字顏色（默認 / 紅 / 琥珀 / 綠 / 藍）、× 刪除。日展開面板爲條目編號並顯示完成進度條。
本機日曆（macOS）¶
在 macOS 上可通過 AppleScript 讀取系統「日曆」應用裏已同步的賬戶（含 Google、飛書/Lark 等），無需單獨註冊密鑰。側欄點 + 連接日曆，在 本機日曆（macOS） 中選擇要展示的日曆；首次讀取會觸發系統「自動化」對 Calendar 的授權。讀取在後臺進行並緩存，避免大日曆阻塞月視圖。
iCal 訂閱與圖例¶
可訂閱任意 iCalendar 地址（Google、飛書/Lark、Outlook、Apple 等提供的私密 iCal URL），事件與自有任務並排顯示；各源有獨立顏色，頁眉下圖例可開關各源。資料說明支持常見重複規則展開、全天事件及時區處理；Host 拉取 feed 後緩存約 10 分鐘，頁面內不執行第三方腳本。
DSH 定時提醒¶
讀取 DSH schedule 服務，將 daily / weekly / one-shot / every / cron 等提醒展開到日曆；頁眉有同步狀態徽標。Host 另提供只讀備用路由 /calendar-board/schedules。若無 schedule 服務，頁眉會提示「Scheduled reminders unavailable」，其餘功能仍可用。
完成慶祝與每日提醒¶
完成一條時可用 WebAudio 三音琶音、canvas 煙火、CSS 彩屑與 toast；頁眉 ✦ 可預覽，揚聲器切換靜音（偏好寫入 localStorage）。尊重系統「減少動態效果」設置。另支持在設定時刻通過系統通知做每日 nudge。界面支持中英文，樣式基於 DSH 主題 token，適配明暗模式。
智能體與 Host 工具¶
Host 側爲規範數據源，各 DSH 會話可通過統一工具讀寫看板，無需瀏覽器抓取。示例載荷如下：
{ "action": "list", "from": "2026-11-02", "to": "2026-11-08" }
{ "action": "add", "date": "2026-11-06", "title": "給 adon 發郵件", "time": "10:00" }
{ "action": "complete", "id": "itmw3c6bd3c83xd" }
{ "action": "remove", "id": "itmw3c6bd3c83xd" }
README 還列出 update、sources、events、subscribe / unsubscribe、toggleSource、calendars 等 action。可對智能體用自然語言，例如：「今天還剩哪些事沒做？」「幫我加一條：明天 10 點給 adon 發郵件」「把『喫小龍蝦』標記完成」。其他插件也可通過 calendarBoard Host 服務調用同一實現。
安裝與啓用¶
官方推薦在 DSH 新會話中讓智能體執行安裝（由插件管理器調用 install_bundle）：
Install the plugin github:jy007/dsh-calendar-board
安裝後側欄應出現日曆圖標；若無，可重載窗口或重啓 DSH。資料中 engines.dsh 要求 >=0.2.1-rc.2。
更新時需在倉庫目錄 git pull 後，再次在 DSH 中安裝 github:jy007/dsh-calendar-board（插件以快照拷貝安裝，不自動跟蹤 git）。面板頁腳 vX.Y.Z 表示當前運行版本。卸載在插件管理器中移除 dsh-calendar-board；自述條目保留在瀏覽器 localStorage。
手動路徑安裝（克隆本地目錄再裝 bundle）見 README「Manual」一節；本文不展開 git clone 步驟。
典型用法¶
- 點擊側欄 calendar 圖標 打開看板。
- 點擊某日，在格內直接輸入（Enter 繼續，Esc 退出）。
- 勾選完成 → 提示音與煙火；懸停調整顏色、下劃線或刪除。
- 頁眉：
‹ ›換月、Today、+ Add for today、Daily nudge、✦預覽煙火、揚聲器靜音、⟳重新同步定時提醒。
macOS 用戶通過 + 連接日曆 綁定本機日曆；需要外部日程時添加 iCal 訂閱 URL，並在圖例中開關各源。
適用場景與注意¶
適合誰： 已在用 DSH Desktop NEXT、希望月視圖統籌每日筆記、待辦與 DSH 內 schedule 提醒的開發者或重度桌面用戶；macOS 上還想零配置疊加系統日曆的人；希望通過智能體或 Host API 編程增刪改查日曆條目的工作流。
數據與隱私（README 摘要）： 自述條目 Host 路徑爲 <DSH_HOME>/storages/calendar-board/items.json，頁面另有 localStorage 緩存；訂閱地址在 sources.json；定時提醒只讀、不落庫。訂閱 iCal 時 Provider 會看到來自本機的請求，私密 iCal 地址應視爲密碼。頁腳顯示「已同步 Host」/「僅本機保存」以區分是否與 Host 通信。
權限與安全： 插件在當前 DSH 進程權限下運行；安裝前請自行查看 源碼與 MIT 許可證。本機日曆與 iCal 拉取會觸及系統自動化與網絡，僅在你顯式連接或訂閱後發生。
兼容性： 註冊 Client 槽位 sidebar.panellist 與 main；可選依賴 Host 的 schedule 與 webServer（無 webServer 時僅走 remote channel）。
結尾¶
dsh-calendar-board 把月視圖、格內編輯、DSH 提醒與本機/訂閱日曆收進 DSH 側欄，並用 Host 工具把同一數據開放給智能體與其他插件。目錄頁：skillhub.cn/plugins/jy007/dsh-calendar-board；源碼與完整 API 表：github.com/jy007/dsh-calendar-board。
