wangzhanchao883/dsh-word-vault ↗★ 0
dsh-word-vault
英语生词库 · 多用户单词助手:拖选双击Ctrl/F9 秒录生词、拍照标记词识别、LLM 翻译落 SQLite,按录入时间/出现次数/已学会维度出趣味记忆卡(Word/HTML/PDF)并支持英译汉单选考试闭环。 适合需要快速录入生词、生成记忆卡并进行复习测试的用户。
インストール
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:wangzhanchao883/dsh-word-vaultドキュメント
README 全文を読む ↗P5.3 使用说明页 + 设置表单（已完成）
| 页面 | 路由 | 内容 |
|---|---|---|
| 词库 | GET /word-vault | 总览 + 写操作 + 动作（P5.1 / P5.2） |
| 使用说明 | GET /word-vault/help | 四种录入方式、三个视图口径、三个动作按钮、掌握度规则、写操作与安全、常见问题 |
| 设置 | GET /word-vault/settings | 18 个设置项按五组（复习口径 / 录入 / 记忆卡 / 考试 / 照片）成表单，每项带说明与配置键；「保存本组」只提交改动过的字段 |
三个页面共用导航条，互相可达。
设置是真写（不是摆设）：宿主侧用 ctx.settings.update(ns, patch) 把改动合并进该命名空间的用户分节（官方 subsystems/settings.md 的 owner scope 写入路径），因此：
- 与 DSH 原生设置页（插件配置 · dsh-word-vault）读写同一份配置，不存在两套真相
- 写入会触发本插件已有的
scope.watch(...)→liveConfig热更新 → 需要时自动重启常驻助手（实测：改highFreqMin+photoPadUp后助手自动重启） - 页面只允许提交
SETTINGS_SPEC里列出的键（防手滑写坏未知字段：未知键回 400） settings服务不可用时（如 headless 场景）页面读写回 501 + 可读说明，而不是静默失败
路径类字段：设置页底部给「📁 打开输出目录 / 📁 打开照片目录」两个按钮，直接调系统默认程序打开，省得手打路径。
9. 配置（settings 命名空间 dsh-word-vault）
| 键 | 默认 | 说明 |
|---|---|---|
enabled | true | 总开关 |
dbPath | D:\workout\AI助理\英语趣味单词\单词库\words.db | 库文件 |
wordsDir / outputDir / imageDir | 既有 英语趣味单词\ 目录约定 | 词表 JSON / 产物 / 剪贴板截图 |
provider / model | deepseek-official / deepseek-v4-flash | 翻译与后续卡片生成 |
autoTranslate | true | 录入即翻译（关掉只记词形） |
defaultUser | 用户1 | autoCommit=true 时的归属 |
users | 用户1 / 用户2 | 多用户列表（弹窗按钮按它生成） |
helperEnabled | true | 是否常驻助手 |
autoCommit | false | 复制后是否直接入默认库（默认关：必须点选） |
promptTimeoutMs | 20000 | 弹窗等待上限，超时丢弃（0=一直等） |
showDialog | true | 是否显示点选弹窗 |
showFloatWindow | true | 常驻小条（监听状态 + 今日累计） |
clipPollMs | 350 | 剪贴板轮询间隔 |
minLen / maxLen | 2 / 400 | 忽略过短与过长文本 |
floatOffsetX/Y | 40 / 40 | 小条默认位置：距屏幕右边缘 / 距顶部的像素偏移（不是绝对坐标）；拖动后以记住的位置为准 |
floatAutoHide | false | 小贴鼠标移开后淡化 |
watchImages | true | 剪贴板图片也交给插件（P4 拍照通道用） |
keepPhrases | true | 2~5 词短文本另存一条「词组」 |
maxWordsPerCapture | 30 | 单次录入最多收多少词 |
extraStopwords | [] | 追加停用词 |
highFreqMin | 2 | 高频词门槛：累计被标记（录入）达到这个次数就算高频，查询/出片据此标记与筛选 |
cardsTitle / cardsSubtitle | 趣味单词记忆卡 / （空=自动） | 记忆卡页眉文案 |
cardsBatchSize | 8 | 记忆卡内容每次交给模型几个词 |
examCount | 10 | 默认出多少题 |
examRecheckRatio | 0.1 | 已学会词混入复查的比例（答错自动摘牌） |
examMinutes | 30 | 答题页空闲多久自动关闭（分钟） |
examBatchSize | 6 | 出题时每次交给模型几个词 |
photoDir | 英语趣味单词\拍照 | 照片目录（可直接往里丢照片，也可以在对话里发图） |
photoOutDir | 英语趣味单词\拍照处理 | 裁剪块与联络图落盘目录 |
photoRecursive | true | 是否递归扫子目录 |
photoKeepCrops | true | 是否保留逐块裁剪 PNG（联络图总是保留） |
photoSatMin | 40 | 算作「标记墨迹」的最低饱和度（荧光笔/红笔饱和，铅笔不饱和） |
photoPadUp | 30 | 裁剪上扩像素（红线在词下方，必须把词带进来） |
photoMaxCropH | 160 | 单个裁剪块的最大高度 |
photoMinDarkSpread | 0.45 | 裁剪块内印刷黑字至少铺开多少比例的列（剔空白边距/插图） |
photoMaxPerRun | 8 | 每次最多处理几张新照片 |
使用说明页与设置表单(P5.3)、客户端设置面板(P5.4:内核契约/字段一致性守卫/主题变量)
powershell.exe -NoProfile -ExecutionPolicy Bypass -File test/helper-clipboard.ps1