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