Markdown 渲染服务 joao-paulo-santos/dsh-md-view

dsh-md-view

一个 DeepSeek Harness (DSH) 插件：为客户端插件提供 markdown 渲染，使每个展示 markdown 的界面（README、日志、便签）都通过同一个服务以相同方式渲染： harness 自带的 MarkdownText 管线（GFM、数学公式、脚注、带复制按钮的 shiki 高亮代码），再加上聊天从不需要的文档特定处理。

它本身没有可访问的 UI。插件注入客户端服务 mdView：

// 消费者客户端部分，inject: ['mdView', …]

// 1. 一个 markdown 文档作为元素（布局由你掌控）： return React.createElement('div', { className: 'mine' },
ctx.mdView.render(markdownText, { links: { repo: 'owner/name' } }))

// 2. 一个自包含的文档： const Doc = ctx.mdView.component({ text: markdownText, links: { repo: 'owner/name' } }) return React.createElement(Doc, {})

它在原语之上增加了什么

- 原始 标签（徽章、截图）变为真实图片，
- 文档相对链接和图片目标会相对于
https://github.com/{repo}/blob/HEAD/... 和原始内容主机解析
（当给出 links.repo 时），
- 围栏代码块和行内代码片段永远不会被转换。

契约

- 渲染输出是仅含纯文本节点的 React 元素；markdown 永远无法注入 HTML（ 保持为可见文本，这是 MarkdownText 的规则）。
- links.repo 是可选的；没有它时相对目标保持原样。
- 包装样式表由本插件安装一次；消费者无需为 markdown 添加任何自己的 CSS。
- 无持久化；宿主部分是一个桩。

如何安装

需要一个 DeepSeek Harness 检出和一个 profile，这里为 web。该插件没有依赖：

mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
git clone https://github.com/joao-paulo-santos/dsh-md-view.git

从 harness 检出目录
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-md-view

验证 profile 仍能组合
pnpm dsh --profile web --dump-config

重启 harness。注入 mdView 服务的插件现在就可以渲染 markdown 了。

依赖

（无）

依赖此插件的插件

- dsh-workspace-history 用它渲染压缩日志正文（可选；降级为纯文本）
- dsh-wo-github 用它渲染仓库 README（可选；降级为纯文本）