dsh-latex
在 DeepSeek Harness 聊天视图中渲染 LaTeX 数学公式，并让模型使用 $...$ / $$...$$ 而不是围栏代码块。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:sbVAN/dsh-latex#eb9794d4c9f118e7ed00704e0993dead1b813904Latex 以 dsh-latex 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Make the DeepSeek Harness chat render formulae as formulae, and make the model write LaTeX by default instead of wrapping math in latex fences.
DSH's frontend already renders TeX through KaTeX (MarkdownText in @deepseek-ai/dsh-client-ui-primitives), but:
| Symptom | Cause | What this plugin does |
|---|---|---|
| Formulae show up as a grey code block | The model writes them in ```latex / ```tex fences, which the frontend never renders (only $...$, $$...$$, \(...\), \[...\] and ```math are supported) | The host half states the output contract in the system prompt; the browser half renders legacy latex/tex fences in place |
During streaming the answer shows raw $ and \frac | The frontend deliberately keeps TeX literal while streaming and swaps in KaTeX once the message settles | Left alone (upstream design); renders correctly after settling |
| A few formulae turn into harsh red text | KaTeX strict mode: align, \si{}, \ce{} are outside the supported subset | Forbidden by the prompt; the browser half turns the red error into a readable badge |
| Wide display math overflows the bubble | KaTeX display blocks do not scroll by default | The browser half adds horizontal scrolling and padding |
dsh plugin --profile desktop add github:sbVAN/dsh-latex
Restart DeepSeek Harness afterwards, then reload the page once (the browser half needs to load the new bundle).
# 1. register a link dependency in the profile package.json:
# "dsh-latex": "link:Z:/文件留存/deepseek project/dsh-latex"
# 2. create the junction (the equivalent of pnpm's link:)
New-Item -ItemType Junction `
-Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-latex" `
-Target "Z:\文件留存\deepseek project\dsh-latex"
# 3. append to the profile's cordis.patch.yml:
# - insert:
# - id: latex
# name: dsh-latex
# 4. restart DeepSeek Harness (the host half needs the new composition)
After that the browser half can hot-reload through HMR when hmr.root covers the plugin sources.
- insert:
- id: latex
name: dsh-latex
config:
strict: true
compact: false
locale: zh
extraRules:
- Write water as $\mathrm{H_2O}$, never \ce{}.
| Key | Default | Meaning |
|---|---|---|
enabled | true | Disables the prompt section entirely (the browser half still runs) |
locale | auto | zh / en / auto (auto follows DSH_LOCALE, LANG, defaulting to Chinese) |
strict | true | true forbids fenced formulae; false only recommends |
compact | false | Shorter prompt, roughly 1/3 of the tokens |
order | 145 | Section order inside the system prompt (tool guidance owns 100–199) |
extraRules | [] | Extra bullet lines appended to the contract |
lib/index.js)Registers ctx.systemPrompt.section({ name: 'dsh-latex:math-output', order, text }) with a contract covering inline $...$, display $$...$$, a ban on fenced formulae, the KaTeX-supported subset (aligned over align, pmatrix/bmatrix/cases, \mathrm{} over \si{}/\pu{}/\ce{}, no \label/\tag), CJK only inside \text{}, and splitting long derivations.
The section is disposed with the plugin fiber, so hot reload cannot leave duplicates. The rendered contract is written to $DSH_HOME/cache/dsh-latex/prompt.txt, mount diagnostics to mounted.json.
lib/client.js)pre > code.language-latex|tex gets a preview below it, rendered with the shared MarkdownText (no bundled KaTeX), source folded by default;latex / tex fences are handled — math fences are already rendered upstream.\ce{} / \pu{} still fail; the prompt routes them to \mathrm{}.conversation.chat.node takeover — replacing the assistant renderer means duplicating the whole message structure and breaks on upstream upgrades.Remove the junction, drop the insert line from cordis.patch.yml, restore the profile package.json, restart. No DSH file is modified.
MIT