前言¶
在 DSH（DeepSeek Harness）裏做工作流時，日程往往散落在系統日曆、CalDAV 賬號和對話上下文之間。智能體要能查空閒、建事件、改重複規則，還要和 iPhone、Mac 上的提醒保持一致，單靠手寫工具調用和自算 RRULE 展開，成本高且容易漏確認步驟。下面介紹社區插件 dsh-calendar-pro：面向 DSH 的日曆能力，支持本地日曆與 CalDAV，並通過智能體工具完成查詢、增改刪與安全約束下的批量操作。
這是什麼¶
dsh-calendar-pro 由維護者 yan-evan 發佈，在 SkillHub 等社區目錄中歸類爲工作流；倉庫爲 yan-evan/dsh-calendar-pro，當前 package 版本爲 0.1.0，許可證 MIT。插件依賴 DSH >=0.2.1-rc.3，運行環境要求 Node ^22.19.0 || >=24.0.0。
項目基於上游 STARDUSTLC666/dsh-calendar v0.14.3 演進，在保留 CalDAV、智能體工具、月/周/議程視圖與 ICS 導入等能力的基礎上，增加了本地日曆、數據源遷移、農曆與法定節假日調休、經期記錄與預測、ICS 導出等能力（詳見倉庫 README 中的對比表）。
核心功能¶
智能體側¶
- 自然語言查詢：例如詢問「下週三有什麼安排」；重複日程會展開到具體場次。
- 對話式增改刪：支持全天事件與重複規則（RRULE）。
- 空閒時段推薦：說明時長與偏好即可得到候選；默認工作日 09:00–18:00。
- 全字段搜索：按關鍵詞匹配標題、描述與地點。
- 安全約束：刪除重複日程系列、批量刪除前，智能體需先說明影響範圍並等待確認。
同步與多端¶
- CalDAV：支持 iCloud、Google、Nextcloud 及兼容 CalDAV 的服務。
- 雙向同步：與系統日曆提醒聯動（README 描述爲同步到 iPhone、iPad、Mac 後由系統日曆提醒）。
- 本地日曆：可不連接任何服務器，零配置使用完整本地能力。
界面與易用¶
- 懸浮日曆：對話頁右下角打開，Esc 收起。
- 農曆與調休：法定節假日、調休在日期上標註。
- 經期預測：數據僅保存在本機（README 說明）。
- 手動操作：月 / 周 / 議程視圖，點擊新建、拖動改期、框選調整時段。
- ICS 導入導出：遷移或備份日程。
- 中英雙語：跟隨 DSH 界面語言切換。
更細的交互與字段說明見倉庫 MANUAL.md。
安裝與啓用¶
插件以 DSH web profile 的客戶端形式注入側欄（package.json 中 dsh.client.platform 爲 web）。安裝前請自行查看倉庫源碼與 MIT 許可證；插件在當前 DSH 進程權限下運行，連接 CalDAV 或讀寫本地數據前請評估賬號與路徑是否可接受。
從 npm 安裝（README 原文）：
dsh plugin --profile web add dsh-calendar-pro
dsh # 重啓後側欄出現「日曆」
也可在 DSH 插件菜單 → 安裝插件 中輸入 dsh-calendar-pro 確認，或在 DSH 插件市場搜索該名稱安裝。
從本機源碼路徑安裝（README 原文）：
dsh plugin --profile web add file:<本項目的絕對路徑>
dsh
卸載：
dsh plugin --profile web remove dsh-calendar-pro
社區目錄頁：https://www.skillhub.cn/plugins/yan-evan/dsh-calendar-pro。目錄站點與 DeepSeek / 幻方無官方從屬關係，安裝來源以你實際使用的市場或 npm 包爲準。
典型用法¶
安裝並重啓 DSH 後，可在對話中用自然語言操作日程。README 給出的示例如下：
你：下週哪天適合安排一次兩小時的復盤會？
DSH：下週二 14:00–16:00 和週四 10:00–12:00 都空閒，要幫你把週二那場建上嗎？
你：建在週二下午兩點，標題「Q4 復盤」。
DSH：已創建。
需要 CalDAV 時，在插件提供的設置流程中配置對應服務（具體字段與步驟以 MANUAL.md 爲準）。若僅使用本地日曆，可不配置遠程賬號。
適用場景與注意¶
適合希望在 DSH 同一界面裏完成「查空閒 → 建會 → 與手機日曆一致」的開發者或日常用戶。依賴 CalDAV 時需準備可用的服務端賬號與網絡；經期等敏感數據 README 聲明僅存本機，但仍建議在本機磁盤與備份策略上自行把控。
問題與需求可通過 GitHub Issues 反饋；版本變更見 CHANGELOG.md。
結尾¶
dsh-calendar-pro 把日曆視圖、本地/遠程數據源和智能體工具收攏到 DSH 插件內，用對話完成查詢與安全確認下的刪改，用 CalDAV 或 ICS 與既有習慣銜接。進一步瞭解可訪問目錄頁 SkillHub 與源碼倉庫 GitHub。
