@luziyang2026/dsh-question-nav 0.3.0 → 0.4.1

package/LICENSE

@@ -1,29 +1,21 @@
-BSD 3-Clause License
+MIT License
 
-Copyright (c) 2026, Abel Keith Sun. All rights reserved.
+Copyright (c) 2026 Abel Keith Sun
 
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-1. Redistributions of source code must retain the above copyright notice,
-   this list of conditions and the following disclaimer.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its
-   contributors may be used to endorse or promote products derived from this
-   software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,22 +10,26 @@ 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]).
+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)
 
 ## 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.
+- **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
+  half registers a `questionIndex` session projection — the projection
+  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 question's **full text**.
+  native-title delay) shows the **turn label** (`Turn N`) plus the turn's
+  **full question text** (all of them, when one turn batched several).
 - **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.
@@ -79,8 +83,9 @@ module table.
 
 ## License
 
-BSD-3-Clause.
+MIT.
 
 [dsh]: https://github.com/deepseek-harness/deepseek-harness
 [npm]: https://www.npmjs.com/package/@luziyang2026/dsh-question-nav
+[github]: https://github.com/AbelKeithsun/dsh-question-nav
 [bundle]: https://github.com/deepseek-harness/deepseek-harness

package/README.zh.md

@@ -7,19 +7,24 @@
 它是外部插件 bundle，**零运行时依赖** —— 浏览器半区（`lib/client.js`）把一切
 外部化给 DSH 外壳，加载时只往 GUI 里加一个很小的 bundle。
 
-包名：**`@luziyang2026/dsh-question-nav`**（[npm][npm]）。
+包名：**`@luziyang2026/dsh-question-nav`**（[npm][npm] · [GitHub][github]）。
+
+## 效果展示
+
+![左缘圆点迷你地图：竖排圆点，每个圆点对应一个用户提问，悬停显示 Turn 编号与全文](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/question-nav-preview.jpg)
 
 ## 功能
 
 - **左缘圆点迷你地图**：内嵌，**不占任何宽度**。
 - **垂直居中**在对话栏中。
-- **一个圆点 = 一个用户提问**，圆点列上方有提问数量。
-- **完整历史、不展开渲染窗口**：索引通过分页读取原始 `session.history`
-  RPC（只读）构建，所以会话里的每一个提问——包括仍被 DSH"加载更早"按钮
-  折叠隐藏的老提问——都会变成圆点，**不会**展开对话的分页窗口（保留 DSH
-  的内存经济性）。构建索引期间数量后显示 "…"；若超过安全预算，最老提问
-  上方会出现一个虚线圆点，点击继续加载。
-- **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示**全文**。
+- **一个圆点 = 一个含提问的 turn**（与轨迹视图的 Turn 编号严格对齐），
+  圆点列上方有圆点数量。
+- **完整历史、持久化、不展开渲染窗口**：插件的 host 半面注册
+  `questionIndex` 会话投影——投影注册表折叠完整事件日志（只读，对话的
+  分页窗口完全不被动），官方 projection-cache 跨重启持久化，新提问通过
+  推送帧实时到达。
+- **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示
+  **Turn 编号**（`Turn N`）和该轮提问**全文**（一轮多条提问时全部列出）。
 - **点击**：跳转到该提问；只有这时跳转循环才 `loadOlder()` 扩窗，把**那一页**
   带进视图——绝不会一次性展开整个历史。
 - 圆点列空白区域**点穿**到对话内容，不会挡住聊天。
@@ -69,8 +74,9 @@ externals 经加载器模块表解析。
 
 ## License
 
-BSD-3-Clause。
+MIT。
 
 [dsh]: https://github.com/deepseek-harness/deepseek-harness
 [npm]: https://www.npmjs.com/package/@luziyang2026/dsh-question-nav
+[github]: https://github.com/AbelKeithsun/dsh-question-nav
 [bundle]: https://github.com/deepseek-harness/deepseek-harness