dsh-chat-index-rail

对话右侧悬浮"输入目录"——DeepSeek Harness (DSH) Web UI 插件。每条用户输入一根横条：悬停预览开头文字，点击平滑定位到对应消息，滚动时当前横条高亮。纯客户端插件，无宿主逻辑、无需批准、重启不丢。

Chat input index rail for DeepSeek Harness (DSH) Web UI: one bar per user message on the right edge; hover to preview, click to jump, active bar follows your scroll. Client-only, no host half, no approval needed, survives restarts.

---

简介 / About

在长对话里上下翻找某条输入很痛苦。本插件在对话窗口右侧悬浮一条"目录"：每一次你输入的内容 = 一根横条，按对话顺序纵向排列。悬停看预览、点击即定位、滚动跟高亮，再长的上下文也能一眼跳到想找的那条输入。

Tired of scrolling forever to find that one message in a long conversation? This plugin adds a floating rail on the right edge of the chat window: each user input is one horizontal bar, in conversation order. Hover to preview, click to jump, and the bar of the message you are currently reading stays highlighted.

功能特性 / Features

• 窗口右侧（距右缘 14px、垂直居中）悬浮目录条，每条用户输入一根横条
• 悬停横条 → 气泡显示 #seq · 第 N 条 + 前 15 字预览（不足 15 字全显示，超长加 …）
• 鼠标移入气泡 → 展开到前 40 字（气泡加宽，超高内部滚动）
• 点击横条 → 聊天区平滑滚动定位到对应消息
• 滚动聊天时，当前视口顶部附近的输入对应横条高亮（品牌色）
• 只收录真正的人类输入：压缩记录、插件注入的上下文不会混入目录

• A floating rail sits at the right edge (14px margin, vertically centered); each user message gets one bar.
• Hover a bar → tooltip shows #seq · #N + first 15 chars (full text when shorter, … when longer).
• Move the mouse into the tooltip → expands to 40 chars.
• Click a bar → the chat smoothly scrolls to that message.
• While scrolling, the bar of the message near the top of the viewport is highlighted in the brand color.
• Only genuine human inputs are indexed — compaction records and plugin-injected context never pollute the rail.

效果预览 / Screenshots

目录条外观示意（右侧竖排小横条，悬停弹出预览气泡）：

           ┌─────────────────────────┐
           │ #102 · 第 3 条           │   ← 悬停气泡（15 字预览）
           │ 调整到比如 15 / 40…      │
           └─────────────────────────┘
  ┌──────┐  ▬▬▬▬
  │      │  ▬▬▬▬▬▬▬▬▬▬▬             ← 高亮 = 当前视口位置
  │ 对话  │  ▬▬▬▬
  │ 区域  │  ▬▬▬▬
  └──────┘  ▬▬▬▬                     ← 悬浮目录条（右侧 14px）

实际效果截图：把截图保存为 docs/screenshot.png 后，取消下面一行的注释即可显示。 To show a real screenshot, save it as docs/screenshot.png and uncomment the line below.

安装 / Installation

方式 A：npm 安装（推荐）/ Via npm (recommended)

# 在 profile 目录（如 C:\Users\<you>\.dsh\profiles\web）执行
# run inside your DSH profile directory (e.g. C:\Users\<you>\.dsh\profiles\web)
npm install dsh-chat-index-rail

在 profile 的 package.json 追加 / then add to your profile package.json:

"dsh": {
  "profile": {
    "bundles": [ "...existing entries...", "dsh-chat-index-rail" ]
  }
}

在 profile 的 cordis.patch.yml 追加 / and append to cordis.patch.yml:

- id: chat-index-rail
  name: dsh-chat-index-rail

重启 DSH 生效 / restart DSH.

方式 B：手动复制 / Manual copy

把包目录复制到 $DSH_HOME/profiles/<active>/node_modules/dsh-chat-index-rail/，同样更新 profile package.json（dependencies + bundles）和 cordis.patch.yml，重启生效。

Copy the package folder into $DSH_HOME/profiles/<active>/node_modules/dsh-chat-index-rail/, update the profile package.json (dependencies + bundles) and cordis.patch.yml the same way, then restart.

使用说明 / Usage

打开任意会话，右侧即出现目录条：

1. 悬停横条看预览（15 字）
2. 鼠标移入气泡展开全文预览（40 字）
3. 点击横条跳转到对应输入
4. 滚动聊天时，当前位置对应横条高亮

Open any session and the rail appears on the right. Hover to preview (15 chars), move into the tooltip to expand (40 chars), click to jump, and follow the highlight while scrolling.

兼容性 / Compatibility

…