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.6

• 双向边界适应 / Both-axis fitting — 悬浮按钮与展开卡片现在横向、纵向都按当前视口钳制：大屏拖到边缘后缩小窗口、或拖到屏幕下方，按钮都会自动回到可见区域，不会消失；最小化/展开时同样生效。Floating pieces are clamped on both axes, so shrinking the viewport (or dragging near the bottom) never strands the button off screen.
• 贴边不留空、开关不消失 / No gap, toggle intact — 右侧边界已计入朗读开关位与边距，贴边时右边缘正好落在边界内侧；挤压态不再隐藏朗读开关。The right bound now accounts for the toggle slot and edge pad, and the reader toggle stays visible when squeezed.
• 拖动连续自适应 / Continuous reflow — 宽度改由 CSS 变量驱动，拖动过程中文字实时逐字压成一列，松手不跳变。Width is driven by a CSS variable, so the label reflows continuously while dragging.

0.2.5

• 边界适应 / Edge-aware window — 悬浮按钮拖到屏幕右侧后点开，卡片按 384 × 缩放 的真实视觉宽度自动内收，不再溢出右边界；不改动已保存的位置，收起后仍在原处；DSH 侧栏或窗口尺寸变化时实时重算。The expanded card now fits itself inside the viewport by its real scaled width, without moving the saved pill position, and re-fits on viewport resize.
• 真实挤压 / Squeeze, don't swap — 贴边时按钮文字被空间逐字压成一列（📖 / 背 / 单 / 词），由布局压力驱动，不是阈值切换或淡入淡出。Near the edge the pill label genuinely reflows into a column under layout pressure — no breakpoint switch, no cross-fade.
• 防误触 / Safer reset — 「重置全部进度」移入二级页「数据与重置」，首页改为低权重入口（显示已学词数）；二次确认 3.5 秒自动失效、危险态实心红、明确显示将清空多少词。Reset moved into a "Data & reset" sub-page; the confirmation now expires after 3.5s, turns solid red, and names how many words will be erased.
• Star 鼓励 / Star the repo — 设置页新增 Star 按钮，打开项目主页（浏览器插件无法代替用户授权）。A "Star the repo" button opens the project page, since a client plugin cannot authorise on the user's behalf.

0.2.4

• 斩单词 / Cut — 「⚔ 斩」不删除、不毕业：词转入记忆阶段 6 的低频维护池，按可配间隔（15/30/60 天）抽查，抽查答错自动打回阶段 1。统计页可查看「已斩」列表并随时召回，抽查词带「维护抽查」角标；循环朗读默认排除已斩词。Cut words move to a low-frequency maintenance pool (memory stage 6) with configurable 15/30/60-day checks instead of being deleted; a failed check returns the word to stage 1. A cut list with recall, a maintenance-check badge, and reader filtering are included.
• 界面精修 / UI polish — 设计令牌统一间距/圆角/字号/过渡，减少重复边框，统一焦点与按压反馈，prefers-reduced-motion 守卫；保留朗读开关的声波环并修复其定位漂移。Design tokens, fewer borders, consistent focus/press feedback, reduced-motion guard, and the sound-wave ring anchored correctly to the reader toggle.
• 例句朗读双渠道 / Example sentences — 词典 API 与 Tatoeba 语料库回落，无例句自动跳过。Dictionary API with Tatoeba corpus fallback; words without examples are skipped silently.
• 选择题 / Quiz — 答完四个选项都显示对应单词，反馈条只显示判定不再重复释义。All four option words appear after answering; the verdict line no longer repeats the definition.

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