前言¶
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 中。經過上面的安裝、重啓和頁面重載，就可以用於日常對話瀏覽和輪次定位。
