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