前言¶
在 DSH 里写代码、查资料时，单词往往散落在备忘录、独立 App 或在线词库里，和当前工作环境脱节。常见做法是导出词表再导入背词软件，或用通用笔记记释义，但插图、发音和练习很难和「这一张卡」绑在一起。
下面介绍维护者 shallinta 出品的 DSH 插件 随记单词本（源码仓库 shallinta/dsh-agentic-word-book，npm 包名 @suiji-ai/dsh-agentic-word-book，当前版本 1.1.0，MIT 许可证）。它在 DSH 左侧栏提供「一个词一页」的浏览与练习，词库以本地目录保存，插件包只带功能代码，不带词库。
这是什么¶
随记单词本属于 DSH 社区插件目录中的「记忆」类插件。核心思路是：每个单词占一整页，插图、音标、发音、常用词组、例句放在同一视图里，并附带挖字母拼写练习与单词辨析；切换页面再回来，练习进度仍保留。
词库、插图与发音文件落在本机目录（默认 ~/Documents/dsh/suiji-word-book/，Windows 上为 %USERPROFILE%\Documents\dsh\suiji-word-book\）。换机时复制该目录即可迁移数据。
核心功能¶
单词卡与首页¶
首页可配置标题、副标题的对齐与配色，背景图可替换并调节透明度。单词卡支持按日期、首字母、字母数量分组，正序或倒序排列；标签筛选与「已掌握」开关；右下角回到顶部。
单张单词卡包含大插图、手写体词头、音标、英文释义；多词性时释义横向排开，每个词性配一条例句。提供 4 档倍速发音、五条常用词组，内容在卡片内滚动。
练习模块¶
拼写练习对当前词挖掉部分字母，用 Tab 提示、Esc 换题、Enter 重听或下一题，答完自动进入下一题。
单词辨析提供 12 种题型轮换，题干与选项都锚定当前单词。
AI 加词与标签¶
点「+单词」输入想学的内容后，由 DSH 中的模型写词条、生成插图与发音（需先安装技能并打开「+单词」按钮，默认隐藏）。装好技能后，也可通过 /suiji-word-book 让 AI 改词条、打标签、换插图或主音频。
标签在设定里配置选项；卡片右键可多选打标，首页用 chip 快速筛选。「已掌握」为固有标签，由首页右侧开关控制显隐。
设定与字体¶
设定页分组包括：单词本外观、字体、浏览与排序、标签、目录、技能与权限等。单词字体与词组例句字体各选一款；内置 Patrick Hand、Kalam、Comic Neue、Caveat 四款开源字体（SIL Open Font License 1.1，许可证文本在插件 assets/fonts/）。
技能安装在 ~/.agents/skills/suiji-word-book/，内含 create-word.mjs（建占位词条与图）与 make-audio.mjs（合成发音：macOS 用 say + afconvert，Windows 用 System.Speech）。已安装技能版本与当前不一致时，首页左上角会出现「技能有更新，点此重装」提示。
安装与启用¶
把下面整段发给 DSH，按 README 中的安装说明操作（不要自行拼接未在文档中出现的 dsh plugin add 命令）：
请帮我安装 DSH 插件「随记单词本」：
源码仓库 https://github.com/shallinta/dsh-agentic-word-book
装好后左侧栏应该出现「随记单词本」，没出现就重启 DSH 或让模型检查插件状态。
本机已有源码时，可让模型通过 plugin_manager 的 install_bundle，将 target 指向包目录。上架后亦可在 DSH 插件市场搜索「随记单词本」安装。
装好后左侧栏应出现「随记单词本」；若未出现，重启 DSH。
插件以当前 DSH 进程权限运行。安装前请自行查看仓库源码与 MIT 许可证，确认符合你的环境与安全要求。
第一次使用¶
- 打开左侧「随记单词本」。首次运行会自动创建单词本根目录（默认
~/Documents/dsh/suiji-word-book/）。 - 点右上角齿轮，进入「技能与权限」，点「安装技能」。
- 在同一分区打开「+单词」按钮（默认隐藏）。
- 回首页点「+单词」，输入几个想学的词并回车；插件会新建会话，由 AI 生成词卡。
- AI 完成后切回单词本刷新，即可看到新卡片。
数据目录结构¶
根目录可在设定中修改。主要文件如下：
~/Documents/dsh/suiji-word-book/
settings.json ← 标题/副标题、背景、分组、排序、根目录、是否显示 +单词 等
meta.json ← tagList 与每词 tags
words.json ← 词条数组（多词性在 senses 里）
words/<slug>/ ← 插图、自定义资源、word.wav 与各词组/例句发音等
插件不上传词库数据，也无遥测。仅在使用「+单词」时，你输入的单词会发往 DSH 里配置的模型服务。插件更新不会改动根目录内容；备份即复制该目录。
适用场景与注意¶
适合需要在 DSH 工作流里背单词、希望词库完全本地化、并愿意用 AI 一次性生成插图与发音的开发者或学习者。
与同系列本地优先笔记插件「随记」（@suiji-ai/dsh-agentic-notes）思路一致：数据在本地，功能在插件。
社区目录页：skillhub.cn 上的随记单词本。目录为社区站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」的扩展方式。
更多截图与约 3 分钟演示流程见 GitHub README：shallinta/dsh-agentic-word-book。
