前言¶
在 DeepSeek Harness（DSH）裏寫代碼、調模型之餘，很多人會把同一套「宿主進程 + Web 面板」留給學習與備忘。新概念英語第一冊有 144 課，傳統做法是分散在書、網課、Anki 和錯題本之間來回切換。下面介紹的 dsh-nce 把課程瀏覽、單頁課文、可填練習卷、SRS 記憶卡、錯題本和音標參考收進 DSH 側邊欄；宿主側提供 /dsh-nce/api，瀏覽器側渲染面板。需要說明的是：教材內容並未隨倉庫分發，裝好插件後還要自行準備符合數據契約的課文數據集，否則課程與詞庫視圖會報錯直至補齊數據。
這是什麼¶
dsh-nce（GitHub：ChenYichener/dsh-nce）是由維護者 ChenYichener 發佈的 DSH 客戶端插件，定位是「新概念英語 Book 1 學習面板」：左側 144 課列表，右側單頁展示所選一課，並帶進度、搜索、分組與學習狀態。插件在 DSH 插件目錄中的分類爲客戶端；當前公開倉庫星標爲 0。許可證 MIT，要求運行 DSH 的機器上 Node.js ≥ 20；README 寫明在 DSH 0.2.2-rc.1 及 dsh web / 桌面 Web 表面下開發與測試。
核心功能¶
課程瀏覽與單頁課文¶
先做左側選課文，再在右側按錨點跳轉。分欄佈局：左側持久顯示 144 課列表，含進度（已學 x / 144）、搜索、四組課文、狀態下拉（未開始 / 學習中 / 已完成）與當前課高亮；每課有三個步驟點（單詞 / 語法 / 練習）標示停在哪一步。窄屏時可收成單列。
單頁課文包含頁眉（上一課 / 下一課、課號、中英標題、頁碼、狀態）和粘在頂部的錨點條，可平滑滾動到 Video / Text / Words / Grammar / Practice。視頻默認摺疊，展開後加載映射好的 Bilibili 嵌入播放器，也可爲每課保存自定義 Bilibili / YouTube 地址並隨時恢復內置鏈接。
課文與詞彙：左列爲問答、對話（可點行或說話人朗讀）及可摺疊參考譯文；右列爲詞彙表（音標、詞性、釋義、朗讀、星標加入記憶卡）。語法爲教材筆記與課堂筆記塊；練習含每課作業清單、課堂回憶卡與可填 worksheet。三步學習狀態可通過狀態下拉切換（選「已完成」會勾選三步），或各區塊內的「標記完成」開關單獨操作。
可填練習卷與 AI 批改¶
練習卷按教材版式渲染：空格變爲行內輸入，連線題爲真實 A/B 列並由答案鍵判定，表格題保留表格，詞框爲帶邊框卡片，印刷例題保持靜態。Enter / Shift+Enter 在空格間移動；草稿按課寫入 localStorage，換課或重啓 DSH 後仍可恢復。
一鍵批改會把所有已答題目連同答案鍵參考發給當前 profile 的默認模型，返回每題 correct / close / wrong、評語與參考答案，得分按 AI 判對題數 / 總題數計算，且可手工改判。若無默認模型或調用失敗，則降級爲確定性系統批改並在頁眉提示。支持瀏覽器內「預覽 PDF」與「下載 PDF」（基於頁面圖像生成 A4 PDF，不經服務器）。
錯題本¶
判爲 wrong 或 close 的題會自動進入錯題本，訂正後移除；按課分組，保留你的答案、參考答案、AI 評語、判定與時間戳，可按全部 / 錯 / 接近篩選。本地已保存的批改卷會掃描一次以回填歷史錯題。每題可請求 AI 講解（正解、錯因類型與記憶提示），結果按題緩存。
記憶卡與間隔重複¶
詞卡來自去重後的 866 詞詞庫，可按課搜索篩選。Space 翻轉，1–4 打分，間隔與 Anki 對齊：Again (1 分鐘) / Hard (10 分鐘) / Good (明天) / Easy (4 天)，並顯示新卡 / 學習中 / 到期數量與日上限。
新卡跟課：只有「已開始」課文中的詞進入隊列（默認每天 10 張）；到期複習不受日上限阻擋。若安裝可選插件 dsh-translate，可從其歷史文件 ~/.dsh/dsh-translate/history.json 自動導入句子卡（默認每天 3 張）。各視圖的頁碼、所選課、滾動位置與視頻展開狀態會記憶。
音標、自然拼讀與朗讀¶
提供 48 個 IPA 符號（12 單元音 / 8 雙元音 / 28 輔音）及發音要點、常見字母組合與可點示例詞；38 條自然拼讀規則、22 組最小對立對與音節重音規則。
朗讀優先複用 dsh-translate 的語音管線（Microsoft Edge 神經網絡音色，無 API Key，共享緩存），其次 macOS /usr/bin/say，再回退瀏覽器語音。右上角 聲音 菜單可設音色、語速、自動朗讀與試聽。
安裝與啓用¶
推薦從 GitHub 安裝到指定 profile：
dsh plugin --profile <profile> add github:ChenYichener/dsh-nce
也可在克隆倉庫後指向本地路徑，或在 DSH 桌面應用的插件頁選擇「從本地目錄安裝」。安裝後需 重啓 dsh web（或桌面應用） 以加載宿主半部；之後僅客戶端改動的刷新頁面即可，宿主半部或數據集變更需再次重啓 DSH（宿主進程內會緩存）。
| 依賴項 | 說明 |
|---|---|
| DeepSeek Harness | 清單含 dsh.bundle patch 與 dsh.client；README 面向 DSH 0.2.2-rc.1 |
| Node.js | ≥ 20；宿主使用 node:sqlite，不可用時回退 JSON |
| macOS（可選） | 離線朗讀回退爲 say |
| dsh-translate（可選） | Edge 音色與句子記憶卡導入 |
| 教材數據集 | 未內置，需自行構建（見下節） |
教材數據（未隨倉庫提供）¶
新概念英語受版權保護。本倉庫僅爲插件代碼；作者本地的課文數據由自有紙質書編譯，.gitignore 排除 data/。全新安裝後插件可掛載，但課程、詞庫與音標視圖在缺少數據時會顯示加載錯誤與重試按鈕。在合法持有教材的前提下，可按 README 構建個人用數據集：
- 將內容整理爲符合 docs/DATA-CONTRACT.md 的結構化 JSON（
nce1/、notes/、gwb/）。 - 執行：
NCE_CONTENT_DIR=/path/to/nce-content npm run build:data
輸出寫入被 git 忽略的 data/ 目錄。
- 執行
npm run build:phonetics生成音標 / 自然拼讀參考（腳本內手寫內容，不依賴教材）。 - 重啓 DSH 加載數據集。
編譯數據僅限個人使用，不得公開發布；提取與校驗細節見倉庫中的 docs/DATA-QUALITY.md。
典型用法¶
在 DSH 側邊欄打開 NCE。頂部有四個入口：課程、記憶卡、錯題本、音標&自然拼讀，右上爲 聲音 菜單。
| 操作 | 方式 |
|---|---|
| 打開某一課 | 在左側列表點選，右側即時切換 |
| 跟讀課文結構 | 用粘性錨點條在 video / text / words / grammar / practice 間跳轉 |
| 展開視頻 | 點視頻區標題或「Video」錨點（默認摺疊） |
| 朗讀 | 點對話行、說話人或詞彙表的朗讀控件 |
| 做練習並批改 | 在 Practice 區填寫 worksheet，使用一鍵批改（需 profile 默認模型） |
| 複習詞彙 | 進入記憶卡，用鍵盤 1–4 打分 |
| 回看錯題 | 在錯題本按課或按 wrong / close 篩選，必要時點 AI 講解 |
面板會在上次未完成的課或下一未學完課打開；每課可從詞彙表星標將詞加入記憶卡隊列。
適用場景與注意¶
適合誰：已在 DSH 中固定使用某一 profile、並希望把新概念第一冊的單課學習、填空練習、間隔重複和錯題回顧放在同一 Web 面板裏的用戶；可選配合 dsh-translate 提升朗讀與句子卡體驗。
權限與安全：插件以當前 DSH 進程權限運行，宿主 API 與本地 SQLite / JSON 存儲均在同一環境。安裝前建議閱讀倉庫源碼與 MIT 許可證，確認可接受數據留在本機（練習草稿、localStorage、批改與錯題緩存等）。
生態說明：DSH 社區插件目錄（如 SkillHub 上的 dsh-nce 頁）是獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝命令與行爲以 GitHub README 爲準。
結尾¶
dsh-nce 把新概念第一冊的 144 課收成一側欄內的單頁學習流，並用模型批改練習卷、錯題本與 Anki 式複習串起來；代價是教材 JSON 需自行合法構建。要進一步查看簡介與安裝入口，可打開目錄頁 https://www.skillhub.cn/plugins/ChenYichener/dsh-nce，源碼與完整說明見 https://github.com/ChenYichener/dsh-nce。
