@luziyang2026/dsh-question-nav 0.1.0 → 0.3.0

package/README.md

@@ -10,47 +10,56 @@ 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
 only a small bundle to the GUI at load time.
 
+Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm]).
+
 ## What it does
 
 - **Left-edge dot minimap** (embedded, not reserving any width).
 - **Vertically centered** in the conversation column.
 - **One dot = one user question**, with a small count above the dot column.
+- **Full history, no render-window expansion**: the index is built by paging
+  the raw `session.history` RPC (read-only), so every question in the session —
+  including ones still collapsed behind DSH's "load older" button — appears as
+  a dot without expanding the conversation's paged window (memory economy
+  preserved). While the index is building the count shows a "…"; if the safety
+  budget is exhausted a dimmed dashed dot above the oldest question offers
+  "load earlier" on click.
 - **Hover**: the dot enlarges and an instant tooltip (portal-rendered, no
   native-title delay) shows the question's **full text**.
-- **Click**: jumps to that question, paging older history when the target is
-  not yet in the loaded window (with a nearest-row fallback).
+- **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.
 - Empty/left areas of the rail pass pointer events through to the conversation
   (it never blocks the chat).
 
-## Behavior notes
+## Requirements
 
-- Only the current session is indexed; the question list reflects the loaded
-  chat window and expands as history is paged in.
-- `user` and `steering` user messages count as questions.
+- DeepSeek Harness Web GUI (a runnable DSH profile; the `dsh` CLI).
+- Node.js `>= 20` (matches the DSH SDK peer range).
 
-## Install (development / local checkout)
+## Install
 
-This repository is a standalone plugin project — build it, then add it to a
-profile as an installable [bundle][bundle].
+Install the prebuilt package from npm and add it to a profile:
 
 ```sh
-pnpm install       # install devDependencies (DSH SDK peers, tsdown, vitest)
-pnpm build         # tsc declarations + tsdown client bundle -> lib/
+dsh plugin --profile web add @luziyang2026/dsh-question-nav
 ```
 
-Add it to a profile (the `dsh` CLI is required):
+Then restart the DSH Web GUI to load the new bundle.
 
-```sh
-dsh plugin --profile web add ./dsh-question-nav
-```
+### Build from source / develop locally
 
-Or, once published, install the prebuilt package from npm:
+This repository is a standalone plugin project — build it, then add the
+checkout to a profile as an installable [bundle][bundle]:
 
 ```sh
-dsh plugin --profile web add @luziyang2026/dsh-question-nav
+pnpm install       # install devDependencies (DSH SDK peers, tsdown, vitest)
+pnpm build         # tsc declarations + tsdown client bundle -> lib/
 ```
 
-Restart the DSH Web GUI to load the new bundle.
+```sh
+dsh plugin --profile web add ./dsh-question-nav
+```
 
 ## Development
 
@@ -73,4 +82,5 @@ module table.
 BSD-3-Clause.
 
 [dsh]: https://github.com/deepseek-harness/deepseek-harness
+[npm]: https://www.npmjs.com/package/@luziyang2026/dsh-question-nav
 [bundle]: https://github.com/deepseek-harness/deepseek-harness

package/README.zh.md

@@ -7,42 +7,50 @@
 它是外部插件 bundle，**零运行时依赖** —— 浏览器半区（`lib/client.js`）把一切
 外部化给 DSH 外壳，加载时只往 GUI 里加一个很小的 bundle。
 
+包名：**`@luziyang2026/dsh-question-nav`**（[npm][npm]）。
+
 ## 功能
 
 - **左缘圆点迷你地图**：内嵌，**不占任何宽度**。
 - **垂直居中**在对话栏中。
 - **一个圆点 = 一个用户提问**，圆点列上方有提问数量。
+- **完整历史、不展开渲染窗口**：索引通过分页读取原始 `session.history`
+  RPC（只读）构建，所以会话里的每一个提问——包括仍被 DSH"加载更早"按钮
+  折叠隐藏的老提问——都会变成圆点，**不会**展开对话的分页窗口（保留 DSH
+  的内存经济性）。构建索引期间数量后显示 "…"；若超过安全预算，最老提问
+  上方会出现一个虚线圆点，点击继续加载。
 - **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示**全文**。
-- **点击**：跳转到该提问，目标尚未加载时自动 `loadOlder` 扩窗（并落到最近可见行兜底）。
+- **点击**：跳转到该提问；只有这时跳转循环才 `loadOlder()` 扩窗，把**那一页**
+  带进视图——绝不会一次性展开整个历史。
 - 圆点列空白区域**点穿**到对话内容，不会挡住聊天。
 
-## 行为说明
+## 环境要求
 
-- 只索引当前会话；问题列表反映已加载的对话窗口，随历史扩窗补全。
-- `user` 与 `steering` 用户消息计为提问。
+- DeepSeek Harness Web GUI（可运行的 DSH profile；需要 `dsh` CLI）。
+- Node.js `>= 20`（与 DSH SDK peer 范围一致）。
 
-## 安装（开发 / 本地 checkout）
+## 安装
 
-本仓库是独立插件工程 —— 先构建，再作为可安装的 [bundle][bundle] 加进 profile。
+从 npm 装预构建包并加进 profile：
 
 ```sh
-pnpm install       # 安装 devDependencies（DSH SDK peers、tsdown、vitest）
-pnpm build         # tsc 声明 + tsdown client bundle -> lib/
+dsh plugin --profile web add @luziyang2026/dsh-question-nav
 ```
 
-加进 profile（需要 `dsh` CLI）：
+然后重启 DSH Web GUI 以加载新 bundle。
 
-```sh
-dsh plugin --profile web add ./dsh-question-nav
-```
+### 从源码构建 / 本地开发
 
-发布后也可直接从 npm 装预构建产物：
+本仓库是独立插件工程 —— 先构建，再作为可安装的 [bundle][bundle] 加进 profile：
 
 ```sh
-dsh plugin --profile web add @luziyang2026/dsh-question-nav
+pnpm install       # 安装 devDependencies（DSH SDK peers、tsdown、vitest）
+pnpm build         # tsc 声明 + tsdown client bundle -> lib/
 ```
 
-重启 DSH Web GUI 以加载新 bundle。
+```sh
+dsh plugin --profile web add ./dsh-question-nav
+```
 
 ## 开发
 
@@ -64,4 +72,5 @@ externals 经加载器模块表解析。
 BSD-3-Clause。
 
 [dsh]: https://github.com/deepseek-harness/deepseek-harness
+[npm]: https://www.npmjs.com/package/@luziyang2026/dsh-question-nav
 [bundle]: https://github.com/deepseek-harness/deepseek-harness