前言¶
做 DSH 桌面端的人大概都有这种体验：待办散在便签里，日程记在纸质本上，天气和农历得另开一个网页，到了周报又得重新核对一遍今天做了什么。dsh-schedule-calendar 的思路是不再单独开一套工具，而是把多城市天气、黄历宜忌、农历日历、日程与提醒、工作待办、日报周报、星座运势、好运签到和上下班倒计时都塞进 DSH 的侧边栏标签页。它依赖宿主插件 dsh-better-sidebar 提供的标签页能力，本身只负责内容与数据。
下面按照「这是什么 → 核心功能 → 安装启用 → 典型用法 → 适用场景与注意」的顺序介绍。
这是什么¶
- 作者 / 维护者：loyalchiiina
- 分类：联网工具（社区目录归类）
- 当前版本：0.3.7（package.json）
- 许可证：MIT
- 位置：https://github.com/loyalchiiina/dsh-schedule-calendar
- 目录页：https://www.skillhub.cn/plugins/loyalchiiina/dsh-schedule-calendar
它是 DSH 桌面端 profile 的侧边栏插件，面向需要在同一界面里同时管理日程、待办、报告和日常信息的个人或小型团队。社区目录页当前显示星标为 0，属于较新的项目。
核心功能¶
下面介绍的功能都来自 README，按界面模块分组。
多城市天气¶
按「省 / 市 / 区」级联或关键字搜索添加城市；区级用 Nominatim 地理编码，回退到 Open-Meteo。天气以横向表格显示今天、明天、后天、大后天共 4 天预报，带「🔄 刷新」按钮和失败自动重试。
黄历与农历日历¶
黄历部分在今日头部、星期右侧显示农历日期和当日宜忌，使用本地黄历算法，按日固定。
日历视图显示农历与节气、法定节假日；周末、个人休息日、法定假期、补班上班四类背景色可区分，颜色可在设置里自定义。日历右侧分栏可以直接点日期查看或添加当天日程，也支持右键添加日程。
日程与提醒¶
日程支持标题、日期、时间、备注和提前提醒。重复规则包括不重复、每日、每周、每月、每年、农历每年（适合生日纪念）。记录会带创建时间，列表按「下次发生」排序：本周期已过的发灰，未到的高亮。
工作待办¶
待办可以设置截止日期。未完成项按截止日排序，逾期的显示红色「⚠ 逾期」，已完成项显示完成时间。
日报 / 周报¶
日报支持「一键生成」，自动统计当日日程、未完成任务和已完成任务，也支持按日期区间批量生成。周报自动汇总本周的日报与完成情况，生成后仍可手动修改并保存。
星座运势与好运签到¶
在「设置」里为每个人填写生日，可选择阳历或农历并带上年份，系统自动识别星座。「今日」底部显示星座图案和当日气运，包括综合、恋爱、事业、财运、幸运色、幸运数字，并给出星座配对（最配 TOP3，以及与其余 11 个星座的相处评分）。
好运签到在今日顶部有一条 Buff 条，每日签到随机抽取「鸿运当头 / 日进斗金 / 暴富」等好运词并附健康提醒，连续签到会累计天数。
人员班制与上下班倒计时¶
支持多人管理，每个人都可以在「双休 / 大小周 / 单休 / 自定义星期」之间切换。大小周语义是：大周周六周日都休（等于双休），小周周六上班、周日休；可以指定本周是大周还是小周，之后自动交替。
上下班倒计时按当前所选人员的班制实时显示距上班、距下班的剩余时间，到点会提醒。
入口¶
插件在原生左侧栏脚部注入「日程助手」按钮，点击即打开右侧面板；也可以从右侧「新建标签页」里选择「日程助手」。
安装与启用¶
这个插件面向桌面端（desktop profile）。README 明确说明：桌面端 profile 由 Electron 独占，dsh plugin --profile desktop 会被拒绝，需要手改 profile。如下步骤来自 README 原文。
1、把插件包放到本地插件目录（或用 npm 安装到本机）：
# 方式一：放到本地插件目录
# ~/.dsh/local-plugins/dsh-schedule-calendar
# 方式二：npm 安装
npm i dsh-schedule-calendar
2、编辑 ~/.dsh/profiles/desktop/package.json，在 dependencies 增加本地引用：
{
"dsh-schedule-calendar": "link:<本包绝对路径>"
}
如果走 npm 安装，这一行写版本号而不是 link:。
同时在 profile 配置里把 bundle 加进去：
{
"dsh": {
"profile": {
"bundles": [
"dsh-schedule-calendar"
]
}
}
}
3、在该 profile 目录执行安装命令：
cd ~/.dsh/profiles/desktop
pnpm install
4、完全退出 DSH 再启动。宿主端没有热重载；重新启动后左侧栏脚部会出现「日程助手」按钮。
数据与隐私¶
插件数据只写入本机插件包内的 data/store.json，不上传任何服务器。天气、城市、节假日、黄历、星座运势由宿主端代理转发或本地生成；这些外部信息取不到时，界面给出降级提示，不影响日程与待办本身的使用。整包打包或备份时，数据随插件包一起带走。
典型用法¶
1、首次启用后，先在「设置」里添加人员，设置姓名、生日（用于星座）和班制（双休 / 大小周 / 单休 / 自定义）。
2、在「今日」视图添加城市天气，确认预报显示正常；顺手做一次每日签到。
3、把反复发生的事项建成日程，例如每周一上午的例会选择「每周」重复；生日等按农历每年重复。
4、把当天需要交付的事项记为待办并填上截止日期，逾期的会在列表里标红。
5、下班前用「一键生成」出日报；需要整理一周情况时用周报自动汇总，再手工补充结论。
适用场景与注意¶
适合的场景：
- 日常要靠 DSH 桌面端工作，希望日程、待办、天气、农历和报告都在同一个侧边栏里看的人。
- 需要按不同班制（尤其大小周）管理上下的人，例如带班的小团队。
- 需要日报 / 周报自动统计当日日程和未完成待办的人。
需要注意的点：
- 插件以当前 DSH 进程的权限运行，可以访问该进程能访问的本地文件与网络。安装前应先打开源码和
license（MIT）自行确认。 - 安装必须手改 desktop profile 的
package.json，README 指出执行dsh plugin --profile desktop会被拒绝。改完必须完全退出 DSH 再启动。 - 依赖宿主插件
dsh-better-sidebar，需要先确认该宿主插件已可用。 - 天气与城市地理编码依赖外部服务（Nominatim / Open-Meteo），断网或服务不可用时只会降级提示，不会读写日程数据。
- 插件使用本地文件
data/store.json存储，注意和插件包一起备份；删除或替换插件包会带走这些数据。
结尾¶
dsh-schedule-calendar 的价值在于把一堆分散的日常信息收进 DSH 现有的侧边栏，而不是再开一个独立工具。它功能覆盖面广，但实现和入口都依附 dsh-better-sidebar 与桌面端 profile，安装前要按 README 手改配置并检查源码与许可证。
- 目录页：https://www.skillhub.cn/plugins/loyalchiiina/dsh-schedule-calendar
- GitHub：https://github.com/loyalchiiina/dsh-schedule-calendar
