@a9i5k4/dsh-literature 0.1.0 → 0.1.2

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 CHANGED
@@ -48,18 +48,34 @@ dsh plugin --profile web add @a9i5k4/dsh-literature
48
48
 
49
49
  ## 配置
50
50
 
51
- 侧窗右上角齿轮进入设置:
51
+ 侧窗右上角齿轮进入设置(分类:保存与导出 / 识别与下载 / 行为与界面 / 本地文献库):
52
52
 
53
53
  | 项 | 说明 | 默认 |
54
54
  |---|---|---|
55
- | 保存方式 | `文献库`:写入本地文献库;`目录`:导出文件三件套 | 文献库 |
56
- | 导出目录 | 目录模式的目标路径 | |
57
- | 命名规则 | `{author} {authors} {year} {title} {journal} {doi} {arxiv}` | `{author}_{year}_{title}` |
55
+ | 保存方式 | `文献库`:写入本地文献库;`目录`:导出文件 | 文献库 |
56
+ | 导出目录 / 命名规则 / 导出侧车 | 目录模式的目标路径、命名模板、CSL-JSON/RIS 选择 | `{author}_{year}_{title}` |
58
57
  | 默认标签 | 保存时附加,逗号分隔 | 空 |
58
+ | 自动解析 / 标题识别 / 自动扫描回复 | 识别策略与误报控制 | 开 / 开 / 关 |
59
+ | 重试次数 / 下载超时 | 网络重试与超时控制 | 3 次 / 30s |
60
+ | 重复条目策略 | 询问 / 保留库中 / 覆盖为新版本 | 询问 |
61
+ | 面板宽度 / 阅读器默认缩放 | 浮窗尺寸与阅读初始视图 | 380px / 适应宽度 |
59
62
  | Unpaywall 邮箱 | 开放获取查询的请求方标识(建议填写) | 空 |
60
- | 自动扫描回复 | 把模型回复中出现的文献自动入窗(可能有误报) | |
61
- | 文献库端口 | 本地文献库的 HTTP 端口 | 23119 |
62
- | 数据目录 | 自动探测,可手动覆盖 | 自动 |
63
+ | 文献库端口 / 数据目录 | 连接参数,可手动覆盖 | 23119 / 自动 |
64
+
65
+ ## dsh-better-sidebar 集成
66
+
67
+ 若安装了 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)(右侧栏工作台),插件会自动检测并**把「文献」作为右侧栏的一个 tab** 注册(`ctx.betterSidebar.registerTab`),不再占用 DSH 左侧栏底部的按钮位,避免与其它插件入口挤兑。未安装时则回退为左侧栏入口 + 浮窗。
68
+
69
+ ## 付费墙与需要登录的文献
70
+
71
+ 全文抓取仅使用出版商公开的开放获取来源。当文献需要**登录或机构订阅**时:
72
+
73
+ 1. 条目会明确标记为「需要登录」,并给出原因
74
+ 2. 点击「打开登录页」在浏览器中完成登录 / 机构访问
75
+ 3. 下载 PDF 后回到侧窗点「导入本地 PDF」选择文件
76
+ 4. 插件校验文件、写入影子库并自动执行保存流程(入库或导出目录)
77
+
78
+ > 出于版权与合规考虑,插件不接入任何破解 / 镜像来源,也不代为保存账号密码。
63
79
 
64
80
  ## 工作原理
65
81
 
@@ -96,7 +112,7 @@ dsh plugin --profile web add @a9i5k4/dsh-literature
96
112
  确认文献库已启动、保存目标(当前选中集合)可写;侧窗顶部会显示连接状态。
97
113
 
98
114
  **付费文献下载失败?**
99
- 无 OA 来源时条目会标记为"付费墙",可手动打开来源页或导入本地 PDF
115
+ 条目会标记为"需要登录/付费墙":先点「打开登录页」完成登录,下载 PDF 后点「导入本地 PDF」即可入库,无需手动建条目。
100
116
 
101
117
  **修改设置后没生效?**
102
118
  设置即时落盘;修改端口后需重启文献库使其生效。