dsh-word-learn
Manifest validDSH English Vocabulary Learning Plugin: instant lookup on selection, word-frequency grading, and FSRS spaced-repetition review — built for developers who work in English.
dsh-word-learn · 划词学单词
在 DSH 对话里划中任意英文单词,就地浮出学习卡:音标、释义、词形变化、词频分级、 真人发音、例句与近义词。查过的词自动进生词本,P2 起接 FSRS 间隔重复复习。
面向的场景很具体:以英语为工作语言的开发者,读英文技术内容时靠模型的思维链。 这类人的问题不是"没背过单词",而是"一个词只认得它在某处的那一个意思", 并且读得准不准自己也不知道。
它和划词翻译有什么不同
| 划词翻译 | 本插件 | |
|---|---|---|
| 目标 | 让你看懂这句话 | 让你记住这个词 |
| 结果 | 译文,看完就忘 | 生词本 + 复习排期 |
| 对常见词 | 照样翻译 | 标出"这是高频词,你多半已认识" |
| 数据 | 无 | 本地 SQLite,可导出 |
已实现(P1)
- 划词卡片:选中即查,不修改页面 DOM,纯浮层
- 只对对话正文生效:选区两端必须落在
[data-chat-flow]里(Chat 视图正文列)。 左侧栏、右侧栏、轨迹(Trajectory)页、英语学习看板一律不响应。 严格模式:锚点找不到就完全不弹,不会退回"全页面乱弹"。 改动前先跑npx vitest run tests/features/scope.test.mjs(范围判定与排除名单的单一来源在src/client/features/core.js,改这里必跑) - 划句子给译文:选中整句时先给中文译文,下面再列可拆的候选词。
优先用 DSH 自己的模型翻(技术语境更准,
reviews→复习、latent space→潜空间), 模型不可用时降级到 MyMemory 公共接口;翻译挂了也不影响拆词 - 本地词典:ECDICT 精简为 14.4 MB SQLite,59,111 词条 + 39,053 变形索引,离线可查
- 变形回退:
children→child、better→good、perceived→perceive, 并继承原形的词频(ECDICT 把变形词单独立条,词频字段常常是错的) - 词频分级:最高频 1000 / 高频 3000 / 常用 8000 / 低频 / 专业词
- 代码过滤:
src/lib/index.js、config_path、getElementById不会被当成单词 - 数值后缀过滤:
≈62.3M、≈65.7k不会被当成单词M/k(前端与宿主路由两处都设了闸,见 DESIGN.md 风险 18) - 真人发音 + 例句:例句来自 dictionaryapi.dev(带磁盘缓存,拿不到就降级,不影响查词);
发音走浏览器内置语音(
src/client/features/voice.js→speechSynthesis):零网络、离线可用, 优先挑系统里的 natural/online 英文音色,选中的音色与语速记在本地。 浏览器不允许录制合成结果,所以没有音频文件缓存——每次都是本机实时合成 - 自动发音(可关):进入学习页、单词出现时自动读一遍;看答案(忘了/模糊)和 拼写结果出来时再读一遍,营造"边看边听"的环境。喇叭图标随时可以手动重听, 自动播放出错不会弹提示。开关在 设置 → 发音偏好 → 自动发音
- 生词本:记原句、遇见次数、五维能力画像(认得/意思/能写/能听/读准)、收藏、笔记
- 易混淆词可悬浮查义:学习页和 AI 分析里的易混淆词/近义词是虚线小标签, 鼠标停留(或点一下)浮出音标 + 释义,卡片里一键 加入生词本; 悬浮只是预览,不会把扫过的词都塞进生词本
- 跟随 DSH 主题:颜色取 DSH 的主题令牌(
--dsw-alias-*),明暗切换自动跟随,无需重启 - AI 分析模型可换:词根拆解/干扰项/记忆法用哪个模型,在设置页从 DSH 已有的文本模型列表里选, 默认用第一个;不跟随对话的默认模型,改完下一次分析立刻生效
- 分析失败给原因:拿不到模型服务、没配 Key、限流、输出不是 JSON 会分别报出来, 不再一律显示"可能是模型不可用"
- 信任栅栏:跨站请求一律 403
学习页(P2a)
左栏上半部分有「英语学习」入口,点开是整页面板:
- 今日复习:到期队列,直接评「忘了 / 勉强 / 记得 / 太简单」,写回 FSRS 排期
- 明日到期:按当前排期算出明天有多少
- 未来 14 天预测 / 近 14 天复习量:两张柱状图
- 学习进度:按词频档位的堆叠条 + 已开始排期比例
- 能力画像:五维(认得/意思/能写/能听/读准)各自的 0-5 分布直方图
- 报表:正确率与作答分布、最容易忘的词、最近遇到
排期用 FSRS-6(ts-fsrs@6.0.0,MIT),每个词两条独立线:
认得出(receptive)与写得出(productive)。
- 写得出要等认得出稳了才上线:receptive 进入复习态(
state>=2)且评过至少 2 次, productive 才排进队列。查词建卡时 productive 只是先把结构建好,不进队列。 - 一个词一轮只出现一次:两条线同一天到期时,先做更早到期的那张(同 due 时先认得出), 另一张留到下一轮;看板的今日/明日/预测也按词去重。 连着把同一个词做两遍是 massed practice,不是间隔重复——早先的实现漏了这两条, 所以会出现"刚背完一个词,下一张还是它"。
- 两条线练的东西不一样:认得出给英文、选释义;写得出给中文释义、把单词拼出来 (提交后对照正确拼写,拼对/笔误/写错分别算 太简单/记得/忘了)。
- 一个词反复忘到 8 次会自动挂起(leech),不再进队列消耗耐心。
- 「忘了」不是直接给答案:先自己写一次意思 → 对照释义和原句 → 把词拼对一次,
才评 Again(1)。单词在拼写阶段被藏起来,喇叭和跳过也一并收起。
这一步只增加提取与产出,不改变评级——补记成功照样评「忘了」,
免得骗过 FSRS 把间隔拉长(见
design/forgot-repair-loop.md)。 - 有义项材料时先做四选一:AI 按「这个词 + 你遇见它的原句」生成义项材料后, 「忘了」会先让你从四个义项里选「这句里是哪个」,再给「你选的是 X / 这句里是 Y」 的反差,然后才进拼写。分析还没跑完时自动退回上面的自由回忆。
- 会话末补记:今天评过「忘了」的词,在这轮结束前再拼一次;拼对才清掉那笔 「补记债」。统计页有「补记循环」面板,看义项首猜命中率与债的清偿。
- 次日回访(R5):第二天进学习页,先花一分钟做「昨天忘过的词,这两句里同一个意思吗」 —— 同义/异义各半,答对清债、答错重开债,只记日志、不动 FSRS。可「跳过回访」。
- 对话内联标注:你在读的英文里,在学、有卡片的词会带一条虚线下划线;
悬停/聚焦出小卡(这个词在这句里的义项 + 「收进复习」)。原文不改、不翻译,
代码块、行内代码、文件名、URL、链接、弹窗、其它插件界面都不标。
折叠着的内容只标标题,展开后才补标;流式生成中的文字不碰。
关掉:控制台
localStorage['dwl-annotate'] = 'off'后刷新。
看板上的「正确率」是本插件自己定的口径(「记得/太简单」算对), 不是 FSRS 的官方指标。
数据位置
| 文件 | 位置 | 说明 |
|---|---|---|
| 词典 | <插件目录>/data/ecdict.db | 只读,可重新生成 |
| 生词本 | $DSH_HOME/dsh-word-learn/user.db | 不可再生,请备份 |
| 外部缓存 | $DSH_HOME/dsh-word-learn/cache/ | 可删 |
重新生成词典
# 1) 下载 ECDICT(63 MB)
curl -L -o D:\dsh-cache\tmp\ecdict.csv https://raw.githubusercontent.com/skywind3000/ECDICT/master/ecdict.csv
# 2) 构建
python scripts\build_dict.py
接口
前端(划词卡 / 标注 / 学习页)全部在 dist/client.js 一个产物里,由宿主按
package.json 的 exports["./client"] 加载 —— 没有前端脚本路由,也没有页面注入。
宿主入口是 package.json 的 exports["."] → lib/host/index.js(src/host/index.ts
经 tsc -p tsconfig.host.json 的产物;源码在 src/host/**)。
下面 22 条数据面接口的路径以 src/host/routes/paths.ts 为唯一出口;写操作只接受表里
声明的方法(其余方法 405 + Allow 头),跨站请求一律 403。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET/POST | /dsh-word-learn/lookup | 查词(word, sentence, enrich) |
| GET/POST | /dsh-word-learn/translate | 整句翻译(text),永远回 200 + ok |
| POST | /dsh-word-learn/save | 拆词(text) |
| GET | /dsh-word-learn/list | 生词本(limit, offset, tier, starred, order) |
| POST | /dsh-word-learn/update | 改画像/收藏/笔记 |
| POST | /dsh-word-learn/remove | 移除 |
| GET | /dsh-word-learn/dashboard | 学习页全部聚合数据(days) |
| GET | /dsh-word-learn/queue | 今日到期队列(limit, track) |
| POST | /dsh-word-learn/grade | 提交评分(cardId, rating 1-4) |
| GET | /dsh-word-learn/word | 单词详情 + 两条线状态(word) |
| GET | /dsh-word-learn/models | AI 分析可用的文本模型(复用 DSH 模型目录)+ 当前选择 |
| POST | /dsh-word-learn/model | 选 AI 分析模型(provider,model;或 reset:true 回到第一个) |
| GET | /dsh-word-learn/model-info | AI 分析当前实际用的模型 + 来源(兼容旧接口) |
| POST | /dsh-word-learn/enrich-ai | 手动触发/补 AI 分析(word, force, field) |
| GET | /dsh-word-learn/quiz | 生成选择题(word) |
| GET | /dsh-word-learn/repair | 补记卡材料(cardId) |
| POST | /dsh-word-learn/repair/log | 记一条补记尝试(cardId, stage, ok, guess, elapsedMs) |
| POST | /dsh-word-learn/repair/clear | 清补记债(wordId 或 cardId) |
| GET | /dsh-word-learn/repair/stats | 补记统计(days 1–90,默认 14) |
| GET/POST | /dsh-word-learn/repair/recap | 次日回访:GET 取题(limit ≤10),POST 提交(wordId 等) |
| GET | /dsh-word-learn/sense-map | 义项地图(word) |
| GET | /dsh-word-learn/annotate/words | 标注目标词表(limit 默认 2000,1–5000) |
开发
先读
AGENTS.md(改代码前的硬约束、「改 X 去哪里」定位表)和CONVENTIONS.md(工程规范:目录边界、路由契约、数据访问、测试纪律)。 交付前跑pnpm verify—— 本插件唯一的验收命令:build(tsdown 打客户端 + tsc 编宿主)→artifact:check→check:tarball→check(typecheck / lint / format:check / deps:check) →test(unit / unit:coverage / component,vitest 同时收 component 与 integration)。 具体任务的提示词模板在prompts/:fix-bug/add-route/edit-frontend/refactor-module/write-test。
目录结构
| 路径 | 说明 |
|---|---|
src/client/** | 前端源码(划词卡、标注、学习页)。tsdown 打成 dist/client.js(+ 外部 .map) |
src/host/** | 宿主源码(插件入口 index.ts、路由、词典/用户库/FSRS/AI 分析)。tsc 编到 lib/host/** |
dist/ | 客户端产物(gitignore,pnpm build 生成) |
lib/host/ | 宿主产物(gitignore,pnpm build 生成) |
tests/unit、tests/features、tests/contract | vitest(node 环境,*.test.mjs):宿主纯函数/模块契约、前端纯函数与 install 生命周期、产物契约 |
tests/component | vitest + jsdom + RTL(*.test.tsx),渲染 dist/client.js 里的真实组件 |
tests/integration | vitest(node 环境,*.test.ts):真实 ctx 桩 + 临时 DSH_HOME + 真实 node:sqlite |
tests/support、tests/helpers | vitest 测试基座、临时 DSH_HOME 助手 |
data/ecdict.db | 精简词典(构建产物,见「重新生成词典」) |
常用命令
# 构建:客户端 bundle + 宿主 tsc 产物,两个都要
pnpm build # tsdown -> dist/client.js(+.map);tsc -p tsconfig.host.json -> lib/host/**
pnpm dev # tsdown --watch(只重建客户端)
pnpm build:host # 只编宿主(tsc -p tsconfig.host.json -> lib/host/**)
# 类型与静态检测
pnpm typecheck # tsc --noEmit(src/**,含宿主 TS)+ tsc -p tsconfig.host.json --noEmit
pnpm lint # eslint .
pnpm lint:fix
pnpm format # prettier --write .
pnpm format:check
pnpm deps:check # dependency-cruiser:环 + 分层方向 + 客户端不碰 node: 内建
# 测试全部由 vitest 一个 runner 跑(unit/features/contract 走 node 环境,component 走 jsdom)
pnpm test # 全量 + 覆盖率门槛(= npx vitest run --coverage)
pnpm test:unit # 单元/特性/契约
pnpm test:component # 组件层(渲染 dist/client.js 真实组件)
pnpm test:integration # 集成层(真实 ctx 桩 + 临时 DSH_HOME,不碰真实用户库)
# 只跑某一条
npx vitest run tests/integration/routes.test.ts
# 产物契约(单 factory / id / 无 node: / sourcemap / 体积预算 / locale)
pnpm artifact:check
pnpm check:tarball
# 全部测试 / 交付前唯一验收
pnpm test # vitest run --coverage:26 个文件 318 条用例 + 覆盖率门槛
pnpm verify # build + artifact:check + check:tarball + check + test
本地 link 安装后必须先
pnpm build:DSH 从exports["."](lib/host/index.js) 加载宿主入口、从exports["./client"](dist/client.js)读客户端产物, 产物缺失时宿主会报run pnpm run build before launch。覆盖率口径(2026-11-06 起统一):
vitest --coverage量lib/host/**/*.js(宿主编译产物, 也就是运行期真正加载的那份),全局门槛行 70% / 分支 62% / 函数 78%(实测 72.9/66.3/81.5), 另有lib/host/{http,text,models}.js三个关键文件 95/85/95。 客户端不计入覆盖率门禁:组件测试渲染的是dist/client.js产物,jsdom 又覆盖不到 布局/悬停/滚动分支,硬卡行数只会逼出针对 jsdom 的假测试(ADR-0005)。
改哪一半、要不要重启
| 改什么 | 怎么生效 |
|---|---|
src/client/**(前端全部源码) | pnpm build(或 pnpm dev 常驻)重建 dist/client.js → 平台 client-hmr 轮询发现变化 → 自动重载模块;不需要刷新或重启(但面板会重挂,学习页退回首页,重点一次侧栏「英语学习」即可) |
src/host/**(宿主路由 / 数据面) | pnpm build(tsc 把源码编到 lib/host/**)→ 重挂插件(或重启宿主)后生效。宿主侧没有 mtime 热重载保证,别指望保存即生效 |
lib/host/**、dist/** | 构建产物(gitignore),不要手改;只改 src/**,然后重新 pnpm build |
阶段 2 起没有注入链:划词卡、标注层、学习页都在同一个 bundle 里用 import 组装,
apply() 里 ctx.effect(installWordcard) / ctx.effect(installAnnotate) 装卸,
不存在「脚本晚到 / 依赖取不到」的竞态,也就没有了「正在加载」兜底和 window.__dwl* 全局。
改生效范围之后怎么验:npx vitest run tests/features/scope.test.mjs 直接 import
src/client/features/core.js(纯判定模块)和 annotate 的 internals,
用真实模块导出的函数/名单求值(不是复制一份逻辑),覆盖「对话正文该生效」与
「左栏/右栏/对话面板根不该生效」两组。真机验证见下面「怎么确认划词范围生效」。
改了 src/host/** 必须重启 dsh(2026-11-06 实测,见 docs/plans/2026-11-05-build-migration.md):
pnpm build只是把src/host/**编成lib/host/**,磁盘上换新了;- 但宿主模块是进程内
import()进来的,Node 的 ESM 缓存活到进程结束 —— 重挂插件 (或往 profile 的cordis.patch.yml追注释触发 profile 重排)只会重跑apply(), 不会重新解析模块,跑的还是旧代码; - 本轮迁移把入口从
lib/index.js换成了lib/host/index.js,入口解析也只发生在加载时, 所以必须重启一次。
判据(重启后自检):GET /dsh-word-learn/lookup?word=throughput 返回 ok:true 且
dict.senses.length > 0;新加的 POST 路由返回 401/403(信任栅栏,说明已挂上)而不是 404/405。
如果没重启就改宿主,症状是「代码改了、测试也过了、真机行为没变」。
⚠️ 首次给插件加 dsh.client 段必须重启宿主:dsh-client-modules 会把
"这个包不是 client 包"的否定结论缓存起来,HMR 不刷新该缓存。重启一次之后,
改 src/client/** 就恢复 mtime 热重载。
怎么确认学习页挂上了(别按直觉拼 URL):看 __DSH_BOOT__.entries 里有没有
dsh-word-learn —— 这是权威信号。有的话,用清单里的 url 字段去取脚本,
形态是 /plugins/??dsh-word-learn/client.js&rev=<hash>(?? 是模块加载器的分隔符)。
/plugins/dsh-word-learn/client.js 这种拼法一定 404。
怎么确认划词范围生效:在 DSH 页面控制台跑下面这段,然后在左栏划一次、 再去对话正文划一次:
document.addEventListener(
'mouseup',
() => {
const r = window.getSelection().getRangeAt(0)
const at = (n) => !!(n.nodeType === 1 ? n : n.parentElement)?.closest('[data-chat-flow]')
console.log('两端在对话正文内:', at(r.startContainer), at(r.endContainer))
},
true,
)
左栏应打出 false false(卡片不弹),对话正文应打出 true true(卡片弹出)。
许可
本插件 MIT。词典数据来自 ECDICT(MIT)。
例句来自 dictionaryapi.dev;发音用浏览器内置的
Web Speech API(speechSynthesis),不经过任何第三方服务。
Comments
Loading…
Similar plugins
by hulibuld
在 DeepSeek Harness 里点选查词与翻译:点击或划选英文单词看释义,划选短语看翻译,生词本、词根词缀、同根词标注。离线词库,不改正文 DOM。
★ 0
MIT
JavaScript
Nov 2, 2026
dsh plugin --profile web add dsh-hover-dictby lukebest
WordLink — 沉浸式英语阅读与词汇学习插件(DeepSeek Harness Web UI)
★ 0
MIT
JavaScript
Nov 4, 2026
dsh plugin --profile web add dsh-wordlinkRotating word and phrase flashcards under the composer, plus a right-sidebar page with an English topic brief, topic-matched vocabulary and a word book.
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-english-loungeby bjcdeshu
Windows 全局划词助手:Cherry 同款取词基础,复用 DSH 模型翻译、解释与总结。MIT 开源。
★ 2
MIT
JavaScript
Nov 4, 2026
dsh plugin --profile web add dsh-selection-assistantby yingjian666
DeepSeek Harness (dsh) 插件:注入系统提示词,强制 Agent 的思维链 / 规划 / 工具推理全程使用简体中文,防止中文思考漂移为英文。零外部依赖,任意本地目录 link 即装。
★ 24
MIT
JavaScript
Nov 18, 2026
dsh plugin --profile web add dsh-zh-thinkingby master1Sun
DSH(DeepSeek Harness)Web 插件:在 composer 工具栏注入一个「提示词库」按钮,管理可复用的 prompt 片段,点击即可插入当前输入框。支持自动学习:输入复杂 prompt 文案时,插件会自动识别并保存到提示词库。
★ 17
↓ 715/wk
MIT
TypeScript
Nov 18, 2026
dsh plugin --profile web add @sunjuntao/dsh-prompt-library