前言¶

用智能体辅助学习时，常见做法是临时让模型出题或总结，对话结束进度就散在聊天记录里，难以追踪掌握度和复习节奏。DeepSeek Harness（DSH）支持以插件扩展 Host 能力；伴学（Study Companion） 把一次对话组织成可持续的学习回路：规划 → 练习 → 测试 → 反馈 → 复习，并在侧栏面板里查看进度、作答和漏洞回顾。

下面介绍插件定位、能力与在 DSH 中的安装、首次使用方式；可选的 Safari 课程同步与数据存放位置一并说明。

这是什么¶

伴学是社区维护的 DSH 工作流类插件，仓库为 zgdllt/study-companion，包名 @local/study-companion，当前发布版本 1.0.0，采用 MIT 许可证。维护者 zgdllt。项目在 DSH 0.2.1-rc.5 下开发与验证；其他 DSH 版本以宿主插件 API 兼容性为准。

插件在对话中让 agent 制订学习阶梯、出题与评分；在侧栏查看进度、考场作答和回顾；还可跟随网页课程记录笔记，把练习难点追溯到课件页与原课时间。

核心功能¶

README 以表格归纳能力，安装后可对照侧栏「概览 / 阶梯 / 考场 / 课堂 / 方法」使用。

Host 侧提供档案读写等工具（如 study_read、study_write、ask_exam、bind_session、lesson_open 等）；面板负责展示与提交，考试评分由对话中的 agent 完成，面板不自行评分。

安装与启用¶

准备 DSH¶

伴学依赖 DSH 的 Host 与 Web 界面。桌面版直接打开应用；命令行可按官方说明启动 Web：

npx @deepseek-ai/dsh web

默认界面为 http://127.0.0.1:3080。先在「设置 → 模型」配置可用模型，再选择或添加工作区。模型细节见 DSH 使用指南。

安装插件（推荐 Git 地址）¶

1. 在 DSH 侧栏打开「插件」，点击「添加插件」。
2. 在安装输入框粘贴完整地址，固定安装 v1.0.0：

git+https://github.com/zgdllt/study-companion.git#v1.0.0

3. 点击「安装」，完成后点击「立即启用」；若提示重启则重启 DSH。
4. 刷新界面。侧栏应出现「伴学」，插件列表包名为 @local/study-companion。

安装机器需能访问 GitHub；无需单独构建，也无需把源码复制进 DSH 安装目录。

Release 包：从 Releases 下载 local-study-companion-1.0.0.tgz，在「添加插件」中填写该文件在 运行 DSH 的机器上 的绝对路径后安装启用。

也可在对话中让 agent 调用 plugin_manager，参数示例（在 DSH 内使用，不要在终端执行）：

{
  "action": "install_bundle",
  "target": "git+https://github.com/zgdllt/study-companion.git#v1.0.0"
}

若 agent 预设没有 plugin_manager，请用插件页面安装。

检查安装¶

• 「插件」页中伴学已启用，Host 行无加载错误。
• 侧栏能打开伴学，看到「概览 / 阶梯 / 考场 / 课堂 / 方法」。
• 在「概览」新建学科后，回对话让 agent 读取学习档案，应能调用 study_read。

典型用法¶

1. 在「概览」新建学科，填写主题、目标、截止时间和可用小时数。
2. 回到 DSH 对话，发送（可按需微调表述）：

请用伴学工具读取我刚创建的学科，先通过 study_write 的 bind_session 操作将它绑定到当前对话，再建立学习阶梯和学习计划并写入档案。先带我完成第一个单元，不要一次讲完整套课程。

3. 学完一个单元后说「开始考试」。agent 用 ask_exam 一次出一道题。
4. 打开「考场」作答，点击「提交并继续考试」；答案保存后可由绑定对话继续，或自行回到该对话说「继续考试」。
5. agent 读取答案、评分并指出漏洞，再讲解或出下一题。
6. 学完后让 agent 保存一页速查表并安排复测。

每个学科可绑定一个主伴学对话；换对话继续时，先让 agent 用 bind_session 重新绑定。「方法」页提供六张方法卡与可复制提示词。

跟随网页课程（Safari，可选）¶

普通学习流程不依赖 Safari。在 macOS 上要同步课程播放状态需：用 Safari 打开回放；在 Safari 设置中启用开发者相关选项并允许从 Apple 事件执行 JavaScript；授权 DSH 相关应用控制 Safari；在对话中用 lesson_open 建立课次，在「课堂」检查适配器并同步状态。

README 写明此前仅在雨课堂回放上实测媒体状态、播放控制、课件锚点与时间对齐；B 站、学堂在线等未验证。无播放器接口时媒体位置保持 null，页面授课时刻不会冒充为视频时间。

数据、隐私与适用注意¶

学习档案保存在运行 DSH 的机器上，DSH_HOME 未设置时为 ~/.dsh：

$DSH_HOME/storages/study-companion/
├── active.json
├── subjects/<id>.json
├── courses/<id>.json
├── lessons/<id>.json
└── prefs.json

可通过 bundle 的 cordis.patch.yml 为 Host 设置 config.dataDir 更换目录。卸载插件不会删除档案；插件本身无额外云端服务或遥测，模型调用仍按 DSH 中配置的权限处理。

适合谁：已在用 DSH、希望用 agent + 面板固化学习计划、单题考试与间隔复习的开发者或自学者。

边界：评分是模型对本次回答的判断，不等于真实能力验收；自动前测、全浏览器端到端验收等待实现项以 docs/CONTRACT.md 为准。安装前建议浏览仓库源码与 MIT 许可证；插件以当前 dsh 进程权限运行。

链接¶

• 社区目录页：https://www.skillhub.cn/plugins/zgdllt/study-companion
• GitHub：https://github.com/zgdllt/study-companion
• 项目主页：https://zgdllt.github.io/study-companion/