@benz-ai-x/dsh-research-graph 0.2.2-rc.3 → 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 CHANGED
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "A DeepSeek Harness Web plugin for AI conversation graphs, research topics, and source-linked Knowledge Cards. Explore capabilities, check compatibility, and install the research workbench."
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
- An independently maintained, open-source **AI research workbench plugin** for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness), running inside **DSH Web**. Organize conversations into research topics and traceable Knowledge Cards for product research, technical research, and ongoing knowledge management.
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 session cards, branches, and the minimap" width="100%" />
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 with demo data. Click the image for the full-resolution screenshot.
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 with demo data. Click the image for the full-resolution scree
52
59
 
53
60
  | Capability | What you can do |
54
61
  | --- | --- |
55
- | **Research graph** | Organize discussions, inspect branches and merges; drag, collapse, and relayout; cards show turn counts and the inspector reports Session stats |
56
- | **Own sidebar with Workspace folders** | Replaces the official sidebar with this package's copy and adds user-created folders inside each Workspace: create/rename/delete from the workspace menu, drag Sessions in or out, native row menus everywhere. Uninstalling the plugin restores the official sidebar |
57
- | **Source tracing** | Search discussion text and return to the exact original turns |
58
- | **Knowledge capture** | Save conclusions, conditions, and open questions; edit through new revisions |
59
- | **AI analysis** | Extract selected discussion and compare 2–3 materials; review before saving |
60
- | **Follow-up research** | Start from a historical turn or chosen card revision, retaining the materials used |
61
- | **Tasks and delivery** | Inspect existing subagent records and export Markdown research results |
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 with demo data. Click the image for the full-resolution scree
67
74
 
68
75
  | Item | Details |
69
76
  | --- | --- |
70
- | Plugin release | [0.2.2-rc.3](https://github.com/benz-ai-x/dsh-research-graph/releases/tag/v0.2.2-rc.3), npm `latest` / `next` |
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 with demo data. Click the image for the full-resolution scree
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,9 @@ 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` | `0.2.2-rc.3` | Current release — reusable Workspace picker Factory and New Session HOC; requires Node.js `>=24.9.0`; npm `latest` / `next` |
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` |
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` |
99
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` |
100
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` |
101
128
  | `0.2.1-rc.5.2` | `0.2.1-rc.5` | **Breaking change**: replaces the official sidebar with the vendored copy and Workspace folders (supersedes sidebar categories; old category data stays dormant) |
@@ -104,4 +131,4 @@ See the [full release history](https://github.com/benz-ai-x/dsh-research-graph/r
104
131
 
105
132
  ## Docs and support
106
133
 
107
- [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.md) · [Report an issue](https://github.com/benz-ai-x/dsh-research-graph/issues)
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: "面向 DeepSeek Harness Web 的 AI 会话图谱、研究主题与可追溯知识卡片插件。了解研究工作台的功能能力、兼容性与安装方法。"
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
- 面向 [DeepSeek Harness(DSH)](https://github.com/deepseek-ai/deepseek-harness)、由社区独立维护的开源 **AI 研究工作台插件**,运行于 **DSH Web**。将分散的讨论组织为研究主题与可追溯的知识卡片,用于产品研究、技术调研与持续知识管理。
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="研图工作台:工作区会话卡片、分支关系与迷你地图" width="100%" />
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 归纳** | 提炼选定原文,对照 2–3 份材料,审核后保存 |
59
- | **继续研究** | 从历史轮次或选定卡片版本开启新讨论,保留当时的材料 |
60
- | **任务与交付** | 检查已有子代理记录,导出 Markdown 研究成果 |
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](https://github.com/benz-ai-x/dsh-research-graph/releases/tag/v0.2.2-rc.3),npm `latest` / `next` |
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,9 @@ dsh web
94
119
 
95
120
  | 插件版本 | 要求的 DSH | 备注 |
96
121
  | --- | --- | --- |
97
- | `0.2.2-rc.3` | `0.2.2-rc.3` | 当前版本——可复用 Workspace Picker Factory 与新会话 HOC,要求 Node.js `>=24.9.0`;npm `latest` / `next` |
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` |
124
+ | `0.2.2-rc.3` | `0.2.2-rc.3` | 可复用 Workspace Picker Factory 与新会话 HOC,要求 Node.js `>=24.9.0` |
98
125
  | `0.2.2-rc.2` | `0.2.2-rc.2` | 上一版本——适配 DSH rc.2 并迁移 Menu 锚点,要求 Node.js `>=24.9.0` |
99
126
  | `0.2.2-rc.1` | `0.2.2-rc.1` | DSH 0.2.2-rc.1 首次适配,要求 Node.js `>=24.9.0` |
100
127
  | `0.2.1-rc.5.2` | `0.2.1-rc.5` | **破坏性变更**:以自带侧栏替换官方侧栏并提供工作区文件夹(取代侧栏分类,旧分类数据保留但不再显示) |
@@ -103,4 +130,4 @@ dsh web
103
130
 
104
131
  ## 文档与支持
105
132
 
106
- [使用指南](docs/user-guide.zh.md) · [故障排查](docs/user-guide.zh.md#故障排查) · [开发与发布](docs/development.zh.md) · [发布验收](docs/reviews/release-0.2.2-rc.3.md) · [问题反馈](https://github.com/benz-ai-x/dsh-research-graph/issues)
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)