前言¶
在 DeepSeek Harness（dsh）里做 agent 开发时，手头常有外文 EPUB、技术 Markdown 或网页长文需要通读。直接读原文费时间；市面译本又可能偏离论证与语气。若把「逐段精译、随时对照原文、在读的过程中追问模型」放进同一宿主，就不必在浏览器翻译、本地阅读器和聊天窗口之间来回切换。
下面介绍社区客户端插件 dsh-reading-room（阅读室）：在 dsh Web 或桌面版左侧栏增加阅读界面，用你已配置的模型按章节翻译，并保留导读、译注与行内追问等阅读工作流。
这是什么¶
dsh-reading-room 由维护者 UncertaintyDeterminesYou4ndMe 发布，在 SkillHub 插件目录 中归类为客户端。源码与说明见 GitHub 仓库。
插件解决的是：在 dsh 内导入 EPUB、TXT、Markdown、HTML 或网页链接，按段落/章节由 LLM 精译（强调忠实、自然、术语一致与背景说明），默认只看译文，点段落可看原文，并可切换双语或原文模式；阅读进度、预译、划线笔记与导出均落在本地书库目录。
核心功能¶
导入与解析¶
支持 EPUB、TXT、Markdown、HTML，以及粘贴网页 URL（类似页面翻译式抽取正文）。EPUB 内插图、图表按原位显示；<table> 与 Markdown 表格解析为结构化段落，翻译后仍按表格渲染。重新导入同一本书时，译文按原文文本对齐段落 id，避免错位。脚注变为可点击 [n]，未译注释可当场译出。
翻译与阅读模式¶
按章节由模型精译：保留论证、限定与语气；关键术语采用「中文（原文）」标注，必要时附译注。每本书、每章可有导读。阅读时默认译文模式；点段落显示原文，并可「重译」「看译注」。顶栏可切「译文 / 双语 / 原文」。
翻到新章时先译开头两三段，几秒内可读；后台按设置预译（往后 N 章或 N 段）。第一次打开书落在第一个正文章节，封面、版权页、目录不翻译。
导读式每日阅读¶
可设每份阅读时长（默认 30 分钟），按时长切「今日份」；份尾有回想卡（脉络、三个回想问题、关键概念）。读完后可「再读一份」。
追问与 agent 联动¶
任一段落可开会话问 AI（原文、译文与问题一并进入 dsh 新会话）。选中词句右键：划线、解释、追问、复制；整段右键：这段在说什么、自由提问、朗读、笔记、书签、看原文、重译等。答案以细虚线或段尾「问」浮层展示，目录抽屉「追问」页签可汇总跳转。
聊天里 agent 可使用工具：reader_books、reader_import、reader_passage、reader_retranslate、reader_glossary、reader_translate（例如按章节段落重译并指定风格）。
导出与统计¶
「目录 → 本书」可导出 Markdown（划线、笔记、追问、本章或全书已译部分等）到书库 exports/<书名>/，或一键复制。删书前会自动导出一份到 exports。
全书搜索（原文与译文）、划线笔记、阅读统计（累计分钟、天数、连续天数）；顶栏「朗读」用系统语音读译文或原文。书架显示全书阅读时长与按每日份额估算的天数；读至末章有「全书到此」卡，可让模型整理全书论证与回想问题。
安装与启用¶
环境要求：dsh ≥ 0.2.0（package.json 中为 >=0.2.0-rc.1 <0.3.0-0），Node ≥ 24.9。client.js 为仓库内预构建产物，从 Git 源安装即可，安装方不需要 bun。
Web 版（--profile web）：
dsh plugin --profile web add github:UncertaintyDeterminesYou4ndMe/dsh-reading-room # 从 GitHub
dsh plugin --profile web add /path/to/dsh-reading-room # 或本地目录
重启 dsh web 后，左侧栏出现「阅读室」图标。DSH-Android 同样通过 dsh 插件安装，界面与 Web 一致。
官方桌面版使用独立 profile。先打开并完全退出桌面版一次，再用其自带 CLI 或在应用内「插件」页添加：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add github:UncertaintyDeterminesYou4ndMe/dsh-reading-room
模型默认跟随 dsh 当前默认模型（设置页可单独选择）；插件不读取 API key，沿用 dsh 既有模型配置。
典型用法¶
- 书架：导入文件（移动端选文件；桌面可填绝对路径）。
- 打开书：从上次位置继续；顶栏切换译文/双语/原文；「目录」抽屉查看章节、导读、术语表。
- 细读：译文模式下点段落看原文，使用「重译」（可写要求如「更口语」）或「看译注」。
- 设置：预译范围（章/段）、每份阅读时长、模型与思考强度、并发、译文风格与附加要求、是否写译注与导读、字体字号等；「本书」页签可设该书专属译风。
数据默认落在 $DSH_HOME/reading-room/（一般为 ~/.dsh/reading-room/），含 settings.json、books/<id>/ 下的 book.json、trans.json、state.json 等。若需改书库路径，可在 profile 的 cordis.patch.yml 中为插件 id reading-room 配置 libraryDir（绝对路径）。
适用场景与注意¶
适合谁：需要在 dsh 内长期读外文书/长文、希望译文可对照原文且能随时交给同一宿主里的 agent 追问或重译的开发者与用户。
运行方式：插件以当前 dsh 进程权限运行，书库与导出文件写在本地；安装前宜浏览源码与 MIT 许可证。
已知限制（README 原文）：
- 网页导入只取文字（含表格），不下载图片；需登录或脚本渲染的页面无法可靠抠正文。
- 预译队列在内存中，重启 dsh 会丢失未完成任务，下次打开该章会重新排队。
- 不要同时用 Web 版与桌面版打开同一书库，两者各自写
trans.json，可能互相覆盖。
SkillHub 目录页显示的星标为 0（以目录统计为准）；生态上 dsh 主张「一切皆插件」，SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-reading-room 把「导入 → 按章精译 → 点读原文 → 行内追问 → 导出笔记」收敛到 dsh 客户端一侧，与 harness 里已有的模型和会话共用一套环境。若要安装或看更新说明，可访问 SkillHub 目录页 与 GitHub 仓库。
