dsh-better-markdown 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线；该结论来自程序自动检查，未经人工实机验证。

dsh-better-markdown 有中文文档吗？

已提供中文汉化 README，本站可切换中英文对照阅读。

dsh-better-markdown 还在维护吗？

GitHub 19 星。最近一次上游提交在 2026/8/17。

← 返回列表

zerob13/dsh-better-markdown

DeepSeek Harnessspec-screened在 GitHub 查看 ↗

✓ 可直接安装

用 markstream-react

自动检查通过：npm 包已发布且 engines 声明满足基线；该结论来自程序自动检查，未经人工实机验证。 · 最近上游提交 2026/8/17 · 已提供中文文档

由 markstream-react 驱动的 DeepSeek Harness Web 插件，用于弹性流式 Markdown、Mermaid 图表、KaTeX 数学公式以及安全的渲染器回退。

综合分

40.2

GitHub 分

40.2

用户评分

—

★ Stars

周下载量

—

安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）

dsh plugin --profile web add dsh-better-markdown

npm 包 dsh-better-markdown 已校验归属本仓库，走 npm 安装最省事

数据截至 2026/9/18（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）

安装兼容性检查✓ 自动检查通过

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-better-markdown @ 0.1.2

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 09:26:05

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-attachment@deepseek-ai/dsh-client-ui-conversation@deepseek-ai/dsh-client-ui-primitives@deepseek-ai/dsh-client-ui-slots

用户评分

还没有人投票，来当第一个

订阅周报，不错过优质插件更新

每周一封 · 高评分插件 + 新用户活动

站内推荐装备清单

插件装完了，桌面还有这些值得配

从键盘、显示器到开发板与存储设备，按七个类目整理，支持切换平台与价格排序比价。

·七大类目，支持平台切换与价格排序
·价格与库存以商品页实时为准

看装备清单→

README

dsh-better-markdown

用 markstream-react
替换 DeepSeek Harness Web 的流式 Markdown 渲染链路。

中文 · English

dsh-better-markdown 是一个 DeepSeek Harness Web 客户端插件。安装后，Web 对话中所有带流式状态的 assistant Markdown 都由 markstream-react 解析和渲染；同一消息流结束后继续使用同一个 renderer，不会在完成瞬间切回另一套 Markdown 实现。

markstream-react 是 Simon-He95/markstream-vue monorepo 提供的 React 版本。本插件在 Harness 中使用的是 React package，不会引入 Vue runtime。

为什么使用 Markstream React

- 面向流式输出：可持续处理尚未闭合的粗体、代码围栏、列表、表格和数学表达式，适合 LLM token stream。
- 减少完成态切换：流式与 settled assistant message 共用 Markstream renderer，避免完成时替换整棵 Markdown UI。
- 更丰富的 Markdown：支持常用 Markdown、表格、任务列表、引用、链接、图片、KaTeX 数学公式和 Mermaid 图表。
- 兼容 Harness 滚动区：关闭不适用于聊天内部滚动容器的 viewport lazy mounting，避免可见内容停留在骨架占位状态。
- 完整 Markstream 代码块：fenced code 由 Markstream MarkdownCodeBlockNode 与 stream-markdown 渲染，使用 Shiki 流式高亮，并保留语言标题、复制和展开操作；reasoning、附件、停止状态仍保持 Harness 原行为。
- 安全边界明确：原始 HTML 使用 htmlPolicy="escape"；链接、图片和 settled file mention 继续执行 Harness 的限制策略；Mermaid 使用 strict mode。

效果截图

Markstream 代码块

图片、链接与 KaTeX 数学公式

Mermaid 图表

功能范围

| 能力 | 行为 |
|---|---|
| Assistant 流式 Markdown | 全部交给 markstream-react |
| 已完成的 assistant Markdown | 继续使用同一个 Markstream renderer |
| Mermaid | 插件内置 mermaid@11.16.1，无需额外安装 |
| Math | KaTeX 行内 / 块级数学公式 |
| 代码围栏 | 使用 Markstream MarkdownCodeBlockNode + stream-markdown + Shiki；未知语言回退为可见纯文本 |
| 原始 HTML | 转义为文本，不注入 DOM |
| 链接与图片 | 仅允许安全的外部协议 |
| Plan review / trajectory 等静态 surface | 继续使用 Harness 内置 MarkdownText；这些 surface 没有统一替换 slot |

工作原理

插件使用 Harness 公开的 client module 与 slot shadowing，不修改 Harness 源码，也不替换全局 React。

Assistant token stream
-> Harness session projection
-> conversation.chat.node / assistant-step
|- priority -100: BetterAssistantNodeView
|                  -> markstream-react  (active)
|                       - fenced code -> stream-markdown -> Shiki
- priority    0: Harness built-in      (fallback)

低优先级 shadow entry 负责正常渲染；如果插件 renderer 抛错或被卸载，Harness 原 renderer 仍在 slot 中并自动接管。

安装

从 npm 安装（推荐）

前置条件：DeepSeek Harness Web 可以正常启动。

dsh plugin --profile web add dsh-better-markdown
dsh --profile web --dump-config
dsh --profile web

更新插件：

dsh plugin --profile web add dsh-better-markdown@latest

从源码安装

前置条件：DeepSeek Harness Web 可以正常启动，Node.js 20+，pnpm 10+。

git clone https://github.com/zerob13/dsh-better-markdown.git
cd dsh-better-markdown
pnpm install
pnpm run check
pnpm run build
dsh plugin --profile web add "$(pwd)"
dsh --profile web --dump-config
dsh --profile web

Windows PowerShell 将 "$(pwd)" 替换为 (Get-Location).Path。

配置输出应包含：

== dsh-better-markdown
- id: better-markdown
name: dsh-better-markdown

打开 Web 后，assistant Markdown 根节点会带有：

直接从 Git 安装

Git dependency 会执行本仓库的 prepare 构建。pnpm 10/11 可能要求在 Web profile 的 pnpm-workspace.yaml 中显式允许：

allowBuilds:
dsh-better-markdown: true

然后安装：

dsh plugin --profile web add git+https://github.com/zerob13/dsh-better-markdown.git
dsh --profile web

建议生产环境固定 commit SHA，而不是长期跟随默认分支。

移除

移除插件：

dsh plugin --profile web remove dsh-better-markdown

卸载会释放 slot shadow 和 Markstream component policy，Harness 内置 renderer 随即恢复。

体积与取舍

- markstream-react: 0.0.55
- mermaid: 11.16.1
- stream-markdown: 0.0.16
- shiki: 4.4.3
- 当前 browser bundle：约 7.40 MB，gzip 约 1.59 MB
- Mermaid 与 Shiki 代码高亮均被打包以保证离线可用；Shiki 使用纯 JavaScript 正则引擎与 34 种常用语言的 fine-grained bundle
- Monaco runtime、D2、Infographic 等可选 peer 没有打包；未知代码语言使用 Markstream 的纯文本回退
如果不需要 Mermaid，移除其 dependency 可以明显减小 bundle，但 Mermaid fence 将无法生成图形预览。

开发

pnpm install
pnpm run check
pnpm run build
pnpm pack --dry-run

维护者发布流程：先让 package.json 版本与 vX.Y.Z tag 保持一致，再发布对应的 GitHub Release。publish.yml 会验证版本、执行测试与构建，并通过 npm trusted publishing 发布公开包；prerelease 不会发布。

主要文件：

- src/client/index.ts：注册 Markstream component policy 和 assistant slot shadow
- src/client/renderer.tsx：assistant node 与 Markdown renderer
- src/client/shiki.ts：单文件插件使用的 fine-grained Shiki bundle
- src/client/styles.css：Harness token 适配
- cordis.patch.yml：插件 bundle row
- tests/plugin.spec.tsx：streaming、fallback、安全与 Mermaid 路由测试

兼容性

- DeepSeek Harness 0.1.0-rc.5 及以上
- React 18 及以上
- 仅替换 Web conversation 的 assistant-step
- 旧版 Harness 如果没有 priority-based slot shadowing，会直接加载失败，避免出现双 renderer

致谢

- DeepSeek Harness
- markstream-vue / markstream-react
- Mermaid

License

MIT

站内推荐装备清单

先看价格，再决定买哪件

不确定该买什么价位？清单支持按价格升序排列，同类目可以直接横向比价。

·支持价格升序排列
·同类目可横向比价

按价格看看→

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问，比一个人翻文档快。

点击加入 QQ 群

扫码进群

zerob13/dsh-better-markdown

README

💬 加入 DPharness 群聊

相关插件 · UI / 主题