DeepSeek Harness (dsh) 遵循“一切皆插件”的理念。Web GUI 的默认交互体验在处理长文本思考、工具调用过程以及流式输出时，往往显得拥挤。dsh-chat-ux 旨在解决这些问题，通过一系列 UI 优化，让聊天区的浏览与操作更加流畅。
核心功能¶
该插件包含以下主要优化项：
- 思考行与过程组自动开合：思考过程展开，结束后自动收起；工具调用过程同理。若用户手动展开或收起，插件不再自动干预。两者共用一个开关，关闭后需手动操作。
- 文件变更行直接显示：
run_code中的write和edit操作，diff 行直接显示在聊天区。对于直接调用，路径、输入大小与+n -m参数会在流式传输中显示，数字随内容实时增长。 - 动效增强：输入框光标会滑动，打字、方向键或点击均可触发。提交时，输入框会变形为气泡飞入消息列表。
- 工作步骤默认标准：网页端默认将 dsh 的“工作步骤展示”设为“标准”（原默认为“详细”），除非用户已在设置中修改。
- 统计信息可视化：输入框下方的缓存命中率胶囊显示一位小数，颜色随数值变化（90%以下为红，99%以上为深绿）。上下文占用从环状改为 16px 实心饼图，颜色同样随占用率变化。
- 输入框毛玻璃：输入框、发送按钮和加号按钮应用了蓝调渐变与模糊效果。
- 轨迹视图收起输入区：切换到“轨迹”标签页时，输入区收起，记录表铺满全屏；切回“对话”时恢复。
安装与启用¶
在 dsh Web GUI 中打开插件页，点击添加插件，输入包名：
@alm-allen/dsh-chat-ux
或者使用命令行安装：
dsh plugin --profile web add @alm-allen/dsh-chat-ux
也可以直接从 GitHub 仓库安装（仓库已包含构建产物，无需本地构建）：
dsh plugin --profile web add github:Alm-Allen/dsh-chat-ux
安装后重启 dsh 或刷新页面即可生效。
配置¶
插件安装后，在插件页的配置行可调整以下开关：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 自动开合 | 开 | 关闭后，思考行与过程组不再自动展开收起。 |
| 光标动效 | 无论何时 | 可选择关闭、移动时触发或始终触发。 |
| 聊天气泡动效 | 开 | 关闭后，提交消息时不再有起飞动画。 |
| 命中率转轮 | 开 | 关闭后，数值变化时直接替换，无弹跳动画。 |
| 上下文占用饼 | 开 | 关闭后恢复 dsh 原有的环形统计。 |
| 输入框毛玻璃 | 开 | 关闭后，输入区与按钮恢复原样。 |
| 实时改动行数 | 开 | 控制文件变更行尾数字的实时跳动效果。 |
“工作步骤展示”的默认设置位于插件页；若用户已在 dsh 的设置 → 通用中修改过，则以用户设置为准。
兼容性与注意事项¶
- DeepSeek Harness 版本：在
0.2.1-alpha.2（Web）和0.2.1-alpha.1（Desktop）上开发与验证。0.2.0-rc.2及更早版本可用，但早期版本部分功能（如命中率、上下文饼图）可能存在兼容性问题。0.1.x可能不支持。 - Node.js 版本：要求
^22.19.0 || >=24.0.0。 - 构建方式：仓库包含预构建的
dist目录，无需执行npm run build。
结语¶
dsh-chat-ux 通过精细的交互调整，提升了 Web GUI 的阅读与操作体验。如需更多细节或反馈，可访问插件目录或GitHub 仓库。
