dsh-chat-index

dsh plugin --profile web add dsh-chat-index

dsh-chat-index

A per-session question index for the DeepSeek Harness Web UI (dsh web): a thin

time-proportional dot rail on the right edge of every conversation, plus an

expandable chain panel. Every user question is a node with its text and time —

including questions in branch/subagent sessions — click any node to jump to

that message and briefly highlight it.





---

功能 / Features

• 右侧圆点窄条(rail):每个提问一个圆点,按真实提问时间间隔分布

(顶部 = 最早,底部 = 最近);点击圆点 → 聊天区滚动定位并短暂高亮;

按住上下拖动可快速滑动,拖动时右侧浮出该提问的摘要小窗;条顶显示提问数。

• 链面板(chain):会话标题行最右的常驻 ≡ 开关,或窄条底部 ⇱,

展开链视图 —— 每个节点显示问题摘要 + 时间;分支/子会话以子树

挂在主会话下(节点可点击,先切换到对应会话再定位高亮);✕ 收起。

• 空会话不显示窄条,但 ≡ 始终可用(面板显示"还没有提问")。
• 数据源:当前会话实时快照 + 持久历史(session.history 分页),换会话自动重建。
• 纯前端实现,host 仅保留最小 loader 入口。
• 与已有同类(dsh-question-nav、dsh-chat-rail、dsh-chat-index-rail)的差异:

链面板 + 分支会话子树 + 时间比例分布。

截图 / Screenshots

右侧提问窄条(rail) · 链面板(chain,含分支子树)

 · 

均为实际运行截图(点击图片可放大)。docs/ 下另存有两张同风格的 SVG 设计稿

(preview-rail.svg / preview-panel.svg),供文档或宣传图复用。

安装 / Install

通过 DSH 官方插件通道安装(npm 发布后可用):

dsh plugin --profile web add dsh-chat-index

手动安装(无需联网,便于本地调试):把本包放进 profile 依赖目录,并在

~/.dsh/profiles/web/cordis.patch.yml 追加:

```yaml

- insert:

- id: chat-index

name: 'dsh-chat-index'

```

无需重启服务,刷新页面即可。注意:手动通道与官方通道二选一,避免双重挂载。

使用 / Usage

1. 打开任意会话 → 右侧出现窄条(有提问时)。

2. 点圆点 / 按住拖动 → 跳到对应提问并高亮。

3. 点标题行右侧 ≡(或窄条底部 ⇱)展开链面板;点节点跳转,✕ 收起。

4. 会话内开关状态各自记忆;刷新页面后默认收起。

开发 / Development

node scripts/build.mjs        # 生成 lib/client.js(src/client/* 拼接)
node scripts/smoke.mjs        # 离线冒烟测试(模拟 DSH 模块加载器)
npm run check                 # build + 语法检查 + smoke

结构:

src/client/  客户端源码片段(纯 JS,无 JSX/TS)
             00-libs 01-style 02-utils 03-data 04-components 05-apply
lib/         发布产物(lib/index.js 宿主入口 + lib/client.js 浏览器模块)
cordis.patch.yml    DSH bundle patch(loader 挂载行)
scripts/      构建与冒烟脚本

发布 / Publishing

• 版本:bump package.json 的 version(semver)。
• 推送 tag(如 v0.1.1)会触发 [.github/workflows/publish.yml](.github/workflows/publish.yml)

自动 npm publish(需在仓库 Settings → Secrets → Actions 配置 NPM_TOKEN,

值 = 一个 npm Automation 令牌;令牌须带 npmjs 的 2FA 绕过能力)。

• 市场目录条目在 awesome-dsh-plugin

的 data/plugins/kk112222__dsh-chat-index.yml,指向本仓库,一般无需改动。

License

[MIT](LICENSE) © xiaoshuai111