产物预览面板 hustshawn/dsh-plugins

dsh-plugins

一组用于 DeepSeek Harness 的插件。

DSH 将一切都组合为插件，而插件无需 fork 即可添加 UI、工具或宿主能力：它通过文档化的扩展点进行贡献，而省略其行的组合只会失去该功能，别无其他。这些插件正是以这种方式构建的，它们被放在一起，以便它们共同所需的构建和测试基础设施只需存在一次。

插件

| 插件 | 包 | 它添加的内容 |
| artifact-preview | @hustshawn/dsh-artifact-preview | Claude 风格的 Artifacts：在可调整大小的侧边面板中预览 agent 写入的 HTML 和 Markdown 文件 |

每个插件自己的 README 负责说明其安装步骤、行为和限制。

仓库布局

packages// 一个可独立安装的插件，单独发布 shared/ 每个插件都使用的构建和测试预设

shared/ 是私有的，从不发布。它之所以存在，是因为关于 DSH 插件的两个事实很容易搞错，且重新发现的代价高昂：

- 浏览器端部分不是普通模块。 Web shell 在任何模块图之外获取它，因此它必须自我注册为 window.__ModuleLoader__.load({ id, factory })，并通过 shell 的冻结模块表解析共享模块。shared/src/plugin-build.ts 生成该包装器。
- Shell 提供的模块必须保持外部化。 内联 React 会给插件带来第二个 React 标识并破坏 hooks；内联服务模块会产生与 shell 注册的不同的 DI 实体。同一个文件掌管该列表。

插件自己的 tsdown.config.ts 随后只需几行来命名其入口。

开发

需要 Node ^22.19 || >=24 和 pnpm。

pnpm install
pnpm run typecheck # 每个包
pnpm run test # 每个包
pnpm run build # 每个包

要处理单个插件：

pnpm --filter @hustshawn/dsh-artifact-preview run test
pnpm --filter @hustshawn/dsh-artifact-preview run build

添加插件

1. packages//，其中 package.json 带有 dsh 清单字段（浏览器端部分为 dsh.client），并将 @hustshawn/dsh-plugin-shared 作为开发依赖。
2. tsconfig.json 继承 @hustshawn/dsh-plugin-shared/tsconfig.plugin.json。
3. tsdown.config.ts 调用 pluginBuild({ id, nodeEntries?, clientEntry? })，其中 id 是包名——shell 用它作为其模块表条目的键。
4. vitest.config.ts 调用 pluginTest(...)，当插件读取会话事件时传入一个客户端运行时桩。
5. 一个涵盖安装、行为和限制的 README，以及上表中的一条条目。

许可证

MIT——见 LICENSE。