dsh-word-vault

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