DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在使用 Web 界面進行開發或對話時,經常需要獲取日期、天氣或時間戳信息。傳統的做法往往依賴模型生成,這會消耗 token,或者依賴不穩定的外部服務。dsh-panda-calendar 是一款專爲 DSH Web 設計的插件,它通過瀏覽器本地運行的方式,提供一站式的日曆、天氣與時間戳服務,無需消耗 token 且支持離線使用。
核心功能¶
該插件在會話頁頭新增了「熊貓日曆」標籤頁,與對話、軌跡、詩詞同級。它主要解決以下問題:
- 曆法與節日:提供公曆、農曆、干支、生肖、節氣及中國法定節假日(含調休)的查詢。
- 天氣與定位:支持多城市天氣查詢、定位及城市管理。
- 時間處理:提供秒/毫秒與年月日時分秒的雙向互轉,並支持時區選擇。
- 歷史檔案:提供「歷史上的今天」大事記與名人誕辰。
- 離線能力:農曆引擎與法定節假日數據內置,斷網環境下核心功能可用。
安裝與啓用¶
安裝此插件需要依賴 pnpm。安裝完成後,必須重啓 dsh web 進程才能加載新插件。
# 1. 安裝 pnpm(如果尚未安裝)
npm i -g pnpm
# 2. 安裝插件
dsh plugin --profile web add dsh-panda-calendar
# 3. 安裝完成後重啓 Web 進程
# (停止當前進程,然後重新啓動 dsh web)
使用方法¶
- 打開一個會話,點擊頁頭的「熊貓日曆」標籤。
- 今日摘要:查看當日公曆、農曆、干支、生肖等信息。點擊「✍ 發送到對話」,該日摘要會寫入輸入框(不自動發送),切換回對話視圖按回車即可讓 AI 解讀或安排。
- 時間戳轉換:在時間戳轉換卡片中,直接粘貼 10 位(秒)或 13 位(毫秒)數字,或填寫日期時間進行轉換。右上角支持選擇時區(含夏令時處理)。
- 歷史與天氣:展開「歷史上的今天」查看大事記;在天氣卡中搜索或切換城市。
技術實現與數據源¶
- 純前端實現:無後端,收藏與狀態均本地保存(localStorage)。
- 農曆引擎:內置 1900–2100 年的離線數據表,基於
lunar-javascript生成。 - 法定節假日:基於
holiday-cn,內置 2025/2026 年快照及規則兜底。 - 天氣服務:使用 Open-Meteo(免費)、BigDataCloud 逆地理編碼及 ip-api.com 兜底,無需 API Key。
- 歷史增強:網絡可達中文維基時,會自動拉取並增強「歷史上的今天」內容(12h 緩存)。