前言¶
在 DeepSeek Harness（DSH）裏，聊天、終端和文件系統已經夠用，但技術書和技術資料往往分散在三個地方：微信讀書 App、本機下載的 PDF 文件夾、GitHub 上的文檔倉庫。本地閱讀器關掉後進度要自己找；想對一段話問 AI 或記筆記，又得另開軟件。社區插件 燈下（Lamplit） 由維護者 lysforge 開源，目標是把上述閱讀源收進同一個書架，在 Harness 面板內沉浸式閱讀，劃詞可走宿主默認模型並存筆記。下文按定位、功能、安裝、用法與注意事項說明。
這是什麼¶
燈下是 DSH 的客戶端類讀書插件：一個書架 + 一個沉浸式閱讀器。名字取自「燈下夜讀」；README 寫明不推送、不社交、不做閱讀排行，只負責在界面裏攤開一本書。
支持的來源包括：
- 微信讀書：掃碼登錄自己的賬號，書架、目錄、正文、書城搜索在插件內完成，不跳轉瀏覽器。
- GitHub 書庫：配置
owner/repo（可選owner/repo#子目錄），將倉庫中的 PDF / EPUB / TXT / MD 當作書架瀏覽與下載。 - 本地文件：直接導入 Markdown、TXT、EPUB、PDF；有文字層的 PDF 可排版與劃詞，掃描版 PDF 按頁渲染（標記爲「影印」，不能劃詞）。
數據默認落在本機 ~/.dsh/lamplit/，權限 0600；Cookie 與 GitHub token 不回顯、不上傳。許可證爲 MIT，運行環境要求 Node.js >= 22（見倉庫 package.json）。
界面與核心能力¶
插件 UI 分爲四個頁面（README 設計說明）：
- 首頁 — 繼續閱讀、本週閱讀、書架概覽、微信讀書狀態、最近在讀與最近筆記。
- 書架 — 按來源篩選、在讀/讀完、排序與密度；封面網格支持 6/4/3/2 列。
- 廣場 — 左側切換書源：微信讀書 tab 可搜書城；GitHub tab 按頁列出倉庫文檔（每頁 10 個）。
- 設置 — 來源（微信讀書、GitHub 書庫）、閱讀默認值、數據導出/備份/緩存、關於。
與閱讀體驗直接相關的能力（均以 README「支持矩陣」爲準）：
| 能力 | 說明 |
|---|---|
| 統一進度 | 按章記進度；微信讀書雲端進度與時長只讀，不回寫 |
| 沉浸閱讀 | 四套紙張主題、襯線限寬、分頁與滾動、目錄抽屜、鍵盤翻頁 |
| 劃詞 AI | 選中正文 → 解釋 / 補充 / 記筆記 / 複製，走 Harness 當前默認 LLM |
| 筆記 | 按書分組，可跳回原文句；導出本書或全部 Markdown |
| 緩存 | 分類書目 30 分鐘、倉庫目錄 5 分鐘等，減少重複請求 |
Host 與 Client 側 README 稱純 JS 實現 PDF 抽取、EPUB 解析等；Client 僅 require('react')，無單獨構建步驟。微信讀書網頁適配部分致謝項目 dsh-weread（MIT）。
已下線或不支持：番茄小說自 0.2.0 起移除；MOBI / AZW3 / KFX 需先用 Calibre 轉 EPUB。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議在 GitHub 倉庫 查看源碼與 MIT 許可證。社區目錄頁：https://www.skillhub.cn/plugins/lysforge/dsh-lamplit（與 DeepSeek / 幻方無官方從屬關係）。
在 Harness 界面安裝（推薦）
插件（Plugins）→ 安裝 → 輸入 dsh-lamplit
命令行（npm 包名 dsh-lamplit）
dsh plugin --profile web add dsh-lamplit
若 npm 安裝失敗，可使用 Release 附件（README 示例版本 v0.1.3）：
dsh plugin --profile <profile> add https://github.com/lysforge/dsh-lamplit/releases/download/v0.1.3/dsh-lamplit-0.1.3.tgz
將 <profile> 換成你實際使用的 DSH profile 名稱。
典型用法¶
README「第一次用」中的可復現流程如下：
- 點左側「燈下」→ 頂欄 導入，將
.md / .txt / .epub / .pdf拖入書架。 - 讀微信讀書：設置 → 來源 → 微信讀書 → 用微信掃碼登錄，掃完後自動同步書架。
- 找書：廣場 → 微信讀書 搜書名；或 設置 → GitHub 書庫 → 管理 添加倉庫，在廣場 GitHub tab 分頁瀏覽並點「下載」。
- 打開任意一本書閱讀；選中一段正文，使用浮層工具條：解釋 / 補充 / 記筆記 / 複製。
GitHub 未配置 token 時 API 限額約 60 次/小時；在設置中填寫 token 可提高到 5000。單文件下載上限 120MB。微信讀書 Cookie 約一個月過期，需重新掃碼。
適用場景與注意¶
適合：已在 DSH 內做開發或查閱資料，希望微信讀書、GitHub 上的電子書與本地文件同一處打開，並在閱讀時劃詞問 AI、導出 Markdown 筆記的開發者。
務必注意：
- 插件僅在用戶操作時訪問
weread.qq.com、github.com/raw.githubusercontent.com；無遙測、無插件自有賬號體系。 - 掃描版 PDF 可讀但無法劃詞；書城搜索在 README 中說明：帶 Cookie 時可能返回空殼，不帶 Cookie 時纔是完整服務端渲染結果。
- GitHub 倉庫內容與授權由填寫者負責，插件只提供訪問通路。
結尾¶
燈下把分散的書源、章節進度和劃詞筆記收進 Harness 同一面板，適合「在終端旁邊夜讀」的工作流。進一步瞭解可訪問社區目錄 lysforge/dsh-lamplit 與源碼倉庫 github.com/lysforge/dsh-lamplit。
