Skip to content

zhangzheng25/dsh-timeline

40Last commit Aug 15, 2026

dsh-timeline DSH plugin

dsh-timeline adds a vertical timeline to the right side of DSH conversation pages. Every user question is represented by a dot; clicking a dot scrolls smoothly to that question, and hovering shows a preview with the question number, time, first 80 characters, and a 3-line AI reply summary. It works with zero configuration, using session snapshots from the browser, and adapts to light/dark themes automatically.

How to install the dsh-timeline DSH plugin

dsh plugin --profile web add github:zhangzheng25/dsh-timeline

Copying does not run this command. Review the repository and version before installing the dsh-timeline DSH plugin.

dsh-timeline DSH plugin data source

dsh-timeline DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-timeline DSH plugin can do

  • Each user question gets a distinct dot on the right rail
  • Click a dot to instantly scroll to the corresponding question-answer block
  • Hover over a dot to see a preview (question index, time, first 80 characters, and 3-line AI reply summary)
  • Automatic highlight: the dot corresponding to the currently visible question-answer block turns blue
  • Supports conversations of any length: at most 15 dots shown at once, older ones scrollable inside the rail
  • Follows scroll: the highlighted dot stays in view as you scroll
  • Zero footprint on host: the server-side component is an empty apply, no database queries
  • No i18n burden: UI text is in Chinese only, keeping the plugin lightweight

Where the dsh-timeline DSH plugin fits

  • Quickly navigate through long conversations with many questions
  • Locate a specific question you asked earlier without manual scrolling
  • Get an overview of the conversation flow and your previous queries
  • Review the AI's responses to selected questions via hover preview
  • Use in light or dark mode without any manual adjustment

Who the dsh-timeline DSH plugin is for

  • DSH users who frequently engage in long conversations
  • Users who want a visual timeline to improve navigation efficiency
  • Developers or power users who need to quickly reference past questions
  • Anyone using DSH in a browser and seeking a lightweight timeline

dsh-timeline DSH plugin limitations

  • UI text is only in Chinese; no i18n support
  • At most 15 dots are displayed simultaneously; older dots are accessible via internal scrolling
  • Relies on DSH's browser environment and session snapshots; not usable outside DSH
  • No customization options for colors, dot size, or preview length

dsh-timeline DSH plugin: from the repository README

Quoted from the zhangzheng25/dsh-timeline README, the upstream source of the dsh-timeline DSH plugin. Copyright remains with the original authors.

零配置、无 host 依赖、不查数据库——数据全部来自浏览器里已有的会话快照。 ## 功能 - 🎯 **每条提问一个圆点** —— 所有用户提问在右侧细条上各有一个圆点 - 🔵 **安静默认** —— 圆点平时是灰色,高亮(悬停或正在阅读的段落)变蓝。状态全靠颜色表达,圆点永不放大,任何情况下都不会被裁剪 - 🌓 **深浅主题自适应** —— 圆点与预览气泡全部使用 DSH 设计令牌(`--dsw-alias-*` / `--dsw-static-*`),跟随浅色 / 深色 / 跟随系统切换,无需重启 - 📍 **分段高亮** —— 滚动对话时,视口底部所在的"提问+回答"段落对应的圆点亮蓝;位于对话底部时默认高亮最新一条 - 📜 **全历史覆盖** —— 长会话自动分页加载(`loadOlder`),直到整条对话的每个提问都有圆点,不只显示最近一页 - 📏 **任意长度都清爽** —— 同时最多显示 **15 个圆点**,更早的在内侧滚动查看(滚动条隐藏),圆点保持等距、不挤压变形 - 🖱 **跟随滚动** —— 滚出可见圆点后,圆点列自动跟随,高亮圆点始终在视野内 - ⚡ **点击跳转** —— 平滑滚动到对应消息,长对话不用再手动翻几百行 - 👁 **悬停预览** —— 显示提问序号、提问时间、前 80 字提问内容,以及 3 行 AI 回复摘要 - 🕐 **绝对时间** —— 今天的提问显示 `HH:MM`,昨天及更早显示 `MM/DD HH:MM` - 🧹 **无滚动条** —— 对话页的垂直滚动条一并隐藏,位置由高亮圆点指示 - 🖱 **点击穿透** —— 时间条本身不挡对话,只有圆点响应点击 - 📦 **零足迹 host** —— node 半端是空 `apply`,服务端零开销 - 🔤 **无 i18n 负担** —— 文案仅中文,保持精简 ## 安装 ```sh dsh plugin --profile web add github:zhangzheng25/dsh-timeline ``` 重启 DSH,打开任意有提问的会话,右侧即出现时间线。 本地开发安装: ```sh dsh plugin --profile web add link:E:/path/to/dsh-timeline # link: 协议 → junction 链接,改代码 pnpm build 后刷新页面即生效 ``` > ⚠️ 必须用 `link:` 协议:`file:` 协议在 profile 的 hoisted 模式下是**复制**目录,改代码不会生效。用 `link:` 后 `node_modules/dsh-timeline` 是指向本目录的 junction,构建产物直接可见,无需同步、无需重启。 ## 原理

Read the full READMEThe repository declares no license. Check with the authors before using it.

dsh-timeline DSH plugin questions

How do I install dsh-timeline?

Run the command `dsh plugin --profile web add github:zhangzheng25/dsh-timeline` in your terminal. After installation, restart DSH and open any conversation with questions. The timeline will appear on the right side. If you want to develop locally, use `dsh plugin --profile web add link:E:/path/to/dsh-timeline` to create a junction link.

How do I uninstall dsh-timeline?

Use the command `dsh plugin --profile web remove dsh-timeline` to remove the plugin. Then restart DSH to fully clear the timeline from the UI. If you used a local link install, you may also need to delete the symlink manually.

Why are only 15 dots shown at once?

The plugin limits the visible dots to 15 to keep the timeline clean and prevent overcrowding. Older dots are still accessible by scrolling inside the timeline rail (the scrollbar is hidden). This design ensures the dots remain evenly spaced and readable even in very long conversations.

Can I customize the color or size of the dots?

No, the plugin does not provide any customization options. The dot colors follow DSH design tokens (`--dsw-alias-*` / `--dsw-static-*`) and adapt automatically to light/dark themes. The dot size is fixed and never scales. This is intentional to keep the plugin lightweight and consistent with the DSH UI.

Does the plugin work with the mobile version of DSH?

The plugin is designed for the web profile of DSH in a desktop browser. It relies on the `shell.overlay` slot and `useSession` hooks, which are part of the DSH browser client. There is no mention of mobile support in the README, so it likely does not work on mobile devices or in non-browser environments.