@a9i5k4/dsh-literature 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aik (a9i5k4)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# DSH Literature · 文献侧窗
+
+> 在 DeepSeek Harness 侧边栏里识别、下载、阅读并归档学术文献。
+> 对话中出现的 DOI / arXiv ID / 标题，一键落入本地文献库，全文随取随读。
+
+[![npm version](https://img.shields.io/npm/v/@a9i5k4/dsh-literature)](https://www.npmjs.com/package/@a9i5k4/dsh-literature)
+[![npm downloads](https://img.shields.io/npm/dt/@a9i5k4/dsh-literature)](https://www.npmjs.com/package/@a9i5k4/dsh-literature)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)]()
+
+---
+
+## 特性
+
+- **自动识别** —— 从模型回复或粘贴文本中解析 `DOI`、`arXiv`、`PMID`、`ISBN` 与标题引用，去重后生成侧窗条目
+- **元数据抓取** —— 内置 Crossref / arXiv / OpenAlex 解析，自动补全标题、作者、期刊、年份与摘要
+- **全文下载** —— 按 OA 来源（arXiv、OpenAlex OA、Unpaywall、出版商 `citation_pdf_url`）抓取 PDF，失败时给出明确原因并支持重试
+- **保存归档** —— 一键写入**本地文献库**（兼容 Zotero 生态，走官方 Connector 协议），或导出为 `PDF + .csl.json + .ris` 三件套到任意目录
+- **侧窗阅读** —— 内置 PDF 阅读器：缩放、翻页、目录跳转、全文搜索、高亮与笔记
+- **冲突预览** —— 库中已有相似条目时，先展示字段级差异再决定保留 / 覆盖 / 合并
+- **完全本地** —— 所有请求经本机回环接口转发，无遥测、无云端中转、无账号依赖
+
+## 安装
+
+要求：DeepSeek Harness（`dsh` CLI）已安装，Node ≥ 20。
+
+```bash
+dsh plugin --profile web add @a9i5k4/dsh-literature
+```
+
+> 本地开发时可改用 `dsh plugin --profile web add D:/path/to/dsh-literature`（`link:` 协议）。
+
+安装后重启 `dsh web`，左侧边栏底部会出现「文献」入口。
+
+## 快速开始
+
+1. 点击侧边栏「文献」打开侧窗
+2. 直接粘贴一段含文献的文本，或让模型在回复中调用 `zotero_lookup` 工具
+3. 条目进入侧窗后：**下载全文 → 阅读 → 保存**
+
+```
+对话回复                       侧窗动作
+─────────────────────────────  ─────────────────────────────
+"参考 DOI: 10.1038/xxxx"   →   条目出现，自动解析元数据
+"arXiv:1706.03762"         →   一键下载全文 PDF
+点击「保存」                →   写入本地文献库（或导出目录）
+```
+
+## 配置
+
+侧窗右上角齿轮进入设置：
+
+| 项 | 说明 | 默认 |
+|---|---|---|
+| 保存方式 | `文献库`：写入本地文献库；`目录`：导出文件三件套 | 文献库 |
+| 导出目录 | 目录模式的目标路径 | 空 |
+| 命名规则 | `{author} {authors} {year} {title} {journal} {doi} {arxiv}` | `{author}_{year}_{title}` |
+| 默认标签 | 保存时附加，逗号分隔 | 空 |
+| Unpaywall 邮箱 | 开放获取查询的请求方标识（建议填写） | 空 |
+| 自动扫描回复 | 把模型回复中出现的文献自动入窗（可能有误报） | 关 |
+| 文献库端口 | 本地文献库的 HTTP 端口 | 23119 |
+| 数据目录 | 自动探测，可手动覆盖 | 自动 |
+
+## 工作原理
+
+```
+浏览器侧窗  ── fetch / SSE ──▶  DSH 宿主进程  ── HTTP :23119 ──▶  本地文献库
+  · 识别/状态/进度        · 解析与下载          · 只读查询 / 写入
+  · PDF 阅读器           · 影子索引与笔记
+```
+
+- 浏览器无法直连本地文献库（其 CORS 仅放行特定来源），因此**所有读写都经 DSH 宿主转发**
+- 写入走官方 Connector 协议两步提交：先建父条目，再挂附件
+- 高亮与笔记保存在插件自己的影子存储中，不侵入文献库数据
+- 保存目标为文献库当前选中位置；如需归类集合，先在文献库中选择对应集合
+
+## 数据与隐私
+
+- 元数据与全文下载请求直连公开学术 API（Crossref / arXiv / OpenAlex / Unpaywall），**不经过任何第三方中转**
+- 插件仅监听 `127.0.0.1` 回环路由，非本机请求一律返回 403
+- 无遥测、无统计、不上传任何本地数据
+
+## 兼容性
+
+| 组件 | 版本 |
+|---|---|
+| DeepSeek Harness | ≥ 0.1.1-rc.2（Cordis v4） |
+| 本地文献库 | 8.x（Zotero 生态，本地 HTTP API v3 / Connector API） |
+| Node | ≥ 20 |
+
+> 本插件与文献库官方无任何附属关系，为独立的开源兼容实现。
+
+## 常见问题
+
+**保存后文献库没出现条目？**
+确认文献库已启动、保存目标（当前选中集合）可写；侧窗顶部会显示连接状态。
+
+**付费文献下载失败？**
+无 OA 来源时条目会标记为"付费墙"，可手动打开来源页或导入本地 PDF。
+
+**修改设置后没生效？**
+设置即时落盘；修改端口后需重启文献库使其生效。
+
+## 开发
+
+```bash
+npm install
+npm run build      # 产物输出到 lib/
+npm run smoke      # 逻辑冒烟
+npm run test       # 宿主侧端到端（模拟请求）
+```
+
+```
+src/
+├── node/          # 宿主侧：路由 / 识别 / 元数据 / 下载 / 写入 / 影子库
+│   ├── zotero/    # 与本地文献库交互（只读查询 + Connector 写入）
+│   ├── metadata/  # Crossref · arXiv · OpenAlex
+│   └── fetch/     # OA 全文获取与重试
+└── client/        # 浏览器侧：侧窗 UI / PDF 阅读器（pdf.js 自捆）
+```
+
+## License
+
+[MIT](LICENSE)
+
+商标声明：本插件与 Zotero 官方无任何关联。"Zotero" 为其版权所有者的商标，此处仅用于描述兼容性。

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# dsh-literature bundle patch: inserts the plugin row into the web profile roster.
+# Applied as a profile bundle layer (the `dsh.bundle.patch` manifest field).
+#
+# The node half (exports ".") runs in the host process:
+#   - /api/dsh-literature/* loopback-only routes (state, scan, resolve, fetch, save, events)
+#   - zotero_lookup / zotero_save agent tools
+#   - session/event fallback scanning (off by default)
+# The `dsh.client` declaration in package.json makes the browser half
+# (exports "./client", served at /plugins/<id>/client.js) load in the web GUI.
+- insert:
+    - id: dsh-literature-pre
+      name: '@a9i5k4/dsh-literature'