前言¶
在 DeepSeek Harness（DSH）的开发流程中，Agent 产出的内容通常是 Markdown 或 JSON 格式。直接展示这些原始文本往往缺乏可读性，且难以作为交付物分享。dsh-artifacts 插件解决了这个问题，它提供了一套「Claude Artifacts」式的渲染方案，将 Agent 的原始输出转化为自包含的 HTML 文档。
什么是 dsh-artifacts¶
dsh-artifacts 是一个社区维护的 DSH 插件（作者：zoahdev），旨在通过零运行时依赖的方式，将 Markdown 和 JSON 数据转换为美观的 HTML 静态页面。它不依赖外部框架，生成的 HTML 文件可以直接在本地打开、发送邮件或在任何静态托管服务上发布。
核心能力¶
插件提供了以下核心功能：
- 多格式输入：支持 Markdown 文本和 JSON 数据的渲染。
- 零运行时依赖：仅依赖 Node.js 环境，生成的 HTML CSS 内联，不依赖外部字体或 JS 库。
- 模板系统：提供四种内置模板，分别用于文档、卡片、仪表盘和图库。
- Vault 导出：支持对整个 Markdown 库（如 Obsidian 或 VS Code 笔记）进行批量导出。
- 双端工具：提供命令行工具（CLI）供开发者直接使用，也提供
artifact_render工具供 Agent 在 Harness 中调用。
安装与启用¶
安装前请确保你的 Node.js 版本大于等于 18。
在 DSH 环境中启用该插件：
dsh plugin --profile web add dsh-artifacts
典型用法¶
下面通过具体命令展示如何使用该插件。
1. 渲染 Markdown 为 HTML¶
将本地 Markdown 文件渲染为 HTML 并指定主题：
dsh-artifacts notes.md --title "Release notes" --theme dark --out notes.html
2. 本地预览¶
开启本地服务进行实时预览：
dsh-artifacts notes.md --serve 8080
3. 渲染仪表盘¶
从 JSON 数据渲染仪表盘页面：
dsh-artifacts --data metrics. --template dashboard --theme brand --out dashboard.html
4. 导出整个知识库¶
将整个文件夹（如 Obsidian Vault）批量导出为静态站点：
dsh-artifacts vault ./my-notes --theme paper --out site
执行后，会在 site 目录下生成 index.html 和对应的笔记 HTML 文件。
注意事项与限制¶
在接入该插件前，请注意以下事实：
- 环境要求：需要 Node.js >= 18。
- 依赖版本：该插件依赖
@deepseek-ai/dsh-tools版本为^0.1.0-rc.6或更高。如果 Harness 版本过低，插件可能无法加载或运行。 - Markdown 兼容性：Markdown 渲染器覆盖了常见子集（标题、列表、引用、代码、表格、链接、图片），并非完整的 CommonMark 实现。
- 仪表盘机制：仪表盘是纯静态 HTML/CSS，不包含 JavaScript 运行时，不支持实时数据绑定（
--serve模式除外）。 - 插件性质：这是一个社区插件，非 DeepSeek 官方产品，请自行审查源码与许可证。
总结¶
dsh-artifacts 适合需要在 Harness 中生成可分享、可离线浏览的静态报告或文档的场景。它通过简单的命令行接口，解决了 Agent 输出结果展示不佳的问题，且由于零依赖特性，维护成本较低。
- 插件目录：zoahdev/dsh-artifacts
- 源码仓库：GitHub
