前言¶
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
其中三项常见配置如下：
Side：选择 rail 在右侧或左侧，可选Right或Left。Preview material：选择预览卡片材质，可选None、Frosted或Liquid glass。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，再完成下面几类操作。
- 点击 rail。点击会吸附到最近的可见
turn。 - 拖动 rail。支持
drag to scrub，用于浏览整段对话。 - 查看预览。每轮
preview card显示该轮prompt和response。 - 切换语言。界面支持
zh/en，并跟随 app locale。 - 调整 rail 配置。可配置
Side、Preview material和Mark layout。 - 保存设置。设置持久化在 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 中。经过上面的安装、重启和页面重载，就可以用于日常对话浏览和轮次定位。
