dsh-math-render：在 DeepSeek Harness 网页端渲染 LaTeX 公式

在 DeepSeek Harness (DSH) 的网页聊天界面中，发送包含数学公式的消息通常只能以纯文本形式显示。对于需要精确展示公式符号的开发者或用户来说，这不够直观。dsh-math-render 插件解决了这个问题，它接管了消息气泡的渲染逻辑，并支持在输入框上方提供实时的公式预览。

这是什么¶

这是一个客户端插件，用于在 DSH 网页端渲染 LaTeX 公式。它支持在消息气泡中渲染公式（如 $...$、$$...$$ 等），并在用户输入时提供草稿的实时预览。该插件由 huanglianqi 维护，采用 MIT 许可证。

安装与启用¶

执行以下命令安装插件：

dsh plugin --profile web add dsh-math-render

安装完成后，需要重启 harness（读取 bundle 列表）并刷新 GUI 页面，插件才能生效。

核心功能¶

1. 消息气泡渲染
   插件覆盖了原本的用户气泡渲染器。在消息中使用 $...$、$$...$$、\(...\) 或 \[...\] 语法，内容会以公式形式渲染在对话中。助手回复的渲染依然由 shell 的 KaTeX 流水线处理，不受此插件影响。

2. 实时预览
   当编辑器草稿中包含公式时，输入框上方会出现预览条，展示当前输入的公式效果。如果草稿中没有任何公式，该预览条不会出现。

3. 诊断路由
   插件提供了诊断路由，可用于监控插件挂载状态。

典型用法¶

1. 输入预览：在输入框中输入 $x^2$，上方会显示预览条，展示平方公式。
2. 消息展示：发送包含 $E=mc^2$ 的消息，该消息会以公式形式渲染在对话中。

行为细节¶

• 无公式渲染：消息如果没有 TeX 语法，渲染行为与官方插件一致，纯文本不受影响（如 *、#、反引号保持原意）。
• 转义机制：反引号（`）内的内容是转义出口，不会被解析为公式。
• 货币符号：单独的 $ 符号（例如紧跟在数字后或空格后）不会被误判为数学符号。
• 错误处理：语法错误的 TeX 会被 KaTeX 渲染引擎报错，错误信息与助手回复一致。
• 回退机制：如果渲染器崩溃，插件会放弃该单元格，回退到官方的气泡渲染，不会破坏对话记录。

限制与注意事项¶

1. 气泡样式限制
   气泡的几何样式（CSS）是直接复制的，无法通过插件重命名哈希类名进行自定义。颜色、字体和间距依赖 DSH 的 --dsh-* / --dsw-* 自定义属性，这些样式由 shell 控制。移除插件后，气泡会恢复到官方样式。

2. 预览模式限制
   预览是一个独立的条带，不是编辑器内的内联所见即所得（WYSIWYG）编辑。编辑器本身是 Lexical 编辑器，插件未暴露内联组件。

3. 配置互斥
   插件提供的 dsh.bundle 配置与手写的 file:// 行设置不能同时启用，两者是互斥的 Loader 源。

兼容性¶

• 引擎要求：需要 dsh >= 0.1.5-rc.1。
• 验证版本：已在 dsh 0.1.5-rc.2 上验证通过。

结语¶

dsh-math-render 为 DSH 网页端增加了基础的 LaTeX 渲染能力，通过简单的安装即可提升数学符号的展示体验。更多细节可参考 GitHub 仓库 或 社区目录。