四六级背单词 zhuran305-web/dsh-cet-vocab

dsh-cet-vocab / 背单词（四六级）

一个 DeepSeek Harness（dsh）Web 界面的四六级背单词悬浮窗：可拖动、可最小化，随时点开背单词——包括模型思考的空档期。

Features / 功能

- Word list / 词库 — 5,805 words (CET-4 3,849 / CET-6 5,407, deduplicated), extracted from ECDICT by tag and sorted by frequency. The list is bundled into the client, so the plugin works fully offline. 词库按 cet4/cet6 标签从 ECDICT 提取、按词频排序，内嵌进前端，运行时不需要网络。
- Two study modes / 两种模式 — flip-card with three-button grading (known / fuzzy / unknown), or multiple-choice quiz with distractors picked from confusable words (edit distance, shared prefix/suffix/bigrams). 翻卡三键评分（认识/模糊/不认识），或形近词干扰项的选择题模式。
- Spaced repetition / 间隔复习 — Ebbinghaus-style ladder (10 min → 1 d → 2 d → 4 d → 8 d → 16 d); failed cards reset and re-queue after 10 minutes. 艾宾浩斯阶梯复习，答错 10 分钟后重新进队。
- Daily plan / 每日计划 — configurable daily new-word quota (0–500); today's review count shown on the pill badge. 每日新词数可自定义（0–500），药丸徽标显示今日待复习数。
- Review / extra practice / 复习与加练 — when today's quota is done, review due cards (≤20) or practice 10 unseen words; practice results don't consume the quota. 完成当日额度后可复习到期词或加练未学词，不计额度。
- Auto-open / 思考时自动弹出 — opens the window automatically whenever a session starts running; toggleable in settings. 检测到会话运行时自动弹出窗口，可在设置中关闭。
- Pronunciation / 发音 — real human US/UK recordings fetched per word from Youdao's open dictionary audio (accent selectable: auto / US / UK), with the browser's speechSynthesis as the offline fallback — no Windows voice pack or admin rights needed. 每个词实时取有道词典的真人美式/英式发音（口音可选：自动/美式/英式），断网时自动回落到系统语音合成——不需要安装任何 Windows 语音包，也不需要管理员权限。
- Window / 窗口 — draggable with pointer capture and edge clamping, minimizes to a badge pill that stays where you left it; geometry persisted. 拖动带边界钳制，最小化成药丸且停在原地，几何持久化。
- Stats & settings / 统计与设置 — per-book progress and streaks; switch between CET-4 / CET-6 / all books. 各词书进度统计，可切换四级/六级/全部词库。
- Resizable / 可缩放 — drag the corner grip to scale the whole card (text, spacing and all) from 70% to 200%; double-click the grip to reset. The size is remembered. 拖动右下角手柄整体缩放（文字同步变大变小，70%–200%），双击手柄复位，尺寸会被记住。
- Keyboard / 快捷键 — Alt+Q 展开/收起悬浮窗（输入框里也能用），Alt+1/Alt+2 切换卡片/选择题模式，Alt+R 复习稍后到期的词，Alt+P 加练 10 个生词，Alt+X 退出加练，Alt+S 朗读当前词；Space 翻面、1/2/3 评分、选择题 1-4 作答、答完按 → 进入下一个词（答错会停留，读完释义再按）。单键只在窗口展开且光标不在输入框时生效，宿主已处理的按键一律让路——设置里有完整键位指南。

进度存于浏览器 localStorage。

Install / 安装

从任意镜像 awesome-dsh-plugin 目录的 DSH 插件市场安装（例如 dshmarket、dsh-plugin-mall），或直接：

dsh plugin add dsh-cet-vocab # from npm
dsh plugin add "https://github.com/zhuran305-web/dsh-cet-vocab/releases/latest/download/dsh-cet-vocab.tgz" # from GitHub Releases

包内自带构建好的 client.js，无构建步骤、无遥测。发音按需流式加载有道词典音频（浏览器自带缓存），其余功能完全离线。

Build from source / 从源码构建

node scripts/build_client.mjs # embeds data/words.json into client.js

data/words.json 由 ECDICT 生成（scripts/build_words.py 筛选 cet4/cet6 标签）；下载 ECDICT 的 release CSV 到 data/ecdict.csv 即可重新生成。

Release / 发版

node scripts/release.mjs 0.2.2 --dry-run # 彩排：构建/冒烟/打包/解包复核/临时 profile 安装验证，然后自动还原
node scripts/release.mjs 0.2.2 # 正式发版：提交推送 → tag → GitHub Release → npm publish → 核验

一条命令跑完整条发版链路：同步三处 i18n 文案、升版本号、重建 client.js、对工作副本做冒烟测试、打包、解包 tarball 再冒烟测试一遍（把 client.js 与构建产物逐字节比对）、通过真实命令行把 tarball 装进临时 DSH 配置档，然后提交、打 tag、发布 GitHub Release 并发布到 npm——最后核验两个渠道。失败时会还原 dry-run 产生的临时改动。

| script | what it does |
| scripts/release.mjs | 上面那条一键发版命令（--dry-run、--no-npm、--no-github、--skip-smoke 等） |
| scripts/build_client.mjs | 把 data/words.json 嵌入 client.js，并对结果做语法检查 |
| scripts/sync_locale.mjs [--check] | 让 locale/zh.json + locale/en.json 与 client.src.js 里的内联字典保持一致 |
| scripts/smoke_release_install.mjs [dir] [reference client.js] | 56–57 项结构检查：包字段、shell.overlay 注册、locale 接线、内嵌词表 |

要求：已登录的 gh，以及 npm granular access token，并开启「Bypass 2FA」（npm 发布要求 2FA 或这类 token），通过 --token-file 或 NPM_TOKEN_FILE 传入。GitHub 流量走 --proxy 指定的代理（默认 http://127.0.0.1:7897）；npm 则刻意不走代理。npm 凭据写入临时 userconfig，用完即删 —— 绝不碰 ~/.npmrc。需要已登录的 gh，以及开启 Bypass 2FA 的 npm granular token；GitHub 走代理、npm 不走代理，凭据只落在临时配置里且用完即删。

Changelog / 更新记录

0.2.2

- Keyboard shortcuts / 快捷键 — Alt+Q 显示或隐藏窗口（打字时也生效），Alt+1 / Alt+2 切换卡片与测验，Alt+R 复习，Alt+P 额外练习，Alt+X 退出练习，Alt+S 朗读单词；Space 翻面，1/2/3 评分，1–4 作答，→ 跳到下一个词。文本框获得焦点或窗口关闭时，裸键保持无响应；宿主已处理的按键一律不碰。完整列表在设置里。全套快捷键，设置页附键位指南。
- Leaner settings / 设置页瘦身 — 词库、每日配额和口音现在收在同一个「学习」子页；单独的「自定义」行已移除，数字框内联在每日配额行末尾。词库/每日新词/发音口音收进「学习」二级页，自定义输入框并入每日新词行。
- Quiz fixes / 选择题修正 — 选项和反馈行显示完整释义（46 字符截断已去掉），答错后不再 1.2 s 自动跳转，而是停在屏幕上：按 → 或新的「下一个」按钮继续。释义不再截断；答错会停留，按 → 或「下一个」继续。
- Resizable / 可缩放 — 拖动角上的手柄整体缩放窗口，文字和间距一起缩放，范围 70% 到 200%；双击手柄复位，尺寸会被记住。拖动右下角手柄整体缩放，双击复位，尺寸持久化。

0.2.1

可发布的 npm 包（去掉 private，声明 engines.dsh）；locale/*.json 与内联字典对齐。

0.2.0

按单词在线获取真人美式/英式发音，离线回退用 speechSynthesis —— 不需要 Windows 语音包，也不需要管理员权限。在线真人美式/英式发音，无需语音包与管理员权限。

Data license / 词库来源

词表提取自 ECDICT（MIT License，© skywind3000）。其余部分均为 MIT —— 见 LICENSE。

License / 许可

MIT