dsh-tool-highlight：给 bash / pwsh 与 read 输出做分层语法染色

前言¶

在使用 DeepSeek Harness（DSH）进行开发时，开发者常通过 bash、pwsh 运行脚本，或使用 read 读取代码文件。这些工具的原始输出通常是纯文本，关键字、字符串、注释混在一起，视觉上难以快速定位。dsh-tool-highlight 插件解决了这个问题，它在 Web 界面中为这些特定工具的输出添加分层语法染色，模仿 VS Code Dark+ 风格，帮助快速识别代码结构。

核心功能¶

该插件主要针对 bash、pwsh 命令与 read 的输出做处理，具备以下能力：

1. 分层语法染色：使用 VS Code Dark+ 风格配色，区分关键字、字符串、数字、函数名和注释。
2. 智能识别：
   • read：按文件扩展名识别语言（支持 .py、.js、.ts、.json、.ps1、.sh 等）。
   • bash / pwsh：按内容启发式识别。若输出像 JSON 则按 JSON 分色，若像代码则按语法分色。对于无法识别的表格或日志，保持原样不上色，避免视觉干扰。
3. 零 Token 开销：纯前端渲染，不调用模型，不新增或改写会话内容，仅对已有文本进行视觉处理。
4. 状态与折叠：附带退出码状态条（绿色表示成功，红色表示非零退出或信号）。默认折叠工具卡片（可开关），运行中或出错时自动展开。

安装与启用¶

通过 DSH 官方命令行工具安装，安装后需重启 dsh web 并硬刷新页面（Ctrl+Shift+R）。

dsh plugin --profile web add dsh-tool-highlight

配置¶

插件支持通过用户设置或 YAML 配置文件进行控制。

配置项说明：

配置方式：

1. 在 DSH 界面中：进入 设置 → 插件配置 → 工具卡片折叠。
2. 在配置文件中（cordis.yml 或 settings.yaml）：

tool-highlight:
  collapseByDefault: true

工作原理与依赖¶

• 渲染逻辑：插件挂载在 DSH 的 tool.call.toolview 槽位上，根据工具名注册渲染器。使用自研轻量正则进行分词染色，配色方案固定为 VS Code Dark+，并跟随 DSH 主题 Token。
• 依赖：依赖 @deepseek-ai/schemastery。
• 互斥与共存：该插件只接管 read、bash、pwsh 三个工具卡片（优先级 -2）。若安装了 dsh-better-tool-ui，两者互不冲突，各自负责不同的工具。

注意事项¶

• 非模型类插件：该插件不调用任何模型，不消耗 Token。
• 内容识别：遵循“认得出来才染”的原则。表格、日志等非结构化内容保持原样，不会强制上色。
• 版本兼容：依赖 @deepseek-ai/schemastery (>=0.1.0-rc.1)。

链接¶

• GitHub: https://github.com/vollegrewar/dsh-tool-highlight
• 社区目录: https://www.skillhub.cn/plugins/vollegrewar/dsh-tool-highlight