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 缓存)。