📄 dsh-md-preview

English | 简体中文

把 Markdown 变成一个可以直接发给别人的网页。

DeepSeek Harness 的 Markdown 渲染插件，两个入口、一套引擎：

• md_html_render —— 模型可以直接调用的工具。传入 Markdown，返回一份完整、自包含的 HTML 文档，可选写入磁盘。无图形界面的 headless 配置下同样可用。
• MD 抽屉 —— 在网页会话头部按 MD，浏览当前工作目录，点开任意 .md 文件即时渲染。不开新标签页，不换编辑器，不打断当前上下文。

两者共用同一个渲染器，所以模型生成的页面和你从抽屉导出的页面逐字节一致——这一点由测试对整个用例集断言。

---

安装

尚未发布到 npm，直接从 GitHub 安装。写进你的 profile package.json：

// ~/.dsh/profiles/
/package.json
{
  "dependencies": {
    "dsh-md-preview": "github:LeslieWylie/dsh-md-preview#v0.2.1"
  },
  "dsh": {
    "profile": {
      "bundles": ["dsh-md-preview"]
    }
  }
}

然后重装并重启 profile：

cd ~/.dsh/profiles/
 && pnpm install
dsh --profile 

去掉 #v0.2.1 即可跟随默认分支，不锁版本。

不改 profile 直接试用

dsh --profile web --patch 

---

## 工具

md_html_render(markdown, title?, save_path?) -> { html, savedPath?, error? }

| 参数 | | |
|---|---|---|
| `markdown` | 必填 | Markdown 原文。 |
| `title` | 可选 | 网页 ``，缺省为 `Markdown`。 |
| `save_path` | 可选 | 写入路径。经由会话文件服务解析，因此与其他写操作遵守同一套沙箱策略。 |

报告、方案、对比表——任何原本只能堆在对话里的内容，都可以变成一个能用浏览器打开、能直接发给同事的文件。

> 把这份迁移方案渲染到 `~/Desktop/plan.html`

产物是**自包含**的：样式内嵌，不加载任何外部样式表、字体、脚本或图片。从磁盘打开、从 U 盘打开、在完全断网的机器上打开，效果都一样，并且自动跟随阅读者的深色模式。它不会向外发起任何请求，因为根本没有可发起的目标。

如果 `save_path` 被沙箱拒绝，工具仍会连同错误信息一起返回 HTML 正文，不会因为一个权限问题就把成果丢掉。

## 抽屉

| | |
|---|---|
| **原地浏览** | 从当前工作目录打开。点文件夹进入，**↑** 返回上级。不弹系统文件对话框。 |
| **点开即渲染** | 标题、粗体/斜体/删除线、行内代码、围栏代码块、引用、有序/无序/任务列表、表格、链接、图片、分隔线。 |
| **编辑** | 切换到纯文本框改一行或记点东西，再切回渲染视图。 |
| **导出** | 在源文件旁写出一份自包含 HTML —— 与 `md_html_render` 产出的是同一份文档。 |
| **主题自适应** | 读取 harness 主题变量，明暗主题都无需额外配置。 |

## 为什么还要再写一个 Markdown 插件

三件这个插件坚持不做的事：

- **零运行时依赖。** 客户端半边以纯脚本方式加载、不经打包器，因此 `marked`、`markdown-it` 这类库根本用不了。渲染器是约 150 行手写 JavaScript，你要审计的依赖树就是这一个文件。
- **不开第二条通往磁盘的路。** 所有读写都走 harness 的 `fs` 服务，因此插件直接继承会话已有的沙箱策略，绝不自行开辟文件访问通道。抽屉的 `readFile` 会拒绝 `.md`、`.markdown`、`.mdx`、`.txt` 以外的一切。
- **不执行任何原始 HTML。** 文档文本在任何行内语法处理之前就已全部转义；非 `http(s):`、`#`、`/`、`mailto:` 的链接目标一律折叠为 `#`。含 `` 或 `javascript:` 链接的文档只会渲染成字面字符。

## 工作原理