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

A CET-4 / CET-6 vocabulary trainer for the DeepSeek Harness (dsh) Web UI: a draggable, minimizable floating word-card window you can open any time — including while the model is thinking.

一个 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 show/hide the floating window (works even while typing), Alt+1 / Alt+2 switch card vs. quiz mode, Alt+R review the words due later, Alt+P practise 10 new words, Alt+X exit practice, Alt+S speak the current word; Space + 1/2/3 grade in card mode, 1-4 answer in quiz mode, → move to the next word after answering (a wrong answer stays on screen until you press it). Bare keys only fire while the window is open and no text field has focus, and any key the host already handled is left alone — the full list is in Settings. Alt+Q 展开/收起悬浮窗（输入框里也能用），Alt+1/Alt+2 切换卡片/选择题模式，Alt+R 复习稍后到期的词，Alt+P 加练 10 个生词，Alt+X 退出加练，Alt+S 朗读当前词；Space 翻面、1/2/3 评分、选择题 1-4 作答、答完按 → 进入下一个词（答错会停留，读完释义再按）。单键只在窗口展开且光标不在输入框时生效，宿主已处理的按键一律让路——设置里有完整键位指南。

Progress is stored in localStorage (per browser profile). 进度存于浏览器 localStorage。

Install / 安装

From any DSH plugin marketplace that mirrors the awesome-dsh-plugin catalog (e.g. dshmarket, dsh-plugin-mall), or directly / 或直接：

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

The package ships prebuilt client.js — no build step, no telemetry. Pronunciation streams one small mp3 per word from Youdao's dictionary audio on demand (cached by the browser); everything else works offline. 包内自带构建好的 client.js，无构建步骤、无遥测。发音按需流式加载有道词典音频（浏览器自带缓存），其余功能完全离线。

Build from source / 从源码构建

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

data/words.json is generated from ECDICT (scripts/build_words.py filters the cet4/cet6 tags); download the ECDICT release CSV to data/ecdict.csv to regenerate it.

Release / 发版

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

One command runs the whole chain: sync the three i18n places, bump the version, rebuild client.js, smoke-test the working copy, pack, unpack the tarball and smoke-test it again (byte-comparing client.js against the build), install the tarball into a throwaway DSH profile through the real CLI, then commit, tag, publish a GitHub Release and publish to npm — verifying both channels afterwards. 一条命令跑完整条发版链路，失败时会还原 dry-run 产生的临时改动。

script	what it does
scripts/release.mjs	the one-command release above (--dry-run, --no-npm, --no-github, --skip-smoke, …)
scripts/build_client.mjs	embeds data/words.json into client.js and syntax-checks the result
scripts/sync_locale.mjs [--check]	keeps locale/zh.json + locale/en.json identical to the inline dictionaries in client.src.js
scripts/smoke_release_install.mjs [dir] [reference client.js]	56–57 structural checks: package fields, shell.overlay registration, locale wiring, embedded word list

Requirements: an authenticated gh, and an npm granular access token with “Bypass 2FA” enabled (npm requires 2FA, or such a token, to publish) supplied via --token-file or NPM_TOKEN_FILE. GitHub traffic uses the proxy from --proxy (default http://127.0.0.1:7897); npm is deliberately called without a proxy. The npm credential is written to a temporary userconfig and deleted afterwards — ~/.npmrc is never touched. 需要已登录的 gh，以及开启 Bypass 2FA 的 npm granular token；GitHub 走代理、npm 不走代理，凭据只落在临时配置里且用完即删。

Changelog / 更新记录

0.2.2

• Keyboard shortcuts / 快捷键 — Alt+Q shows or hides the window (works even while typing), Alt+1 / Alt+2 switch card vs. quiz, Alt+R review, Alt+P extra practice, Alt+X exit practice, Alt+S speak the word; Space flips, 1/2/3 grade, 1–4 answer, → moves to the next word. Bare keys stay inert while a text field has focus or the window is closed, and any key the host already handled is left alone. The full list is in Settings. 全套快捷键，设置页附键位指南。
• Leaner settings / 设置页瘦身 — the word book, daily quota and accent now live on a single 「学习」 sub-page; the separate 「自定义」 row is gone and its number box sits inline at the end of the daily-quota row. 词库/每日新词/发音口音收进「学习」二级页，自定义输入框并入每日新词行。
• Quiz fixes / 选择题修正 — options and the feedback line show the whole definition (the 46-character cut is gone), and a wrong answer now stays on screen instead of auto-advancing after 1.2 s: press → or the new 「下一个」 button to continue. 释义不再截断；答错会停留，按 → 或「下一个」继续。
• Resizable / 可缩放 — drag the corner grip to scale the entire window, text and spacing included, from 70% to 200%; double-click the grip to reset, and the size is remembered. 拖动右下角手柄整体缩放，双击复位，尺寸持久化。

0.2.1

Publishable npm package (dropped private, declared engines.dsh); locale/*.json aligned with the inline dictionaries.

0.2.0

Online human US/UK pronunciation fetched per word, with speechSynthesis as the offline fallback — no Windows voice pack or admin rights needed. 在线真人美式/英式发音，无需语音包与管理员权限。

Data license / 词库来源

The word list is extracted from ECDICT (MIT License, © skywind3000). Everything else is MIT — see LICENSE.

License / 许可

MIT