@benz-ai-x/dsh-research-graph 0.2.2-rc.3.1 → 0.2.2-rc.3.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 +41 -15
- package/README.zh.md +41 -15
- package/lib/client.js +261 -197
- package/lib/client.js.map +1 -1
- package/lib/index.js +258 -126
- package/lib/types/index.d.ts +15 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "
|
|
2
|
+
description: "Open-source DeepSeek Harness Web plugin that turns AI conversations into a visual research graph, traceable Knowledge Cards, and reusable research materials. Explore use cases, compatibility, and installation."
|
|
3
3
|
kind: "package-bundle"
|
|
4
4
|
---
|
|
5
5
|
|
|
@@ -11,7 +11,14 @@ kind: "package-bundle"
|
|
|
11
11
|
|
|
12
12
|
**English** | [简体中文](README.zh.md)
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
Turn scattered AI conversations into a **visual, traceable, reusable research knowledge base**. **DSH Research Graph** is an independently maintained, open-source **AI research workbench plugin** for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness), running inside **DSH Web**. Map conversation branches and merges, connect research across Workspaces, and turn selected discussion turns into source-linked Knowledge Cards for product research, technical investigation, and ongoing knowledge management.
|
|
15
|
+
|
|
16
|
+
## Use cases
|
|
17
|
+
|
|
18
|
+
- **Technical investigation:** compare design branches, retain the evidence behind each conclusion, and resume from a selected historical turn.
|
|
19
|
+
- **Product research:** gather findings from several Workspaces into one Research Topic without moving or rewriting source Sessions.
|
|
20
|
+
- **Research knowledge management:** turn completed discussions into reviewed Knowledge Cards with exact source ranges, revisions, and open questions.
|
|
21
|
+
- **Follow-up research:** reuse frozen cards and discussion ranges in a new Session, compare 2–3 materials, and export results as Markdown.
|
|
15
22
|
|
|
16
23
|
## Capability map
|
|
17
24
|
|
|
@@ -39,11 +46,11 @@ flowchart LR
|
|
|
39
46
|
|
|
40
47
|
<p align="center">
|
|
41
48
|
<a href="docs/assets/readme/research-workbench.png">
|
|
42
|
-
<img src="docs/assets/readme/research-workbench.png" alt="Research workbench showing a Workspace graph with
|
|
49
|
+
<img src="docs/assets/readme/research-workbench.png" alt="DSH Research Graph AI research workbench showing a Workspace conversation graph with Session cards, Branch and Merge relations, and a minimap" width="100%" />
|
|
43
50
|
</a>
|
|
44
51
|
</p>
|
|
45
52
|
|
|
46
|
-
Version 0.2.2-rc.3.
|
|
53
|
+
Version 0.2.2-rc.3.2 with demo data. Click the image for the full-resolution screenshot.
|
|
47
54
|
|
|
48
55
|
<a id="features"></a>
|
|
49
56
|
<a id="what-it-adds"></a>
|
|
@@ -52,13 +59,13 @@ Version 0.2.2-rc.3.1 with demo data. Click the image for the full-resolution scr
|
|
|
52
59
|
|
|
53
60
|
| Capability | What you can do |
|
|
54
61
|
| --- | --- |
|
|
55
|
-
| **
|
|
56
|
-
| **Own sidebar with Workspace folders** |
|
|
57
|
-
| **
|
|
58
|
-
| **Knowledge
|
|
59
|
-
| **AI
|
|
60
|
-
| **Follow-up research** | Start from a historical turn or chosen card
|
|
61
|
-
| **
|
|
62
|
+
| **Visual conversation graph** | See how discussions fork and merge, show verified ordinary-fork Branch links, and inspect existing Subagent work; drag, collapse, and relayout without changing source Sessions |
|
|
63
|
+
| **Own sidebar with Workspace folders** | Organize Sessions in user-created folders inside each Workspace while retaining native row menus. Re-adding a removed Workspace's directory restores its currently unaccounted Sessions; uninstalling restores the official sidebar |
|
|
64
|
+
| **Research Topics and source tracing** | Gather discussions across Workspaces, search discussion text, and return to the exact original turns behind a finding |
|
|
65
|
+
| **Source-linked Knowledge Cards** | Save reviewed conclusions, conditions, and open questions with exact sources; edit through new revisions without losing earlier versions |
|
|
66
|
+
| **AI extraction and synthesis** | Extract selected turns and compare 2–3 frozen materials; inspect drafts and citations before explicitly saving |
|
|
67
|
+
| **Follow-up research** | Start from a historical turn or reuse chosen card revisions and discussion ranges, retaining the exact materials used |
|
|
68
|
+
| **Inspection and delivery** | Read turn counts and Session statistics, inspect existing Subagent records, and export Markdown research results |
|
|
62
69
|
|
|
63
70
|
<a id="compatibility"></a>
|
|
64
71
|
<a id="dsh-and-agent-presets"></a>
|
|
@@ -67,13 +74,31 @@ Version 0.2.2-rc.3.1 with demo data. Click the image for the full-resolution scr
|
|
|
67
74
|
|
|
68
75
|
| Item | Details |
|
|
69
76
|
| --- | --- |
|
|
70
|
-
| Plugin release | [0.2.2-rc.3.
|
|
77
|
+
| Plugin release | [0.2.2-rc.3.2](https://github.com/benz-ai-x/dsh-research-graph/releases/tag/v0.2.2-rc.3.2), npm `next` |
|
|
71
78
|
| Required Host | **DSH 0.2.2-rc.3 · Web**, Node.js `>=24.9.0` |
|
|
72
79
|
| Data | Research records and Workspace folders live on the DSH Host; view preferences and working positions stay in the browser, and Topic arrangements require explicit saving |
|
|
73
80
|
| Model calls | Browsing, manual capture, and export make no model call; AI generation and new discussions use models on demand |
|
|
74
81
|
| Agent capabilities | DSH provides models, tools, presets, and agent execution; this plugin includes no preset or Agent Team launcher. [Details](docs/user-guide.md#dsh-and-agent-presets) |
|
|
75
82
|
| Stack and license | TypeScript · React · [MIT](LICENSE) |
|
|
76
83
|
|
|
84
|
+
## Frequently asked questions
|
|
85
|
+
|
|
86
|
+
### How is DSH Research Graph different from ordinary AI chat history?
|
|
87
|
+
|
|
88
|
+
It adds a visual map of Branch and Merge relations, cross-Workspace Research Topics, source-linked Knowledge Cards, and reusable frozen materials. It complements the native DSH conversation instead of replacing its original history.
|
|
89
|
+
|
|
90
|
+
### Does it require a separate workbench service?
|
|
91
|
+
|
|
92
|
+
No. Research Graph installs as a plugin inside a compatible **DSH Web** Host; the DSH profile still owns Session execution and model services.
|
|
93
|
+
|
|
94
|
+
### Where are research records stored?
|
|
95
|
+
|
|
96
|
+
Research Topics, Knowledge Card revisions, Reuse records, and Workspace folders are stored on the DSH Host. Browser-local working positions and unsaved arrangements remain separate; original Session logs stay in Harness.
|
|
97
|
+
|
|
98
|
+
### When does it call an AI model?
|
|
99
|
+
|
|
100
|
+
Browsing, searching, manual capture, and Markdown export make no model call. AI extraction, synthesis, title or digest generation, and new discussions use models only when explicitly requested.
|
|
101
|
+
|
|
77
102
|
<a id="install"></a>
|
|
78
103
|
|
|
79
104
|
## Quick start
|
|
@@ -81,7 +106,7 @@ Version 0.2.2-rc.3.1 with demo data. Click the image for the full-resolution scr
|
|
|
81
106
|
Requires **DSH 0.2.2-rc.3** (Node.js `>=24.9.0`), with both `dsh` and `pnpm` on your `PATH`. Stop any running `dsh web`, then run:
|
|
82
107
|
|
|
83
108
|
```sh
|
|
84
|
-
dsh plugin --profile web add @benz-ai-x/dsh-research-graph@0.2.2-rc.3.
|
|
109
|
+
dsh plugin --profile web add @benz-ai-x/dsh-research-graph@0.2.2-rc.3.2
|
|
85
110
|
dsh web
|
|
86
111
|
```
|
|
87
112
|
|
|
@@ -95,7 +120,8 @@ Install a release that matches your DSH Host with `dsh plugin --profile web add
|
|
|
95
120
|
|
|
96
121
|
| Plugin release | Required DSH | Notes |
|
|
97
122
|
| --- | --- | --- |
|
|
98
|
-
| `0.2.2-rc.3.
|
|
123
|
+
| `0.2.2-rc.3.2` | `0.2.2-rc.3` | Current release — restores unaccounted Sessions when re-adding the same Workspace directory; requires Node.js `>=24.9.0`; npm `next` |
|
|
124
|
+
| `0.2.2-rc.3.1` | `0.2.2-rc.3` | Restores Branch links for independent ordinary forks; requires Node.js `>=24.9.0` |
|
|
99
125
|
| `0.2.2-rc.3` | `0.2.2-rc.3` | Reusable Workspace picker Factory and New Session HOC; requires Node.js `>=24.9.0` |
|
|
100
126
|
| `0.2.2-rc.2` | `0.2.2-rc.2` | Previous release — DSH rc.2 compatibility and Menu anchor migration; requires Node.js `>=24.9.0` |
|
|
101
127
|
| `0.2.2-rc.1` | `0.2.2-rc.1` | First adaptation of DSH 0.2.2-rc.1; requires Node.js `>=24.9.0` |
|
|
@@ -105,4 +131,4 @@ See the [full release history](https://github.com/benz-ai-x/dsh-research-graph/r
|
|
|
105
131
|
|
|
106
132
|
## Docs and support
|
|
107
133
|
|
|
108
|
-
[User guide](docs/user-guide.md) · [Troubleshooting](docs/user-guide.md#troubleshooting) · [Development and release](docs/development.md) · [Release acceptance](docs/reviews/release-0.2.2-rc.3.
|
|
134
|
+
[User guide](docs/user-guide.md) · [Troubleshooting](docs/user-guide.md#troubleshooting) · [Development and release](docs/development.md) · [Release acceptance](docs/reviews/release-0.2.2-rc.3.2.md) · [Report an issue](https://github.com/benz-ai-x/dsh-research-graph/issues)
|
package/README.zh.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "
|
|
2
|
+
description: "开源 DeepSeek Harness Web 插件,将 AI 对话转化为可视化会话图谱、可追溯知识卡片与可复用研究材料。了解适用场景、兼容性与安装方法。"
|
|
3
3
|
kind: "package-bundle"
|
|
4
4
|
---
|
|
5
5
|
|
|
@@ -11,7 +11,14 @@ kind: "package-bundle"
|
|
|
11
11
|
|
|
12
12
|
[English](README.md) | **简体中文**
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
把分散的 AI 对话转化为**可视化、可追溯、可持续复用的研究知识库**。**DSH Research Graph · 研图**是面向 [DeepSeek Harness(DSH)](https://github.com/deepseek-ai/deepseek-harness)、由社区独立维护的开源 **AI 研究工作台插件**,运行于 **DSH Web**。呈现会话分支与汇聚关系,跨工作区连接研究主题,并将选定讨论轮次转化为带来源的知识卡片,适用于产品研究、技术调研与持续知识管理。
|
|
15
|
+
|
|
16
|
+
## 适用场景
|
|
17
|
+
|
|
18
|
+
- **技术调研:**比较不同设计分支,保留结论背后的证据,并从选定的历史轮次继续研究。
|
|
19
|
+
- **产品研究:**将多个工作区中的发现汇入同一研究主题,无需移动或改写来源会话。
|
|
20
|
+
- **研究知识管理:**把已完成讨论整理为经过审核的知识卡片,保留准确的原文范围、修订与待验证问题。
|
|
21
|
+
- **后续研究:**在新会话中复用冻结的卡片和讨论范围,对照 2–3 份材料,并将结果导出为 Markdown。
|
|
15
22
|
|
|
16
23
|
## 功能能力图谱
|
|
17
24
|
|
|
@@ -39,11 +46,11 @@ flowchart LR
|
|
|
39
46
|
|
|
40
47
|
<p align="center">
|
|
41
48
|
<a href="docs/assets/readme/research-workbench.png">
|
|
42
|
-
<img src="docs/assets/readme/research-workbench.png" alt="
|
|
49
|
+
<img src="docs/assets/readme/research-workbench.png" alt="DSH Research Graph 研图 AI 研究工作台:工作区会话图谱、会话卡片、分支与汇聚关系及迷你地图" width="100%" />
|
|
43
50
|
</a>
|
|
44
51
|
</p>
|
|
45
52
|
|
|
46
|
-
0.2.2-rc.3.
|
|
53
|
+
0.2.2-rc.3.2 的真实界面(演示数据),点击图片查看高清原图。
|
|
47
54
|
|
|
48
55
|
<a id="核心能力"></a>
|
|
49
56
|
|
|
@@ -51,13 +58,13 @@ flowchart LR
|
|
|
51
58
|
|
|
52
59
|
| 能力 | 你可以做什么 |
|
|
53
60
|
| --- | --- |
|
|
54
|
-
|
|
|
55
|
-
| **自有侧栏与工作区文件夹** |
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
| **AI
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
+
| **可视化会话图谱** | 直观看清讨论如何分叉与汇聚,显示经过验证的普通 fork 分支关系,并检查已有子代理工作;拖动、折叠与重排不会改变来源会话 |
|
|
62
|
+
| **自有侧栏与工作区文件夹** | 在工作区内创建文件夹整理会话,同时保留原生会话行菜单;同目录重新添加已移除的工作区时恢复当前未归属会话,卸载插件即还原官方侧栏 |
|
|
63
|
+
| **研究主题与来源追溯** | 跨工作区汇集讨论,检索讨论正文,并回到发现所对应的准确原文轮次 |
|
|
64
|
+
| **带来源的知识卡片** | 保存经过审核的结论、适用条件和待验证问题,并保留准确来源;编辑形成新修订,不丢失历史版本 |
|
|
65
|
+
| **AI 提炼与对照综合** | 提炼选定轮次,对照 2–3 份冻结材料;检查草稿与引用后再明确保存 |
|
|
66
|
+
| **后续研究** | 从历史轮次开始,或复用选定的卡片修订与讨论范围,准确保留当时使用的材料 |
|
|
67
|
+
| **检查与交付** | 查看轮数与会话统计,检查已有子代理记录,并导出 Markdown 研究成果 |
|
|
61
68
|
|
|
62
69
|
<a id="兼容性"></a>
|
|
63
70
|
<a id="dsh-与-agent-预设"></a>
|
|
@@ -66,13 +73,31 @@ flowchart LR
|
|
|
66
73
|
|
|
67
74
|
| 项目 | 说明 |
|
|
68
75
|
| --- | --- |
|
|
69
|
-
| 当前插件 | [0.2.2-rc.3.
|
|
76
|
+
| 当前插件 | [0.2.2-rc.3.2](https://github.com/benz-ai-x/dsh-research-graph/releases/tag/v0.2.2-rc.3.2),npm `next` |
|
|
70
77
|
| 适配宿主 | **DSH 0.2.2-rc.3 · Web**,Node.js `>=24.9.0` |
|
|
71
78
|
| 数据保存 | 研究数据与工作区文件夹保存在 DSH Host;视图偏好和工作位置保存在浏览器,主题排列需显式保存 |
|
|
72
79
|
| 模型调用 | 浏览、手工留卡、导出不调用模型;AI 生成与新讨论按需调用 |
|
|
73
80
|
| Agent 能力 | 模型、工具、预设与 Agent 执行由 DSH 提供;插件不内置预设或 Agent Team 启动器。[详细说明](docs/user-guide.zh.md#dsh-与-agent-预设) |
|
|
74
81
|
| 技术与许可 | TypeScript · React · [MIT](LICENSE) |
|
|
75
82
|
|
|
83
|
+
## 常见问题
|
|
84
|
+
|
|
85
|
+
### 研图与普通 AI 聊天记录有什么不同?
|
|
86
|
+
|
|
87
|
+
研图增加可视化的分支与汇聚关系、跨工作区研究主题、带来源的知识卡片和可复用的冻结材料。它补充原生 DSH 会话能力,而不是替换或改写原始历史。
|
|
88
|
+
|
|
89
|
+
### 需要单独部署工作台服务吗?
|
|
90
|
+
|
|
91
|
+
不需要。研图作为插件安装在兼容的 **DSH Web** 宿主中,Session 执行和模型服务仍由 DSH profile 持有。
|
|
92
|
+
|
|
93
|
+
### 研究数据保存在哪里?
|
|
94
|
+
|
|
95
|
+
研究主题、知识卡片修订、材料沿用记录和工作区文件夹保存在 DSH Host;浏览器工作位置和未保存排列单独保留,原始 Session 日志仍由 Harness 管理。
|
|
96
|
+
|
|
97
|
+
### 什么时候会调用 AI 模型?
|
|
98
|
+
|
|
99
|
+
浏览、搜索、手工留卡和 Markdown 导出不调用模型;AI 提炼、对照综合、标题或摘要生成以及新讨论只在明确操作时按需调用。
|
|
100
|
+
|
|
76
101
|
<a id="安装"></a>
|
|
77
102
|
|
|
78
103
|
## 快速开始
|
|
@@ -80,7 +105,7 @@ flowchart LR
|
|
|
80
105
|
需要 **DSH 0.2.2-rc.3**(Node.js `>=24.9.0`),并确保 `dsh`、`pnpm` 均在 `PATH` 中。如有正在运行的 `dsh web`,先停止,再执行:
|
|
81
106
|
|
|
82
107
|
```sh
|
|
83
|
-
dsh plugin --profile web add @benz-ai-x/dsh-research-graph@0.2.2-rc.3.
|
|
108
|
+
dsh plugin --profile web add @benz-ai-x/dsh-research-graph@0.2.2-rc.3.2
|
|
84
109
|
dsh web
|
|
85
110
|
```
|
|
86
111
|
|
|
@@ -94,7 +119,8 @@ dsh web
|
|
|
94
119
|
|
|
95
120
|
| 插件版本 | 要求的 DSH | 备注 |
|
|
96
121
|
| --- | --- | --- |
|
|
97
|
-
| `0.2.2-rc.3.
|
|
122
|
+
| `0.2.2-rc.3.2` | `0.2.2-rc.3` | 当前版本——同目录重新添加工作区时恢复未归属会话,要求 Node.js `>=24.9.0`;npm `next` |
|
|
123
|
+
| `0.2.2-rc.3.1` | `0.2.2-rc.3` | 恢复独立普通 fork 的分支连线,要求 Node.js `>=24.9.0` |
|
|
98
124
|
| `0.2.2-rc.3` | `0.2.2-rc.3` | 可复用 Workspace Picker Factory 与新会话 HOC,要求 Node.js `>=24.9.0` |
|
|
99
125
|
| `0.2.2-rc.2` | `0.2.2-rc.2` | 上一版本——适配 DSH rc.2 并迁移 Menu 锚点,要求 Node.js `>=24.9.0` |
|
|
100
126
|
| `0.2.2-rc.1` | `0.2.2-rc.1` | DSH 0.2.2-rc.1 首次适配,要求 Node.js `>=24.9.0` |
|
|
@@ -104,4 +130,4 @@ dsh web
|
|
|
104
130
|
|
|
105
131
|
## 文档与支持
|
|
106
132
|
|
|
107
|
-
[使用指南](docs/user-guide.zh.md) · [故障排查](docs/user-guide.zh.md#故障排查) · [开发与发布](docs/development.zh.md) · [发布验收](docs/reviews/release-0.2.2-rc.3.
|
|
133
|
+
[使用指南](docs/user-guide.zh.md) · [故障排查](docs/user-guide.zh.md#故障排查) · [开发与发布](docs/development.zh.md) · [发布验收](docs/reviews/release-0.2.2-rc.3.2.md) · [问题反馈](https://github.com/benz-ai-x/dsh-research-graph/issues)
|