DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-word-learn

g

dsh-word-learn

Manifest valid

DSH English Vocabulary Learning Plugin: instant lookup on selection, word-frequency grading, and FSRS spaced-repetition review — built for developers who work in English.

UI (client)hasBundlePatchMachine translated

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/modelsAI 分析可用的文本模型(复用 DSH 模型目录)+ 当前选择
POST/dsh-word-learn/model选 AI 分析模型(provider,model;或 reset:true 回到第一个)
GET/dsh-word-learn/model-infoAI 分析当前实际用的模型 + 来源(兼容旧接口)
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/contractvitest(node 环境,*.test.mjs):宿主纯函数/模块契约、前端纯函数与 install 生命周期、产物契约
tests/componentvitest + jsdom + RTL(*.test.tsx),渲染 dist/client.js 里的真实组件
tests/integrationvitest(node 环境,*.test.ts):真实 ctx 桩 + 临时 DSH_HOME + 真实 node:sqlite
tests/support、tests/helpersvitest 测试基座、临时 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):

  1. pnpm build 只是把 src/host/** 编成 lib/host/**,磁盘上换新了;
  2. 但宿主模块是进程内 import() 进来的,Node 的 ESM 缓存活到进程结束 —— 重挂插件 (或往 profile 的 cordis.patch.yml 追注释触发 profile 重排)只会重跑 apply(), 不会重新解析模块,跑的还是旧代码;
  3. 本轮迁移把入口从 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

dsh-hover-dict

by hulibuld

在 DeepSeek Harness 里点选查词与翻译:点击或划选英文单词看释义,划选短语看翻译,生词本、词根词缀、同根词标注。离线词库,不改正文 DOM。

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Nov 2, 2026

dsh plugin --profile web add dsh-hover-dict

by lukebest

WordLink — 沉浸式英语阅读与词汇学习插件(DeepSeek Harness Web UI)

Manifest valid

★ 0

MIT

JavaScript

Nov 4, 2026

dsh plugin --profile web add dsh-wordlink

Rotating word and phrase flashcards under the composer, plus a right-sidebar page with an English topic brief, topic-matched vocabulary and a word book.

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-english-lounge

by bjcdeshu

Windows 全局划词助手:Cherry 同款取词基础,复用 DSH 模型翻译、解释与总结。MIT 开源。

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 2

MIT

JavaScript

Nov 4, 2026

dsh plugin --profile web add dsh-selection-assistant

by yingjian666

DeepSeek Harness (dsh) 插件:注入系统提示词,强制 Agent 的思维链 / 规划 / 工具推理全程使用简体中文,防止中文思考漂移为英文。零外部依赖,任意本地目录 link 即装。

Development & InfrastructureSessions & MessagesManifest valid

★ 24

MIT

JavaScript

Nov 18, 2026

dsh plugin --profile web add dsh-zh-thinking

by master1Sun

DSH(DeepSeek Harness)Web 插件:在 composer 工具栏注入一个「提示词库」按钮,管理可复用的 prompt 片段,点击即可插入当前输入框。支持自动学习:输入复杂 prompt 文案时,插件会自动识别并保存到提示词库。

UI & ExperienceManifest valid

★ 17

↓ 715/wk

MIT

TypeScript

Nov 18, 2026

dsh plugin --profile web add @sunjuntao/dsh-prompt-library