dsh-message-rail 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线；该结论来自程序自动检查，未经人工实机验证。

dsh-message-rail 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-message-rail 还在维护吗？

GitHub 16 星。最近一次上游提交在 2026/9/4。

← 返回列表

wx-yss/dsh-message-rail

DeepSeek Harnessspec-screened扫描：低风险在 GitHub 查看 ↗

✓ 可直接安装

Codex 风格左侧消息导航轨道：等距刻度 + 悬停预览 + 点击跳转用户消息 · DSH Web 插件

自动检查通过：npm 包已发布且 engines 声明满足基线；该结论来自程序自动检查，未经人工实机验证。 · 最近上游提交 2026/9/4 · 已提供中文文档

综合分

GitHub 分

用户评分

—

★ Stars

周下载量

—

安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）

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

npm 包 dsh-message-rail 已校验归属本仓库，走 npm 安装最省事

信任档位：已验证本站已于 4 天前真实安装成功（L4 · 真实安装）

是什么: dsh 原生插件 · tool
装得上吗: 本站已真实安装成功（L4 · 真实安装，非静态推断）
安全吗: 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
还在维护吗: 活跃：最近一次提交在 21 天前

档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。验证判据与等级说明 →

🟢实装验证通过· 2026/9/21

由本站实装验证器在真实 dsh 环境安装成功，非静态推断。

数据截至 2026/9/21（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）

安装兼容性检查✓ 自动检查通过

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-message-rail @ 0.1.7

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/21 20:14:53

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-client-connection@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-client-ui-conversation@deepseek-ai/dsh-client-ui-layout

用户评分

还没有人投票，来当第一个

订阅周报，不错过优质插件更新

每周一封 · 高评分插件 + 新用户活动

装之前先看这里

ℹ️ 暂无已知风险记录。注意：dsh 与插件都处于 developer-preview 阶段，装任何插件前建议先备份 ~/.dsh 配置，出问题好回滚。

装完遇到问题了？反馈一下（可选填报错关键词）：

安全扫描自动 · 静态分析源码

v2.7.0

🟢 扫描：低风险尚无人工评估

静态扫描未发现命令执行或本地文件写入，最多只发网络请求、读取自身元数据或只读文件（不修改）。

扫描于 2026/9/25（0 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

DeepSeek Harness Hub

wx-yss/dsh-message-rail

Codex 风格左侧消息导航轨道：等距刻度 + 悬停预览 + 点击跳转用户消息 · DSH Web 插件

https://dpharness.com/plugin/wx-yss/dsh-message-rail

粘贴到微信 / 小红书 / 微博等，链接会自动带上本站预览图。

广告WorkBuddy 天津胜凌

WorkBuddy 官方合作伙伴 · 天津胜凌

有意合作请致电 185 2226 8817 —— 代理合作或直接购买。

致电联络→

广告WorkBuddy 海外版

WorkBuddy 海外版 · 注册立得 350 积分

通过邀请链接注册即得 350 积分（100 邀请积分 + 250 新人积分），可用于平台内 AI 能力调用。

领取 350 积分→

README

由 DeepSeek 最新模型翻译生成

dsh-message-rail

npm version
npm downloads
Awesome DSH Plugin
License: MIT

Codex 风格左侧消息导航轨道 —— 在 DeepSeek Harness Web UI 的长会话里快速定位历史提问。

Left-side message navigation rail for the DeepSeek Harness Web UI: jump to any past user message in long sessions, Codex-style.

交互灵感来自 Codex 的消息导航栏（inspired by Codex's message rail）。本插件与 OpenAI 无关联。

效果预览

会话左侧的消息导航轨道（悬停刻度显示预览卡，点击跳转到对应消息）：

轨道悬停预览

功能

- 等距刻度轨道：会话左侧一条 42px 轨道，每条用户消息一个刻度（固定 10px 间距）；轨道默认高度 500px（约 50 条），屏幕不足时撑满
- 对话视图专用：仅在对话消息流挂载时显示刻度；切到轨迹页立即隐藏，切回对话页自动恢复
- 悬停预览：从默认刻度到悬停中心按 Codex 的五级宽度展开（6/10/14/20/26px），右侧浮出预览卡（序号 + 相对时间 + 消息文本）
- 点击跳转：目标已在视口时只高亮消息气泡，否则瞬时定位；普通消息居中，超高消息顶部留白；目标尚未进入右侧窗口时才逐页加载，找到后立即停止
- 独立全量索引：通过 DSH history API 在后台提取用户消息刻度，不把助手回复、工具调用和历史消息写入右侧 ChatView
- 轨道虚拟滚动：无论索引多少刻度，都只渲染最多 50 条的可见窗口 ±12 条缓冲；首尾还有更多刻度时以 40px 渐隐提示
- 稳定切换：索引期间先显示右侧已经加载的刻度，不发布中间分页；完整索引完成后一次性切换，避免刻度持续重排闪动
- 按需分页：点击未加载刻度时保护右侧当前阅读锚点，逐页寻找目标；后一次点击可取代前一次跳转，并立即清除旧消息高亮
- 加载反馈：根据刻度所在 history 分页预估剩余页数；预计超过 1 秒时立即提示，预估较快但实际超时则在 1 秒后补充提示，目标组件就绪后关闭
- 当前位置：视口 40% 线最近的消息刻度深色高亮，滚动即知读到哪
- 智能滚动：轨道钉在最新刻度，手动滚动后停止跟随；隐藏滚动条、滚轮可用
- 细节：少于 2 条用户消息自动隐藏；明暗主题自适应；prefers-reduced-motion 降级；键盘可悬停（focus 等价 hover）

兼容性

- DeepSeek Harness >=0.1.0-rc.7；manifest 已对官方最新三个发行版逐项声明兼容
- Node.js >=22.13.0
- 系统：macOS、Linux、Windows
- Profile：web
- 浏览器：Chrome / Edge / Safari / Firefox 最新版

安装

插件通过 DeepSeek Harness 的 dsh 命令安装。下面每个命令都给出两种等价写法：

- dsh 形式：适用于已全局安装 dsh（npm install -g @deepseek-ai/dsh）
- npx 形式：无需安装 dsh，临时调用，效果相同——推荐（dsh 尚在快速迭代，全局安装非必需）

从 npm 安装（推荐，免构建授权）

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

npx 形式（无需安装 dsh）
npx @deepseek-ai/dsh plugin --profile web add dsh-message-rail

从 GitHub 安装

dsh 形式
dsh plugin --profile web add github:wx-yss/dsh-message-rail

npx 形式
npx @deepseek-ai/dsh plugin --profile web add github:wx-yss/dsh-message-rail

本地开发安装

git clone git@github.com:wx-yss/dsh-message-rail.git
cd dsh-message-rail
pnpm install
npx @deepseek-ai/dsh plugin --profile web add .

重启

安装后完整重启 dsh web：

dsh 形式
dsh web

npx 形式
npx @deepseek-ai/dsh web

使用

打开包含至少两条用户消息的会话，左侧即出现导航轨道：

- 悬停刻度 → 波纹展开 + 预览卡（序号 / 时间 / 文本）
- 点击刻度 → 跳转到对应消息
- 滚轮在轨道上滚动 → 浏览更早/更晚的刻度
- 滚动会话 → 当前位置刻度高亮

已知限制

- 后台索引通过独立 history API 每页读取 50 个表层消息边界；响应仍可能携带所属的 chunk、工具事件等原始记录，但不会进入右侧聊天状态或 DOM
- 索引页数上限为 400（约 2 万个表层消息）；超过上限时保留右侧当前已加载刻度，不展示不完整的全量索引
- 点击非常早的刻度时，DSH 的 loadOlder() 仍会把中间页面逐步加入右侧且不会自动卸载；这属于 DSH 聊天列表当前的累积渲染限制
- 剩余时间只估算历史分页和目标组件准备，不包含后续目标定位；当前按固定准备约 0.2 秒、每页约 0.45 秒校准，属于体验预估而非完成时间承诺
- 轨道索引用户消息（kind === 'user' 普通提问 与 kind === 'steering' 运行中插话），不包含助手回复、工具调用、命令与注入上下文（kind === 'context'）
- 轨道配色跟随 DSH 运行时主题（--dsw-* 设计令牌），不支持独立于 DSH 的配色偏好
- 轨道刻度为虚拟窗口渲染，键盘 Tab 可达（focus 等价悬停）；DOM 锚点（data-chat-anchor-key / data-conversation-scroll / data-chat-flow / data-time-hover-root / data-slot="conversation.view"）为 DSH 内部契约，随 DSH 版本可能变化

文件结构

├── package.json         # dsh.client（Web 插件）+ dsh.bundle（profile patch）声明
├── cordis.patch.yml     # bundle patch：插入插件行
├── lib/
│   ├── index.js         # Host 半部：空 apply 占位
│   └── client.js        # Client 半部：独立索引 + 轨道 UI + 按需分页跳转
├── assets/              # README 效果截图
├── LICENSE              # MIT
└── README.md

实现要点

- 挂载：shell.overlay 声明会话级子 seat message-rail.rail（SessionProvider 桥接，每会话一个实例）
- 数据：当前窗口读取 useSession 的 chat.order + chat.nodes；完整刻度通过 connection.api.sessions.history()（子 Agent 使用 subagents.history()）独立建立
- 索引：直接保留 surfaceOp === 'append' 且 source.kind === 'user' 的 user/message 记录及其 messageId、seq、时间和预览文本；中间分页不进入 React 状态
- 跳转加载：按 messageId 判断目标是否已进入右侧；未加载时才调用 session.loadOlder()，每页保护可见消息锚点并在命中目标后停止
- 进度：索引记录每条用户消息距最新页的 historyPage；结合右侧已加载深度估算剩余页数，预计超过一秒时立即显示，否则实际等待超过一秒再提示；目标组件就绪后立即关闭，下一帧再定位
- 跳转：[data-conversation-scroll] + [data-chat-anchor-key] DOM 锚点；目标已可见时只描边闪烁，否则直接写入 scrollTop 瞬时定位，并在两帧内按最新容器几何有界校正
- 虚拟窗口：floor(scrollTop / 10) - 12 到 ceil((scrollTop + 高度) / 10) + 12，绝对定位刻度

License

MIT