前言¶
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 安装，且阅读视图功能受限。
