[BUG] markdown 渲染：单个 ~ 被当删除线，gfm() 未传 singleTilde:false 违反 GFM 规范

[wangzy50]

现象

助手消息里单个 ~ 被当作删除线渲染，违反 GFM 规范——GFM 要求 ~~ 双波浪号才是 strikethrough。

例如 哈~哈~啊 渲染成 哈哈啊（单 ~ 也划线），而 GFM 规范下应保留为字面 ~。

根因

packages/client/ui-primitives/src/markdown/parse.ts 中 parseGfm 和 parseGfmWithMath 调用 gfm() 未传 singleTilde: false：

// packages/client/ui-primitives/src/markdown/parse.ts
export function parseGfm(text: string): Root {
  return fromMarkdown(text, {
    extensions: [gfm(), cjkFriendlyStrong()],          // ← gfm() 无参
    mdastExtensions: [gfmFromMarkdown()],
  })
}

export function parseGfmWithMath(text: string): Root {
  return fromMarkdown(text, {
    extensions: [gfm(), cjkFriendlyStrong(), mathCompatibility(), math()],  // ← 同上
    mdastExtensions: [gfmFromMarkdown(), mathFromMarkdown()],
  })
}

micromark-extension-gfm 的 strikethrough 扩展默认 singleTilde: true（单 ~ 即触发删除线），这是上游默认值，但不符合 GFM 规范（GFM spec 要求 ~~）。

影响范围

三处复用这两个 parser，均受影响：

1. 流式渲染（parseGfm）
2. 定稿渲染（parseGfmWithMath）
3. 纯文本投影（plain-text.ts 第 9、111 行 import 并复用 parseGfm）

受影响版本

• npm @deepseek-ai/dsh 0.1.1-rc.2（已确认）
• master 分支 cd5ef81（2026-08-27）仍存在——仓库内 singleTilde 零命中，从未传过该选项

建议修复

源码 packages/client/ui-primitives/src/markdown/parse.ts 两处：

-    extensions: [gfm(), cjkFriendlyStrong()],
+    extensions: [gfm({ singleTilde: false }), cjkFriendlyStrong()],

-    extensions: [gfm(), cjkFriendlyStrong(), mathCompatibility(), math()],
+    extensions: [gfm({ singleTilde: false }), cjkFriendlyStrong(), mathCompatibility(), math()],

附：已发布的 0.1.1-rc.2 本地 patch

≥0.1.1-rc.x 起，dsh-client-ui-primitives 不再作为独立 npm 包安装，markdown 解析逻辑被打包内联进 dsh-web-frontend/dist/assets/vendor-*.js（minified）。minifier 因 gfm()/s4() 总是无参调用，做了死代码折叠——strikethrough 工厂内部 e.singleTilde 被折叠成字面量 {}.singleTilde（恒 undefined → 走默认 true），所以传参修复在 dist 产物上无效，只能直接改默认值：

- function s4(e){let n={}.singleTilde;
+ function s4(e){let n=!1;

（函数名 s4 随构建变化，定位：grep -oE "function [a-z0-9]+\(e\)\{let n=\{\}\.singleTilde" vendor-*.js）

已验证：patch 后单 ~ 保留为字面，~~ 正常触发删除线，符合 GFM 规范。

[denial123789]

I turned this into an English operator runbook with a narrow control matrix: single ~ stays literal, ~~word~~ remains strikethrough, code spans stay literal, and streaming/finalized/plain-text projections are checked separately. At alpha.1 commit cd5ef814, both GFM parser calls still use gfm() without { singleTilde: false }; verify the served bundle too because minification can hide the source-level fix.

Independent SandBase handbook: https://github.com/sandbaseai/deepseek-harness-handbook/blob/main/docs/en/troubleshooting/markdown-single-tilde.md