DeepSeek Harness 产物浏览器插件开发最佳实践
本文档以
@wangjunjian/dsh-artifact-viewer为实例,系统梳理 DeepSeek Harness(DSH)bundle 插件的开发方法:工作原理、架构设计、构建打包、测试、发布自动化,以及开发和发布过程中实际踩过的坑。

1. 工作原理
Bundle 插件是什么
DSH 的 bundle 插件是一个普通 npm 包,通过 package.json 里的 dsh 字段声明自己:
{
"dsh": {
"bundle": { "patch": "./cordis.patch.yml" },
"client": {
"platform": "web",
"inject": ["@deepseek-ai/dsh-client-runtime"],
"external": ["@deepseek-ai/dsh-client-ui-primitives"]
}
}
}
dsh.bundle.patch:指向一个 cordis patch 文件,负责把插件注册进 loader 树。dsh.client:声明浏览器半部分的运行平台、注入依赖和 external 包。