前言¶
DeepSeek Harness（DSH）采用插件化架构，允许开发者扩展宿主能力。在个人知识管理中，英语生词的录入与记忆是一个高频需求。dsh-word-vault 由开发者 wangzhanchao883 维护，是一款针对多用户场景的英语生词库插件。它解决了传统生词本“手动敲击录入”效率低、无法利用 LLM 辅助生成记忆内容的问题，通过剪贴板监听、弹窗点选和 SQLite 持久化，提供了一套从录入到复习再到测试的闭环工具链。
核心功能¶
插件提供以下能力：
* 多用户管理：支持为不同用户维护独立的生词库。
* 无感录入：监听剪贴板，复制后自动弹窗供用户点选入库，避免误录。
* LLM 辅助：自动翻译，并根据单词生成拆词、趣味梗和例句。
* 持久化与查询：数据落库 SQLite，支持按时间、频次、掌握度查询。
* 记忆卡片：生成 HTML/PDF/Word 格式的趣味记忆卡。
* 考试闭环：在线答题，连对 3 次自动标记掌握。
* 语音朗读：集成 Windows 自带语音（SAPI），离线朗读单词与例句。
* 拍照识别：支持标记印刷词并提取。
安装与启用¶
插件适配 DSH 0.2 及以上版本（0.1.7 亦兼容）。在 DSH 命令行执行以下命令进行安装：
dsh plugin --profile web add dsh-word-vault@1.0.2
安装完成后，根据 DSH 版本不同，设置面板的加载逻辑会有所差异（详见下文注意事项）。
录入流程¶
插件默认采用“剪贴板监听 + 弹窗点选”的交互模式，确保只有用户确认的单词才会落库。
- 监听：常驻助手（PowerShell）监听剪贴板变化。
- 切词：检测到文本后，由宿主切分单词。
- 弹窗：在鼠标位置弹出对话框，列出识别到的单词（如
plant world share animal）。 - 点选：用户点击对应用户名按钮进行入库。
- 反馈：同一窗口显示成功反馈（如“今日累计录入 12 词”），并在 20 秒内自动消失。
不落库的三种情况：
* 用户未进行点选操作。
* 用户点击“忽略”。
* 弹窗 20 秒内无人响应。
若习惯“复制即录”的手感，可在设置中开启 autoCommit 选项。
工具命令¶
插件提供了一系列工具命令，可用于对话或脚本调用：
- 录入：
wordvault_add- 将一段英文录入指定用户库（切词 -> 翻译 -> 落库）。 - 查询：
wordvault_query- 按时间区间、频次、掌握状态查询。 - 状态：
wordvault_status- 查看库统计、助手状态及最近日志。 - 出片：
wordvault_export_cards- 生成记忆卡 HTML / PDF / Word。 - 考试：
wordvault_exam_start- 启动在线答题页；wordvault_exam_result- 查看错题清单。 - 拍照：
wordvault_scan_photo- 识别照片中的标记词。
记忆卡与语音¶
记忆卡支持 HTML、PDF 和 Word 三种格式输出，每页 8 张（A4 竖版）。卡片内容包含词头、拆解块、荒诞梗（用于辅助记忆）以及 7 年级难度的英文例句。卡片与例句旁均设有 🔊 按钮，点击可使用 Windows 自带语音朗读（SAPI），支持后台预热以实现秒开。
考试闭环¶
在线答题采用单选题形式，题干为包含该词的英文句子，并询问词义。系统会自动计算掌握度，连对 3 次将标记为“已学会”。
注意事项¶
- DSH 版本兼容：
- DSH 0.2+：完整支持，包括浏览器端设置面板。
- DSH 0.1.5：工具和页面可用，但设置面板不会出现（因缺少
configForms服务）。 - DSH 0.1.7：兼容。
- 常驻助手：必须在 PowerShell 上运行。
- 语音依赖：朗读功能仅支持
en-*语言包，未安装时明确报错。 - 许可证：目前未提及具体许可证信息。
结语¶
dsh-word-vault 通过剪贴板监听与 LLM 结合，降低了生词录入的摩擦成本，并通过结构化的卡片与考试系统提供了可落地的复习方案。适合需要管理多语言知识库的开发者与学习者。
- 目录页：skillhub.cn
- 源码：github.com
