前言¶

DSH 强调“一切皆插件”，社区目录是独立站点，不是官方应用商店。在 dsh web 中浏览一段较长对话时，如果只靠滚动回看，定位某一轮的 prompt 和 response 会比较低效。

dsh-ui-outline 是一个用于 dsh web 的轮次导航插件。它给对话侧增加一条 navigation rail，支持按轮次浏览、点击吸附、拖动 scrub，以及预览每轮 prompt 和 response。下面介绍它的功能、安装方式和典型用法。

这是什么¶

dsh-ui-outline 由 iluluyu 维护，许可证为 MIT。package.json 当前版本为 0.0.2，适用于 dsh.client.platform is web 的场景。

它按官方 TurnNavigator 设计语言实现 dsh web 轮次导航 rail，并提供大纲、刻度和毛玻璃预览相关能力。

核心功能¶

下面列出的能力都来自已核实的插件说明。

• dsh web 轮次导航 rail
• 官方 TurnNavigator 设计语言
• 可配置 Side：Right / Left
• 可配置 Preview material：None / Frosted / Liquid glass
• 可配置 Mark layout：Compact / Loose
• 点击会吸附到最近的可见 turn
• 支持 drag to scrub 浏览整段对话
• 每轮 preview card 显示该轮 prompt 和 response
• 设置持久化在 host settings document，不使用 localStorage
• 预览卡片为纯 CSS 实现
• 支持 zh / en 双语，并跟随 app locale
• 动画仅使用 compositor-only 属性，并尊重 reduced motion

其中三项常见配置如下：

1. Side：选择 rail 在右侧或左侧，可选 Right 或 Left。
2. Preview material：选择预览卡片材质，可选 None、Frosted 或 Liquid glass。
3. Mark layout：选择刻度布局，可选 Compact 或 Loose。

安装与启用¶

先确认环境满足版本要求：需要 dsh ≥ 0.1.0-rc.7，并要求 keyed plugin-settings slot + open settings namespaces。

下面介绍三种安装方式。

从 npm 安装：

dsh plugin --profile web add dsh-ui-outline

从 GitHub 安装：

dsh plugin --profile web add github:iluluyu/dsh-ui-outline

固定到 v0.0.2：

dsh plugin --profile web add github:iluluyu/dsh-ui-outline#v0.0.2

安装完成后，重启 dsh web 并重新加载页面以启用插件：

dsh web

之后在浏览器中刷新页面。

更新和移除插件：

dsh plugin --profile web update dsh-ui-outline

dsh plugin --profile web remove dsh-ui-outline

典型用法¶

经过上面的步骤启用后，可以先在 dsh web 页面里找到 rail，再完成下面几类操作。

1. 点击 rail。点击会吸附到最近的可见 turn。
2. 拖动 rail。支持 drag to scrub，用于浏览整段对话。
3. 查看预览。每轮 preview card 显示该轮 prompt 和 response。
4. 切换语言。界面支持 zh / en，并跟随 app locale。
5. 调整 rail 配置。可配置 Side、Preview material 和 Mark layout。
6. 保存设置。设置持久化在 host settings document，不使用 localStorage。

设置命名空间为 outline。如果需要手动覆盖，在 ~/.dsh/settings.yaml 中可使用这样的示例：

outline: { side: left, material: frost, layout: loose }

适用场景与注意¶

这个插件适合在 dsh web 中需要快速浏览长对话、定位某轮 prompt 和 response 的用户。它也能用于按照 Right / Left、None / Frosted / Liquid glass、Compact / Loose 调整 rail 的视觉和交互布局。

注意以下事项：

• 插件以当前 dsh 进程权限运行。安装前应检查源码和许可证。
• 要求 dsh ≥ 0.1.0-rc.7，并具备 keyed plugin-settings slot + open settings namespaces。
• package.json 版本为 0.0.2。
• 许可证为 MIT，版权为 iluluyu。
• peerDependencies 为 @deepseek-ai/cordis >=1.0.0 和 react >=18.0.0。
• dependency 为 @deepseek-ai/schemastery ^3.18.1。
• 包内不捆绑第三方代码，无 transitive license obligations。
• 设置保存在 host settings document，不使用 localStorage。
• 目录页可查阅：https://www.skillhub.cn/plugins/iluluyu/dsh-ui-outline。该目录页是社区目录页，不是官方应用商店。
• GitHub 仓库：https://github.com/iluluyu/dsh-ui-outline。

结尾¶

dsh-ui-outline 的价值很具体：在 dsh web 中提供一条可配置的轮次导航 rail，支持点击吸附、drag to scrub、preview card 显示 prompt 和 response，并把设置持久化在 host settings document 中。经过上面的安装、重启和页面重载，就可以用于日常对话浏览和轮次定位。