dsh-wordlink

WordLink — 沉浸式英语阅读与词汇学习插件，为 DeepSeek Harness（DSH）Web UI 提供整页学习面板。

在侧边栏添加一个 WordLink 入口，打开后是独立的阅读/查词/复习面板：分级标注英文文章里的词义、点词查词与发音、把生词收进生词本，并用间隔重复安排复习。全部数据保存在浏览器本地。

功能

• 分级词义标注：内置三篇分级英文文章（A2/B1/B2）与约 110 条高频词条，按 CEFR 等级（A1–C1）标注中文释义。
• 难度阈值：只标注高于所选难度的词（全部 / A2+ / B1+ / B2+ / C1），避免满屏注释。
• 点词查词：点击任意英文单词弹出卡片，显示音标、词性、等级、中文释义、例句，可播放发音。
• 未收录词自建释义：点按词典里没有的词，直接输入自己的中文释义保存，立即进入词典与生词本。
• 粘贴任意文本：把网页/文章英文粘进「我的文本」，实时分词并套用同一套标注与查词逻辑。
• 批量导入生词：在生词本里粘贴文本或选择 .txt / .csv，按「单词 + 中文释义」批量导入（Tab、逗号、分号、=、空格分隔均可）；只有单词的行也能先导入，之后再补释义。
• 生词本：收藏/移除单词，按到期时间排序，到期词高亮。
• 间隔重复复习：SM-2 变体（Again / Hard / Good 三档，键盘 1 2 3，空格揭示释义），按记忆难度自动安排下次复习。
• 学习统计：收藏数、今日到期、已掌握、连续学习天数、正确率、近 7 天学习柱状图、生词难度分布。
• 中英双语界面：跟随 DSH Client locale 自动切换（en / zh / zh-CN / zh-Hans）；明暗主题只使用 --dsw-alias-* 主题 token。
• 本地持久化：学习数据保存在 localStorage 的 wordlink.state.v1 键下，不上传、无网络请求。

安装

已发布到 npm 后：

dsh plugin --profile web add dsh-wordlink

安装完成重启（或刷新）DSH Web 页面即可，侧边栏会出现 WordLink 图标；侧边栏底部与会话标题栏也有备用入口。

从源码安装（不需要 npm 包）：

dsh plugin --profile web add github:lukebest/dsh-wordlink

目录结构

package.json       # bundle 清单：dsh.bundle.patch + dsh.client
cordis.patch.yml   # 向 Host 组合插入 dsh-wordlink
index.js           # Host 半（纯 Client 插件，空实现）
client.js          # Web Client 半：槽位注册、UI、词典、SRS
locale/en.json     # 插件元信息（英文）
locale/zh.json     # 插件元信息（中文）
icon.svg           # 侧边栏图标

实现要点

• 纯 Client 插件：client.js 通过 window.__ModuleLoader__.load({ id: 'dsh-wordlink', factory(require) {...} }) 注册，React 只从宿主模块表 require('react') 获取。
• apply(ctx) 中：
  • ctx.get('locale') + ctx.effect 注册 wordlink 命名空间的中英文字典，locale.bind('wordlink') 得到翻译函数；
  • ctx.slots.inject('sidebar.panellist', ...) 注册侧边栏入口（id: 'wordlink', order: 30）；
  • ctx.slots.inject('main', ...) 注册整页面板（key: 'wordlink'），侧边栏按同名 id 分发；
  • sidebar.footer.action 与 conversation.session.header.utilities 提供两个备用入口，点击调用 layout.selectPanel('wordlink')。
• 不 import 任何 Harness Client 内部包，不操作宿主 DOM，不使用 iframe；组件内联 <style>，仅使用 --dsw-alias-* 主题 token。

兼容性

• 平台：DSH Web UI（platform: 'web', immediately: true）。
• 开发与验证环境：DSH 0.2.1-rc.5，Node 26.x。
• 无 Host 服务依赖、无外部网络请求、无额外 npm 依赖。

权限与数据

• 仅注册客户端槽位，不申请文件、网络、命令等权限。
• 学习数据只写入浏览器 localStorage，不会上传；清除站点数据会清空生词本与统计。

已知限制

• 内置词典为精选小词表（约 110 词），主要用于演示标注链路；实际阅读时可用「点按未收录词补充释义」持续扩充。
• 尚未提供浏览器视觉回归截图；如遇排版问题请提交 Issue。

License

MIT