前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在處理長會話時，開發者常面臨兩個痛點：一是需要像閱讀文檔一樣掃讀上下文，二是需要快速定位歷史對話節點。

現有的 dsh-better-display 和 dsh-tidychat 雖然分別解決了閱讀和導航問題，但兩者存在衝突：閱讀視圖丟失了宿主行級錨點，導致依賴錨點的消息軌靜默失效；而消息軌的 DOM 手術又與宿主 0.1.2+ 的原生摺疊功能重疊。

dsh-tidy-display 由 drscrewdriver 維護，將這兩個插件合併。它解決了長會話可掃讀、可定位、可續聊的需求，支持原生「對話」與「閱讀」雙視圖。

核心功能¶

該插件主要分爲閱讀視圖和消息軌兩個部分。

閱讀視圖¶

閱讀視圖將執行過程收攏爲可展開的摘要，最終回答以消息氣泡呈現，思考卡採用同款半透明襯底，支持流式思考。

• 流式思考與摺疊：思考過程可跟隨滾動、可暫停、可展開全文。
• 視覺優化：最終回答採用半透明氣泡底，思考卡採用同款半透明襯底，透出皮膚壁紙。
• 官方橋接：工具視圖、反饋、產物卡片等經官方槽位渲染，保證兼容性。

消息軌¶

消息軌在會話區邊緣提供 canvas 導航軌，支持魚眼懸停、摘要卡、點擊跳轉等功能。

• 交互：支持魚眼懸停、摘要卡、點擊跳轉、滾動時當前輪高亮。
• 樣式與位置：支持橫線 / 圓點樣式，左緣 / 右緣（鏡像）位置。
• 視覺增強：白色柔光外圈，標記當前輪與懸停輪，複雜壁紙上也清晰。
• 配色：支持自動（跟隨主題）或自定義（取色器 + HEX/RGB 文本 + 透明度滑桿）。
• 雙視圖可用：原生「對話」視圖與「閱讀」視圖均可使用。

安裝與啓用¶

依賴檢查¶

安裝前請確認已卸載或禁用以下插件，否則會因重複註冊 reader 視圖而失敗：
* dsh-better-display
* dsh-tidychat

安裝命令¶

使用官方 Web CLI 安裝：

dsh plugin --profile web add dsh-tidy-display

舊宿主安裝¶

如果宿主版本較舊（0.1.1 / 0.1.2 / 0.1.5），需指定 tag 安裝：

# 0.1.5 線
dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.1.0-dsh0.1.5

# 0.1.2 線
dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.1.0-dsh0.1.2

# 0.1.1 線
dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.1.0-dsh0.1.1

安裝後請重啓宿主進程。

注意事項¶

• 版本範圍：本插件支持 DSH 0.1.0–0.2.0 版本。DSH 0.1.0-rc.6 及更早版本不在支持範圍。
• 配置存儲：配置持久化在 dsh.reader.v1。
• 舊宿主兼容：舊宿主（0.1.1/0.1.2/0.1.5）需使用特定 tag 安裝，且閱讀視圖功能受限。