@ericwang1358/dsh-daily-flashcard

dsh plugin --profile web add @ericwang1358/dsh-daily-flashcard

StudyHub（DSH 学习插件）

[English](README.md) · 中文

把老师的课件变成题，每道题都点得回原页；做完一轮，看得见自己变熟。

开源免费，资料存在你电脑上；模型自己选，按用量付费。

StudyHub 是 DeepSeek Harness（DSH）的插件。DSH 是 AI 助手应用，可以装成桌面版，也可以在自己电脑上以网页版运行；StudyHub 就在 DSH 里打开使用。

在线体验 · [安装指南](docs/install.zh-CN.md) · 发布页 · [更新日志](CHANGELOG.zh-CN.md)

在线体验直接在浏览器里打开，用示例题和预置的 AI 回复演示，不用安装，也不用 Key；体验进度只保存在当前浏览器。

开始前先知道

• 适合谁：用课件、PDF、讲义和课堂录音学习的学生，中文、英文资料都可以。
• 要花钱吗：StudyHub 本身免费开源（MIT）。浏览资料、做题和安排复习都免费，不调用模型。出题和 AI 讲解按你的模型服务商计费。每次出题前，StudyHub 会显示预计 Token 用量，出题后显示实际用量；「统计」里还能看近 7 天或近 30 天的合计。
• 网络与费用：可用地区、免费额度和收费规则以各服务商的当前说明为准。从 GitHub 地址装不上插件时，见[快速上手](#快速上手)后面的备用办法。
• 什么电脑能用：下方提供 Windows 64 位和 Apple 芯片 Mac 的 DSH 安装入口。其他系统请查看 DSH 官方支持情况，或使用需要 Node.js 22.19 或以上的网页版。
• 版本要求：需要 DSH 0.2（0.2.0-rc.2 或以上，低于 0.3）。StudyHub 当前版本是 4.3.3。
• 资料会上传吗：学习库是你电脑上的一个文件夹。只有用到相应功能时，所选内容才会发给对应的服务，详见[数据与隐私](#数据与隐私)。

能做什么

• 用自己的资料出题：按页或按章节选资料，生成闪卡、单选、多选、开放问答或填空题。每道题都标明引用的原文，你检查草稿后再发布。
• 题目和原文互相跳转：点引用就回到原文段落；资料里的段落、表格角标能打开关联的题目和讲解。
• 练习与复习：在「学习库」开始今日学习，或进入「学习流」先讲后练；任何一道题都能点「帮我弄懂」；FSRS-6 会把到期的题按时推给你。
• 录入考试重点（只有图片也能用）：在「录入重点…」拖入或粘贴划重点截图、板书照片或范围消息（同时支持看图模型与 DeepSeek 等纯文本主会话模型）；重点题间隔更短、优先进入每日学习与备考计划，出题时自动提高配额并加深到应用 / 进阶难度。
• 找出薄弱点：用「错题与待巩固」「统计」和「模拟考试」。模拟考试有选择题笔试、案例分析卷和口头面试三种形式。
• 学完读一篇今日总结：同一天同一课程累计完成 10 道不同题目后，可以生成错题讲解合集；不同章节合成一篇，重练不重复计数。设置里可选亲切或专业口吻、主动开启自动生成。合集沿用资料阅读器，「转成资料」和 CSDN 发布是单独的操作。
• 录音转文字：导入课堂录音，或用「课堂实录」边上课边转写，得到中英对照的讲稿，可以直接拿来出题。
• 阅读与整理：阅读器有目录、搜索、「翻译本页」和「做这几页的题」；课程、「学习笔记」「待办」和「知识骨架」帮你把一学期的内容管起来。
• 搭配开源的 Archify（MIT 协议，作者 tt-a1i，与 StudyHub 没有合作关系）：助手可以用它把知识骨架画成可交互的图，StudyHub 负责保存和显示这个文件。详见[搭配好用的工具](docs/companions.zh-CN.md)。

快速上手

你想做的 · 需要什么 · 费用

看示例课程和功能导览、浏览资料、练习已有题目 · 装好插件即可 · 免费，不调用模型

用资料出题、看讲解、用「帮我弄懂」 · 一个模型服务商的 API Key，填在 DSH 的「设置 › 模型」 · 按服务商计费，例如 DeepSeek API

录音转文字 · 一个转写服务密钥，填在 StudyHub 的「设置 › 音频转写」 · 硅基流动 SenseVoice 支持录音转写；Gemini、Groq 可用地区和额度由服务商决定

1. 安装 DSH（已装可跳过）：下载官方的 Windows 64 位安装器（.exe）或 macOS Apple 芯片安装器（.dmg）。其他电脑先安装 Node.js 22.19 或以上，再运行 npx @deepseek-ai/dsh web 启动网页版。

2. 安装 StudyHub：在 DSH 打开「插件」，点「添加插件」，粘贴下面的地址，装好后点「启用」：

   https://github.com/EricWang1358/dsh-web-studyhub/releases/download/v4.3.3/ericwang1358-dsh-daily-flashcard-4.3.3.tgz

确认包名是 @ericwang1358/dsh-daily-flashcard、版本是 4.3.3。启用后 StudyHub 会自动打开；以后从 DSH 左栏的「StudyHub」进入（会话里的「StudyHub」标签和右侧栏也可以），不需要先发消息。

3. 看一遍示例（可选，一两分钟）：在欢迎页点「载入示例并开始导览」。7 步导览按首页那条线的顺序走：模型在哪里设置、添加资料、出题、检查草稿、练习，直接指向真实的按钮，最后落在那条线的第 2 步；想看全部页面（包括任务），最后可以接着看完整导览。示例不调用模型，可以一键移除。

4. 配置模型：在 DSH 的「设置 › 模型」粘贴 API Key，再在会话里选一个模型。配置好之前，凡是需要模型的步骤，StudyHub 都会先提示并带一个「前往设置」链接，不会让你点了之后再失败；「设置 › 学习库与模型」顶部显示「模型已连接」或「模型未连接」和步骤。

5. 用自己的资料开始：点「添加资料」，一次拖入多个 PDF、PPT 或笔记，然后「用资料出题」→ 检查草稿 → 发布 → 开始练习。

安装补充说明：

• 已经在用 DSH：只装插件即可。桌面版或网页版、原来的 profile、模型设置和工作区都不用动。
• GitHub 地址装不上：先用浏览器从发布页下载 .tgz，再在「添加插件」里填它的绝对路径。文件必须放在运行 DSH 的那台电脑或服务器上。
• 发布页文件很多，下哪个：只需要完整包 ericwang1358-dsh-daily-flashcard-<版本号>.tgz，而且一般不用下载，按第 2 步粘贴地址就行。其余文件是 6 个可单独安装的组件、检索扩展（点「安装检索扩展」时由 StudyHub 安装）、校验值清单和两份安装引导。
• 命令行安装等更多方式见[安装与模型配置](docs/install.zh-CN.md)。也可以下载能在浏览器里打开的安装引导（English）。DSH 本身只从第 1 步的官方渠道获取。

使用 StudyHub

添加资料

点「添加资料」，先选课程，再一次拖入多个文件，或粘贴文本；录音在同一窗口的「音频 / 录音」标签导入。

格式 · 上限 · 说明

PDF · 8 MB、200 页 · 每个 PDF 保存为一份文档，可展开到页；更大的书见下文

Word（.docx）、PowerPoint（.pptx，以及旧版 .ppt） · 40 MB · 只读取文字：图片、图表和 SmartArt 不读，Word 的文本框、页眉页脚也不读。PPT 按幻灯片分页，并带上演讲者备注；旧版 .ppt 不保留项目符号的缩进层级

Markdown、HTML、TXT · 8 MB ·

JSON 题组 · 2 MB · 你已有的题目，或在别处（例如其他 AI）生成的题（[格式说明](docs/json-import.zh-CN.md)）

字幕（.srt、.vtt） · 8 MB · 需要启用音频组件

音频（MP3、WAV、M4A、AAC、OGG、FLAC、OPUS、WEBM、AIFF） · 512 MB、8 小时 · 见[录音转文字](#录音转文字)

旧版 .doc（以及 .wps、.key、.pages）不能直接读取，请先另存为 .docx 或 PDF。有密码保护的文件也读不了。

大教材（超过 8 MB 或 200 页）：

• 在导入窗口点「用 MinerU 解析」。PDF 最大 800 MB，转换后作为一份分页文档导入，可以按章节选择。
• MinerU 在这台电脑上运行。在「设置 › PDF 转换」（或直接在导入窗口里）点「一键安装」：StudyHub 把程序、Python 和模型装进一个文件夹，默认不在系统盘，不需要管理员权限，也不需要事先装任何东西。PDF 不上传，也不需要令牌。云端解析已在 3.5.5 版移除（[说明](docs/mineru-conversion.zh-CN.md)）。
• 想整本书出题，可以用检索扩展，或在「创建题组」用「分步生成路径」。

详见[大教材](docs/large-documents.zh-CN.md)和[用 MinerU 转换 PDF](docs/mineru-conversion.zh-CN.md)。

也可以在「添加资料」查看 [Marker 外部转换指南](docs/marker-external.zh-CN.md)，下载转换脚本自行运行，再选择生成的分页 Markdown 导入。Marker 和模型需自行安装；代码与模型许可分别适用。

出题

1. 打开「创建题组」，在「用资料出题」标签按文档（大教材可按章节）选资料，再选题型、题数和难度。不确定练什么，可以点「帮我想想」：它只根据资料标题和目录推荐主题，不发送全文。

2. 点「生成并检查题组」。任务在后台运行，你可以继续学习。

3. 检查草稿和引用，然后发布。发布时会再逐题检查，有问题的题留在草稿里。草稿和已发布的题目分开保存。

想补进已有题组，就选那个题组：审核通过的题会加进去，原有题目和复习进度都保留。已经有现成的题目，就用「导入 JSON 题组」标签导入。

<details>

<summary>出题怎样检查题目</summary>

• 每批题只做一轮独立审核：通过的题保留，没补足的数量会明确告诉你。2.5.8 曾加入一次引文修复；当前流程先核验知识点和答案，必要时纠正这两个准备步骤，再写题和独立审核。只因措辞被标记的题会改写一次并单独复审，不会无限循环修复。
• 补入已有题组时，预算到点也会保存已审核的部分，不需要再次确认发布。
• 引用和题目结构由代码检查，但内容仍可能有模型错误，请认真看草稿。详见[出题与质量检查](docs/assessment-quality.zh-CN.md)。
• 资料里的文字只作为证据交给模型，不会被当成要执行的指令。
• 课程是资料和题组的归属标签，文件夹只用来分组展示题组。出题和练习只使用你明确选中的课程、资料和题组。

</details>

默认题型、题数、内容语言、难度和侧重点可在「设置 › 出题偏好」保存；新建出题仍可单次调整。每批题数、并行批次和运行时限也在这里，初始为 5 题、4 批、20 分钟。已经开始的任务和补题的原草稿保留原设置。详见[生成安排](docs/generation-agents-sidebar.zh-CN.md#出题任务怎么做)。

练习与复习

「今日学习安排」把待办接进学习库首页。先请 AI 根据真实的待复习题、薄弱点、已有资料、未完成学习流和已接受任务提出安排，再写下意见让它调整，或直接接受。每项显示建议理由和预计分钟数；接受前不会创建待办，接受后可直接开始或继续。

今天的时间预算和长期工作日／周末习惯分开保存，0 分钟可以安排休息日。未完成行动重新纳入预算，已完成行动也计入当天学习量，避免重复加量。完成后可记录实际用时；累积至少 5 个同类日的有效记录后，系统用中位数估

…(truncated)