前言¶
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
