前言¶
在 Harness 里写代码、调 Agent 时，查词往往要切到浏览器词典或独立 App，学习进度也散在不同工具里。DeepSeek Harness 支持通过插件扩展界面与能力；社区维护的 词光 for DeepSeek Harness（仓库 MC0571/DSH-Plugin-Word-Atlas）把上游开源项目 词光 · Word Atlas 的雅思词库、插画与复习逻辑接到 DSH 侧边栏，进度只写本机，Agent 还能直接调用同一套词条工具。下面介绍它是什么、能做什么，以及如何安装与自检。
这是什么¶
词光 for DeepSeek Harness 是一套插画雅思词汇插件：侧边栏点开「词光」，每个词对应一张插画词卡——先看画面理解词义，再听英音美音，做主动回忆练习，由 FSRS 在快忘时安排复习。插件代码以 MIT 授权；词库、插画与发音来自上游 词光 · Word Atlas（CC BY 4.0）。本仓库由社区维护者 MC0571 维护，不是词光官方仓库，与上游原作者无隶属关系。
面向对象主要是备考雅思、每天能拿出约 10–20 分钟、想先把「认词」练扎实的中文母语学习者。它解决背了就忘、词义与画面脱节、在 App 与笔记之间来回切换等问题；不提供作文批改、口语陪练，也不承诺提分。
内置规模（与 README 一致）：7,298 条词条（CEFR A1–C2，19 个话题）、14,596 条例句、7,298 幅插画、22,905 段录音；「书房」含 732 篇分级短文及《小王子》沉浸式阅读。词库索引内置在插件 data/（约 7 MB），无本机素材也可浏览词条；插画与发音优先读本机词光目录，否则按需从上游词光站点加载。
核心功能¶
学习闭环¶
| 环节 | 说明 |
|---|---|
| 看见 | 一词一画，中英释义、两条例句，以及搭配、词族与用法提示 |
| 听见 | 英音、美音可切换；例句朗读；1,011 个重点词第二条例句带录音 |
| 想起 | 看义选词、看图补句、听音辨词、拼写四类题型；答错会重新进入本轮 |
| 复习 | FSRS 按答题记录排期；仅首次作答计入正确率；无到期词时可自由复习已学词 |
| 积累 | 星图按话题展示学习状态；打字练习统计 WPM 与准确率；进度可导出备份 |
界面入口¶
| 入口 | 能力概要 |
|---|---|
| 今日 | 每日计划、连续天数、本周统计、今日一词、A1–C2 路线、19 个话题 |
| 图鉴 | 全库筛选搜索，打开插画词卡 |
| 书房 | 分级短文（双语、点词查义、T/F/NG）与《小王子》多种阅读方式 |
| 星图 | WebGL2 词汇星系，按学习状态明暗，点星开词卡 |
| 复习 | 到期词优先；重来 / 困难 / 良好 / 简单四档；可自由复习 |
| 练习 | 单词、例句、听写打字，实时 WPM 与准确率 |
| 生词本 | 收藏与错词集中管理 |
| 我的 | 统计、热力图、复习预测、备份导入导出、离线素材下载 |
例句中可点任意英文词查义并播放发音；⌘K（Windows 为 Ctrl+K）打开命令面板搜索词条或跳转页面。
给 Agent 用的工具¶
装好插件后，Harness 内模型可查询同一份词库：
| 工具 | 用途 |
|---|---|
word_atlas_lookup |
按单词或词条 ID 返回完整词条（音标、CEFR、话题、释义、例句、搭配、插画链接等） |
word_atlas_search |
按英文、中文释义或音标搜索，可按 CEFR 与 19 个话题过滤 |
若不想让模型调用词库工具，可在配置里设 tools: false（细节见仓库内 docs/DEVELOPMENT.md）。
安装与启用¶
推荐在 DSH 界面手动添加。
- 侧边栏打开「插件」，点右上角「添加插件」；
- 在输入框粘贴仓库地址；
- 点「安装」，等待完成；侧边栏出现「词光」后点开即可。
安装地址（与 README 原文一致）：
https://github.com/MC0571/DSH-Plugin-Word-Atlas
安装过程可能请求 danger-full-access 或需审批：插件需写入自有目录、进度与素材缓存（$DSH_HOME/word-atlas-dsh/）。装完后不再额外授权，学习数据不上传服务器。
脚本或自动化可用 plugin_manager（README 折叠说明）：
action: install_bundle
target: https://github.com/MC0571/DSH-Plugin-Word-Atlas.git
装完自检（约 30 秒）： 侧边栏有「词光」图标；今日页有计划、连续天数与可点的词卡；词卡含插画、英美音标与中文释义，播放可听到发音；联网时插画与发音按需加载，无需预先整包下载。
若侧边栏无入口：确认插件页安装无报错；仍无效时可重启 Harness 或重装。插件页面注册在 main 槽，侧边栏在 sidebar.panellist。
典型用法¶
日常学习： 从「今日」跟计划完成词卡与题型，到期词在「复习」里按 FSRS 评分；用「图鉴」或星图浏览未学词。
Agent 查词： 在对话中让 Agent 使用 word_atlas_lookup 查某个词并引用雅思例句，或 word_atlas_search 按话题筛选——返回结构化词条，无需另开词典。
离线： 默认按需联网加载素材。通勤或弱网可在「我的 → 离线素材」分档下载（缩略图约 84 MB、完整插画约 199 MB、发音约 418 MB；三档合计约 701 MB，支持暂停续传）。若本机已有上游词光仓库，也可本地导入或配置 contentDir（见开发文档）。
换机： 进度在 $DSH_HOME/word-atlas-dsh/progress.json（浏览器内另有镜像）。换设备前在「我的 → 数据与备份」导出，新环境导入；格式与上游词光兼容。卸载插件不会自动删进度目录，确认不需要后可手动删除。
适用场景与注意¶
适合： 在 DSH 内一站式背单词、复习与阅读短文；希望 Agent 与界面共用同一词库；重视本机隐私、不注册账号。
不适合： 需要真人批改、口语陪练或「一键提分」预期——这是词汇与学习工具。
内容与局限： 释义、例句、插画与录音由生成式 AI 制作并经自动校验，尚未逐条人工审校，可能有个别错误；非官方雅思词表。发现错误可在 GitHub 提 Issue，词条类请附词条 ID。
安全与权限： 插件在当前 DSH 进程权限下运行；安装前建议浏览仓库源码与 LICENSE、THIRD_PARTY_NOTICES.md。社区目录 SkillHub 插件页 与 GitHub 均为社区生态，与 DeepSeek / 幻方无官方从属关系。
结尾¶
词光 DSH 插件把 7,298 个雅思词的插画、发音与 FSRS 复习收进 Harness 侧边栏，学习记录留在本机，并为 Agent 提供 word_atlas_lookup / word_atlas_search。目录与详情见 SkillHub：DSH-Plugin-Word-Atlas，源码与安装说明见 GitHub：MC0571/DSH-Plugin-Word-Atlas。
