前言¶
DeepSeek Harness (DSH) 採用插件化架構，dsh-study-planner 是其中一個客戶端插件。它利用 DSH 的會話視圖，在對話標籤欄旁增加一個“學習計劃”標籤頁，將學習計劃拆解爲每日任務、課後題與打卡進度，並提供可視化界面。
插件的核心價值在於：計劃內容由對話中的 AI 動態生成，打卡數據保存在本地，適合需要長期跟蹤學習進度的場景。
核心功能¶
- 計劃表：按周或天展示主題、知識點、閱讀章節、動手任務、完成標準，以及每日課後題（包含題目、提示、參考答案和難度）。
- 打卡進度可視化：顯示總進度百分比、已完成天數、累計學時、連續打卡天數、課後題完成數，並提供一個可點擊的打卡日曆。
- 今日推薦：設置開始日期後，系統按自然日推算“今天”該學哪一天；未設置時，自動推薦第一個未完成的天。
- 計劃生成：在頁面頂部輸入目標，一鍵將提示詞填入下方對話框，回車發送。AI 按照指定 JSON 格式生成計劃文件，刷新頁面即可顯示。
- 多計劃支持：支持多個學習計劃。
plans/目錄下有多少份計劃，頁面頂部下拉框就有多少個選項。 - 數據本地化：計劃文件是普通 JSON，打卡記錄由插件宿主維護，全部存儲在
~/.dsh/study-planner/目錄。
安裝¶
在終端執行以下命令即可安裝：
dsh plugin --profile <你的 profile> add github:4399Accelerator/dsh-study-planner
安裝完成後刷新頁面（F5）。如果標籤欄未出現，嘗試重啓 DSH。
使用方法¶
- 進入標籤頁：打開任意一個已發送過消息的會話（空白會話不顯示標籤欄），點擊頂部的“學習計劃”標籤。
- 生成計劃：第一次進入是引導頁。在輸入框寫下學習目標，例如“6 周 Python 數據分析，每天 1 小時，零基礎”。
- AI 生成：點擊“讓 AI 生成計劃”。提示詞會自動填入本對話下方的輸入框，回車發送。AI 生成 JSON 格式的計劃文件並寫入本地數據目錄。
- 查看與打卡：返回本頁點擊“刷新”，即可看到計劃表。左側查看整體進度與日曆，右側查看當日任務。完成後點擊“完成今日打卡”。
也可以跳過按鈕，直接在對話中輸入指令讓 AI 生成計劃。
數據與宿主接口¶
所有數據存儲在本地路徑 ~/.dsh/study-planner/：
* plans/：存放計劃 JSON 文件。
* progress.json：存放打卡記錄（不建議手動修改）。
* README.md：計劃 JSON 格式說明。
插件宿主側註冊了一個僅限本機迴環訪問的 HTTP 接口 POST /dsh-study-planner/api，用於讀寫狀態。支持的 action 包括 state（獲取狀態）、plan（獲取計劃）、toggle-day（打卡/撤銷）、toggle-exercise（課後題勾選）等。
注意事項¶
- DSH 目前不支持插件自動更新，升級需要先卸載再安裝新版。
- 卸載插件不會刪除
~/.dsh/study-planner/目錄中的數據。 - 空白會話不顯示標籤欄，必須先在對話中發送過消息。
- 插件依賴宿主提供的 Web/桌面形態運行，宿主接口僅限本機迴環訪問。
生態背景¶
該插件由社區開發者維護，可從 SkillHub 插件目錄 或 GitHub 獲取源碼。
