DeepSeek Harness Hub
← 返回列表

Markdown 查看器AKS1st/dock-markdown

Cordisspec-screened在 GitHub 查看 ↗
✓ 可直接安装

渲染 GFM 文档并支持大纲跳转与一键切编辑

自动检查通过:npm 包已发布且 engines 声明满足基线(声明 Node >=20);该结论来自程序自动检查,未经人工实机验证。 · 最近上游提交 2026/9/11 · 已提供中文文档

DSH 生态中最好的 Markdown 查看插件:GFM 渲染、DOMPurify 消毒、文档大纲、相对路径图片/链接解析、一键切换编辑;依赖 dock/dock-files/dock-editor | The best Markdown viewer for DSH: GFM rendering, DOMPurify sanitization, document outline, relative image/link resolution, one-click switch to editing; requires dock/dock-files/dock-editor

综合分
32.2
GitHub 分
32.2
用户评分
★ Stars
3
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add dock-markdown
npm 包 dock-markdown 已校验归属本仓库,走 npm 安装最省事
数据截至 2026/9/12(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查✓ 自动检查通过

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

npm 包dock-markdown @ 0.1.2
Node 引擎要求 >=20 · 基线 Node 22.19 满足
dsh CLI 依赖未声明 dsh 版本约束
入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 21:07:54

用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

dock-markdown

English

DSH 生态中最好的 Markdown 查看插件 —— 没有之一。 GFM 渲染、DOMPurify 消毒、文档大纲、相对路径图片/链接解析、一键切编辑,读 README、看文档、审稿子,dock-markdown 让 Markdown 在 DSH 里第一次有了「编辑器级」体验。

dock 系列的 Markdown 查看插件:为 dock-files 文件域注册 markdown 文件查看器(md / markdown / mdx)与对应的编辑器区视图。通过 dock-editor 的 /desk-editor/fs.read 读取文件内容,用 marked + DOMPurify 渲染为消毒后的 HTML,并提供一键切换到 dock-editor 编辑。

效果预览

dock-markdown Markdown 查看视图

功能

- Markdown 渲染:marked(GFM)+ DOMPurify 消毒,输出纯静态 HTML。
- 相对路径资源解析:Markdown 中的相对图片与内部跳转链接按「Markdown 所在目录 → 当前路径所在 git 仓库根目录 → 会话工作区根目录」的优先级解析;图片以内联 data URL 展示,内部链接点击后通过工作台打开目标文件,#锚点 链接平滑滚动到对应标题。
- 文档大纲:工具栏 ☰ 按钮展开/收起大纲栏,按标题层级缩进列出 h1–h6,点击跳转到对应标题,滚动时高亮当前所在章节。
- 查看器切换:工具栏按钮一键在「查看」与「编辑」(dock-editor)之间切换。
- 主题适配:排版样式使用 DSH 主题 token,跟随亮/暗主题。
- 代码块 / 表格 / 引用等常用 GFM 元素均有排版样式。

依赖

| 依赖 | 类型 | 说明 |
| --- | --- | --- |
| dock >= 0.1.0 | peer(必需) | 工作台外壳:编辑器区视图、浮窗、ctx.workbench 由它提供 |
| dock-files >= 0.1.0 | peer(必需) | 文件域服务:dock-markdown 作为 markdown 查看器被分发打开 |
| dock-editor >= 0.1.0 | peer(必需) | 提供 /desk-editor/fs.read 读取文件内容,以及「一键切编辑」的目标编辑器视图 |
| DSH Web 环境 | 运行时 | 必需,客户端平台为 Web |
| cordis ^4.0.0-rc.7 | peer | 插件框架(DSH 自带) |
| react ^18.2.0 | peer(可选) | 客户端渲染需要;未提供时查看器 UI 不激活 |
| marked / dompurify | 内置(构建打包) | GFM 渲染与消毒,随插件打包,无需单独安装 |

安装

需要 dock、dock-files 与 dock-editor(查看器切换依赖其 editor 视图):

推荐从 npm registry 安装:

dsh plugin --profile web add dock-base
dsh plugin --profile web add dock-files
dsh plugin --profile web add dock-editor
dsh plugin --profile web add dock-markdown

或通过 GitHub 安装(备选):

dsh plugin --profile web add github:AKS1st/dock
dsh plugin --profile web add github:AKS1st/dock-files
dsh plugin --profile web add github:AKS1st/dock-editor
dsh plugin --profile web add github:AKS1st/dock-markdown

安全

marked 输出的原始 HTML 一律经 DOMPurify.sanitize()(默认白名单)消毒后才写入 DOM,dangerouslySetInnerHTML 只用于消毒后的结果。已知取舍:DOMPurify 默认允许 style 属性,恶意 Markdown 理论上可用 CSS 做外联跟踪——如需更严格可加 FORBID_ATTR: ['style']。

相对路径资源不受会话工作区限制:Markdown 文件可能位于主机的任何位置(对话上下文可提及工作区外的文件,如 ~/.dsh/skills/...),其相对图片 / 内部链接按「Markdown 所在目录 → git 仓库根目录 → 会话工作区根目录」优先级解析,只要候选是存在的文件即可读取。

License

MIT

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

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

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群