dsh-synapse 0.5.6 → 0.5.7

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
@@ -30,18 +30,26 @@
30
30
 
31
31
  | 你平时怎么用 DSH | 要装的 profile | 安装命令 |
32
32
  |---|---|---|
33
- | 桌面 App(DeepSeek Harness 客户端) | `desktop` | `corepack pnpm dsh plugin --profile desktop add dsh-synapse` |
34
- | 命令行 `dsh web` / 浏览器访问 | `web` | `corepack pnpm dsh plugin --profile web add dsh-synapse` |
35
- | 两种都用 | 两套各装一次 | 两条命令都执行 |
33
+ | 桌面 App(DeepSeek Harness 客户端) | `desktop` | `dsh plugin --profile desktop add dsh-synapse` |
34
+ | 命令行 `dsh web` / 浏览器访问(如果你也维护了这套) | `web` | `dsh plugin --profile web add dsh-synapse` |
36
35
 
37
36
  - 从 App 内的插件页面安装时,App 会自动装进它自己用的那套,不用管 profile。
38
- - **自检口诀:装完顶部看不到「会话地图」开关,就是装到另一套去了**,换成另一条命令再装一次即可。
37
+ - **自检口诀:装完顶部看不到「会话地图」开关,就是装到另一套去了**,把 `--profile` 换成另一套的名字再装一次即可。
39
38
  - 桌面 App 装完需要**重启 App**(Host 侧插件在启动时加载);命令行装的,重启 `dsh web` 并刷新页面。
40
39
 
40
+ `dsh` 是 DSH 运行时自带的 launcher,位于 App 安装目录的 `resources\runtime\cli\bin\dsh.cmd`。先确认它能调用:
41
+
41
42
  ```powershell
42
- # 命令行方式:装好后启动
43
- corepack pnpm dsh plugin --profile web add dsh-synapse
44
- corepack pnpm dsh web
43
+ dsh --version
44
+ ```
45
+
46
+ ```powershell
47
+ # 装进桌面 App 那套 profile
48
+ dsh plugin --profile desktop add dsh-synapse
49
+
50
+ # 需要命令行形态时(装完重启 dsh web 并刷新页面)
51
+ dsh plugin --profile web add dsh-synapse
52
+ dsh web
45
53
  ```
46
54
 
47
55
  启动后,在 DSH 顶部切换到 **会话地图**。Synapse 复用现有的 DSH Web Server,不会启动第二个应用或代理系统。
package/docs/en/README.md CHANGED
@@ -17,23 +17,28 @@ DSH installs plugins per profile. Each profile keeps its own plugin list and `no
17
17
  | How you run DSH | Profile to use |
18
18
  |---|---|
19
19
  | Desktop app (DeepSeek Harness client) | `desktop` |
20
- | `dsh web` on the command line | `web` |
21
- | Both | Install once per profile |
20
+ | `dsh web` on the command line (if you keep that profile) | `web` |
22
21
 
23
22
  - Installing from the app's plugin page already targets the profile the app uses, so you do not pick one there.
24
- - **Quick self-check: if the "会话地图 / Session map" switch never appears, the plugin went into the other profile** — run the other command and install again.
23
+ - **Quick self-check: if the "会话地图 / Session map" switch never appears, the plugin went into the other profile** — install again with the other `--profile`.
25
24
  - A desktop install takes effect after **restarting the app**; a command-line install takes effect after restarting `dsh web` and refreshing the page.
26
25
 
27
26
  ## Installation
28
27
 
28
+ `dsh` is the launcher that ships with the DSH runtime, at `resources\runtime\cli\bin\dsh.cmd` inside the app directory. Check that it responds first:
29
+
30
+ ```powershell
31
+ dsh --version
32
+ ```
33
+
29
34
  ### Install from npm
30
35
 
31
36
  ```powershell
32
37
  # Desktop app
33
- corepack pnpm dsh plugin --profile desktop add dsh-synapse
38
+ dsh plugin --profile desktop add dsh-synapse
34
39
 
35
- # Command line (dsh web)
36
- corepack pnpm dsh plugin --profile web add dsh-synapse
40
+ # Command line (only if you keep a web profile)
41
+ dsh plugin --profile web add dsh-synapse
37
42
  ```
38
43
 
39
44
  The npm package ships prebuilt code, so no build-script permission is needed — the simplest install. GitHub and local-checkout routes below are alternatives.
@@ -41,7 +46,7 @@ The npm package ships prebuilt code, so no build-script permission is needed —
41
46
  ### Install from GitHub
42
47
 
43
48
  ```powershell
44
- corepack pnpm dsh plugin --profile web add github:liangmianya/dsh-synapse
49
+ dsh plugin --profile desktop add github:liangmianya/dsh-synapse
45
50
  ```
46
51
 
47
52
  GitHub installs run the package `prepare` script, which validates JavaScript syntax with `node --check`.
@@ -60,7 +65,7 @@ Use the complete key containing the tarball URL and commit, not the bare package
60
65
  ### Install a local checkout
61
66
 
62
67
  ```powershell
63
- corepack pnpm dsh plugin --profile web add link:E:\path\to\dsh-synapse
68
+ dsh plugin --profile desktop add link:E:\path\to\dsh-synapse
64
69
  ```
65
70
 
66
71
  The `link:` form references the local checkout directly and is recommended for development. In a normal run, restart the host (the desktop app or `dsh web`) and refresh the page after editing the plugin.
@@ -68,7 +73,7 @@ The `link:` form references the local checkout directly and is recommended for d
68
73
  ## Start DSH Web
69
74
 
70
75
  ```powershell
71
- corepack pnpm dsh web
76
+ dsh web
72
77
  ```
73
78
 
74
79
  Default address:
@@ -80,7 +85,7 @@ http://127.0.0.1:3080/
80
85
  Let DSH choose a free port when 3080 is occupied:
81
86
 
82
87
  ```powershell
83
- corepack pnpm dsh web --port 0
88
+ dsh web --port 0
84
89
  ```
85
90
 
86
91
  Open the top **Session Map** switch after startup. Do not run two `dsh web` processes that share the same profile.
@@ -151,7 +156,7 @@ Add the actual host to `trustedHosts` when exposing DSH on a LAN.
151
156
  Remove the plugin:
152
157
 
153
158
  ```powershell
154
- corepack pnpm dsh plugin --profile web remove dsh-synapse
159
+ dsh plugin --profile web remove dsh-synapse
155
160
  ```
156
161
 
157
162
  `remove` deletes the dependency and profile activation layer but keeps canvas data. Reinstalling reuses and migrates the old data when necessary.
@@ -17,23 +17,28 @@ DSH 按 profile 分套安装插件:每套 profile 有自己的插件清单和
17
17
  | 你平时怎么用 DSH | 要装的 profile |
18
18
  |---|---|
19
19
  | 桌面 App(DeepSeek Harness 客户端) | `desktop` |
20
- | 命令行 `dsh web` / 浏览器访问 | `web` |
21
- | 两种都用 | 两套各装一次 |
20
+ | 命令行 `dsh web` / 浏览器访问(如果你自己也维护了这套) | `web` |
22
21
 
23
22
  - 从 App 内的插件页面安装时,App 会自动装进它自己用的那套,无需关心 profile。
24
- - **自检口诀:装完顶部看不到「会话地图」开关,就是装到另一套去了**,换成另一条命令再装一次即可。
23
+ - **自检口诀:装完顶部看不到「会话地图」开关,就是装到另一套去了**,把 `--profile` 换成另一套的名字再装一次即可。
25
24
  - 桌面 App 装完需要**重启 App**;命令行装的,重启 `dsh web` 并刷新页面。
26
25
 
27
26
  ## 安装
28
27
 
28
+ `dsh` 是 DSH 运行时自带的 launcher,位于 App 安装目录的 `resources\runtime\cli\bin\dsh.cmd`。先确认它能调用:
29
+
30
+ ```powershell
31
+ dsh --version
32
+ ```
33
+
29
34
  ### 从 npm 安装
30
35
 
31
36
  ```powershell
32
37
  # 桌面 App
33
- corepack pnpm dsh plugin --profile desktop add dsh-synapse
38
+ dsh plugin --profile desktop add dsh-synapse
34
39
 
35
- # 命令行 dsh web
36
- corepack pnpm dsh plugin --profile web add dsh-synapse
40
+ # 命令行形态(仅当你有对应的 web profile)
41
+ dsh plugin --profile web add dsh-synapse
37
42
  ```
38
43
 
39
44
  npm 包分发的是预构建产物,无需任何构建授权——最简单的安装方式。下方 GitHub 与本地 checkout 为备选。
@@ -41,7 +46,7 @@ npm 包分发的是预构建产物,无需任何构建授权——最简单的
41
46
  ### 从 GitHub 安装
42
47
 
43
48
  ```powershell
44
- corepack pnpm dsh plugin --profile web add github:liangmianya/dsh-synapse
49
+ dsh plugin --profile desktop add github:liangmianya/dsh-synapse
45
50
  ```
46
51
 
47
52
  GitHub 安装会运行本包的 `prepare` 脚本,通过 `node --check` 验证 JavaScript 语法。
@@ -60,7 +65,7 @@ allowBuilds:
60
65
  ### 本地开发安装
61
66
 
62
67
  ```powershell
63
- corepack pnpm dsh plugin --profile web add link:E:\path\to\dsh-synapse
68
+ dsh plugin --profile desktop add link:E:\path\to\dsh-synapse
64
69
  ```
65
70
 
66
71
  `link:` 会直接引用本地 checkout,适合开发和调试。普通运行模式下修改代码后,建议重启宿主(桌面 App 或 `dsh web`)并刷新页面。
@@ -68,7 +73,7 @@ corepack pnpm dsh plugin --profile web add link:E:\path\to\dsh-synapse
68
73
  ## 启动
69
74
 
70
75
  ```powershell
71
- corepack pnpm dsh web
76
+ dsh web
72
77
  ```
73
78
 
74
79
  默认地址:
@@ -80,7 +85,7 @@ http://127.0.0.1:3080/
80
85
  如果 3080 被占用,可以让 DSH 自动选择端口:
81
86
 
82
87
  ```powershell
83
- corepack pnpm dsh web --port 0
88
+ dsh web --port 0
84
89
  ```
85
90
 
86
91
  启动后点击顶部“会话地图”进入 Synapse。不要同时运行两个共享同一 profile 的 `dsh web` 实例。
@@ -151,7 +156,7 @@ corepack pnpm dsh web --port 0
151
156
  卸载插件:
152
157
 
153
158
  ```powershell
154
- corepack pnpm dsh plugin --profile web remove dsh-synapse
159
+ dsh plugin --profile web remove dsh-synapse
155
160
  ```
156
161
 
157
162
  `remove` 只移除插件依赖和 profile 激活层,不会删除画布数据。重新安装后,旧数据会继续使用并按需迁移。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-synapse",
3
- "version": "0.5.6",
3
+ "version": "0.5.7",
4
4
  "description": "A visual, non-linear conversation workspace plugin for DeepSeek Harness.",
5
5
  "type": "module",
6
6
  "main": "index.js",