DeepSeek Harness (DSH) 插件生态中,场景数据的标准化是模型推理环节的关键。开发者经常需要从原始的点坐标和旁白材料生成结构化的 tour_robot YAML,同时确保字段定义的准确性。rein-scene-forge-dsh-plugin 正是为此设计的自动化工具。
是什么¶
这是一个由 peng2048 维护的 DSH 插件,核心职责是根据权威的 points.json 和旁白材料,生成并校验 tour_robot YAML 文件。该插件采用 MIT 许可证开源。
核心功能¶
插件内置了一套严格的生成与校验机制,主要包含以下特性:
- 字段权威性:插件使用
references/model-catalog.md作为字段选择的依据,确保输出结构符合既定标准。 - 严格校验:内部封装了
schemas/tour-robot/*.schema.json,任何未定义的目标 YAML 字段都会被拒绝。 - 规则集管理:包含一个版本化的机器可读规则集,位于
rules/目录下。 - 确定性工具集:插件暴露了四个确定性工具,用于处理场景数据:
get_authoring_rulesanalyze_point_inputvalidate_authoring_modelvalidate_tour_robot_scene
典型用法¶
开发者通常使用上述四个确定性工具来处理场景数据。默认情况下,插件会将生成的场景输出为一个 <scene_id>/ 目录,其中包含:
* map_config.yaml
* scene_config.yaml
* explain_config.yaml
* reception_pack.yaml
开发与测试¶
在进行开发检查时,可以使用以下命令:
pnpm test
pnpm run smoke
pnpm pack --dry-run
注意事项与约束¶
- 导入门槛:每个生成的场景都必须完成
references/validation-sop.md的验证。只有is_publishable: true的场景才能被导入;is_valid: true但带有警告的场景不具备导入能力。 - 动态 PAD 接收:新生成的场景默认启用动态 PAD 接收。如果缺失用户指令,不得静默禁用该功能。
运行依赖¶
插件基于 Node.js 运行,且对上游依赖有特定版本要求:
* Node.js 版本需 >= 20。
* 需要以下 DSH 生态组件(版本要求 >=):
* @deepseek-ai/cordis
* @deepseek-ai/dsh-skill
* @deepseek-ai/dsh-tools