dsh-research-desk 0.0.0-stage → 0.2.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/LICENSE +21 -0
- package/README.md +170 -2
- package/cordis.patch.yml +4 -0
- package/index.json +68 -0
- package/lib/client.js +597 -0
- package/lib/desk.mjs +368 -0
- package/lib/export.mjs +353 -0
- package/lib/host.mjs +889 -0
- package/lib/llm.mjs +94 -0
- package/lib/mcp.mjs +428 -0
- package/lib/qa.mjs +208 -0
- package/lib/review.mjs +254 -0
- package/lib/runner.mjs +498 -0
- package/lib/search.mjs +300 -0
- package/lib/settings.mjs +338 -0
- package/lib/stats.mjs +297 -0
- package/lib/store.mjs +150 -0
- package/lib/util.mjs +69 -0
- package/package.json +54 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 dsh-research-desk contributors
|
|
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,171 @@
|
|
|
1
|
-
#
|
|
1
|
+
# dsh-research-desk · 科研工作台
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
DeepSeek Harness 插件:把「查文献 → 精读 → 问答 → 选题 → 草稿」这条科研工作流做成一个可复用的工作台,
|
|
4
|
+
**并且每一条引文都回到原文逐字核对**。
|
|
5
|
+
|
|
6
|
+
- 插件包名:`dsh-research-desk`(MIT,零运行时依赖,零构建步骤)
|
|
7
|
+
- 宿主要求:DSH `>=0.2.1-rc.5 <0.3.0`,Node `>=22`
|
|
8
|
+
- 状态:代码与测试在本机跑通;**尚未在桌面宿主里安装验证**(本机 `dsh` CLI 不在 PATH,只能走 GUI 插件页或自定义插件索引安装)
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. 它解决什么
|
|
13
|
+
|
|
14
|
+
调研报告《开源科研工作台全景调研分析报告》给出的结论是:严格跑通「文献→假设→实验→论文」四段闭环的开源项目 = 0 个,
|
|
15
|
+
生态真实形态是 8 层栈(L1 文献 / L2 综述 / L3 精读 / L4 选题假说 / L5 实验计算 / L6 可复现 / L7 写作出版 / L8 协作评审),
|
|
16
|
+
瓶颈在 L4(选题假说)与 L6(可复现),而这两层恰好是现有生态最薄弱的。
|
|
17
|
+
|
|
18
|
+
本插件覆盖其中**不需要实验设备、可以真做出来的五段**:L1 检索与文献库、L3 精读与带锚点问答、L4 选题假说、L7 草稿,
|
|
19
|
+
外加一条贯穿式约束:**引用必须可核验**。
|
|
20
|
+
|
|
21
|
+
对应调研报告里最硬的负面证据:
|
|
22
|
+
|
|
23
|
+
- Ideation–Execution Gap(arXiv 2506.20803 / Science 10.1126/science.aeb7969):43 位专家各花 100 小时以上盲审执行,
|
|
24
|
+
AI 生成的假设在 novelty / excitement / effectiveness / overall 四项上**全部显著更差**(p<0.05),部分排序直接反转。
|
|
25
|
+
- arXiv 2608.05179 的验证缺口审计:9 个自称闭环的 L4 系统里 7 个只是机械重跑,**没有一个有外部在环 oracle**。
|
|
26
|
+
- PNAS 2026;123(44) doi 10.1073/pnas.2610214123 归纳的五类失效模式;只看手稿的检出率只有 53.7%(F1 0.42),
|
|
27
|
+
给日志和代码才升到 81.5%(F1 0.81)。
|
|
28
|
+
- GhostCite(arXiv 2602.06718):LLM 引用幻觉率 14.23%–94.93%,76.7% 的评审者根本不核引用。
|
|
29
|
+
|
|
30
|
+
所以这个插件的设计取向是**反着做**:能力宁可少,不可假。
|
|
31
|
+
- 问答只从已入库的全文回答;**没有命中就根本不调模型**(不是让模型自由发挥后再标个"不确定")。
|
|
32
|
+
- 模型给的引文逐条与原文片段比对,**对不上就剔除并计入 `unverified`**,而不是照样显示。
|
|
33
|
+
- 选题阶段明确告诉模型"你只拿到了摘要,不许声称机制已被证明",要求每个选题写出**能杀死它的最便宜实验**。
|
|
34
|
+
- 草稿阶段要求每条主张标注来源 id;**文献库撑不起某节就写缺什么**,不许编。
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## 2. 六个动作
|
|
39
|
+
|
|
40
|
+
Agent 侧只有一个工具 `research_desk`,一个 `action` 参数切换;侧栏面板走同源 HTTP 桥,打到同一份状态文件。
|
|
41
|
+
|
|
42
|
+
| action | 作用 | 关键参数 |
|
|
43
|
+
|---|---|---|
|
|
44
|
+
| `status` | 库内篇数、选题数、草稿数、当前默认模型 | — |
|
|
45
|
+
| `models` | 列出宿主可调用的模型 | — |
|
|
46
|
+
| `search` | 检索 arXiv / Europe PMC / OpenAlex(免密钥) | `query` `sources` `maxResults` |
|
|
47
|
+
| `add` | 把检索结果放进文献库(按 doi→arxiv→标题去重) | `papers[]` |
|
|
48
|
+
| `library` | 列出文献库、选题、草稿 | — |
|
|
49
|
+
| `read` | 拉全文并切成可检索片段存进库里 | `paperId` |
|
|
50
|
+
| `ask` | 只用库内全文回答,每条引文核验 | `question` `paperIds` |
|
|
51
|
+
| `hypothesis` | 从文献库推出可证伪选题 | — |
|
|
52
|
+
| `draft` | 生成论文大纲 | `instruction` |
|
|
53
|
+
| `remove` | 移出一篇文献 | `paperId` |
|
|
54
|
+
| `undo` | 撤销上一步 | — |
|
|
55
|
+
|
|
56
|
+
调用示例:
|
|
57
|
+
|
|
58
|
+
```json
|
|
59
|
+
{ "action": "search", "query": "retrieval augmented generation evaluation", "maxResults": 12 }
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## 3. 数据源与免密钥说明
|
|
65
|
+
|
|
66
|
+
三个源都**不需要 API key**,这是刻意的:科研工作者装插件的第一道门槛应该是判断题,不是注册。
|
|
67
|
+
|
|
68
|
+
| 源 | 端点 | 覆盖 | 备注 |
|
|
69
|
+
|---|---|---|---|
|
|
70
|
+
| arXiv | `export.arxiv.org/api/query` | 预印本全文(TeX/HTML) | 自然语言检索用 AND 词链;AND 0 命中自动回退 OR 链 |
|
|
71
|
+
| Europe PMC | `ebi.ac.uk/europepmc/webservices/rest/search` | 生命科学 + PMC 全文 | 优先命中 PMC 全文 |
|
|
72
|
+
| OpenAlex | `api.openalex.org/works` | 全学科 + 引用数 + 摘要倒排索引 | 2026-02-13 起 polite pool 已废,`mailto` 改为可选、缺省不发 |
|
|
73
|
+
|
|
74
|
+
**踩过的坑(已修)**:arXiv 不把裸多词查询当关键词列表。`all:"retrieval augmented generation scientific literature"` 实测 **0 行**(它只做整串短语匹配),
|
|
75
|
+
而 `all:retrieval AND all:augmented AND all:generation` 实测 3 行。所以 `arxivQuery()` 会把自然语言拆成 AND 词链,
|
|
76
|
+
引号短语原样保留,最多 8 个词;AND 链 0 命中再退到 OR 链(最多 5 项)。
|
|
77
|
+
|
|
78
|
+
**全文抓取顺序**:PMC `fullTextXML` → `arxiv.org/html/{id}` → 摘要降级。
|
|
79
|
+
Europe PMC 的 JATS 里混着 `journal-meta / contrib-group / ref-list` 等元数据噪声,会把
|
|
80
|
+
"pmc Innovation (Camb) … 4094 theinnov 101771342" 这种串混进正文开头,已在 `stripHtml()` 里剥掉。
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## 4. 安装
|
|
85
|
+
|
|
86
|
+
三条路,任选其一:
|
|
87
|
+
|
|
88
|
+
1. **自定义插件索引**(推荐,适合自己 fork 迭代)
|
|
89
|
+
桌面端「插件 → 实验性插件 → 自定义插件索引」填:
|
|
90
|
+
`https://raw.githubusercontent.com/<owner>/<repo>/main/index.json`
|
|
91
|
+
或 jsDelivr 镜像 `https://cdn.jsdelivr.net/gh/<owner>/<repo>@main/index.json`(最多晚 12 小时同步)。
|
|
92
|
+
2. **直装包名**:插件页输入 `dsh-research-desk`。
|
|
93
|
+
3. **命令行**(本机 `dsh` CLI 不在 PATH,需先补 PATH):
|
|
94
|
+
```bash
|
|
95
|
+
dsh plugin --profile desktop add dsh-research-desk
|
|
96
|
+
```
|
|
97
|
+
桌面 profile 必须**完全退出**再装,否则安装会静默不生效。
|
|
98
|
+
|
|
99
|
+
装完在侧栏看到「科研工作台」图标即为成功;也可让 agent 直接调 `research_desk` 工具验证。
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## 5. 架构
|
|
104
|
+
|
|
105
|
+
```
|
|
106
|
+
lib/host.mjs host 半片:注册 webServer 前缀路由 + 注册 research_desk 工具
|
|
107
|
+
lib/search.mjs 三源检索 + 全文抓取 + arXiv 查询构造 + HTML/JATS 清洗
|
|
108
|
+
lib/qa.mjs BM25 检索、分块、模型问答、引文逐字核验
|
|
109
|
+
lib/desk.mjs 领域模型与唯一写路径(字段白名单、去重、操作集)
|
|
110
|
+
lib/store.mjs 原子落盘、mtime 重读、串行写队列、30 步 undo
|
|
111
|
+
lib/llm.mjs 模型路由与流式调用(block-end 聚合、sessionId 自带)
|
|
112
|
+
lib/client.js 侧栏面板(免构建 React.createElement)
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
**零依赖、零构建**:没有 npm 依赖,没有 JSX,没有 esbuild。
|
|
116
|
+
`lib/client.js` 直接是 `window.__ModuleLoader__.load({...})` 形态,由宿主模块加载器注入 `react`。
|
|
117
|
+
|
|
118
|
+
**状态文件**:`$DSH_HOME/research-desk/state.json`(Windows 上即
|
|
119
|
+
`C:/Users/<用户>/.dsh/research-desk/state.json`)。桌面端与 Web 端共享这一份。
|
|
120
|
+
写入是「临时文件 + rename」原子替换;每次写前按 mtime 重读,两个宿主进程同时跑不会互相覆盖;
|
|
121
|
+
撤销采用三方回滚(只回滚这一步真正改动的字段,别人之后的改动不动)。
|
|
122
|
+
|
|
123
|
+
**安全边界**:
|
|
124
|
+
- 侧栏只走同源 `POST /api/research-desk/`,并校验 `sec-fetch-site` 与 loopback 来源,非同源一律 403。
|
|
125
|
+
- 请求体上限 512 KB。
|
|
126
|
+
- 模型调用在会话外进行,必须自带 `sessionId`(`dsh-research-desk-<uuid>`),否则部分网关会报 `MissingSessionID`。
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## 6. 测试
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
node --test test/desk.test.mjs test/search.test.mjs # 24 个用例,全绿
|
|
134
|
+
node test/live-probe.mjs # 真实打三个上游的连通性探针
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
- `test/desk.test.mjs`(19 例):字段白名单、去重优先级、状态枚举、证据 id 必须来自库内、
|
|
138
|
+
undo 三方回滚不覆盖他人后续修改、引文核验通过/不通过、模型流失败、无命中不调模型。
|
|
139
|
+
- `test/search.test.mjs`(5 例):arXiv AND/OR 词链、引号短语、词数上限、空查询通配、JATS 噪声剥离。
|
|
140
|
+
- `test/live-probe.mjs`:真实 HTTP 探针(search → fetchFullText → chunkText → retrieve)。
|
|
141
|
+
最近一次实跑:检索 24 篇(三个源全通,`errors=[]`),arXiv 命中 HiPerRAG / HySemRAG / PaperQA / SciRAG;
|
|
142
|
+
全文抓取 86,234 字符 / 99 片段 / 4.3 秒;BM25 命中 4 段(最高分 7.79)。
|
|
143
|
+
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
## 7. 明确的边界(不吹)
|
|
147
|
+
|
|
148
|
+
- **未在宿主内实机安装验证**:本机 `dsh` CLI 不在 PATH,只能走 GUI 插件页或自定义插件索引。
|
|
149
|
+
侧栏面板是否被宿主识别为可渲染 slot,**尚未在真实宿主里验证过**——这是当前最大的未知项。
|
|
150
|
+
- **只覆盖摘要级选题**。选题模型的输入是标题+摘要,不是全文;因此它**不可能**发现机制层面的结论。
|
|
151
|
+
这与调研报告的结论一致:AI 假说的上限就在这里。
|
|
152
|
+
- **没有实验执行、没有统计分析、没有版本化的可复现产物**(对应 8 层栈的 L5/L6,本插件不含)。
|
|
153
|
+
- **没有引文格式化器**(GB/T 7714 / APA 等);引文是自由文本 id 标注。
|
|
154
|
+
- **单用户本地状态**,没有多人协作、没有冲突消解 UI(写入层做了不覆盖,但没做合并界面)。
|
|
155
|
+
- **检索覆盖有限**:三个源不等于全网。Google Scholar 无官方 API,Scopus / Web of Science 需付费订阅,本插件不接。
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## 8. 与调研报告的关系
|
|
160
|
+
|
|
161
|
+
本插件是《开源科研工作台全景调研分析报告》结论的**工程化落点**,不是报告的复述:
|
|
162
|
+
|
|
163
|
+
- 报告说"生态是 8 层栈、跨层需自搭 glue code"→ 本插件把 L1/L3/L4/L7 四层里的**可做部分**连成一条闭环,
|
|
164
|
+
剩下的 L2(综述)、L5(实验)、L6(可复现)、L8(评审)留给 Zotero / DVC / Overleaf / OpenReview 这类成熟件。
|
|
165
|
+
- 报告说"引用污染是当下最贵的坑"→ 本插件把**引文核验做成硬约束**:对不上就剔,并显式报 `unverified`。
|
|
166
|
+
- 报告说"L4 是最薄的一层"→ 本插件的选题动作刻意加了三道闸:只用库内摘要、必须写出能杀死它的实验、
|
|
167
|
+
不许声称机制已被证明。
|
|
168
|
+
|
|
169
|
+
## 许可证
|
|
170
|
+
|
|
171
|
+
MIT(见 `LICENSE`)。
|
package/cordis.patch.yml
ADDED
package/index.json
ADDED
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
{
|
|
2
|
+
"format": 1,
|
|
3
|
+
"title": {
|
|
4
|
+
"en": "Research Desk",
|
|
5
|
+
"zh": "科研工作台"
|
|
6
|
+
},
|
|
7
|
+
"description": {
|
|
8
|
+
"en": "Open-source DeepSeek Harness plugin for the literature loop: search, curate, read with anchors, ask grounded questions, frame hypotheses, draft a paper outline.",
|
|
9
|
+
"zh": "开源的 DeepSeek Harness 科研工作台插件:检索、精选、带着页码精读、有锚点问答、选题、草稿写作,一条龙跑通文献工作流。"
|
|
10
|
+
},
|
|
11
|
+
"metadata": {
|
|
12
|
+
"categories": [
|
|
13
|
+
"research",
|
|
14
|
+
"literature",
|
|
15
|
+
"productivity"
|
|
16
|
+
]
|
|
17
|
+
},
|
|
18
|
+
"plugins": [
|
|
19
|
+
{
|
|
20
|
+
"name": "dsh-research-desk",
|
|
21
|
+
"title": {
|
|
22
|
+
"en": "Research Desk",
|
|
23
|
+
"zh": "科研工作台"
|
|
24
|
+
},
|
|
25
|
+
"description": {
|
|
26
|
+
"en": "Search arXiv / Europe PMC / OpenAlex without an API key, keep a reading library, pull full text, ask questions answered only from that text, write multi-perspective reviews, derive falsifiable hypotheses, run sandboxed verification snippets and export the whole library.",
|
|
27
|
+
"zh": "免密钥检索 arXiv / Europe PMC / OpenAlex,维护阅读文献库并拉取全文,只用全文回答问题并逐条核验引文,写多视角综述与研究缺口,从文献库推出可证伪选题,在沙箱里跑验证脚本,最后整库导出。"
|
|
28
|
+
},
|
|
29
|
+
"author": "stallenlu",
|
|
30
|
+
"homepage": "https://github.com/stallenlu/dsh-research-desk",
|
|
31
|
+
"repository": {
|
|
32
|
+
"url": "https://github.com/stallenlu/dsh-research-desk"
|
|
33
|
+
},
|
|
34
|
+
"metadata": {
|
|
35
|
+
"category": "research",
|
|
36
|
+
"keywords": [
|
|
37
|
+
"research",
|
|
38
|
+
"literature",
|
|
39
|
+
"arxiv",
|
|
40
|
+
"pubmed",
|
|
41
|
+
"openalex",
|
|
42
|
+
"hypothesis",
|
|
43
|
+
"citation",
|
|
44
|
+
"science",
|
|
45
|
+
"科研",
|
|
46
|
+
"文献",
|
|
47
|
+
"选题",
|
|
48
|
+
"引文",
|
|
49
|
+
"综述",
|
|
50
|
+
"实验验证",
|
|
51
|
+
"导出"
|
|
52
|
+
]
|
|
53
|
+
},
|
|
54
|
+
"versions": [
|
|
55
|
+
{
|
|
56
|
+
"version": "0.2.0",
|
|
57
|
+
"publishTimestamp": "2026-11-18T01:00:00.000Z",
|
|
58
|
+
"source": {
|
|
59
|
+
"type": "npm"
|
|
60
|
+
},
|
|
61
|
+
"engines": {
|
|
62
|
+
"dsh": ">=0.2.1-rc.5 <0.3.0"
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
]
|
|
66
|
+
}
|
|
67
|
+
]
|
|
68
|
+
}
|