dsh-math-snippets
DSH 网页编辑器中的 LaTeX 代码片段展开：按 Tab 键可将简短触发词展开为公式模板，并将光标置于第一个占位符处，随后依次跳转到其余占位符。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-math-snippets@1.3.1Math Snippets 以 dsh-math-snippets 发布，当前版本为 1.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
LaTeX-Suite-style snippet expansion in the DSH web composer. The trigger table is built from Obsidian LaTeX Suite's own defaults — the same triggers, the same auto/Tab split, the same tabstop numbering — so the muscle memory carries over.
$// → $\frac{}{}$ no Tab: an auto snippet expands as it is typed
$sum → $\sum_{i=1}^{n} $
$ff<Tab> → $\frac{}{}$ this plugin's short pair, on Tab or on its own
mk → $$ outside math, caret between the dollars
dm → $$⏎⏎$$ display math, caret on the empty line
$@a → $\alpha LaTeX Suite's Greek spelling, also auto
$sr → $^{2} and `_`, `cb`, `rd`, `**`, `->`, `<=`, `!=`, `oo` …
Tab then walks the tabstops, in the order LaTeX Suite numbers them: $ff<Tab>3<Tab>4<Tab>
puts the caret in the numerator, then the denominator, then after the fraction.
dsh plugin --profile <profile> add dsh-math-snippets
Restart the harness afterwards (a profile's bundle list is read at boot), then reload the GUI page.
Add a row to the profile's cordis.patch.yml:
- insert:
- id: math-snippets
name: 'file:///path/to/dsh-math-snippets/index.js'
The table is not a hand-written approximation: it is generated from LaTeX Suite's
src/default_snippets.js, keeping every entry that can be expressed as a plain string
snippet. 142 tags, 138 of them auto, 4 left on Tab.
| Same | the trigger vocabulary (//, @a, sr, cb, rd, _, **, ->, <=, >=, !=, oo, sum, lim, dint, hat, bar, vec, norm, ceil, floor, text, …), which triggers are auto and which need Tab, w word-boundary flags, and the $0,$1,$2 tabstop order |
| Same | the ${1:\infty} placeholder syntax parses (the default text is dropped — see below) |
| Different | the four LaTeX Suite deliberately keeps on Tab — par, \sum, \prod, \int — stay on Tab here too, which is the point |
| Different | dm does not prepend the newline LaTeX Suite's does. In a note you always want display math on a line of its own; in a chat composer the common case is that you are already on an empty line, and that newline would leave a blank first paragraph |
| Different | no conceal/render of formulas while typing, no auto-enlarging brackets, no backwards expansion, no regex/visual/function snippets, and ${1:x} placeholder text is not preselected: the shell publishes no selection seam, so a hole is empty instead |
On first start the host half writes an editable table to ~/.dsh/math-snippets.json
containing every built-in trigger, and serves the effective table at
/plugin/math-snippets/table. The browser half re-reads that route once a minute, so
edits take effect without a restart or a page reload.
Each entry is { "body": "...", "auto": true }:
| Field | Meaning |
|---|---|
body | what the trigger becomes. $0, $1, $2 … are holes and Tab visits them in numeric order; ${1:\infty} is accepted too. A body with no hole leaves the caret after the text. |
auto | true expands on the keystroke that completes the trigger, with no Tab. This is the default here, as it is in LaTeX Suite. |
open | true allows the trigger outside math (used by mk and dm, which are how you enter math). Everything else only fires inside $…$, $$…$$, \(…\) or \[…\]. |
word | true also requires a delimiter after the trigger, so dm inside dmx stays a word. Taken from LaTeX Suite's w flag. |
desc | free-form note for yourself; unused by the expander. |
Example — add your own:
{
"snippets": {
"capm": { "body": "$E[R_i]=R_f+\\beta_i(E[R_m]-R_f)$", "auto": true },
"npv": { "body": "\\mathrm{NPV}=\\sum_{t=0}^{n}\\frac{CF_t}{(1+r)^t}" },
"par": { "body": "\\frac{\\partial $0}{\\partial $1}", "auto": true }
}
}
A tag in the file overrides the built-in of the same name field by field, so an entry that
only restates a body keeps the built-in's open/auto/word switches — and an explicit
"auto": false turns one off. That last line is the escape hatch: if an auto trigger fires
when you were still typing a word, switch that one tag to Tab.
| Tag | Kind | Matched as |
|---|---|---|
ff, sum, alp | bare word | the whole word before the caret (xff is the token xff, not ff) |
//, @a, _, sr | literal run | the exact characters before the caret; longest table entry wins |
A tag is a bare word when it is all letters, and a literal run otherwise, so //, _, **,
->, @a and :e all work. Two carve-outs keep literal runs out of URLs, mirroring the
shell's own / rules: a slash directly after another slash does not fire (/// is dead), and
a slash pair after a scheme: colon does not either, so https:// never arms the fraction.
Four seams the shell already publishes, no DOM editing and no fork of the composer:
shell.projection, the composer's own projection product
({ detectText, clipboardText, selection, caret }). caret is an offset into
detectText — the same coordinate space the input span uses — so nothing is measured
from the DOM.actx.bail(actx, "slash/input-insert-text", { text, span }) with
actx = sessions.scope(sessionId) and span = { start, end, draftRev }. The shell
refuses a span whose draftRev no longer matches, so a stale keystroke can never
corrupt the draft.start === end.keyup, not a draft subscription: by then the character is
committed and the shell has re-projected, and it is an ordinary event rather than a
notification raised inside the editor's own update, so the insert travels the same scoped
path a Tab would have taken.par, \sum, \prod and
\int (the four LaTeX Suite keeps on Tab) expands as it is typed; Tab expands any of them
and is never needed for the rest."open": true never fires outside math, so typing
sum in a sentence does nothing. $ glued to a digit is read as a currency sign, so
costs $5 and $10 is not math. Code spans and fenced blocks are skipped whole.\, /, @ or #, so typing \operatorname cannot fire op. Only the three explicit
literal tags \sum, \prod and \int match a backslash, and they are Tab-only.par is fine (Tab-only), but a bare
word that starts with an auto trigger expands at the trigger, so integral would become
\int…egral. word: true only guards the case where a character already follows the
trigger. Fix it per tag with "auto": false, or press Cmd/Ctrl+Z — the undo step restores
the typed trigger.xff yields the token xff, not ff: a word snippet
can never fire from the middle of a word. A literal trigger still fires there, because
x// is a fraction in LaTeX Suite too.$ in a body is a hole marker. A literal cannot currently be written in a body,
and loses its default text.curl -s http://127.0.0.1:<port>/plugin/math-snippets/status # mounted + counts
curl -s http://127.0.0.1:<port>/plugin/math-snippets/table # the effective table
Loopback Host only.
npm test
62 assertions, no harness and no browser. Two layers: the keystroke paths run against a fake composer that mirrors the shell's span semantics (span replacement, caret after the insertion, collapsed inserts, stale-revision refusal), so hole placement, the tabstop walk and the auto path are asserted at the level that matters — the resulting text and where the caret ends up — and the seat itself is then rendered against a fake document and fake shell, so the dependency wiring, the composer gate, the capture listeners and their cleanup are exercised too.
Written and verified against dsh 0.1.5-rc.2 (client packages 0.1.5-rc.2, DSH Desktop
2.0.13). The projection product and the slash/input-insert-text contract were read out of
that version's sources; a newer shell may move either.
MIT
$${1:default}