前言¶
在 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。
