deepseek-harness/packages/support/loader-smoke/README.zh.md

@deepseek-ai/dsh-loader-smoke

English | 中文

用于测试通过 Cordis Loader 启动应用和 cordis.yml 的共享子进程 harness。resolveExampleLaunch 选择本地 src mode（tsx 和根 tsconfig 路径）或 CI lib mode（普通 Node 和包导出）；选择依据为显式 mode 或 DSH_EXAMPLE_MODE。

runLoaderSmoke 接受可执行文件路径和配置路径、可选的完整可执行文件参数、环境变量覆盖、标准输入、运行前准备和清理前检查。它负责隔离工作目录、DSH 主目录、诊断、截止时间、终止、EOF 和清理；进程以零状态退出后返回两个流，失败时则返回拒绝并附带两个流。

这是支持层测试基础设施，而非产品 API。

模型体验

无。该测试专用 harness 启动示例进程并检查它们的流，不会改变组装后的模型请求。

KV Cache 影响

无；该包既不组装也不发送提供方请求。

已知限制与暂缓事项

• 构建模式需要事先构建：配置还必须能够通过 examples/node_modules 向上解析每个命名包。
• 捕获的 stdout 和 stderr 仅受 execa 默认 100 MB maxBuffer 约束：失控子进程会在该上限处被终止，而不是在冒烟测试自选的预算处。
• 超时只终止直接子进程：有故障的 fixture（测试前置数据）spawn 的进程树可能比冒烟测试存活更久，需要外部清理。