dsh-npie-reader 0.0.0-stage → 0.87.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.
Files changed (205) hide show
  1. package/CHANGELOG.md +13852 -0
  2. package/LICENSE +21 -0
  3. package/README.md +316 -2
  4. package/THIRD-PARTY-NOTICES.md +82 -0
  5. package/cordis.patch.yml +8 -0
  6. package/lib/client.js +38321 -0
  7. package/lib/index.js +21070 -0
  8. package/package.json +109 -4
  9. package/src/host/ocr-vision.js +66 -0
  10. package/vendor/chinese-independent-blogs/LICENSE +21 -0
  11. package/vendor/editor/LICENSE +21 -0
  12. package/vendor/editor/editor.mjs +49 -0
  13. package/vendor/pdfjs/README.md +45 -0
  14. package/vendor/pdfjs/cmaps/78-EUC-H.bcmap +0 -0
  15. package/vendor/pdfjs/cmaps/78-EUC-V.bcmap +0 -0
  16. package/vendor/pdfjs/cmaps/78-H.bcmap +0 -0
  17. package/vendor/pdfjs/cmaps/78-RKSJ-H.bcmap +0 -0
  18. package/vendor/pdfjs/cmaps/78-RKSJ-V.bcmap +0 -0
  19. package/vendor/pdfjs/cmaps/78-V.bcmap +0 -0
  20. package/vendor/pdfjs/cmaps/78ms-RKSJ-H.bcmap +0 -0
  21. package/vendor/pdfjs/cmaps/78ms-RKSJ-V.bcmap +0 -0
  22. package/vendor/pdfjs/cmaps/83pv-RKSJ-H.bcmap +0 -0
  23. package/vendor/pdfjs/cmaps/90ms-RKSJ-H.bcmap +0 -0
  24. package/vendor/pdfjs/cmaps/90ms-RKSJ-V.bcmap +0 -0
  25. package/vendor/pdfjs/cmaps/90msp-RKSJ-H.bcmap +0 -0
  26. package/vendor/pdfjs/cmaps/90msp-RKSJ-V.bcmap +0 -0
  27. package/vendor/pdfjs/cmaps/90pv-RKSJ-H.bcmap +0 -0
  28. package/vendor/pdfjs/cmaps/90pv-RKSJ-V.bcmap +0 -0
  29. package/vendor/pdfjs/cmaps/Add-H.bcmap +0 -0
  30. package/vendor/pdfjs/cmaps/Add-RKSJ-H.bcmap +0 -0
  31. package/vendor/pdfjs/cmaps/Add-RKSJ-V.bcmap +0 -0
  32. package/vendor/pdfjs/cmaps/Add-V.bcmap +0 -0
  33. package/vendor/pdfjs/cmaps/Adobe-CNS1-0.bcmap +0 -0
  34. package/vendor/pdfjs/cmaps/Adobe-CNS1-1.bcmap +0 -0
  35. package/vendor/pdfjs/cmaps/Adobe-CNS1-2.bcmap +0 -0
  36. package/vendor/pdfjs/cmaps/Adobe-CNS1-3.bcmap +0 -0
  37. package/vendor/pdfjs/cmaps/Adobe-CNS1-4.bcmap +0 -0
  38. package/vendor/pdfjs/cmaps/Adobe-CNS1-5.bcmap +0 -0
  39. package/vendor/pdfjs/cmaps/Adobe-CNS1-6.bcmap +0 -0
  40. package/vendor/pdfjs/cmaps/Adobe-CNS1-UCS2.bcmap +0 -0
  41. package/vendor/pdfjs/cmaps/Adobe-GB1-0.bcmap +0 -0
  42. package/vendor/pdfjs/cmaps/Adobe-GB1-1.bcmap +0 -0
  43. package/vendor/pdfjs/cmaps/Adobe-GB1-2.bcmap +0 -0
  44. package/vendor/pdfjs/cmaps/Adobe-GB1-3.bcmap +0 -0
  45. package/vendor/pdfjs/cmaps/Adobe-GB1-4.bcmap +0 -0
  46. package/vendor/pdfjs/cmaps/Adobe-GB1-5.bcmap +0 -0
  47. package/vendor/pdfjs/cmaps/Adobe-GB1-UCS2.bcmap +0 -0
  48. package/vendor/pdfjs/cmaps/Adobe-Japan1-0.bcmap +0 -0
  49. package/vendor/pdfjs/cmaps/Adobe-Japan1-1.bcmap +0 -0
  50. package/vendor/pdfjs/cmaps/Adobe-Japan1-2.bcmap +0 -0
  51. package/vendor/pdfjs/cmaps/Adobe-Japan1-3.bcmap +0 -0
  52. package/vendor/pdfjs/cmaps/Adobe-Japan1-4.bcmap +0 -0
  53. package/vendor/pdfjs/cmaps/Adobe-Japan1-5.bcmap +0 -0
  54. package/vendor/pdfjs/cmaps/Adobe-Japan1-6.bcmap +0 -0
  55. package/vendor/pdfjs/cmaps/Adobe-Japan1-UCS2.bcmap +0 -0
  56. package/vendor/pdfjs/cmaps/Adobe-Korea1-0.bcmap +0 -0
  57. package/vendor/pdfjs/cmaps/Adobe-Korea1-1.bcmap +0 -0
  58. package/vendor/pdfjs/cmaps/Adobe-Korea1-2.bcmap +0 -0
  59. package/vendor/pdfjs/cmaps/Adobe-Korea1-UCS2.bcmap +0 -0
  60. package/vendor/pdfjs/cmaps/B5-H.bcmap +0 -0
  61. package/vendor/pdfjs/cmaps/B5-V.bcmap +0 -0
  62. package/vendor/pdfjs/cmaps/B5pc-H.bcmap +0 -0
  63. package/vendor/pdfjs/cmaps/B5pc-V.bcmap +0 -0
  64. package/vendor/pdfjs/cmaps/CNS-EUC-H.bcmap +0 -0
  65. package/vendor/pdfjs/cmaps/CNS-EUC-V.bcmap +0 -0
  66. package/vendor/pdfjs/cmaps/CNS1-H.bcmap +0 -0
  67. package/vendor/pdfjs/cmaps/CNS1-V.bcmap +0 -0
  68. package/vendor/pdfjs/cmaps/CNS2-H.bcmap +0 -0
  69. package/vendor/pdfjs/cmaps/CNS2-V.bcmap +3 -0
  70. package/vendor/pdfjs/cmaps/ETHK-B5-H.bcmap +0 -0
  71. package/vendor/pdfjs/cmaps/ETHK-B5-V.bcmap +0 -0
  72. package/vendor/pdfjs/cmaps/ETen-B5-H.bcmap +0 -0
  73. package/vendor/pdfjs/cmaps/ETen-B5-V.bcmap +0 -0
  74. package/vendor/pdfjs/cmaps/ETenms-B5-H.bcmap +3 -0
  75. package/vendor/pdfjs/cmaps/ETenms-B5-V.bcmap +0 -0
  76. package/vendor/pdfjs/cmaps/EUC-H.bcmap +0 -0
  77. package/vendor/pdfjs/cmaps/EUC-V.bcmap +0 -0
  78. package/vendor/pdfjs/cmaps/Ext-H.bcmap +0 -0
  79. package/vendor/pdfjs/cmaps/Ext-RKSJ-H.bcmap +0 -0
  80. package/vendor/pdfjs/cmaps/Ext-RKSJ-V.bcmap +0 -0
  81. package/vendor/pdfjs/cmaps/Ext-V.bcmap +0 -0
  82. package/vendor/pdfjs/cmaps/GB-EUC-H.bcmap +0 -0
  83. package/vendor/pdfjs/cmaps/GB-EUC-V.bcmap +0 -0
  84. package/vendor/pdfjs/cmaps/GB-H.bcmap +4 -0
  85. package/vendor/pdfjs/cmaps/GB-V.bcmap +0 -0
  86. package/vendor/pdfjs/cmaps/GBK-EUC-H.bcmap +0 -0
  87. package/vendor/pdfjs/cmaps/GBK-EUC-V.bcmap +0 -0
  88. package/vendor/pdfjs/cmaps/GBK2K-H.bcmap +0 -0
  89. package/vendor/pdfjs/cmaps/GBK2K-V.bcmap +0 -0
  90. package/vendor/pdfjs/cmaps/GBKp-EUC-H.bcmap +0 -0
  91. package/vendor/pdfjs/cmaps/GBKp-EUC-V.bcmap +0 -0
  92. package/vendor/pdfjs/cmaps/GBT-EUC-H.bcmap +0 -0
  93. package/vendor/pdfjs/cmaps/GBT-EUC-V.bcmap +0 -0
  94. package/vendor/pdfjs/cmaps/GBT-H.bcmap +0 -0
  95. package/vendor/pdfjs/cmaps/GBT-V.bcmap +0 -0
  96. package/vendor/pdfjs/cmaps/GBTpc-EUC-H.bcmap +0 -0
  97. package/vendor/pdfjs/cmaps/GBTpc-EUC-V.bcmap +0 -0
  98. package/vendor/pdfjs/cmaps/GBpc-EUC-H.bcmap +0 -0
  99. package/vendor/pdfjs/cmaps/GBpc-EUC-V.bcmap +0 -0
  100. package/vendor/pdfjs/cmaps/H.bcmap +0 -0
  101. package/vendor/pdfjs/cmaps/HKdla-B5-H.bcmap +0 -0
  102. package/vendor/pdfjs/cmaps/HKdla-B5-V.bcmap +0 -0
  103. package/vendor/pdfjs/cmaps/HKdlb-B5-H.bcmap +0 -0
  104. package/vendor/pdfjs/cmaps/HKdlb-B5-V.bcmap +0 -0
  105. package/vendor/pdfjs/cmaps/HKgccs-B5-H.bcmap +0 -0
  106. package/vendor/pdfjs/cmaps/HKgccs-B5-V.bcmap +0 -0
  107. package/vendor/pdfjs/cmaps/HKm314-B5-H.bcmap +0 -0
  108. package/vendor/pdfjs/cmaps/HKm314-B5-V.bcmap +0 -0
  109. package/vendor/pdfjs/cmaps/HKm471-B5-H.bcmap +0 -0
  110. package/vendor/pdfjs/cmaps/HKm471-B5-V.bcmap +0 -0
  111. package/vendor/pdfjs/cmaps/HKscs-B5-H.bcmap +0 -0
  112. package/vendor/pdfjs/cmaps/HKscs-B5-V.bcmap +0 -0
  113. package/vendor/pdfjs/cmaps/Hankaku.bcmap +0 -0
  114. package/vendor/pdfjs/cmaps/Hiragana.bcmap +0 -0
  115. package/vendor/pdfjs/cmaps/KSC-EUC-H.bcmap +0 -0
  116. package/vendor/pdfjs/cmaps/KSC-EUC-V.bcmap +0 -0
  117. package/vendor/pdfjs/cmaps/KSC-H.bcmap +0 -0
  118. package/vendor/pdfjs/cmaps/KSC-Johab-H.bcmap +0 -0
  119. package/vendor/pdfjs/cmaps/KSC-Johab-V.bcmap +0 -0
  120. package/vendor/pdfjs/cmaps/KSC-V.bcmap +0 -0
  121. package/vendor/pdfjs/cmaps/KSCms-UHC-H.bcmap +0 -0
  122. package/vendor/pdfjs/cmaps/KSCms-UHC-HW-H.bcmap +0 -0
  123. package/vendor/pdfjs/cmaps/KSCms-UHC-HW-V.bcmap +0 -0
  124. package/vendor/pdfjs/cmaps/KSCms-UHC-V.bcmap +0 -0
  125. package/vendor/pdfjs/cmaps/KSCpc-EUC-H.bcmap +0 -0
  126. package/vendor/pdfjs/cmaps/KSCpc-EUC-V.bcmap +0 -0
  127. package/vendor/pdfjs/cmaps/Katakana.bcmap +0 -0
  128. package/vendor/pdfjs/cmaps/NWP-H.bcmap +0 -0
  129. package/vendor/pdfjs/cmaps/NWP-V.bcmap +0 -0
  130. package/vendor/pdfjs/cmaps/RKSJ-H.bcmap +0 -0
  131. package/vendor/pdfjs/cmaps/RKSJ-V.bcmap +0 -0
  132. package/vendor/pdfjs/cmaps/Roman.bcmap +0 -0
  133. package/vendor/pdfjs/cmaps/UniCNS-UCS2-H.bcmap +0 -0
  134. package/vendor/pdfjs/cmaps/UniCNS-UCS2-V.bcmap +0 -0
  135. package/vendor/pdfjs/cmaps/UniCNS-UTF16-H.bcmap +0 -0
  136. package/vendor/pdfjs/cmaps/UniCNS-UTF16-V.bcmap +0 -0
  137. package/vendor/pdfjs/cmaps/UniCNS-UTF32-H.bcmap +0 -0
  138. package/vendor/pdfjs/cmaps/UniCNS-UTF32-V.bcmap +0 -0
  139. package/vendor/pdfjs/cmaps/UniCNS-UTF8-H.bcmap +0 -0
  140. package/vendor/pdfjs/cmaps/UniCNS-UTF8-V.bcmap +0 -0
  141. package/vendor/pdfjs/cmaps/UniGB-UCS2-H.bcmap +0 -0
  142. package/vendor/pdfjs/cmaps/UniGB-UCS2-V.bcmap +0 -0
  143. package/vendor/pdfjs/cmaps/UniGB-UTF16-H.bcmap +0 -0
  144. package/vendor/pdfjs/cmaps/UniGB-UTF16-V.bcmap +0 -0
  145. package/vendor/pdfjs/cmaps/UniGB-UTF32-H.bcmap +0 -0
  146. package/vendor/pdfjs/cmaps/UniGB-UTF32-V.bcmap +0 -0
  147. package/vendor/pdfjs/cmaps/UniGB-UTF8-H.bcmap +0 -0
  148. package/vendor/pdfjs/cmaps/UniGB-UTF8-V.bcmap +0 -0
  149. package/vendor/pdfjs/cmaps/UniJIS-UCS2-H.bcmap +0 -0
  150. package/vendor/pdfjs/cmaps/UniJIS-UCS2-HW-H.bcmap +0 -0
  151. package/vendor/pdfjs/cmaps/UniJIS-UCS2-HW-V.bcmap +0 -0
  152. package/vendor/pdfjs/cmaps/UniJIS-UCS2-V.bcmap +0 -0
  153. package/vendor/pdfjs/cmaps/UniJIS-UTF16-H.bcmap +0 -0
  154. package/vendor/pdfjs/cmaps/UniJIS-UTF16-V.bcmap +0 -0
  155. package/vendor/pdfjs/cmaps/UniJIS-UTF32-H.bcmap +0 -0
  156. package/vendor/pdfjs/cmaps/UniJIS-UTF32-V.bcmap +0 -0
  157. package/vendor/pdfjs/cmaps/UniJIS-UTF8-H.bcmap +0 -0
  158. package/vendor/pdfjs/cmaps/UniJIS-UTF8-V.bcmap +0 -0
  159. package/vendor/pdfjs/cmaps/UniJIS2004-UTF16-H.bcmap +0 -0
  160. package/vendor/pdfjs/cmaps/UniJIS2004-UTF16-V.bcmap +0 -0
  161. package/vendor/pdfjs/cmaps/UniJIS2004-UTF32-H.bcmap +0 -0
  162. package/vendor/pdfjs/cmaps/UniJIS2004-UTF32-V.bcmap +0 -0
  163. package/vendor/pdfjs/cmaps/UniJIS2004-UTF8-H.bcmap +0 -0
  164. package/vendor/pdfjs/cmaps/UniJIS2004-UTF8-V.bcmap +0 -0
  165. package/vendor/pdfjs/cmaps/UniJISPro-UCS2-HW-V.bcmap +0 -0
  166. package/vendor/pdfjs/cmaps/UniJISPro-UCS2-V.bcmap +0 -0
  167. package/vendor/pdfjs/cmaps/UniJISPro-UTF8-V.bcmap +0 -0
  168. package/vendor/pdfjs/cmaps/UniJISX0213-UTF32-H.bcmap +0 -0
  169. package/vendor/pdfjs/cmaps/UniJISX0213-UTF32-V.bcmap +0 -0
  170. package/vendor/pdfjs/cmaps/UniJISX02132004-UTF32-H.bcmap +0 -0
  171. package/vendor/pdfjs/cmaps/UniJISX02132004-UTF32-V.bcmap +0 -0
  172. package/vendor/pdfjs/cmaps/UniKS-UCS2-H.bcmap +0 -0
  173. package/vendor/pdfjs/cmaps/UniKS-UCS2-V.bcmap +0 -0
  174. package/vendor/pdfjs/cmaps/UniKS-UTF16-H.bcmap +0 -0
  175. package/vendor/pdfjs/cmaps/UniKS-UTF16-V.bcmap +0 -0
  176. package/vendor/pdfjs/cmaps/UniKS-UTF32-H.bcmap +0 -0
  177. package/vendor/pdfjs/cmaps/UniKS-UTF32-V.bcmap +0 -0
  178. package/vendor/pdfjs/cmaps/UniKS-UTF8-H.bcmap +0 -0
  179. package/vendor/pdfjs/cmaps/UniKS-UTF8-V.bcmap +0 -0
  180. package/vendor/pdfjs/cmaps/V.bcmap +0 -0
  181. package/vendor/pdfjs/cmaps/WP-Symbol.bcmap +0 -0
  182. package/vendor/pdfjs/pdf.mjs +27 -0
  183. package/vendor/pdfjs/pdf.worker.mjs +27 -0
  184. package/vendor/pdfjs/standard_fonts/FoxitDingbats.pfb +0 -0
  185. package/vendor/pdfjs/standard_fonts/FoxitFixed.pfb +0 -0
  186. package/vendor/pdfjs/standard_fonts/FoxitFixedBold.pfb +0 -0
  187. package/vendor/pdfjs/standard_fonts/FoxitFixedBoldItalic.pfb +0 -0
  188. package/vendor/pdfjs/standard_fonts/FoxitFixedItalic.pfb +0 -0
  189. package/vendor/pdfjs/standard_fonts/FoxitSerif.pfb +0 -0
  190. package/vendor/pdfjs/standard_fonts/FoxitSerifBold.pfb +0 -0
  191. package/vendor/pdfjs/standard_fonts/FoxitSerifBoldItalic.pfb +0 -0
  192. package/vendor/pdfjs/standard_fonts/FoxitSerifItalic.pfb +0 -0
  193. package/vendor/pdfjs/standard_fonts/FoxitSymbol.pfb +0 -0
  194. package/vendor/pdfjs/standard_fonts/LiberationSans-Bold.ttf +0 -0
  195. package/vendor/pdfjs/standard_fonts/LiberationSans-BoldItalic.ttf +0 -0
  196. package/vendor/pdfjs/standard_fonts/LiberationSans-Italic.ttf +0 -0
  197. package/vendor/pdfjs/standard_fonts/LiberationSans-Regular.ttf +0 -0
  198. package/vendor/pdfjs/wasm/LICENSE_JBIG2 +196 -0
  199. package/vendor/pdfjs/wasm/LICENSE_OPENJPEG +39 -0
  200. package/vendor/pdfjs/wasm/LICENSE_QCMS +21 -0
  201. package/vendor/pdfjs/wasm/jbig2.wasm +0 -0
  202. package/vendor/pdfjs/wasm/jbig2_nowasm_fallback.js +15 -0
  203. package/vendor/pdfjs/wasm/openjpeg.wasm +0 -0
  204. package/vendor/pdfjs/wasm/openjpeg_nowasm_fallback.js +17 -0
  205. package/vendor/pdfjs/wasm/qcms_bg.wasm +0 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Banny
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,317 @@
1
- # Temporary Holding Version
1
+ # 澄境 | Limina
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ **阅人际,留寸心。** *Glean the World, Guard the Heart.*
4
+
5
+ 装在 DeepSeek Harness 桌面端里的**阅读与记录**插件。
6
+
7
+ 它把「读」和「记」放在同一个界面里,并且读完能直接问模型:
8
+
9
+ - **读三种** —— 订阅(newsletter、播客、YouTube、博客)、电子书、论文;
10
+ - **记一处** —— 灵感速记、私密日记、读后感。
11
+
12
+ 不需要注册账号,不需要第三方后端。**订阅、书、日记都存在你这台电脑上**;
13
+ 只有你主动点的翻译、云端朗读、云端识别才会把内容发出去,界面每次都写明。
14
+
15
+ `MIT` · 4 个主视图 · 25 个 agent 工具
16
+
17
+ ---
18
+
19
+ ## 它长什么样
20
+
21
+ ![订阅视图:左侧是订阅源与文章列表,中间是播客播放器、正文与字幕,右侧是 AI 伴读](docs/images/feeds.png)
22
+
23
+ 四个主视图,用**左侧栏最顶部那组图标**切换。左边三个是**读**(内容从外面进来),
24
+ 最右边一个里装着**记**(内容由你写下)。
25
+
26
+ | | 主视图 | 读什么 / 写什么 |
27
+ | --- | --- | --- |
28
+ | 读 | **订阅** | RSS / Atom 源:newsletter、播客、YouTube 频道、独立博客 |
29
+ | 读 | **书** | 电子书:PDF 按原版式读,EPUB / MOBI / AZW3 / AZW / TXT 重排读 |
30
+ | 读 | **论文** | 按 arXiv 编号 / DOI / 标题导入,先看速读卡再决定读不读 |
31
+ | 记 | **日记** | 里面分三块:**灵感速记**、**私密日记**、**读后感** |
32
+
33
+ **「记」为什么是一块而不是三块**:这三个模块共用同一份存储、同一个页脚、同一条
34
+ 「只在本机」的边界;写读后感就是从「读完」那一行进来的同一个页面,不是另一件工具。
35
+ 在顶上再拆三个 tab,只会让人以为得先找到一个入口才能下笔。
36
+
37
+ > **RSS / feed 是什么**:一个网站提供的「更新列表」地址。订阅它就是让阅读器替你
38
+ > 盯着那个站,有新文章自动收进来。下面提到的 newsletter、播客、博客,本质都是这个。
39
+
40
+ ---
41
+
42
+ ## 装之前,先确认四件事
43
+
44
+ | 需要 | 说明 |
45
+ | --- | --- |
46
+ | **DeepSeek Harness 桌面端** | 在 **0.2.2-rc.1** 上开发与测试。更低版本没实测过,遇到怪问题先升级宿主 |
47
+ | **macOS** | 开发与测试都在 macOS。Windows / Linux **未实测**,已知差异见下 |
48
+ | **Node.js 18 或更高** | **只有从源码安装时才需要** —— 仓库不含构建产物,得自己构建一次 |
49
+ | 一个可用的模型 | 翻译、解读、「问 AI」都用 Harness 里**当前选中**的模型,插件不代付、不代理 |
50
+
51
+ **非 macOS 的两处已知差异**:扫描版 PDF 的**本机 OCR 用不了**(用的是 macOS Vision);
52
+ 系统钥匙串取不到时,私密日记的密钥会退回 `0600` 文件而不是钥匙串(代码里有兜底,会告诉你)。
53
+
54
+ 不知道有没有 Node:终端执行 `node -v`,显示 `v18.x` 以上就行。
55
+
56
+ ---
57
+
58
+ ## 安装
59
+
60
+ ### 方式一:从 npm 装(推荐,不需要 Node)
61
+
62
+ 1. 侧栏点 **「插件」** → **「添加插件」**;
63
+ 2. 「包名或地址」填 `dsh-npie-reader`;
64
+ 3. 点 **安装**,再点 **启用**;
65
+ 4. **完全退出 App(`Cmd+Q`)再打开**,回到面板按 `Cmd+Shift+R` 强刷。侧栏出现
66
+ **「澄境 | Limina」** 即为装好。
67
+
68
+ > 之前用本地目录装过这个插件的,先「卸载」再装这一版。
69
+
70
+ ### 方式二:从源码装(想改代码时用)
71
+
72
+ 先构建一次:
73
+
74
+ ```bash
75
+ git clone https://github.com/BannyLon/dsh-npie-reader.git
76
+ cd dsh-npie-reader
77
+ npm install # 装 4 个构建依赖
78
+ npm run build # 生成 lib/index.js 与 lib/client.js
79
+ ```
80
+
81
+ 没有 git 就打开仓库页 → **Code** → **Download ZIP** → 解压,在解压出的目录里跑那两条
82
+ `npm` 命令。
83
+
84
+ 再装进 App:
85
+
86
+ 1. 侧栏点 **「插件」** → **「添加插件」**,「包名或地址」填**那个目录的绝对路径**;
87
+ 2. 点 **「立即启用」**;
88
+ 3. **完全退出 App(`Cmd+Q`)再打开**,回到面板按 `Cmd+Shift+R` 强刷。侧栏出现
89
+ **「澄境 | Limina」** 即为装好。
90
+
91
+ > `npm run build` 不能省。跳过会报找不到 `lib/index.js`,或启动即 `failed to import`。
92
+
93
+ 细节(`link:` 前缀、对账机制、`failed to import` 逐条排查)见
94
+ [安装与启动细节](docs/development.md#安装与启动细节)。
95
+
96
+ ---
97
+
98
+ ## 第一次打开:四个视图各自的第一步
99
+
100
+ 进入插件后,**左侧栏最顶部**有一组四个图标,从左到右是 **订阅 / 书 / 论文 / 日记**;
101
+ 同一行往右依次是频道名、添加(`+`)、搜索、刷新,**最右端是设置齿轮**。
102
+
103
+ ![订阅视图:左栏是订阅源与文章列表,右侧没打开文章时给上手提示](docs/images/feeds-empty.png)
104
+
105
+ | 你想做的事 | 点哪里 | 第一件事 |
106
+ | --- | --- | --- |
107
+ | 订几个作者 | **订阅** | 点 `+` → **「粘贴订阅地址」**;想从内置目录挑就选 **「浏览推荐源」** |
108
+ | 读一本电子书 | **书** → 书架 | 先点 **设置(齿轮)→ 电子书书架**,加一个本机目录作为书源 |
109
+ | 读一篇论文 | **论文** | 粘 arXiv 编号(如 `2401.00001`)或 DOI,也可以直接上传 PDF |
110
+ | 记一条想法 | **日记** | 打开就是灵感速记,写完点 **「记下来」**(或按 `⌘↵`) |
111
+
112
+ **设置齿轮只在「订阅」和「书」这两个视图里有**(在工具栏右端)。论文与日记的选项
113
+ 就摆在各自界面上,没有单独一页 —— 论文的翻译在顶部两颗胶囊里,日记的搜索/导出在
114
+ 它自己的工具条里。设置页分七类:阅读体验 / 电子书书架 / 字幕与识别 / 朗读 /
115
+ 订阅管理 / 快捷提示词 / 关于。
116
+
117
+ ---
118
+
119
+ ## 读 · 订阅
120
+
121
+ 把你信得过的作者集中到一处。**粘链接就行,不用自己翻页面找 feed。**
122
+
123
+ ![探索订阅:内置目录按 Newsletter / 独立博客 / 播客 / AI 动态分类,每行标明更新时间与文章数](docs/images/feeds-explore.png)
124
+
125
+ - **三种来源都吃**:RSS 2.0 / Atom / RDF。粘 **Apple Podcasts**、**小宇宙**、**YouTube**
126
+ 的节目或频道链接,会自动反查出订阅源(Apple 走 iTunes 目录最稳;小宇宙不公开 RSS,
127
+ 只能经 Apple 中国区目录反查;YouTube 只能拿到频道级 feed)。
128
+ - **内置目录带体检**:点「+」→「浏览推荐源」,里面有 Newsletter 18 家 + 独立博客 404 家,
129
+ 每行标「最新一篇 N 天前 / 已 N 天未更新 / 上次体检没抓到」,页脚写体检日期。
130
+ - **分组与历史**:自己的源按分组排在最前,目录里没订阅的接在后面;某个源可以
131
+ **「补全历史文章」**,把更早的条目往回追进来。
132
+ - **正文语言四档**:原文 / 译文 / 对照 / 改写,在下拉里选(「对照」要等译文生成后才出现)。
133
+ - **播客能听,也能读**:单集边听边跟字幕,字幕本身还有「原文 / 双语 / 中文」一键轮转;
134
+ 字幕翻译**先走 Google 免费端点,不通自动落到模型**,并告诉你这次用的是哪个。
135
+ - **没有字幕也不绝望**:中文播客实测普遍不带字幕,可在**本机**把音频转成字幕
136
+ (音频不出本机、不需要任何 key;首次要下一两百 MB 模型)。
137
+ - 读的时候随时**带着这篇问 AI**,或让它生成导读。
138
+
139
+ 细节见[订阅与信息源](docs/features.md#订阅与信息源)、[播客、字幕与语音](docs/features.md#播客字幕与语音)。
140
+
141
+ ## 读 · 书
142
+
143
+ 本地目录、你自己的网盘里的书,配好书源就能读。
144
+
145
+ ![书架:左侧书架带封面与书源标签,右侧是上手引导](docs/images/books.png)
146
+
147
+ 点任意一本进阅读页 —— 左边书架、中间正文、右边伴读:
148
+
149
+ ![书阅读页:左侧书架带封面,中间是重排正文,顶部工具栏可切伴读、译文、划线、目录与配色,右侧是 AI 伴读](docs/images/book-reading.png)
150
+
151
+ - **PDF 按原版式**:内置 pdf.js,页面原样渲染 —— 页内链接能点(外链开浏览器、
152
+ 内部目的地跳到对应页),划词翻译落在书页底部的独立浮层。版面固定,**字号改不了**,
153
+ 只能调配色(原色 / 护眼 / 薄荷 / 夜间四档)与亮度。
154
+ - **重排格式**:EPUB / MOBI / AZW3 / AZW / TXT 走重排 —— 字号、行高、版心可调,
155
+ **六种纸色**(白色 / 纸张 / 护眼 / 雾蓝 / 深色 / 纯黑),书自带目录可用,
156
+ 支持全书搜索与划线笔记。重排不还原原书图片与版式,要原版式请先转 PDF。
157
+ - **读得下去**:抽正文 → 切章 → **逐章中文解读**;整本可导出成 agent 按需加载的
158
+ skill 包,让模型一次只读一章。
159
+ - **听得下去**:朗读用本机或你自配的云端语音,可定时关闭,可导出 MP3。
160
+ - **读完就写**:在阅读器顶部点 **「标记读完」**,回到 **书 → 阅读** 并切到 **「读完」**
161
+ 这一筛,那一行会出现 **「写读后感」**,点进去直接落到日记的读后感模块,
162
+ 并带着这本书的划线侧栏。
163
+
164
+ 书源在 **设置(齿轮)→ 电子书书架** 里配:加一个本机目录、授权一个网盘、生成书单,
165
+ 三步走完书架就有书了。
166
+
167
+ ![设置 → 电子书书架:本地目录、网盘授权、生成书单三步](docs/images/book-settings.png)
168
+
169
+ 细节见[电子书](docs/features.md#电子书)。
170
+
171
+ ## 读 · 论文
172
+
173
+ 论文和书的差别是**结构可预期**:先看标题、作者、venue、摘要,再决定读不读。
174
+
175
+ ![论文库:每行是一张速读卡,标着 arXiv 编号与阅读进度](docs/images/papers.png)
176
+
177
+ 点开一篇就是原版式 PDF,右侧挂着伴读:
178
+
179
+ ![论文阅读页:左侧是论文库,中间按原版式渲染 PDF,右侧是 AI 伴读](docs/images/paper-reading.png)
180
+
181
+ - **三种导入方式**:arXiv 编号 / DOI / 标题,或直接上传本地 PDF。开放获取的会
182
+ 自动补下全文(元数据来自 **arXiv → Crossref → OpenAlex**),付费墙内的给你
183
+ DOI 落地页并提示手动上传。
184
+ - **速读卡**:标题 / 作者 / venue / 摘要 / 标签 / 进度,先做决定再打开正文。
185
+ - **页级翻译**:翻译本页或翻译全本,公式、图、表格、版面保留,译文按页落盘缓存,
186
+ 重新打开插件也不用重译。
187
+ - **写论文用得上的两件**:复制 BibTeX 引用;补全元数据(只填空着的字段,已有的
188
+ 标题摘要绝不覆盖)。
189
+ - **落盘之后就是一本普通 PDF**:目录、找词、划词、划线、逐章解读、读后感全部原样
190
+ 复用书架那条链路。
191
+
192
+ 细节见[论文](docs/features.md#论文)。
193
+
194
+ ## 记 · 灵感 / 日记 / 读后感
195
+
196
+ 三块,一个页面,都只在本机。
197
+
198
+ ![记视图:顶部三个 tab 依次是灵感速记、私密日记、读后感,左侧是标签云与时间线](docs/images/notes.png)
199
+
200
+ **灵感速记** —— 打开即写;在订阅、书、论文里按 `L` 随时唤起浮层(日记页不响应,
201
+ 那儿本来就有输入框)。标签云 + 时间轴,也能把一条灵感挂到某本书上,
202
+ 形成「书 → 想法」的流转。
203
+
204
+ ![灵感速记:卡片按时间铺开,左侧是标签云与时间线](docs/images/notes-ideas.png)
205
+
206
+ **私密日记** —— 一天一篇,AES-256-GCM 独立加密,密钥在系统钥匙串;钥匙串不可用时
207
+ 退回 0600 文件并**如实告诉你**。带情绪与日历,日历只统计私密条目。
208
+
209
+ ![私密日记:左边日历只统计私密条目,右边是当天的日记与心情](docs/images/notes-diary.png)
210
+
211
+ **读后感** —— **只对标记为「读完」的书开放**,结构化模板,旁边挂这本书的划线。
212
+ 也可以从日记视图直接进来,手动选书。
213
+
214
+ ![读后感:左侧只列已读完的书,中间写读后感,右侧挂着这本书的划线](docs/images/notes-review.png)
215
+
216
+ 三块共用一套存储与页脚;顶部搜索、导出、垃圾桶都跟着当前模块走,不会串档。
217
+
218
+ 细节见[日记与灵感](docs/features.md#日记与灵感)。
219
+
220
+ ---
221
+
222
+ ## 给 agent 用
223
+
224
+ 25 个工具,按前缀分四组:`rss_*`(9)· `book_*`(6)· `diary_*`(5)· `paper_*`(5)。
225
+ 在 Harness 对话里说「把我订阅的 newsletter 这三天讲了什么汇总一下」,走的就是这些。
226
+
227
+ 护栏有三条,值得先说:**私密日记对模型不可见**(`scope` 固定 public,读不到也改不到);
228
+ **改与删必须先 `diary_today` 拿到编号**,模型不能自己数;**没有 `paper_delete`** ——
229
+ 删论文连 PDF 一起删,这条路留给你自己点。
230
+
231
+ 语义、时间窗、检索闸门与内置目录取舍见[Agent 能力](docs/agent-tools.md)。
232
+
233
+ ## 你的数据在哪
234
+
235
+ | 内容 | 位置 |
236
+ | --- | --- |
237
+ | 设置、订阅、书单索引、阅读进度 | `~/.dsh/storages/dsh-npie-reader/` |
238
+ | 灵感 / 读后感(明文)与私密日记(加密) | 同一目录下的 `daily/` 与 `private/` |
239
+ | 音频缓存、页译文缓存、本机识别模型 | 同一目录;删掉只会重新生成,不动你的内容 |
240
+
241
+ - **备份**:拷走整个 `dsh-npie-reader` 目录。私密日记要能解开,还得有**同一台机器**
242
+ 钥匙串里的那把钥匙(换机器后旧条目只能看到密文)。
243
+ - **卸载**:先在插件面板停用、再删插件目录;**数据目录不会自动删**,要清干净得自己删。
244
+ - 你填过的云端语音 / 识别 API key 存在同目录的设置文件里(文件权限 `0600`,
245
+ 仅当前用户可读),**不在**系统钥匙串里。
246
+
247
+ ## 常见问题
248
+
249
+ **装完侧栏没有入口?** 确认走完了重启那步(`Cmd+Q` 完全退出后重开)。还没有就查日志里有
250
+ 没有 `service started`:源码装的跑一遍 `npm run build` 再重启;npm 装的先卸载同名旧版再装。
251
+
252
+ **订阅加了却不显示文章?** 有些站点的 feed 只给最近 10 篇摘要,正文要单独抓;
253
+ 还有的要求登录。「补全历史」能往回追,但追不到站上没公开的内容。
254
+
255
+ **电子书列表是空的?** 还没配书源。设置 → 电子书书架 → 加一个本机目录。
256
+ 网盘(百度)需要先注册开放平台应用,属于可选步骤。
257
+
258
+ **翻译一直转圈?** 翻译用的是 Harness 当前选中的模型:确认 Harness 里配了可用模型,
259
+ 且它能正常对话。Google 字幕翻译不通会自动落到模型,不影响使用。
260
+
261
+ **能读公众号吗?** 不能 —— 公众号没有官方 RSS。可以自己搭一个转 RSS 服务,
262
+ 把它的 feed 地址订阅进来。
263
+
264
+ **日记会被模型看到吗?** 私密日记不会(对模型完全不可见);灵感与读后感是明文,
265
+ 模型能读到 —— 需要它帮你整理时,这正是前提。
266
+
267
+ ---
268
+
269
+ ## 开发
270
+
271
+ ```bash
272
+ npm install
273
+ npm run build # lib/ 不入库,发布前现建
274
+ npm test # 单元测试
275
+ npm run verify # 构建 + 单测 + 契约守卫
276
+ ```
277
+
278
+ 带真 Chrome 的视觉 / 布局检查需要本机浏览器,单独跑 `npm run verify:all`。
279
+ 完整命令、守卫脚本与内部契约见 [开发](docs/development.md)。
280
+
281
+ ## 已知边界
282
+
283
+ - **不抓公众号**:只能读你自己搭的转 RSS 服务。
284
+ - **Win / Linux 未实测**:本机 OCR 只在 macOS 可用(依赖 macOS Vision);钥匙串取不到时
285
+ 私密日记退回 `0600` 文件。
286
+ - **重排不还原图片与原版式**(EPUB / MOBI / AZW3),要原版式请先转 PDF。
287
+ - **PDF 不能改字号**(版面固定),只能调配色与亮度。
288
+ - **论文没有朗读**,朗读只在播客与重排电子书上。
289
+ - **云端语音识别会上传音频**,界面上明说;本机识别则不出本机。
290
+ - **翻译与解读只用 Harness 当前选中的模型**,插件不代付、不代理。
291
+
292
+ 做不到的、故意不做的、已知没解决的,全部列在 [边界与已知限制](docs/limits.md)。
293
+
294
+ ## 文档
295
+
296
+ | 文档 | 内容 |
297
+ | --- | --- |
298
+ | [功能详解](docs/features.md) | 48 项功能的完整说明,以及每一项「为什么这么做」 |
299
+ | [Agent 能力](docs/agent-tools.md) | 工具语义、时间窗、检索闸门、内置目录取舍 |
300
+ | [设计笔记](docs/design-notes.md) | 已修正的缺陷:现象 / 根因 / 修法 / 守卫用例 |
301
+ | [开发](docs/development.md) | 构建、测试、守卫脚本、契约、数据位置、安装细节 |
302
+ | [边界与限制](docs/limits.md) | 做不到的、故意不做的、已知没解决的 |
303
+ | [CHANGELOG](CHANGELOG.md) | 逐版本变更 |
304
+
305
+ ## 安全
306
+
307
+ 插件**不内置任何凭证**、没有作者的服务器;私密日记独立加密且对模型不可见;
308
+ 本地路由自带回环校验(挡 DNS rebinding),外抓第三方地址有私网守卫。
309
+
310
+ 安全设计与**明确的残余风险**见 [SECURITY.md](SECURITY.md)。发现漏洞请走
311
+ GitHub 的 **Security → Report a vulnerability**,不要开公开 issue。
312
+
313
+ ## 许可
314
+
315
+ MIT(`Copyright (c) 2026 Banny`)。第三方组件的许可与版权行见
316
+ [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md):pdf.js(Apache-2.0)、
317
+ Milkdown(MIT)、agentero motif(MIT)、chinese-independent-blogs(MIT)、shuting(MIT)。
@@ -0,0 +1,82 @@
1
+ # 第三方组件归属 / Third-Party Notices
2
+
3
+ dsh-npie-reader 自身的代码以 MIT 发布(见 `LICENSE`)。本文件列出随仓库分发、
4
+ 或被打包进产物的第三方组件及其许可。
5
+
6
+ 维护方式:新增第三方依赖时在下面加一节;`vendor/` 下的产物必须同时放入对应的许可文件。
7
+
8
+ ---
9
+
10
+ ## 1. pdf.js 6.4.299
11
+
12
+ - 位置:`vendor/pdfjs/`
13
+ - 许可:Apache License 2.0
14
+ - 版权:Copyright 2024 Mozilla Foundation
15
+ - 许可正文:`vendor/pdfjs/pdf.mjs` 与 `vendor/pdfjs/pdf.worker.mjs` 文件头的 `@licstart` 块;
16
+ `vendor/pdfjs/wasm/LICENSE_JBIG2`、`LICENSE_QCMS`、`LICENSE_OPENJPEG`
17
+ - 升级方式:见 `vendor/pdfjs/README.md`
18
+
19
+ ## 2. Milkdown 7.22.3
20
+
21
+ - 位置:`vendor/editor/editor.mjs`(由 `src/vendor/editor-entry.js` 经 esbuild 打包)
22
+ - 来源包:`@milkdown/kit`(devDependency)
23
+ - 许可:MIT
24
+ - 版权:Copyright (c) 2020-present Mirone
25
+ - 许可正文:`vendor/editor/LICENSE`
26
+
27
+ ## 3. agentero motif(页级排版算法)
28
+
29
+ - 位置:`src/client/paper-reflow/`
30
+ - 许可:MIT
31
+ - 版权:Copyright (c) 2026 poco-ai
32
+ - 许可正文:`src/client/paper-reflow/MOTIF-LICENSE.txt`
33
+ - 说明:移植的是排版算法本身;适配层、字体度量与阅读顺序实现为本仓库自有代码。
34
+
35
+ ## 4. chinese-independent-blogs(内置订阅目录)
36
+
37
+ - 位置:`vendor/chinese-independent-blogs/`
38
+ - 许可:MIT
39
+ - 版权:Copyright (c) 2019 Tim Qian
40
+ - 许可正文:`vendor/chinese-independent-blogs/LICENSE`
41
+ - 说明:仅包含目录数据(站点名 / URL / 分类),不含其站点内容。
42
+
43
+ ## 5. shuting(多音字词典与 MP3 拼接判据)
44
+
45
+ - 位置:`src/speech-pronunciation.js`(多音字词表与「一次扫描 + 最长匹配」判据)、
46
+ `src/speech-export.js`(`src/core/mp3.ts` 的「剥 ID3 + 按比特位找同步头 + 原样相接」判据)
47
+ - 许可:MIT
48
+ - 版权:Copyright (c) 2026 Zanbin Xu
49
+ - 移植范围:只搬词条与判据,未搬其用户自定义词典,也未搬整本一键导出
50
+ - 许可正文:
51
+
52
+ ```text
53
+ MIT License
54
+
55
+ Copyright (c) 2026 Zanbin Xu
56
+
57
+ Permission is hereby granted, free of charge, to any person obtaining a copy
58
+ of this software and associated documentation files (the "Software"), to deal
59
+ in the Software without restriction, including without limitation the rights
60
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
61
+ copies of the Software, and to permit persons to whom the Software is
62
+ furnished to do so, subject to the following conditions:
63
+
64
+ The above copyright notice and this permission notice shall be included in all
65
+ copies or substantial portions of the Software.
66
+
67
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
68
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
69
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
70
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
71
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
72
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
73
+ SOFTWARE.
74
+ ```
75
+
76
+ ---
77
+
78
+ ## 不属于本仓库的引用
79
+
80
+ - **dalibre**:仅在 `CHANGELOG.md` 中作为「功能可移植性评估」的参考对象被提及,
81
+ 本仓库不包含其任何代码。
82
+ - **calibre**:仅在测试用例注释中出现,用于描述 calibre 生成的电子书结构特征。
@@ -0,0 +1,8 @@
1
+ # dsh-npie-reader bundle patch: inserts the reader plugin row into the profile
2
+ # roster. One `insert` row mounts both halves:
3
+ # - host 半区 (lib/index.js): `rss` 服务、25 个 agent 工具、订阅抓取与本地存储
4
+ # - client 半区 (lib/client.js): 侧边栏入口 + 阅读面板 + 原生对话伴读
5
+ # 生效方式:`dsh plugin --profile <name> add link:<this-dir>`,之后重启该 profile。
6
+ - insert:
7
+ - id: npie-reader
8
+ name: 'dsh-npie-reader'