前言¶
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 获取源码。
