前言¶
DeepSeek Harness (DSH) Desktop 的 Web 模式在运行长时间任务时，原生终端输出往往缺乏实时性反馈，且界面样式定制能力较弱。dsh-better-uiux 插件为 DSH 提供了两个核心 UI 增强：实时流式终端输出和自定义 CSS 注入。这两个功能被整合在同一个设置区块中，通过开关控制，旨在解决开发者调试过程中的可视化和定制化需求。
插件定位¶
这是一个为 DSH Desktop 提供的 UI 增强（UIUX）插件，由 nguyenduclong-ict 维护。它将功能模块化地集成在 Settings -> Better UIUX 中，主要包含以下两个独立组件：
* Live terminal output: 实时流式终端输出。
* Custom CSS: 自定义 CSS 注入。
核心功能¶
1. 实时终端输出¶
开启此开关后，前台命令的输出和后台任务（Job）的输出都会被实时流式传输到日志记录中。
* 交互元素: 输出块带有脉冲式头部圆点。每个输出条目旁提供了 Copy（复制）、Stop（停止）和 View Job（查看任务）按钮。
* 输出弹窗: 支持通过弹窗查看详细的流式输出内容。
2. 自定义 CSS 注入¶
在设置中编辑 CSS 代码，样式会实时生效。此功能允许用户对 DSH 的 Web 界面进行深度定制，无需修改插件源码。
3. 开关控制机制¶
两个功能均由独立的开关控制。
* 运行时行为: 当功能关闭时，其对应的路由会返回 enabled:false，且不再拦截子进程或任务。
* 自动清理: 关闭 Live terminal 后，插件会移除所有注入的节点，以避免与 DSH 原生实时输出的未来版本冲突。
安装与启用¶
安装此插件需使用 DSH CLI 命令。
dsh plugin --profile web add https://github.com/nguyenduclong-ict/dsh-better-uiux
执行命令后，请重启 DSH Desktop 或重新加载 Web 配置文件，插件即可生效。
典型用法¶
- 进入 DSH Desktop 的 Settings 菜单。
- 找到 Better UIUX 区域。
- 打开 Live terminal output 开关，即可在日志流中看到前台和后台任务的实时输出，并使用弹窗或按钮进行交互。
- 在 Custom CSS 编辑框中输入 CSS 代码，保存后界面样式会即时更新。
注意事项¶
- 插件冲突: 请勿同时运行独立的
dsh-plugin-live-terminal插件。两者使用相同的样式 ID (dsh-live-*) 和模态框结构，会相互覆盖节点。 - 功能状态: 当前版本中，“编辑消息”功能已实现代码但处于隐藏和禁用状态，设置界面中不显示该开关。
- 性能开销: 即使关闭 Live terminal 开关，后台仍会保持 1Hz 的轮询（仅执行无操作调用）以检测状态变化。
- 卸载: 若需卸载，使用
dsh plugin --profile web remove dsh-better-uiux。配置数据存储在本地，卸载后需手动清理<harness>/plugins/dsh-better-uiux/config.json及浏览器中的localStorage(dsh_better_uiux_config_v2)。
总结¶
dsh-better-uiux 通过简单的开关机制解决了 DSH 在实时监控和样式定制上的短板，适合需要精细调试或定制界面样式的开发者。该插件无运行时依赖，安装后直接可用。
- GitHub: https://github.com/nguyenduclong-ict/dsh-better-uiux
- 目录页: https://www.skillhub.cn/plugins/nguyenduclong-ict/dsh-better-uiux
