plugin-test

用途：为 DeepSeek Harness（DSH）插件、外部 DSH 插件包及 deepseek-harness 仓库的包变更编写或评审测试。核心原则是选择能证明变更正确的最小测试层级集合，默认不跑完整测试套件，也不重复已通过的检查。\n\n主要能力：\n版本迁移测试——适配新 DSH 宿主版本时，阅读 references/version-migration-testing.md，按精确的 from/to 版本建立迁移台账并扫描全部七类接触点；为每个适用的破坏性或行为变更添加针对性回归测试。\nDocker 发布冒烟——发布前外部插件检查可参考 references/docker-release-smoke.md，在打包产物上使用附带的 runner，固定一个精确 DSH 版本与非 latest 的 Node 镜像，安装进隔离 Profile，冷启动真实 DSH 入口，必要时加一个基于 argv 的功能探针。生成的 JSON 与 Markdown 仅作为该产物与目标版本的窄口径证据。\n\n测试层级（Harness 单仓命令）：单元测试 pnpm run test；覆盖率门槛 pnpm run test:coverage（packages///src 下文件需 100% 覆盖）；真实 API 端到端 pnpm run test:e2e；快照 pnpm run test:snapshot；Web 浏览器快照 pnpm run test:web。外部插件应使用其自有脚本与路径，不要新增不存在的 Harness 根命令或强加单仓目录结构。\n\n层级选择：纯逻辑改动只跑单元测试；新增或修改包源码跑覆盖率门槛；模型可见行为（提示词、工具 Schema、工具输出、Skill 目录）加免凭证快照再补真实组合测试；协议可见行为（ACP、JSON-RPC、传输层）加免凭证快照；用户可见行为（CLI 记录、交互终端、GUI 流程）使用对应快照目录；供应商行为在凭证可用且获授权时跑真实 API 端到端。\n\n使用方式与限制：快照在记录或刷新后需逐项审查差异，CI 强制只读重放；真实入口路径指发布产物，package bin 需在原生 Node 下运行构建入口，缺少必需配置时应断言进程以非零码退出。测试应优先真实实现，仅对昂贵或非确定性边界（LLM 适配器、网络、时钟）打桩；端到端测试自行创建并在 afterEach 中释放 Harness 资源。无法验证的凭证、供应商、操作系统、浏览器、PTY 及破坏性迁移边界应如实报告，不得声称全面兼容。具体凭证配置、价格与平台支持资料中未提供。