前言¶
做 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
