前言¶
DSH Web 版長會話裏，已完成輪次的過程與最終總結排在一起，回看時不易掃讀。dsh-tidychat 用於整理這類 Web 會話時間線：已完成輪次自動摺疊，只保留最終總結；用實線分隔區分過程與結論；用 Codex 式左緣定位條做全局跳轉；並在頁面空閒時加載更早歷史。下面介紹它的功能、安裝方式和版本注意。
這是什麼¶
dsh-tidychat 是 BananaSoldier01 維護的 DSH 插件，MIT 許可證，當前包版本爲 0.2.5。它面向 DSH Web 會話界面，解決長會話中過程與結論混排、歷史較長時瀏覽和加載不方便的問題。插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
核心功能¶
自動摺疊已完成輪次¶
已完成輪次自動摺疊，只保留最終總結。控制條會顯示「過程 N 步」和處理時長，展開後可以查看完整過程。
過程與結論分隔¶
在思考行與正文之間插入實線分隔，區分過程與結論。
左緣定位條¶
在聊天區左緣提供 Codex 式定位條，使用 Canvas minimap 做全局映射，支持魚眼懸停放大、拖動預覽和點擊跳轉。
智能加載更早歷史¶
頁面空閒時逐步加載更早歷史，檢測到頁面響應下降時自動暫停。
一鍵報告問題¶
生成診斷報告，並打開 GitHub issue 預填頁。
獨立開關¶
上述四個核心功能各自獨立，可在設置面板可視化開關。
安裝與啓用¶
前置：已安裝 DSH（Web 版），pnpm 在 PATH 上。
先安裝 npm 包。npm 包爲預構建產物，安裝免 allowBuilds 授權：
dsh plugin --profile web add @bananasoldier01/dsh-tidychat
安裝後重啓 dsh web + 硬刷新（Cmd+Shift+R），再進入「設置 → 插件配置」展開 dsh-tidychat 卡片。功能開關改動即時生效。
如果從 GitHub 安裝，建議釘版本：
dsh plugin --profile web add git+https://github.com/BananaSoldier01/dsh-tidychat.git#v0.2.5
更新¶
npm 方式安裝後，可以直接更新插件依賴：
dsh plugin --profile web update @bananasoldier01/dsh-tidychat
更新後重啓 dsh web + 硬刷新（Cmd+Shift+R）。
典型用法¶
1、安裝後重啓 dsh web + 硬刷新（Cmd+Shift+R）。
2、在「設置 → 插件配置」展開 dsh-tidychat 卡片。
3、按會話需要開啓自動摺疊、過程與結論分隔、左緣定位條、智能加載更早歷史。
4、遇到異常時，用一鍵報告問題生成診斷報告並打開 GitHub issue 預填頁。
經過上面的步驟，就能在 DSH Web 中查看和切換這些功能。
版本兼容與注意¶
- 0.2.0 起適配 DSH ≥ 0.1.0-rc.7；插件適配 DSH ≥ 0.1.0-rc.7 ~ 0.1.1-rc.x。
- DSH ≤ 0.1.0-rc.6 請使用 0.1.0，可運行 whitelist-patch.sh 將 tidychat 加進白名單，使設置開關可寫。
- DSH ≥ 0.1.0-rc.7 不需要運行 whitelist-patch.sh。
- DSH alpha.1 暫不可直接升級，npm 未發佈；alpha.1 原生摺疊與插件 fold 功能重疊，建議二選一。
- npm 包爲預構建產物，安裝免 allowBuilds 授權；從 GitHub 安裝推薦釘版本。
- 插件 peerDependencies 要求 @deepseek-ai/dsh-settings ^0.1.0-rc.7、react ^18.2.0。
- 展開/收起狀態爲會話內內存態，刷新後恢復默認（全部摺疊）。
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
適用場景¶
適合使用 DSH Web 版處理多輪任務、需要回看結論的開發者。長會話中需要快速定位消息、瀏覽更早歷史，或需要把異常信息整理成 issue 時，也可以使用。
結尾¶
dsh-tidychat 的價值在於把已完成輪次、過程與結論、長會話定位和歷史加載拆成可獨立控制的模塊。當前版本 0.2.5，MIT 許可證。
社區目錄頁：https://www.skillhub.cn/plugins/BananaSoldier01/dsh-tidychat
GitHub：https://github.com/BananaSoldier01/dsh-tidychat
