How to use dsh-message-rail

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

Adds a Codex-style left message navigation rail with tick marks, hover previews, and click-to-jump for user messages.

— source: plugins.ai_summary

Install & verify

dsh plugin --profile web add dsh-message-rail

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

• 等距刻度轨道：会话左侧一条 42px 轨道，每条用户消息一个刻度（固定 11px 间距）；轨道默认高度 550px（约 50 条），屏幕不足时撑满
• 对话视图专用：仅在对话消息流挂载时显示刻度；切到轨迹页立即隐藏，切回对话页自动恢复
• 悬停预览：相邻刻度逐级变长（30/22/16/12px 波纹），右侧浮出预览卡（序号 + 相对时间 + 消息文本）
• 点击跳转：目标已在视口时只高亮消息气泡，否则瞬时定位；普通消息居中，超高消息顶部留白；目标尚未进入右侧窗口时才逐页加载，找到后立即停止
• 独立全量索引：通过 DSH history API 在后台提取用户消息刻度，不把助手回复、工具调用和历史消息写入右侧 ChatView

— source: plugin_wiki.readme_en (fallback readme_raw)

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule