前言¶
用 DSH 這類智能體工作臺時，常會遇到一個具體問題：對話裏聊出來的待辦事項——改天跑一個測試、下週回顧某個方案——散落在各個會話裏，關掉窗口就忘了。外部待辦工具可以記，但和 agent 不打通，agent 也沒法替你寫日程。
dsh-schedule 解決的就是這個問題：把日程管理直接裝進 DSH Web 界面，同時以 agent 工具的形式暴露給模型，人在面板裏操作，agent 也能在對話裏代勞。下面介紹它的功能、安裝方法和典型用法。
這是什麼¶
dsh-schedule 是一個 DeepSeek Harness（DSH）本地日程插件，作者是 magicOF2，許可證爲 MIT，當前版本 0.2.0（package.json 標明）。它的定位一句話概括：側邊欄入口加全高抽屜日程面板，支持日程-會話鏈接、行內編輯與詳情視圖、完成打勾、重複日程與 agent 工具，數據長期保存在本地文件。
插件依賴 @deepseek-ai/cordis 和 @deepseek-ai/dsh-tools 兩個 peer 包，面向 web platform，需要安裝到 web profile 後使用。
核心功能¶
面板與入口¶
插件提供兩個入口：會話標題欄右側的「日程」文字按鈕，以及側邊欄底部的日程入口。點開後是從右側滑出的全高抽屜面板（不是浮動小窗），內部分三個頁籤：
- 今天：分未完成和已完成兩區；
- 本週：按天分組展示；
- 歷史：月曆，外加本週、本月、本年和連續完成的統計。
面板打開期間每 30 秒自動同步一次，其他會話裏 agent 修改的日程也會出現。按 Esc 或點擊面板外空白處關閉。
添加與編輯¶
添加表單默認收起爲「+ 添加」按鈕，點開才展開完整表單（標題 + 日期/重複/時間 + 備註輸入），把更多空間留給日程列表。
編輯有兩種方式：日程條右側的 ✎ 按鈕直接行內編輯名稱、日期、重複、時間、備註和順延開關；點擊日程標題則進入詳情視圖，可查看完整備註（自動換行，不再截斷）、完成統計、順延歷史日期與關聯會話，並支持在詳情裏打勾、關聯和刪除。
重複日程支持三種類型：一次性、每天、每週（週一到週日多選）。
完成打勾與自動順延¶
完成一項，點日程左側圓圈打勾。完成記錄按天累積，重複日程每天獨立記錄；勾掉的條目進入「已完成」區，次日自動清空當日記錄，但歷史永久保留，可在歷史頁籤回看。
一次性日程可以勾選「未完成自動順延」：到期未完成時，下次打開面板自動順延到當天。順延經過的歷史日期保留在月曆中，並顯示「順」標記，完成的當天會顯示最終狀態。
日程與會話關聯¶
這是插件比較有特點的一塊：日程可以和會話互相跳轉。
1、日程條右側的 ⊕ 按鈕一鍵關聯當前會話；
2、輸入框右側的 🔗 按鈕彈出日程列表，從中選擇關聯；
3、一個日程可以關聯多個會話；
4、點擊會話標籤跳轉回關聯會話。
Agent 工具¶
插件向 agent 暴露六個工具：dailytask_add、dailytask_list、dailytask_set_done、dailytask_update、dailytask_delete、dailytask_link_session。也就是說，在任意對話裏說一句「幫我記一條日程」，模型就能通過工具直接寫入，不需要你手動打開面板。
存儲與數據安全¶
數據保存在本地文件 ~/.dsh/dsh-schedule-data.json，結構爲 items（日程定義）+ done（按日程 ID 到日期累積的完成記錄）。完成歷史永不刪除，舊版數據文件會自動遷移。文件損壞時，插件會先把原文件備份爲 .corrupt-時間戳，再以空數據啓動，絕不覆蓋原文。備份只需拷貝這一個文件。
安裝與啓用¶
官方安裝方式是從源碼構建後裝入 web profile。先克隆倉庫並構建、跑測試：
git clone https://github.com/magicOF2/dsh-schedule.git
cd dsh-schedule
pnpm build
pnpm test
pnpm build 產出 lib/ 目錄（Host 端 ESM + Client bundle）；pnpm test 基於 node --test，覆蓋存儲核心和客戶端純視圖邏輯，測試在 Windows/macOS/Linux 下均可用。
構建通過後，安裝到 web profile：
dsh plugin --profile web add /path/to/dsh-schedule
其中 /path/to/dsh-schedule 換成你本地的倉庫路徑。最後重啓 DSH：
dsh web
經過上面的步驟，重啓後即可在側邊欄或會話標題欄看到日程入口。
典型用法¶
日常使用流程大致如下：
- 打開 DSH Web，從側邊欄底部或會話標題欄右側打開日程面板；
- 點「+ 添加」展開表單，填寫標題、日期/重複/時間和備註；一次性日程可勾選「未完成自動順延」；
- 完成一項，點左側圓圈打勾，條目進入「已完成」區；
- 需要修改時，日程條右側 ✎ 行內編輯，或點標題進詳情頁；
- 想把當前會話和某個日程掛上鉤，點日程條 ⊕ 或輸入框右側 🔗，之後點會話標籤可跳回原會話；
- 到「歷史」頁籤看月曆和本週/本月/本年/連續完成統計，順延過的日期會帶「順」標記；
- 不想動手時，直接在對話裏說「幫我記一條日程」，agent 會調用工具完成。
適用場景與注意事項¶
適合的場景：日常在 DSH Web 裏工作、待辦和對話強相關的人。日程跟着界面走，agent 能讀寫，完成歷史長期留在本地文件裏，適合做周/月維度的回顧。
幾點注意：
- 插件需安裝到 web profile 並重啓 DSH（
dsh web）後才能使用； - 數據在
~/.dsh/dsh-schedule-data.json，定期備份拷貝這個文件即可； - 和所有 DSH 插件一樣，插件以當前 dsh 進程的權限運行。安裝前建議先檢查源碼和許可證——這個項目是 MIT，倉庫公開，構建和測試命令都可以本地執行驗證；
- 該插件目前在 DSH Web（web platform）下使用。
另外說明：社區插件目錄（skillhub.cn）是獨立站點，與 DeepSeek、幻方沒有官方從屬關係，僅作索引用途。
小結¶
dsh-schedule 做的事情不復雜：把日程放進 DSH Web，給 agent 一組工具，把數據留在本地一個 JSON 文件裏。入口、編輯、打勾、順延、會話關聯這些細節都處理得比較完整，適合把日常工作流和 agent 會話放在一處的人。
- GitHub：https://github.com/magicOF2/dsh-schedule
- 目錄頁：https://www.skillhub.cn/plugins/magicOF2/dsh-schedule
