dsh-plugin-question-index · 问题索引

一个 DeepSeek Harness (DSH) 的 Client UI 插件：以主聊天区左缘的问题刻度轨道展示当前会话的问题索引。 点击任一提问，聊天内容自动平滑滚动定位到该提问所在的位置。

![slot] 本插件只做加法：注册 shell.overlay（全局浮层）的一个列表条目，不替换任何产品 UI； 样式引用 --dsw-alias-* 主题令牌，明暗主题自动适配。

效果展示

主聊天区左缘按问题数量显示一列细横线。鼠标移入某条横线时，该线延长并在右侧浮层显示完整问题原文；点击后，会话内容自动滚动到对应消息。

功能

• 问题刻度：固定在主聊天区左缘，每个用户问题对应一条短横线，无按钮或弹框外观
• 仅对话可见：只在「对话」Tab 展示，切换到「轨迹」等其他页签时自动隐藏
• 原文浮层：鼠标移入某条横线时，该线平滑延长，并在右侧显示完整问题原文
• 索引：按顺序列出当前会话全部提问（含运行中插话发送的「插话」，带角标）
• 轨道内滚动：问题较多时轨道可独立滚动，不撑爆页面
• 原文滚动：问题内容较长时，原文浮层可独立滚动阅读
• 点击定位：点击问题 → 聊天内容平滑滚动到该提问所在行（约视口上方 1/4 处）； 若当前停在轨迹等其他视图，先自动切回「对话」再滚动
• 键盘访问：Tab 聚焦横线后显示摘要，Enter / Space 定位到对应问题

实现要点（对齐市场插件的开发方式）

关注点	做法
界面挂载	slots.inject('shell.overlay', …) + slots.register，增量槽位，随 Fiber 卸载
浮层托管	根节点 pointer-events:none（浮层容器规则），仅面板/按钮恢复 pointer-events:auto
数据来源	useSessions(s => s.current) → sessions.binding(id).session（SessionFace 的 getSnapshot()/subscribe()），零 Host RPC、零持久化
跳转锚点	聊天节点 key = 行上的 data-chat-anchor-key（产品滚动恢复用同一契约）
视图切换	头部 [role="tablist"] 第一个标签按钮（「对话」order 0），仅 aria-selected !== 'true' 时点击
延时轮询	timer 服务（ctx.get('timer')），80ms × 25 次上限，连续点击自动取消上一轮询链
样式	插件自有样式：动态环境用 styles.insert，静态装载降级为 <style data-plugin> 标签

框架没有公开的跨视图滚动 API（活动视图 id 在会话包的私有 store 里），所以「切视图 + 滚动定位」 用了轻量 DOM 桥接（只读产品自己的锚点属性），全程 typeof document 守卫，找不到元素即静默降级。 消息太旧未被加载进当前渲染窗口时，约 2 秒内找不到锚点会自动放弃。

工程结构

question-index/
├── package.json            # 双面清单：dsh.bundle.patch + dsh.client + ./client 导出
├── src/client.js           # 浏览器端功能源码（ESM）
├── src/index.js            # Host 装载载体（纯客户端插件，空 apply）
├── scripts/build-client.mjs# 构建：src/client.js → lib/client.js（lazy-CJS bundle）
├── cordis.patch.yml        # 包自带组合补丁（dsh.bundle.patch 层，insert 本插件行）
├── lib/                    # 构建产物（发布内容）
└── README.md

构建与验证：

node scripts/build-client.mjs   # 产出 lib/client.js + lib/index.js

安装方式

本包是「双面自挂载」形态：dsh.client.platform: 'web' 让宿主自动服务浏览器 bundle， dsh.bundle.patch 让包自带组合补丁——装上即挂载，无需手改 profile 文件。

方式一：从 GitHub 在线安装

dsh plugin --profile web add github:antlordGit/dsh-plugin-question-index

命令会安装包、把包名追加进 profile 的 dsh.profile.bundles、合入自带的 cordis.patch.yml（单条 insert），重启/热重载后生效。

方式二：下载源码后安装

打开 GitHub 仓库，点击 Code → Download ZIP，解压后进入源码目录：

cd /你的路径/dsh-plugin-question-index
npm install
npm run build
dsh plugin --profile web add "$(pwd)"

两种方式任选其一。安装完成后重启 dsh web（或等待补丁层热重载），任意会话右上角会出现 「问题索引」悬浮面板。

React 不需要安装：客户端 bundle 里的 require("react") 由 DSH shell 的模块表提供。

契约依赖（版本敏感点）

• shell.overlay：全局浮层（列表条目 {id, order, label}；容器 pointer-events:none， 直接子元素恢复交互）
• sessions 服务：binding(id) → SessionFace（ObservableSnapshot<ConversationSnapshot>）
• useSessions：全局标准 props，SessionListState.current 为当前会话 id
• 聊天行：data-chat-anchor-key / 滚动容器：data-conversation-scroll
• 会话头部：[role="tablist"] + button[role="tab"][aria-selected]
• 主题令牌：--dsw-alias-bg-overlay、--dsw-alias-bg-layer-1/2、--dsw-alias-border-l1/l2、 --dsw-alias-brand-primary、--dsw-alias-label-primary/secondary

这些是当前 DSH 版本的运行时契约；升级 DSH 后如有变化，优先核对上表。