@benz-ai-x/dsh-research-graph 0.2.2-rc.3.2 → 0.2.2-rc.3.3

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
@@ -31,7 +31,7 @@ config:
31
31
  ---
32
32
  flowchart LR
33
33
  G["DSH Research Graph"] --> O["Organize research"] & K["Capture knowledge"] & R["Extend research"]
34
- O --> O1["Cross-workspace topics"] & O2["Conversation graph<br/>Branches · Merges<br/>Subagent records"]
34
+ O --> O1["Cross-workspace topics"] & O2["Conversation graph<br/>Branches · Merges<br/>Subagent records"] & O3["Session backups<br/>Logs · Attachments · Restore"]
35
35
  K --> K1["History search<br/>Sources · Digests"] & K2["Knowledge Cards<br/>AI extraction · Review · Revisions"]
36
36
  R --> R1["Synthesis · Frozen materials"] & R2["Follow-up discussions<br/>Markdown export"]
37
37
  classDef brand fill:#2563eb,stroke:#2563eb,color:#fff
@@ -39,7 +39,7 @@ flowchart LR
39
39
  classDef feature fill:#f8fafc,stroke:#cbd5e1,color:#0f172a
40
40
  class G brand
41
41
  class O,K,R group
42
- class O1,O2,K1,K2,R1,R2 feature
42
+ class O1,O2,O3,K1,K2,R1,R2 feature
43
43
  ```
44
44
 
45
45
  ## Workbench screenshot
@@ -50,7 +50,7 @@ flowchart LR
50
50
  </a>
51
51
  </p>
52
52
 
53
- Version 0.2.2-rc.3.2 with demo data. Click the image for the full-resolution screenshot.
53
+ Version 0.2.2-rc.3.3 with demo data. Click the image for the full-resolution screenshot.
54
54
 
55
55
  <a id="features"></a>
56
56
  <a id="what-it-adds"></a>
@@ -61,6 +61,7 @@ Version 0.2.2-rc.3.2 with demo data. Click the image for the full-resolution scr
61
61
  | --- | --- |
62
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
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
+ | **Session backup and restore** | Back up complete Session logs, context events, descendants, and attachments in one ZIP; name archives by Workspace and restore on demand without overwriting different same-ID Sessions |
64
65
  | **Research Topics and source tracing** | Gather discussions across Workspaces, search discussion text, and return to the exact original turns behind a finding |
65
66
  | **Source-linked Knowledge Cards** | Save reviewed conclusions, conditions, and open questions with exact sources; edit through new revisions without losing earlier versions |
66
67
  | **AI extraction and synthesis** | Extract selected turns and compare 2–3 frozen materials; inspect drafts and citations before explicitly saving |
@@ -74,10 +75,10 @@ Version 0.2.2-rc.3.2 with demo data. Click the image for the full-resolution scr
74
75
 
75
76
  | Item | Details |
76
77
  | --- | --- |
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` |
78
+ | Plugin release | [0.2.2-rc.3.3](https://github.com/benz-ai-x/dsh-research-graph/releases/tag/v0.2.2-rc.3.3), npm `latest` / `next` |
78
79
  | Required Host | **DSH 0.2.2-rc.3 · Web**, Node.js `>=24.9.0` |
79
80
  | 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 |
80
- | Model calls | Browsing, manual capture, and export make no model call; AI generation and new discussions use models on demand |
81
+ | Model calls | Browsing, manual capture, export, backup, and restore make no model call; AI generation and new discussions use models on demand |
81
82
  | 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) |
82
83
  | Stack and license | TypeScript · React · [MIT](LICENSE) |
83
84
 
@@ -97,7 +98,7 @@ Research Topics, Knowledge Card revisions, Reuse records, and Workspace folders
97
98
 
98
99
  ### When does it call an AI model?
99
100
 
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
+ Browsing, searching, manual capture, Markdown export, and Session backup/restore make no model call. AI extraction, synthesis, title or digest generation, and new discussions use models only when explicitly requested.
101
102
 
102
103
  <a id="install"></a>
103
104
 
@@ -106,7 +107,7 @@ Browsing, searching, manual capture, and Markdown export make no model call. AI
106
107
  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:
107
108
 
108
109
  ```sh
109
- dsh plugin --profile web add @benz-ai-x/dsh-research-graph@0.2.2-rc.3.2
110
+ dsh plugin --profile web add @benz-ai-x/dsh-research-graph@0.2.2-rc.3.3
110
111
  dsh web
111
112
  ```
112
113
 
@@ -120,7 +121,8 @@ Install a release that matches your DSH Host with `dsh plugin --profile web add
120
121
 
121
122
  | Plugin release | Required DSH | Notes |
122
123
  | --- | --- | --- |
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.3` | `0.2.2-rc.3` | Current release — native Session backup and on-demand restore with Workspace-aware filenames and no overwriting; requires Node.js `>=24.9.0`; npm `latest` / `next` |
125
+ | `0.2.2-rc.3.2` | `0.2.2-rc.3` | Restores unaccounted Sessions when re-adding the same Workspace directory; requires Node.js `>=24.9.0` |
124
126
  | `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
127
  | `0.2.2-rc.3` | `0.2.2-rc.3` | Reusable Workspace picker Factory and New Session HOC; requires Node.js `>=24.9.0` |
126
128
  | `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` |
@@ -131,4 +133,4 @@ See the [full release history](https://github.com/benz-ai-x/dsh-research-graph/r
131
133
 
132
134
  ## Docs and support
133
135
 
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)
136
+ [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.3.md) · [Report an issue](https://github.com/benz-ai-x/dsh-research-graph/issues)
package/README.zh.md CHANGED
@@ -31,7 +31,7 @@ config:
31
31
  ---
32
32
  flowchart LR
33
33
  G["DSH Research Graph · 研图"] --> O["组织研究"] & K["沉淀知识"] & R["延伸研究"]
34
- O --> O1["跨工作区主题"] & O2["会话图谱<br/>分支 · 汇聚 · 子代理记录"]
34
+ O --> O1["跨工作区主题"] & O2["会话图谱<br/>分支 · 汇聚 · 子代理记录"] & O3["会话备份<br/>完整日志 · 附件 · 恢复"]
35
35
  K --> K1["原文检索 · 来源追溯 · 摘要"] & K2["知识卡片<br/>AI 提炼 · 审核 · 修订"]
36
36
  R --> R1["对照综合 · 固定材料"] & R2["继续讨论 · Markdown 导出"]
37
37
  classDef brand fill:#2563eb,stroke:#2563eb,color:#fff
@@ -39,7 +39,7 @@ flowchart LR
39
39
  classDef feature fill:#f8fafc,stroke:#cbd5e1,color:#0f172a
40
40
  class G brand
41
41
  class O,K,R group
42
- class O1,O2,K1,K2,R1,R2 feature
42
+ class O1,O2,O3,K1,K2,R1,R2 feature
43
43
  ```
44
44
 
45
45
  ## 功能截图
@@ -50,7 +50,7 @@ flowchart LR
50
50
  </a>
51
51
  </p>
52
52
 
53
- 0.2.2-rc.3.2 的真实界面(演示数据),点击图片查看高清原图。
53
+ 0.2.2-rc.3.3 的真实界面(演示数据),点击图片查看高清原图。
54
54
 
55
55
  <a id="核心能力"></a>
56
56
 
@@ -60,6 +60,7 @@ flowchart LR
60
60
  | --- | --- |
61
61
  | **可视化会话图谱** | 直观看清讨论如何分叉与汇聚,显示经过验证的普通 fork 分支关系,并检查已有子代理工作;拖动、折叠与重排不会改变来源会话 |
62
62
  | **自有侧栏与工作区文件夹** | 在工作区内创建文件夹整理会话,同时保留原生会话行菜单;同目录重新添加已移除的工作区时恢复当前未归属会话,卸载插件即还原官方侧栏 |
63
+ | **会话备份与恢复** | 用一个 ZIP 备份完整会话日志、上下文事件、子代理和附件;按工作区命名,按需恢复且绝不覆盖同 ID 的不同会话 |
63
64
  | **研究主题与来源追溯** | 跨工作区汇集讨论,检索讨论正文,并回到发现所对应的准确原文轮次 |
64
65
  | **带来源的知识卡片** | 保存经过审核的结论、适用条件和待验证问题,并保留准确来源;编辑形成新修订,不丢失历史版本 |
65
66
  | **AI 提炼与对照综合** | 提炼选定轮次,对照 2–3 份冻结材料;检查草稿与引用后再明确保存 |
@@ -73,10 +74,10 @@ flowchart LR
73
74
 
74
75
  | 项目 | 说明 |
75
76
  | --- | --- |
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` |
77
+ | 当前插件 | [0.2.2-rc.3.3](https://github.com/benz-ai-x/dsh-research-graph/releases/tag/v0.2.2-rc.3.3),npm `latest` / `next` |
77
78
  | 适配宿主 | **DSH 0.2.2-rc.3 · Web**,Node.js `>=24.9.0` |
78
79
  | 数据保存 | 研究数据与工作区文件夹保存在 DSH Host;视图偏好和工作位置保存在浏览器,主题排列需显式保存 |
79
- | 模型调用 | 浏览、手工留卡、导出不调用模型;AI 生成与新讨论按需调用 |
80
+ | 模型调用 | 浏览、手工留卡、导出、备份与恢复不调用模型;AI 生成与新讨论按需调用 |
80
81
  | Agent 能力 | 模型、工具、预设与 Agent 执行由 DSH 提供;插件不内置预设或 Agent Team 启动器。[详细说明](docs/user-guide.zh.md#dsh-与-agent-预设) |
81
82
  | 技术与许可 | TypeScript · React · [MIT](LICENSE) |
82
83
 
@@ -96,7 +97,7 @@ flowchart LR
96
97
 
97
98
  ### 什么时候会调用 AI 模型?
98
99
 
99
- 浏览、搜索、手工留卡和 Markdown 导出不调用模型;AI 提炼、对照综合、标题或摘要生成以及新讨论只在明确操作时按需调用。
100
+ 浏览、搜索、手工留卡、Markdown 导出以及会话备份/恢复不调用模型;AI 提炼、对照综合、标题或摘要生成以及新讨论只在明确操作时按需调用。
100
101
 
101
102
  <a id="安装"></a>
102
103
 
@@ -105,7 +106,7 @@ flowchart LR
105
106
  需要 **DSH 0.2.2-rc.3**(Node.js `>=24.9.0`),并确保 `dsh`、`pnpm` 均在 `PATH` 中。如有正在运行的 `dsh web`,先停止,再执行:
106
107
 
107
108
  ```sh
108
- dsh plugin --profile web add @benz-ai-x/dsh-research-graph@0.2.2-rc.3.2
109
+ dsh plugin --profile web add @benz-ai-x/dsh-research-graph@0.2.2-rc.3.3
109
110
  dsh web
110
111
  ```
111
112
 
@@ -119,7 +120,8 @@ dsh web
119
120
 
120
121
  | 插件版本 | 要求的 DSH | 备注 |
121
122
  | --- | --- | --- |
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.3` | `0.2.2-rc.3` | 当前版本——原生会话备份与按需恢复,文件名包含工作区且不覆盖现有会话,要求 Node.js `>=24.9.0`;npm `latest` / `next` |
124
+ | `0.2.2-rc.3.2` | `0.2.2-rc.3` | 同目录重新添加工作区时恢复未归属会话,要求 Node.js `>=24.9.0` |
123
125
  | `0.2.2-rc.3.1` | `0.2.2-rc.3` | 恢复独立普通 fork 的分支连线,要求 Node.js `>=24.9.0` |
124
126
  | `0.2.2-rc.3` | `0.2.2-rc.3` | 可复用 Workspace Picker Factory 与新会话 HOC,要求 Node.js `>=24.9.0` |
125
127
  | `0.2.2-rc.2` | `0.2.2-rc.2` | 上一版本——适配 DSH rc.2 并迁移 Menu 锚点,要求 Node.js `>=24.9.0` |
@@ -130,4 +132,4 @@ dsh web
130
132
 
131
133
  ## 文档与支持
132
134
 
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)
135
+ [使用指南](docs/user-guide.zh.md) · [故障排查](docs/user-guide.zh.md#故障排查) · [开发与发布](docs/development.zh.md) · [发布验收](docs/reviews/release-0.2.2-rc.3.3.md) · [问题反馈](https://github.com/benz-ai-x/dsh-research-graph/issues)
@@ -1,6 +1,6 @@
1
1
  # Bundled dependency notices
2
2
 
3
- The browser module bundles clsx plus `@deepseek-ai/dsh-util-values` and `@deepseek-ai/dsh-util-workspace-path`, and includes the vendored sidebar/workspace client code below. The offline history recovery command bundles additional Harness libraries and their utility dependencies. The bundled `@deepseek-ai/dsh-*` libraries are aligned to DSH `0.2.1-rc.5`.
3
+ The browser module bundles clsx plus `@deepseek-ai/dsh-util-values` and `@deepseek-ai/dsh-util-workspace-path`, and includes the vendored sidebar/workspace client code below. The Host Session Backup importer bundles `fflate`. The offline history recovery command bundles additional Harness libraries and their utility dependencies. The bundled `@deepseek-ai/dsh-*` libraries are aligned to DSH `0.2.1-rc.5`.
4
4
 
5
5
  ## @deepseek-ai/cordis, @deepseek-ai/cosmokit, @deepseek-ai/schemastery
6
6
 
@@ -68,6 +68,32 @@ The above copyright notice and this permission notice shall be included in all c
68
68
  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.
69
69
  ```
70
70
 
71
+ ## fflate
72
+
73
+ ```text
74
+ MIT License
75
+
76
+ Copyright (c) 2026 Arjun Barrett
77
+
78
+ Permission is hereby granted, free of charge, to any person obtaining a copy
79
+ of this software and associated documentation files (the "Software"), to deal
80
+ in the Software without restriction, including without limitation the rights
81
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
82
+ copies of the Software, and to permit persons to whom the Software is
83
+ furnished to do so, subject to the following conditions:
84
+
85
+ The above copyright notice and this permission notice shall be included in all
86
+ copies or substantial portions of the Software.
87
+
88
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
89
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
90
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
91
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
92
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
93
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
94
+ SOFTWARE.
95
+ ```
96
+
71
97
  ## DeepSeek Harness sidebar and workspace client code
72
98
 
73
99
  The `src/client/sidebar/` and `src/client/workspace/` directories vendor the