@luziyang2026/dsh-question-nav 0.8.0-alpha.0 → 0.8.0-alpha.1

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 -22
  2. package/README.zh.md +36 -18
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -19,31 +19,13 @@ only a small bundle to the GUI at load time.
19
19
 
20
20
  Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm] · [GitHub][github]).
21
21
 
22
- > **Alpha-adapted build (0.8.0-alpha.0).** This release adapts the plugin to the
23
- > **DSH `0.1.2-alpha.2` SDK line** — the current Alpha build of the DeepSeek
24
- > Harness web GUI. The live chat window is now read through the 0.1.2
25
- > conversation service (`ctx.uiConversation.binding(id).target('chat')`),
26
- > replacing the removed `session.getSnapshot().chat`; settings types, the
27
- > session-projection unit, and the sessions selector were updated to the new
28
- > API shapes, and the `@deepseek-ai/*` devDeps moved from `0.1.1-rc.1` to
29
- > `0.1.2-alpha.2`. When the conversation service is absent (headless/edge
30
- > compositions) the strip degrades to projection-only dots. All earlier
31
- > interactions — hover focus + cascade, paging, scroll-spy marker,
32
- > right-aligned rail — are unchanged.
33
- >
34
- > Install it with the `alpha` dist-tag when your GUI runs the Alpha build:
35
-
36
- ```sh
37
- dsh plugin --profile web add @luziyang2026/dsh-question-nav@alpha
38
- ```
39
-
40
22
  ## Preview
41
23
 
42
- ![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)
43
25
 
44
26
  Plugin settings (rail alignment + dots per page):
45
27
 
46
- ![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)
47
29
 
48
30
  ## What it does
49
31
 
@@ -95,12 +77,50 @@ Plugin settings (rail alignment + dots per page):
95
77
  - DeepSeek Harness Web GUI (a runnable DSH profile; the `dsh` CLI).
96
78
  - Node.js `>= 20` (matches the DSH SDK peer range).
97
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
+
98
102
  ## Install
99
103
 
100
- 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:
101
120
 
102
121
  ```sh
103
- 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
104
124
  ```
105
125
 
106
126
  Then restart the DSH Web GUI to load the new bundle.
package/README.zh.md CHANGED
@@ -16,27 +16,13 @@
16
16
 
17
17
  包名：**`@luziyang2026/dsh-question-nav`**（[npm][npm] · [GitHub][github]）。
18
18
 
19
- > **适配 Alpha 版本（0.8.0-alpha.0）。** 本版本将插件适配到 **DSH `0.1.2-alpha.2` SDK 线**
20
- > —— 即 DeepSeek Harness Web GUI 当前的 Alpha 构建。实时对话窗口改为通过 0.1.2 的
21
- > conversation 服务读取（`ctx.uiConversation.binding(id).target('chat')`），取代被移除的
22
- > `session.getSnapshot().chat`；settings 类型、会话投影单元与 sessions 选择器均按新 API
23
- > 形态更新，`@deepseek-ai/*` devDeps 从 `0.1.1-rc.1` 升到 `0.1.2-alpha.2`。当 conversation
24
- > 服务不可用（headless / 边缘组合）时，导航条自动降级为仅投影圆点。此前的全部交互
25
- > —— 悬停聚焦 + 卡片级联、分页、scroll-spy 位置标记、右对齐导航条 —— 均保持不变。
26
- >
27
- > 若你的 GUI 运行在 Alpha 构建上，用 `alpha` dist-tag 安装：
28
-
29
- ```sh
30
- dsh plugin --profile web add @luziyang2026/dsh-question-nav@alpha
31
- ```
32
-
33
19
  ## 效果展示
34
20
 
35
- ![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)
36
22
 
37
23
  插件设置页（导航条对齐 + 每次翻出数量）：
38
24
 
39
- ![插件设置页截图：导航条对齐与每次翻出数量两组分段选项](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)
40
26
 
41
27
  ## 功能
42
28
 
@@ -77,12 +63,44 @@ dsh plugin --profile web add @luziyang2026/dsh-question-nav@alpha
77
63
  - DeepSeek Harness Web GUI（可运行的 DSH profile；需要 `dsh` CLI）。
78
64
  - Node.js `>= 20`（与 DSH SDK peer 范围一致）。
79
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
+
80
83
  ## 安装
81
84
 
82
- 从 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
+ 如需锁定具体版本，可显式指定：
83
100
 
84
101
  ```sh
85
- 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 锁版
86
104
  ```
87
105
 
88
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.8.0-alpha.0",
4
+ "version": "0.8.0-alpha.1",
5
5
  "type": "module",
6
6
  "packageManager": "pnpm@11.7.0",
7
7
  "engines": {