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