@luziyang2026/dsh-question-nav 0.7.7 → 0.7.8

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.
Files changed (3) hide show
  1. package/README.md +42 -4
  2. package/README.zh.md +36 -4
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -21,11 +21,11 @@ Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm] · [GitHub][github]).
21
21
 
22
22
  ## Preview
23
23
 
24
- ![Full DSH Web GUI screenshot with the question-nav dot rail embedded on the left edge of the conversation column](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/0.7.4%E6%95%88%E6%9E%9C%E9%A2%84%E8%A7%88.jpg)
24
+ ![Full DSH Web GUI screenshot with the question-nav dot rail embedded on the left edge of the conversation column](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/assets/screenshots/01-main.png)
25
25
 
26
26
  Plugin settings (rail alignment + dots per page):
27
27
 
28
- ![The plugin's settings page: rail alignment and dots-per-page segmented controls](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/%E6%8F%92%E4%BB%B6%E9%85%8D%E7%BD%AE%E5%8F%82%E6%95%B0%E8%AE%BE%E7%BD%AE.jpg)
28
+ ![The plugin's settings page: rail alignment and dots-per-page segmented controls](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/assets/screenshots/02-settings.png)
29
29
 
30
30
  ## What it does
31
31
 
@@ -77,12 +77,50 @@ Plugin settings (rail alignment + dots per page):
77
77
  - DeepSeek Harness Web GUI (a runnable DSH profile; the `dsh` CLI).
78
78
  - Node.js `>= 20` (matches the DSH SDK peer range).
79
79
 
80
+ ## Which version to install
81
+
82
+ The package publishes **two lines** under the same name, so pick the one that
83
+ matches the DSH build your GUI runs on:
84
+
85
+ | npm dist-tag | Version | Targets the DSH | Status |
86
+ |---|---|---|---|
87
+ | `latest` | `0.7.x` | `0.1.1-rc.1` SDK line | **Stable** — recommended for everyday use |
88
+ | `alpha` | `0.8.0-alpha.x` | `0.1.2-alpha.2` SDK line | **Alpha** — for the Alpha GUI build |
89
+
90
+ - **Most users install the `latest` (stable) line** — it tracks the stable DSH
91
+ release and is safe for daily use.
92
+ - **Running the DSH Alpha GUI (`0.1.2-alpha.2`)?** Install the `alpha`
93
+ dist-tag instead. The stable build reads a chat snapshot API
94
+ (`session.getSnapshot().chat`) that was **removed** in the Alpha SDK; the
95
+ `alpha` build reads the live chat through the new conversation service
96
+ instead. Installing the stable line on an Alpha GUI would leave the strip
97
+ degraded (projection-only dots).
98
+ - **Not sure which DSH build you have?** Check the version in your GUI / with
99
+ `dsh --version`; if it reports `0.1.1-rc.x`, use `latest`; if it reports
100
+ `0.1.2-alpha.x`, use `alpha`.
101
+
80
102
  ## Install
81
103
 
82
- Install the prebuilt package from npm and add it to a profile:
104
+ Install the prebuilt package from npm and add it to a profile. **Use the
105
+ dist-tag that matches your DSH build** (see above):
106
+
107
+ **Stable line (DSH `0.1.1-rc.1`, most users):**
108
+
109
+ ```sh
110
+ dsh plugin --profile web add @luziyang2026/dsh-question-nav # latest → 0.7.x
111
+ ```
112
+
113
+ **Alpha line (DSH `0.1.2-alpha.2` GUI):**
114
+
115
+ ```sh
116
+ dsh plugin --profile web add @luziyang2026/dsh-question-nav@alpha # alpha → 0.8.0-alpha.x
117
+ ```
118
+
119
+ If you prefer a specific version, pin it explicitly:
83
120
 
84
121
  ```sh
85
- dsh plugin --profile web add @luziyang2026/dsh-question-nav
122
+ dsh plugin --profile web add @luziyang2026/dsh-question-nav@0.7.7 # stable pin
123
+ dsh plugin --profile web add @luziyang2026/dsh-question-nav@0.8.0-alpha.0 # alpha pin
86
124
  ```
87
125
 
88
126
  Then restart the DSH Web GUI to load the new bundle.
package/README.zh.md CHANGED
@@ -18,11 +18,11 @@
18
18
 
19
19
  ## 效果展示
20
20
 
21
- ![DSH Web GUI 完整截图：对话栏左侧内嵌提问导航圆点列，每个圆点对应一个用户提问](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/0.7.4%E6%95%88%E6%9E%9C%E9%A2%84%E8%A7%88.jpg)
21
+ ![DSH Web GUI 完整截图：对话栏左侧内嵌提问导航圆点列，每个圆点对应一个用户提问](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/assets/screenshots/01-main.png)
22
22
 
23
23
  插件设置页（导航条对齐 + 每次翻出数量）：
24
24
 
25
- ![插件设置页截图：导航条对齐与每次翻出数量两组分段选项](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/%E6%8F%92%E4%BB%B6%E9%85%8D%E7%BD%AE%E5%8F%82%E6%95%B0%E8%AE%BE%E7%BD%AE.jpg)
25
+ ![插件设置页截图：导航条对齐与每次翻出数量两组分段选项](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/assets/screenshots/02-settings.png)
26
26
 
27
27
  ## 功能
28
28
 
@@ -63,12 +63,44 @@
63
63
  - DeepSeek Harness Web GUI（可运行的 DSH profile；需要 `dsh` CLI）。
64
64
  - Node.js `>= 20`（与 DSH SDK peer 范围一致）。
65
65
 
66
+ ## 选择哪个版本
67
+
68
+ 同一个包名下发布**两条版本线**，请按你 GUI 所运行的 DSH 构建选择：
69
+
70
+ | npm dist-tag | 版本 | 适配的 DSH | 状态 |
71
+ |---|---|---|---|
72
+ | `latest` | `0.7.x` | `0.1.1-rc.1` SDK 线 | **稳定版** —— 日常使用推荐 |
73
+ | `alpha` | `0.8.0-alpha.x` | `0.1.2-alpha.2` SDK 线 | **Alpha 版** —— 适配 Alpha GUI |
74
+
75
+ - **绝大多数用户装 `latest`（稳定版）**：跟随 DSH 稳定版发布线，日常使用安全。
76
+ - **你的 GUI 是 DSH Alpha 版（`0.1.2-alpha.2`）？** 请改用 `alpha` dist-tag。
77
+ 稳定版读取的是 `session.getSnapshot().chat` 这个 chat 快照 API，它在 Alpha SDK
78
+ 中**已被移除**；`alpha` 版改为通过新的 conversation 服务读取实时对话。若在 Alpha
79
+ GUI 上装稳定版，导航条会降级（只剩投影圆点）。
80
+ - **不确定自己是什么 DSH 构建？** 在 GUI 里或 `dsh --version` 看版本号：`0.1.1-rc.x`
81
+ 用 `latest`；`0.1.2-alpha.x` 用 `alpha`。
82
+
66
83
  ## 安装
67
84
 
68
- 从 npm 装预构建包并加进 profile：
85
+ 从 npm 装预构建包并加进 profile。**请使用与你的 DSH 构建匹配的 dist-tag**（见上）：
86
+
87
+ **稳定版（DSH `0.1.1-rc.1`，大多数用户）：**
88
+
89
+ ```sh
90
+ dsh plugin --profile web add @luziyang2026/dsh-question-nav # latest → 0.7.x
91
+ ```
92
+
93
+ **Alpha 版（DSH `0.1.2-alpha.2` GUI）：**
94
+
95
+ ```sh
96
+ dsh plugin --profile web add @luziyang2026/dsh-question-nav@alpha # alpha → 0.8.0-alpha.x
97
+ ```
98
+
99
+ 如需锁定具体版本，可显式指定：
69
100
 
70
101
  ```sh
71
- dsh plugin --profile web add @luziyang2026/dsh-question-nav
102
+ dsh plugin --profile web add @luziyang2026/dsh-question-nav@0.7.7 # 稳定版锁版
103
+ dsh plugin --profile web add @luziyang2026/dsh-question-nav@0.8.0-alpha.0 # Alpha 锁版
72
104
  ```
73
105
 
74
106
  然后重启 DSH Web GUI 以加载新 bundle。
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@luziyang2026/dsh-question-nav",
3
3
  "description": "In-session question navigator for the DSH web GUI: a vertical minimap of round dots overlaid on the edge of the conversation column (left or right, configurable in settings), one dot per user question — hovering focuses a magnified window and a vertical cascade of crisp question cards showing the full text and sent time of each (any card is clickable), click jumps to that message.",
4
- "version": "0.7.7",
4
+ "version": "0.7.8",
5
5
  "type": "module",
6
6
  "packageManager": "pnpm@11.7.0",
7
7
  "engines": {