前言¶
在 DeepSeek Harness（DSH）里写提示、读回复，英文生词往往就散落在对话里：另开 App 背词会打断上下文，纯靠划词复制又很难形成复习节奏。DSH 社区插件按「一切皆插件」的思路，把能力嵌进宿主界面；dsh-vocab-study（仓库 wt0812/dsh-vocab-study）走纯客户端路线：输入框旁一颗胶囊、右侧栏一个「今日背单词」标签页，按记忆半衰期排期，数据只存在本机浏览器，不上报、不联网、不占 Host 服务。
下面介绍它是什么、能做什么，以及如何在 Web profile 里安装与使用。
这是什么¶
| 项 | 说明 |
|---|---|
| 名称 | dsh-vocab-study（npm 包名；GitHub：wt0812/dsh-vocab-study） |
| 维护者 | wt0812 |
| 分类 | 记忆（SkillHub 目录归类） |
| 版本 | 0.3.0（见仓库 Releases / package.json） |
| 许可证 | MIT |
| 依赖 | 零；无 node_modules 运行时依赖，内置词库打包在 lib/client.js |
插件声明为 DSH 纯客户端 UI 插件：只在两个 Cordis 槽位挂载 UI——conversation.input.right（输入框右侧胶囊）与 sidebar.right.pane.tab（右侧栏标签页）。背单词进度、生词本等内容落在浏览器 localStorage；README 写明不注册 Host 服务、不发网络请求（音标朗读用系统 TTS）。
界面与核心功能¶
入口位置¶
- 胶囊：排在「权限」与「模型」之间，文案随状态变化（如「今天第一词」）；点击打开背单词相关交互。
- 右侧面板：标签名「今日背单词」，内含四个页签：今日、进度、生词本、设置。
面板不会自动弹出；不用插件时它不占用交互（README 中的设计约束之一）。
今日¶
- 词卡 + 三档评分（熟悉程度反馈）。
- 下方展示本轮进度环、KPI、半月热力图等。
- 进度环表示当前这一轮（例如
0/20）；今天已背为当日累计，跨轮累加、点「再背一轮」后环归零而 KPI 不归零。
一轮结束后可选：再背一轮（原批重背、不改记忆数据）、再来 N 个新词（N 在设置里可调，默认 5）、我还是想继续（新词安全阀自动关闭时由用户决定是否继续）、换词库。
进度¶
30 天留存曲线、半月热力图、顽固词榜、需重点练习的混淆对等，用于查看长期记忆情况。
生词本¶
在对话里选中纯英文单词时，输入框旁可出现「加入生词本」。收录后插件会离线调用内置词表（README 称约 29,841 词可查释义）补 音标、词性、释义；并把选中上下文存为例句。查不到则标注「（还没释义）」并允许手填，来源区分 lookup 与 manual。判定「收服」（记忆强度 ≥ 0.9 且拼写答对）后词会从生词本移入「已收服」归档。今日错过的词可在生词本顶栏看到提示，是否加入由用户决定，不会自动写入。
设置¶
可配置一轮词数、加量步长、「再来几个」时的 N（3 / 5 / 10）、攻守天平、数据导入导出等。
内置词库与体积¶
README 说明 lib/client.js 约 5.40 MB，内含六本词库共 34,216 词；安装后无需再拉在线词库即可离线查词与背词。
安装与启用¶
安装命令须带 --profile web。README 强调不要用 --profile desktop（CLI 会拒绝，desktop profile 由 Electron 应用独占管理）；桌面 App 内嵌界面同样读取 profiles/web 的插件列表。
推荐从 npm 安装：
dsh plugin --profile web add dsh-vocab-study
npm 不可用时从 GitHub 安装：
dsh plugin --profile web add github:wt0812/dsh-vocab-study
装完后 完全退出 DeepSeek Harness 再启动。cordis.patch.yml 在启动时读取，仅刷新页面不足以加载新插件；改插件 JS 可刷新，改 patch 必须重启。
卸载：
dsh plugin --profile web remove dsh-vocab-study
package.json 要求 Node ≥ 20、DSH ≥ 0.2.0-rc.1。
典型用法¶
不装插件先看效果¶
仓库 demo/index.html 为自包含演示页（假 DSH 外壳 + 与正式版同源的胶囊与面板）。本地双击打开即可试用，无需安装 DSH。
Windows 示例：
start demo\index.html
日常背词¶
- 启动 DSH 并确认已安装插件且完整重启过。
- 点击输入框旁胶囊，或在右侧打开「今日背单词」→ 今日。
- 按词卡作答并用三档评分反馈；需要时在 设置 调整每轮词数与加量步长。
- 对话中遇到生词：选中英文单词 → 「加入生词本」→ 在 生词本 查看或编辑释义。
- 在 进度 查看留存与顽固词，按需调整学习量。
开发/本机构建（维护者路径）¶
改源码后可在仓库内执行（README 给出）：
python tools/build.py
python tools/build-plugin.py
python tools/install.py
对外分发仍建议使用上面的 dsh plugin --profile web add ...；install.py 含本机绝对路径，主要供作者自用。
适用场景与注意¶
适合谁：希望在 DSH 同一窗口里抽空背词、用间隔重复排期、且希望学习数据留在本机的用户；常与英文对话、文档阅读并行的开发者也适用。
环境与权限：插件以当前 DSH 客户端（Web profile）进程权限运行，逻辑全部在浏览器侧执行。安装前建议阅读 GitHub 仓库 源码与 MIT 许可证；README 列有「12 条硬约束」与「已知缺口」诚实清单，生产级成熟度作者自述为克制表述（功能在真界面点验过，测试套件 591 条断言全绿，但用户面仍较窄）。
生态说明：SkillHub（目录页）为社区插件目录，与 DeepSeek / 幻方无官方从属关系；市场收录 PR 见 README（awesome-dsh-plugin#7043，等上游合并）。国内 GitHub 不稳定时 README 提供 Gitee 镜像 gitee.com/wutong2005/dsh-vocab-study，需克隆后按文档用 python tools/install.py 等方式安装本地目录。
若重启后客户端无法启动，README 建议先用 DSH「禁用第三方插件」恢复，再执行卸载脚本或从 cordis.patch.yml 移除 vocab-study 条目并再次完整重启。
结尾¶
dsh-vocab-study 把间隔重复背单词做成 DSH 内的零联网客户端插件：一颗胶囊、四个页签，生词从对话收录并离线补释义，进度与设置都在本地完成。需要安装时记住 dsh plugin --profile web add dsh-vocab-study，装完务必完整重启 DSH。
- 目录页：https://www.skillhub.cn/plugins/wt0812/dsh-vocab-study
- GitHub：https://github.com/wt0812/dsh-vocab-study
