前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在現有的 Google 日曆與任務集成方案中，通常需要 Python 或 Node.js 中間服務，或者作爲 MCP 服務器旁掛，且 OAuth 憑據管理較爲複雜。dsh-plugin-google 是一個原生插件，旨在解決這一問題，將 Google Calendar 與 Google Tasks 直接接入 DSH，通過對話即可完成日常管理。
核心能力¶
該插件專注於高頻場景，具備以下核心功能：
- 對話式 CRUD：直接通過自然語言完成日程、日曆、待辦與任務列表的增刪改查。
- 日程與任務管理：支持日程的創建、修改、移動、刪除，以及任務列表與任務的增刪改查。
- 智能查詢：支持忙閒查詢（多日曆衝突檢測）與每日日程彙總（包含待辦、逾期任務及時間衝突）。
- 自然語言解析：支持解析時間與意圖，例如直接輸入時間創建日程或修改時間。
- 零依賴與原生 OAuth：不依賴 Python 或 Node 運行時，內置 OAuth 2.0 桌面授權流程，無需額外令牌存儲。
安裝¶
使用 DSH 插件管理器進行安裝：
dsh plugin --profile <profile> add dsh-plugin-google
安裝後，該包自帶的 cordis.patch.yml 會自動插入一條 id: google 的插件配置到你的 profile 中。
授權與配置¶
憑據與令牌默認存儲在 $DSH_HOME 目錄下，無需額外配置文件：
$DSH_HOME/google-oauth-client.json：Google Cloud 下載的 OAuth 客戶端憑據。$DSH_HOME/google-oauth-token.json：授權後由插件自動寫入的訪問令牌。
中國大陸網絡配置：
Google API 通常無法直連，需配置代理。可在插件配置中顯式指定，或讓 DSH 進程繼承 HTTPS_PROXY 環境變量。
重要注意事項：
如果 Google Cloud 中的 OAuth 應用處於“測試”發佈狀態，refresh token 會在 7 天后失效。建議在 Google Cloud 控制台將應用發佈狀態改爲“正式”。
典型用法¶
安裝並授權完成後，可以直接通過對話調用工具：
- 查詢日程：說「我今天有什麼安排」或「我有哪些待辦」，插件會返回日曆與待辦的彙總。
- 創建日程：說「明天下午3點到4點，和張總開項目評審，加個騰訊會議鏈接」，插件會自動解析時間並創建事件。
- 修改日程：說「把下週三的牙醫改到週五上午10點」。
- 約時間：說「幫我約一個下週一上午、雙方都空的 1 小時」，插件會查詢空閒時段並創建會議。
注意事項¶
- 權限範圍：默認請求
.../auth/calendar（含日曆與事件的完整讀寫）與.../auth/tasks權限。這些權限可在配置中替換爲更窄的範圍。 - 授權流程：首次使用需在對話中依次觸發
google_auth_status、google_auth_begin（獲取鏈接）、瀏覽器確認、google_auth_complete（完成授權）。
結語¶
dsh-plugin-google 提供了一套完整的 Google 生產力工具接入方案，通過 DSH 的原生能力減少了環境搭建的複雜度。相關目錄與源碼可訪問：SkillHub 目錄 或 GitHub。
