@cxx42/dsh-plugin-user-question-nav 1.0.0 → 1.0.1

package/README.md

@@ -1,129 +1,22 @@
-# dsh-plugin-user-question-nav
+# @cxx42/dsh-plugin-user-question-nav
 
-一个 DeepSeek Harness **桌面 bundle 插件**（客户端 UI 插件）：在会话**右侧**渲染一列竖直小圆按钮，从上到下一一对应已加载的每一条**用户提问**；点击某个按钮把会话滚动区平滑滚动到该提问处。
+A DeepSeek Harness **client** plugin that adds a right-side navigation rail to the conversation. It shows one small button per user question, top to bottom; clicking a button scrolls the chat to that question — handy for long sessions, similar to the question-jump rail on chat.deepseek.com.
 
-> 对标 [chat.deepseek.com](https://chat.deepseek.com/) 官网右侧的“问题定位”导航，解决长会话手动滚动太累的问题。
+## Install
 
-本插件是**纯客户端**，不需要 Host 端能力。
-
----
-
-## 包结构
-
-```
-dsh-plugin-user-question-nav/
-├── package.json          # 桌面 bundle 插件清单（dsh.bundle + dsh.client）
-├── cordis.patch.yml      # 客户端行插入示意（本机设为 no-op，见下文“加载方式”）
-├── lib/
-│   ├── index.js          # Host 半（空 —— 纯客户端插件）
-│   └── client.js         # Client 半（浏览器 bundle，实现导航条）
-├── install.ps1           # 注册到 profile 的幂等脚本（写入无 BOM）
-├── README.md
-└── dynamic-form/         # 备选：动态 Cordis 插件形式（client.js / host.js）
-```
-
-### 关键字段（package.json）
-
-- `dsh.bundle.patch: "./cordis.patch.yml"` —— 桌面 bundle 的补丁声明。
-- `dsh.client: { platform: "web", inject: [...] }` —— 使 `client-modules` 节点把本包扫进 `window.__DSH_BOOT__` 的浏览器清单。
-- `exports["."]` → `./lib/index.js`（Host），`exports["./client"]` → `./lib/client.js`（浏览器 bundle）。
-- `peerDependencies`：`react`（平台种子模块）、`@deepseek-ai/dsh-client-runtime`。
-
-### 原理
-
-- Client 半读取会话快照 `snapshot.chat`（`order` + `nodes`），筛选 `node.kind === "user"` / `"steering"` 的提问，渲染按钮。
-- 点击按钮用 `[data-conversation-scroll]` 与 `[data-chat-anchor-key="<node.key>"]` 计算偏移并 `scrollTo({behavior:"smooth"})`。
-- 挂载在会话级槽位 `conversation.session.header.utilities`（list / session scope），通过 `ctx.slots.inject` 等待槽位声明，避免加载顺序问题。
-
----
-
-## 如何安装（desktop 与 `dsh --port` web 均适用）
-
-1. **确认包名**：`dsh-plugin-user-question-nav`，本地路径
-   `C:/Users/cxx/Documents/DSHWorkspace/dsh_project2/dsh-plugin-user-question-nav`。
-
-2. **编辑 profile 清单** `~/.dsh/profiles/desktop/package.json`：
-   - 在 `dependencies` 加：
-     ```json
-     "dsh-plugin-user-question-nav": "file:C:/Users/cxx/Documents/DSHWorkspace/dsh_project2/dsh-plugin-user-question-nav"
-     ```
-   - 在 `dsh.profile.bundles` 加：
-     ```json
-     "dsh-plugin-user-question-nav"
-     ```
-
-3. **安装依赖**（在 profile 目录里）：
-   ```pwsh
-   Push-Location "$env:USERPROFILE\.dsh\profiles\desktop"
-   pnpm install
-   Pop-Location
-   ```
-
-4. **在 profile 的用户补丁层 `~/.dsh/profiles/desktop/cordis.patch.yml` 追加客户端行**（见下文“加载方式”，这是生效的**唯一**插入来源）：
-   ```yaml
-   - insert:
-       - id: ui-user-question-nav
-         name: 'dsh-plugin-user-question-nav'
-   ```
-
-5. **重启桌面 / 重新运行 `dsh --port <N>`**，让 profile 在启动时重新组装。
-
-> 也可直接运行本目录的安装脚本 `install.ps1`。它会幂等完成上面第 2、3 步（清单编辑 + pnpm 安装），并且**以无 BOM 的 UTF-8 写清单**（历史上 PowerShell 5 的 `Set-Content -Encoding UTF8` 会写 BOM，导致桌面 `JSON.parse` 崩溃）。
-
----
-
-## 重要：本机加载方式与“副本同步”（已踩过的坑）
-
-### 唯一插入来源 = profile 用户补丁层
-
-在这台 desktop 上，**profile bundle 的 `- insert:` 不会被可靠地推进到浏览器清单**（证据：同样注册在 profile 里的 `dsh-context`、`@linxin666/dsh-web-ui-all` 也没进 `window.__DSH_BOOT__`；它们走的是 `dsh-market` 热挂载的另一条路）。
-
-所以本插件的客户端行**只在** `~/.dsh/profiles/desktop/cordis.patch.yml`（用户补丁层，最后合成）里插入一次；而 **bundle 自己的 `cordis.patch.yml` 被置为 no-op**（仅注释，无 `insert`），避免重复。
-
-> 如果你在别的部署里 profile bundle 的 `insert` 能正常进图，可以把 bundle 的 `cordis.patch.yml` 恢复为 `- insert:`，并删掉 profile 用户补丁层那行，改成单一来源。
-
-### `duplicate loader entry id: ui-user-question-nav` 的成因
-
-如果**同时**存在两处 insert（bundle 的 `cordis.patch.yml` + profile 用户补丁层），`dsh --port 3081` 会报：
-
-```
-failed to apply loader entry include (cordis:include):
-duplicate loader entry id: ui-user-question-nav
+```powershell
+dsh plugin add @cxx42/dsh-plugin-user-question-nav
 ```
 
-修复：**只保留一处**生效插入（本机保留用户补丁层那处）。改完后 `dsh --port 3081` 能通过组合，直到绑定端口（`listen EACCES` 是环境/端口限制，与插件无关）。
-
-### `file:` 依赖是复制，不是符号链接 —— 改代码后要重新同步
-
-pnpm 对 `file:` 依赖默认**复制**到 `~/.dsh/profiles/desktop/node_modules/dsh-plugin-user-question-nav`（不是链接）。所以改过工作区里的 `lib/client.js`、`package.json`、`cordis.patch.yml` 后，**必须重新同步副本**：
-
-```pwsh
-Push-Location "$env:USERPROFILE\.dsh\profiles\desktop"
-pnpm install    # 或用 install.ps1，会重装 file: 依赖并重写清单（无 BOM）
-Pop-Location
-```
-
-否则桌面/`dsh` 会继续用旧副本。
-
-### 禁用请注意
-
-bundle 在 `dsh.profile.bundles` 里是可修改项，可在桌面“插件清单”禁用。但因为客户端行来自 profile 用户补丁层（不在 bundle 的补丁里），**禁用该 bundle 不会移除那行 insert**。要真正关掉导航条，需删掉/注释掉 `~/.dsh/profiles/desktop/cordis.patch.yml` 里那行。
-
----
-
-## 备选：动态 Cordis 插件形式
-
-`dynamic-form/` 里是同一功能的**动态插件**版本（`code.client` / `code.host`），适合用 `cordis_define` + `cordis_run` 即改即用（无需安装/重启）。两者 Client 逻辑一致；动态版用 `styles.insert(css)` 注入样式，桌面 bundle 版按官方 bundle 规范用 `<style>` 标签注入。
-
----
+Then **restart** the desktop (or `dsh --port` web) so the bundle is recomposed. The rail appears on the right once the session has more than one user message.
 
-## 依赖与约定
+## Requirements / Notes
 
-- Client 全局/模块：浏览器 module 系统提供 `react`（平台种子），`ctx.slots`（声明 `inject: ["slots"]`）。
-- 样式全部使用 DSH 主题变量（`--dsw-alias-*`），自动适配亮/暗色。
-- 遵守约定：不操作 `document.body` / `window`，仅用平台暴露的功能性数据属性（`[data-conversation-scroll]`、`[data-chat-anchor-key]`）做滚动定位。
+- It mounts into the chat conversation view (`@deepseek-ai/dsh-client-ui-conversation`), which ships with the base install.
+- Only the already-loaded part of the conversation is navigable; earlier pages aren't reachable until loaded.
+- Pure client plugin — no Host capabilities needed. Styling uses the DSH theme tokens, so it follows light/dark.
 
-## 局限
+## How it works
 
-- 只对**已加载**的会话节点导航（历史分页更早的消息不在 DOM 中）。
-- 导航条为固定定位、右侧垂直居中；无提问时自动隐藏。
+- Reads the conversation snapshot (`snapshot.chat`), filters `user` / `steering` nodes, and renders one button per question.
+- On click it scrolls the `[data-conversation-scroll]` container to the matching `[data-chat-anchor-key]` node.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxx42/dsh-plugin-user-question-nav",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "DeepSeek Harness web plugin: a right-side navigation rail of user-question buttons that scrolls the chat to each user message (like chat.deepseek.com).",
   "type": "module",
   "main": "lib/index.js",