前言¶
在 Harness 里做英语阅读，常见做法是临时丢一篇 URL 或正文，让模型逐段讲解。每次会话上下文不同，词汇和句式很难沉淀，也不容易在 UI 里连续读下去。English Reader 由 chenzhenhong 维护，作为 DSH 的客户端 bundle 运行：以文章为入口，经分阶段 AI 解析后支持双栏精读与连续阅读，并把用户主动收藏的内容放进本地知识库与复习队列。模型调用走 Harness 的 llm 运行时，插件不读取任何 API Key；元数据与正文落在本机 SQLite 与文件目录。
这是什么¶
English Reader 是 DeepSeek Harness 的原生 bundle 插件，分类为客户端。仓库地址：chenzhenhong/English-Reader；社区目录页：SkillHub 条目。当前 package.json 版本为 1.0.0，许可证 MIT。
数据路径默认是 $DSH_HOME/english-reader，可通过 cordis.patch.yml 中的 dataDir 调整。
从采集到精读的主线¶
整条链路可以概括为先入稿、再解析、后阅读与沉淀。
- 采集：自动发现、URL 导入或手动粘贴；采集规格支持难度区间、21 个来源、发布时间、12 种类型、敏感内容过滤与词数等筛选项。
- 正文处理：导入时做正文清洗与去重，去掉出版商页面的装饰性内容，只保留正文段落；详情页还可「清理正文」重新抓取，但正文变化会清掉旧分析，需重新解析。
- 分阶段解析：导读、难度、单词、短语、搭配、切分、逐句、复盘等阶段依次或按需执行；失败阶段可查看错误码与模型原始输出，单句可单独重试。
- 阅读：文章详情提供双栏精读（左原文右解析）与连续阅读，句子联动、单词弹窗与笔记。
- 知识库与复习：解析只产生候选词汇/短语/搭配/句子，须用户在阅读页手动「加入知识库」后才会进入四库列表；复习中心针对未掌握单词做卡片复习。
首页另有学习统计、最近阅读，以及基于真实学习事件（非预估阅读时长）的 GitHub 风格一年热力图。
安装与启用¶
安装前请自行阅读仓库源码与 MIT 许可证；插件以当前 dsh 进程权限运行，并会发起网络抓取与模型调用。
在 dsh 会话中，使用资料记载的 bundle 安装方式（路径须为本机上的绝对路径）：
# 在 dsh 会话中
plugin_manager install_bundle target: /absolute/path/to/english-reader
也可在插件管理界面里安装同一目录。完成后侧栏出现 English Reader 图标，点击进入主面板。
配置项¶
在 cordis.patch.yml 中可调整解析与数据行为，常用键如下：
| 键 | 默认 | 说明 |
|---|---|---|
dataDir |
$DSH_HOME/english-reader |
数据库与文章正文目录；留空用默认 |
sentenceConcurrency |
2 |
逐句解析并发（1–5） |
retryLimit |
2 |
单个阶段最大尝试次数 |
wordsPerArticle |
15 |
每篇提取的重点词数 |
若目标站页面很长，Harness 抓取 provider 的 maxBodyChars 默认 100000 字符可能导致正文被截断。可在 cordis.patch.yml 中调大 @deepseek-ai/dsh-web-fetch-http 的 maxBodyChars 与 maxResponseBytes（README 中给出了示例数值）。
界面与 Agent 工具¶
主界面按功能分页：首页、采集文章（「采集规格」与「发现内容」两级页签）、我的文章、文章详情、知识库、复习中心、设置（模型分组、解析参数、发音、数据目录与备份说明）。排版遵循仓库内 Bento Grid 2.0 规范文档。
除 UI 外，同一套 facade 暴露 Agent 工具，便于在会话里自动化：
| 工具 | 用途 |
|---|---|
english_reader_search |
搜索文章或任一知识库集合 |
english_reader_import |
按 URL 或正文导入，可选立即解析 |
english_reader_analyze |
启动 / 查询 / 重试单个阶段 / 取消解析 |
english_reader_knowledge |
收藏、设置掌握程度、写笔记 |
english_reader_speak |
用 Edge 神经语音朗读单词 / 短语 / 整句（返回 MP3 附件） |
典型用法思路¶
在界面里：先在「采集文章」按规格发现或导入内容，在「我的文章」中触发解析，进入详情双栏阅读并把需要的词条加入知识库，最后在「复习中心」巩固未掌握单词。设置页可试听发音、查看当前 Harness 会话实际使用的模型，并确认数据目录以便备份。
在 Agent 里：例如用 english_reader_import 导入 URL 并立即解析，用 english_reader_analyze 查询进度或在失败阶段重试；需要听读时用 english_reader_speak。发音走 Edge 神经语音 WebSocket，音色与语速存在浏览器本地，音频缓存在 <dataDir>/cache/speech/。
抓取优先使用 Harness 的 ctx.web.fetch()，插件自带抓取器作兜底并带 SSRF 防护。解析阶段若出现 LLM_TRUNCATED、LLM_INVALID_JSON、LLM_UNAVAILABLE 等错误码，可在详情页阶段条上对照排查。
数据备份与适用场景¶
备份即复制整个 <dataDir>（含 SQLite、<dataDir>/articles/<id>/cleaned.md、语音缓存等）；恢复时放回同一路径再启动 Harness。设置页「数据目录与备份」列出了需复制的子目录。
适合需要在 Harness 内长期积累、可证据追溯（AI 结论需对应原文）的英语阅读流程，且接受本地优先存储与自行管理备份的用户。不适合希望「解析结果全自动进词库、零点击沉淀」的用法——知识库条目必须手动加入。
社区插件目录由 SkillHub 等站点维护，与 DeepSeek / 幻方无官方从属关系；安装与使用须以仓库 README 与许可证为准。
参考链接¶
- 目录页：https://www.skillhub.cn/plugins/chenzhenhong/English-Reader
- GitHub：https://github.com/chenzhenhong/English-Reader
