”数学“公式与“Markdown”公式输入增强
DSH 输入框支持 Markdown 样式预览和数学公式排版。原始文本保留为可编辑内容。
npm 1.0.0 页面 · npm 安装包 · GitHub 仓库
安装
在 DSH 中打开「插件管理器」，选择「添加插件」。
输入下面的包名并安装：
dsh-live-markdown-math@1.0.0
此版本支持 DSH >=0.2.1-rc.2 <0.3.0。安装不需要本地构建或单独安装依赖。
功能
Markdown
标题、粗体、斜体、删除线、引用、行内代码、代码块和列表会显示格式预览。光标进入标记时，编辑器显示对应源码。
任务列表、表格、链接和图片保留为可编辑文本。插件不把 Markdown 转成发送用 HTML，也不加载 Markdown 图片。
数学公式
支持 $…$、$$…$$、\(…\) 和 \[…\]。公式闭合且光标离开后，输入框显示排版预览。点击公式可以回到原生公式源码编辑。
数学公式渲染使用随包提供的 KaTeX。插件也会为符合结构的已发送用户消息渲染公式。
兼容范围与限制
宿主兼容
插件适配 DSH 原生编辑器，并使用宿主提供的 React。运行时检查不匹配时，插件会停止增强并保留原生输入。
插件依赖 DSH 私有编辑器接口。升级 DSH 后，请重新检查插件兼容性。
公式范围
多行公式、跨原生文本节点的公式和跨引用内容的公式保留源码，不显示公式排版。
公式长度、文档长度和公式数量有上限。超过上限时，插件保留原生输入。
Markdown 范围
插件提供编辑期样式预览，不是完整的富文本编辑器。列表、任务列表和表格不提供交互控件，链接不提供跳转行为。
维护与检查
开发环境需要 Node.js >=22。在仓库目录安装锁定的开发依赖：
npm ci --ignore-scripts
原生回归需要一个通过 test/native-runtime.mjs 摘要审查的 DSH 运行时副本。将路径赋给 DSH_NATIVE_RUNTIME 后运行检查：
DSH_NATIVE_RUNTIME='/absolute/path/to/reviewed/client.js' npm run check
如需运行独立 Chrome 检查：
DSH_NATIVE_RUNTIME='/absolute/path/to/reviewed/client.js' npm run check:browser
生成发布候选包时，命令会在系统临时目录构建，并保留仓库中的 lib/：
DSH_NATIVE_RUNTIME='/absolute/path/to/reviewed/client.js' npm run pack:release -- --browser
脚本会生成当前版本的 .tgz 文件，并检查候选包内容。源码目录禁止直接运行 npm publish。发布时请使用检查通过的归档文件。
许可证
插件使用 MIT 许可证。第三方组件的许可信息见 THIRD_PARTY_NOTICES.md。
