@luziyang2026/dsh-question-nav 0.4.2 → 0.6.0

package/README.md

@@ -1,10 +1,17 @@
 # dsh-question-nav
 
+<p align="center">
+  <a href="https://github.com/AbelKeithsun/dsh-question-nav/blob/main/README.md">English</a> |
+  <a href="https://github.com/AbelKeithsun/dsh-question-nav/blob/main/README.zh.md">简体中文</a>
+</p>
+
 In-session question navigator for the [DeepSeek Harness (DSH) Web GUI][dsh]: a
 vertical column of small round dots overlaid on the **left edge** of the
-conversation column — one dot per user question. Hover a dot to enlarge it and
-see the question's **full text** immediately; click a dot to scroll the chat to
-that question.
+conversation column — one dot per user question. Hover a dot to magnify it
+(together with its two neighbors on each side) and reveal a vertical cascade
+of crisp question cards with each question's **full text** and **sent time**
+(clicking any card jumps to it); click a dot to scroll the chat to that
+question.
 
 It is an external plugin bundle with zero runtime dependencies — the browser
 half (`lib/client.js`) externalizes everything to the DSH shell, so it adds
@@ -14,12 +21,17 @@ Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm] · [GitHub][github]).
 
 ## Preview
 
-![Left-edge dot minimap with a hover tooltip showing the turn label and full question text](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/question-nav-preview.jpg)
+![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/question-nav-preview.jpg)
 
 ## What it does
 
-- **Left-edge dot minimap** (embedded, not reserving any width).
-- **Vertically centered** in the conversation column.
+- **Left-edge dot minimap** (embedded, not reserving any width). The rail's
+  anchor edge is configurable — **Settings → Plugins → Question Nav → Rail
+  alignment** switches it between the left and right edge of the conversation
+  column.
+- **Height-capped and scrollable**: the dot column is vertically centered and
+  uses at most **60%** of the conversation height; longer sessions scroll
+  inside that band (wheel over the dots or the gaps between them).
 - **One dot = one turn that asked a question** (strictly aligned with the
   Trajectory view's turn numbering), with a small count above the dot column.
 - **Full history, persisted, no render-window expansion**: the plugin's host
@@ -27,9 +39,17 @@ Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm] · [GitHub][github]).
   registry folds the whole event log (read-only, the chat's paged window is
   never touched), the official projection cache persists it across restarts,
   and push frames deliver new questions live.
-- **Hover**: the dot enlarges and an instant tooltip (portal-rendered, no
-  native-title delay) shows the **turn label** (`Turn N`) plus the turn's
-  **full question text** (all of them, when one turn batched several).
+- **Hover (focus)**: the dot and its **two neighbors on each side** magnify
+  progressively (selected largest), the rail auto-centers the selection, and a
+  **vertical cascade of five crisp question cards** (portal-rendered, no
+  native-title delay) appears beside the rail — one card per window dot,
+  stacked top-to-bottom without overlap and centered on the selected dot. Each
+  card shows the turn's **full question text** (all of them, when one turn
+  batched several) and the question's **sent time** (`HH:MM` on the same day,
+  `MM-DD HH:MM` across days, `YYYY-MM-DD HH:MM` across years). The **center
+  card is the brightest** and marked with a brand edge; cards further from it
+  are slightly narrower, dimmer and show fewer lines. **Clicking any card
+  jumps to that question** exactly like clicking its dot.
 - **Click**: jumps to that question. Only then does the jump loop page the
   window (`loadOlder()`) to bring that specific page into view — never the
   whole history up front.

package/README.zh.md

@@ -1,8 +1,15 @@
 # dsh-question-nav
 
+<p align="center">
+  <a href="https://github.com/AbelKeithsun/dsh-question-nav/blob/main/README.md">English</a> |
+  <a href="https://github.com/AbelKeithsun/dsh-question-nav/blob/main/README.zh.md">简体中文</a>
+</p>
+
 [DeepSeek Harness (DSH) Web GUI][dsh] 的**会话内提问导航**插件：在对话栏**左侧**
-内嵌一列竖排的圆点小按钮 —— 每个圆点对应一个用户提问。鼠标悬停圆点会放大
-并**立即**显示该提问的**全文**；点击圆点则把对话滚动跳到那一提问的位置。
+内嵌一列竖排的圆点小按钮 —— 每个圆点对应一个用户提问。鼠标悬停圆点会把该圆点
+连同其**上下各两个**圆点一起放大，并弹出**竖排的清晰问题卡片**显示对应提问的
+**全文**与**发出时间**（点击任意卡片即可跳转）；点击圆点则把对话滚动跳到那一
+提问的位置。
 
 它是外部插件 bundle，**零运行时依赖** —— 浏览器半区（`lib/client.js`）把一切
 外部化给 DSH 外壳，加载时只往 GUI 里加一个很小的 bundle。
@@ -11,20 +18,28 @@
 
 ## 效果展示
 
-![左缘圆点迷你地图：竖排圆点，每个圆点对应一个用户提问，悬停显示 Turn 编号与全文](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/question-nav-preview.jpg)
+![DSH Web GUI 完整截图：对话栏左侧内嵌提问导航圆点列，每个圆点对应一个用户提问](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/question-nav-preview.jpg)
 
 ## 功能
 
-- **左缘圆点迷你地图**：内嵌，**不占任何宽度**。
-- **垂直居中**在对话栏中。
+- **左缘圆点迷你地图**：内嵌，**不占任何宽度**。导航条锚定边**可配置**——
+  **设置 → 插件 → 提问导航 → 导航条对齐**可在对话栏左/右缘之间切换。
+- **限高 + 可滚动**：圆点列垂直居中，最多占用对话栏高度的 **60%**；会话提问
+  更多时在带内上下滚动（滚轮在圆点上或圆点间隙上都能滚）。
 - **一个圆点 = 一个含提问的 turn**（与轨迹视图的 Turn 编号严格对齐），
   圆点列上方有圆点数量。
 - **完整历史、持久化、不展开渲染窗口**：插件的 host 半面注册
   `questionIndex` 会话投影——投影注册表折叠完整事件日志（只读，对话的
   分页窗口完全不被动），官方 projection-cache 跨重启持久化，新提问通过
   推送帧实时到达。
-- **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示
-  **Turn 编号**（`Turn N`）和该轮提问**全文**（一轮多条提问时全部列出）。
+- **悬停（聚焦）**：圆点与其**上下各两个**圆点一起渐进放大（选中最大），
+  导航条自动把选中点居中；导航条旁出现一列**竖排的 5 张清晰问题卡片**
+  （portal 渲染，无原生 `title` 延迟）——窗口内每个圆点一张卡片，上下排布、
+  **互不遮挡**，以选中点为中心垂直居中。每张卡片显示该轮提问**全文**（一轮
+  多条提问时全部列出）与提问的**发出时间**（当天 `HH:MM`，跨天
+  `MM-DD HH:MM`，跨年 `YYYY-MM-DD HH:MM`）。**中心卡片最亮**并带品牌色描边，
+  离中心越远的卡片稍窄、稍暗、行数更少；**点击任意卡片即跳转到对应提问**，
+  与点击圆点效果一致。
 - **点击**：跳转到该提问；只有这时跳转循环才 `loadOlder()` 扩窗，把**那一页**
   带进视图——绝不会一次性展开整个历史。
 - 圆点列空白区域**点穿**到对话内容，不会挡住聊天。