公式渲染 huanglianqi/dsh-math-render

dsh-math-render

一个 DeepSeek Harness（dsh）插件，可在 Web GUI 中渲染 LaTeX：

- 你自己的消息气泡 —— 你发送的消息中的 $...$、$$...$$、\(...\) 和 \[...\] 会就地渲染为公式。
- 编辑器草稿预览 —— 当草稿中包含公式时，输入框上方会有一条预览条实时渲染它。草稿中没有公式时，该预览条完全不存在。

助手回复已经通过 shell 的 KaTeX 管线渲染；本插件不会触碰它们。

安装

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

之后重启 harness（profile 的 bundle 列表在启动时读取），然后重新加载 GUI 页面。

改为从本地检出安装

dsh plugin --profile web add /path/to/dsh-math-render

机制相同：该包声明了一个 dsh.bundle 层，因此 dsh plugin add 会将其记录到 profile 中，其条目会在下次启动时挂载。

工作原理

| 席位 | 作用 | 为何选该席位 |
| conversation.chat.node，键为 user 和 steering，priority: -1 | 遮蔽内置的用户气泡渲染器。气泡保持内置形态——相同的 DOM、相同的几何布局、相同的附件、相同的复制操作。只有 TeX 片段会交给 shell 自带的 MarkdownText，即助手回复所用的渲染器 | 槽位注册表按优先级升序为每个单元格投射一个胜出者，因此 -1 优先于内置的 0。注册表自身的错误文本记录了这一路径：以不同的优先级注册即可遮蔽它（最低者渲染） |
| conversation.input.dock，id 为 math-preview，order: 5 | 编辑器上方的草稿预览条 | 该席位是一个会话作用域的列表席位，使用输入快照（包含 draft）渲染，因此无需访问任何内部服务；order: 5 使其排在 20 处的内置队列 dock 之前 |

宿主侧部分是一个包锚点加一条只读诊断路由。它不保存任何状态，启动时也不触碰任何东西。

行为

- 不含 TeX 的消息与内置气泡的渲染完全一致。 普通文本仍走 shell 的纯文本投射，因此不会被 Markdown 化：、# 和反引号保持其字面含义。
- 反引号是转义出口。 围栏代码块或行内代码片段中的 TeX 保持字面形式，\$ 也是如此。
- 货币不会被误认为数学公式。 costs $5 and $10 保持为普通文本：紧贴数字的闭合 $ 会被拒绝，两侧带空格的内容也会被拒绝。
- 错误的 TeX 不会被隐藏。 它会交给 shell 渲染器，因此语法错误会显示 KaTeX 的错误输出，与助手回复中完全一致。
- 渲染器崩溃时会回退到内置气泡。 槽位边界会隔离条目崩溃并将该条目从其单元格中撤下，因此最坏情况是“无效果”，而不是损坏的对话记录。
- 新会话主界面输入框无预览。 宿主仅为已绑定的会话渲染该位置；一旦第一条消息将你带入对话，它就会出现。

限制

- 气泡几何形状是复制的 CSS。 这些样式表是 CSS 模块，其哈希类名无法被任何树外 bundle 解析，且客户端模块表未暴露 ui-chat 组件。对壳层进行精确的重新样式化不会触及这些声明，因此气泡会保留其被复制时所依据的构建版本的几何形状。颜色、字体和间距依赖 --dsw- / --dsh-* 自定义属性，这些仍由壳层掌控。移除插件会完全恢复出厂气泡。
- 输入框预览是预览，而非内联所见即所得。 输入框是一个 Lexical 编辑器，插件接缝未暴露任何内联组件。输入 $x^2$ 会渲染在输入框上方的条带中，而非可编辑区域内。
- dsh.bundle 与手写的 file:// 行互斥。 同一包名有两个活动的 Loader 源是错误的；请以其中一种方式安装。

诊断

curl -s http://127.0.0.1:/plugin/math-render/status
{"plugin":"dsh-math-render","version":"1.0.0","mounted":true,"clientRegistered":true,"clientBundle":"…/client.js"}

仅限回环 Host。mounted 证明该行已解析；clientRegistered 证明浏览器端已进入客户端模块图。在页面控制台中，一旦浏览器端加载完成，document.querySelector('style[data-plugin-css="dsh-math-render/styles.css"]') 非空。

测试

npm install
npm test

无需测试框架、无需浏览器、无需网络。27 条断言覆盖分词器（分隔符、跨行显示数学、货币与代码段的拒绝，以及片段必须精确重建源文本的不变量）、两个位置注册所用的形状、各组件（TeX 路由到 MarkdownText，无数学内容的消息永不触及它，畸形节点降级而非抛出异常，预览的零足迹），以及——当壳层自身的插槽注册表可达时——遮蔽语义，包括让位会将单元格交还给出厂气泡。

兼容性

针对 dsh 0.1.5-rc.2（客户端包 0.1.5-rc.2，DSH Desktop 2.0.13）编写并验证。位置名称、优先级遮蔽、projectUserText / MarkdownText / writeClipboard 原语，以及 conversation.input.dock 渲染属性均从该版本的源码中读取。更新的壳层版本可能会改动其中任何一项。

许可证

MIT