shiguang-reader 0.0.0-stage → 1.120.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +77 -2
- package/client.js +18433 -0
- package/cordis.patch.yml +12 -0
- package/hostindex.js +761 -0
- package/hostlib.js +1313 -0
- package/icon.svg +25 -0
- package/index.js +417 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +53 -4
- package/screenshots/batch-actions.png +0 -0
- package/screenshots/book-detail.png +0 -0
- package/screenshots/shelf.png +0 -0
- package/screenshots/stats.png +0 -0
package/README.md
CHANGED
|
@@ -1,3 +1,78 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 拾光阅读 · Shiguang Reader
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> 把世界关小一点，把书页放大一点。
|
|
4
|
+
|
|
5
|
+
一个装进 DeepSeek Harness 的本地阅读插件：书架、沉浸式阅读、划线想法、书签、搜索、统计，都在同一个安静的面板里。
|
|
6
|
+
|
|
7
|
+
## 界面
|
|
8
|
+
|
|
9
|
+
| 书架 | 批量操作 |
|
|
10
|
+
|:---:|:---:|
|
|
11
|
+
|  |  |
|
|
12
|
+
| **书籍详情** | **阅读统计** |
|
|
13
|
+
|  |  |
|
|
14
|
+
|
|
15
|
+
> 截图由真实 React 组件与生产 CSS 在无头 Chromium 中渲染，使用演示数据，不含 DSH 主界面外壳。
|
|
16
|
+
|
|
17
|
+
## 功能
|
|
18
|
+
|
|
19
|
+
- **阅读**：分页阅读、目录、章节进度、四套主题、字号/行距/页宽调节、全屏与语音朗读。
|
|
20
|
+
- **笔记**：划线、想法、四种颜色、标签、书签、书评与摘录卡片。
|
|
21
|
+
- **搜索**：书内搜索、跨书正文搜索、命中高亮与引用复制。
|
|
22
|
+
- **书架**：封面/列表/分组视图，按最近阅读、进度、评分、字数排序；置顶、想读、搁置、已读完。
|
|
23
|
+
- **批量操作**：多选后批量标记、搁置、打标签、置顶、复制/导出书单与删除。
|
|
24
|
+
- **导入**：TXT / Markdown / EPUB，支持多选和拖拽；批量导入显示进度并逐本落盘。
|
|
25
|
+
- **统计**：七日趋势、连续阅读、热力图、阅读节律、时长排行与月度卡片。
|
|
26
|
+
- **宿主工具**：Agent 可直接跨书检索、读书、查笔记/书签/书架/统计。
|
|
27
|
+
|
|
28
|
+
## 安装
|
|
29
|
+
|
|
30
|
+
### 在线安装（推荐）
|
|
31
|
+
|
|
32
|
+
GitHub：[sayhia/shiguang-reader](https://github.com/sayhia/shiguang-reader)
|
|
33
|
+
|
|
34
|
+
在 DeepSeek Harness 的 **设置 → 插件** 中安装 Bundle，二选一：
|
|
35
|
+
|
|
36
|
+
```text
|
|
37
|
+
shiguang-reader
|
|
38
|
+
github:sayhia/shiguang-reader
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
`shiguang-reader` 来自 npm；GitHub spec 适合直接跟随仓库最新提交。安装完成后刷新 Web UI，点击左侧栏的书本图标「拾光阅读」；如果插件列表里还没启用，手动打开「拾光阅读」即可。
|
|
42
|
+
|
|
43
|
+
也可以直接安装 npm 包：
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
npm install shiguang-reader
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### 本地开发
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
dsh plugin --profile desktop add link:/path/to/shiguang-reader
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
适合改源码时使用；正式使用建议用上面的 GitHub 在线安装。
|
|
56
|
+
|
|
57
|
+
## 数据
|
|
58
|
+
|
|
59
|
+
- 正文只保存在你选择的**书库目录**：`library.json` + `books/*.txt` + 原始 `.epub`。
|
|
60
|
+
- 浏览器只保存书架元数据、进度、笔记与设置。
|
|
61
|
+
- SQLite 只做宿主侧的**派生检索索引**，可随时删除重建；设置 `index: false` 可完全关闭。
|
|
62
|
+
- 不使用 `better-sqlite3`，SQLite 也不是主存储。
|
|
63
|
+
|
|
64
|
+
## 开发
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
npm run dev # 监听 source/，自动构建
|
|
68
|
+
npm run build # 手动构建
|
|
69
|
+
npm test # 客户端 + 宿主测试
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
客户端源码在 `source/`，构建产物为 `client.js` 与 `parse-worker.js`。
|
|
73
|
+
|
|
74
|
+
## 已知边界
|
|
75
|
+
|
|
76
|
+
- 书库目录依赖 Chromium 的 File System Access API；Safari / Firefox 不支持导入。
|
|
77
|
+
- EPUB 按纯文字阅读，不还原固定版式；不解析 PDF。
|
|
78
|
+
- 截图使用演示数据，真实阅读数据保存在本机。
|