rein-scene-forge-dsh-plugin: 场景构建与校验工具

DeepSeek Harness (DSH) 插件生态中,场景数据的标准化是模型推理环节的关键。开发者经常需要从原始的点坐标和旁白材料生成结构化的 tour_robot YAML,同时确保字段定义的准确性。rein-scene-forge-dsh-plugin 正是为此设计的自动化工具。

是什么

这是一个由 peng2048 维护的 DSH 插件,核心职责是根据权威的 points.json 和旁白材料,生成并校验 tour_robot YAML 文件。该插件采用 MIT 许可证开源。

核心功能

插件内置了一套严格的生成与校验机制,主要包含以下特性:

  1. 字段权威性:插件使用 references/model-catalog.md 作为字段选择的依据,确保输出结构符合既定标准。
  2. 严格校验:内部封装了 schemas/tour-robot/*.schema.json,任何未定义的目标 YAML 字段都会被拒绝。
  3. 规则集管理:包含一个版本化的机器可读规则集,位于 rules/ 目录下。
  4. 确定性工具集:插件暴露了四个确定性工具,用于处理场景数据:
    • get_authoring_rules
    • analyze_point_input
    • validate_authoring_model
    • validate_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

注意事项与约束

  1. 导入门槛:每个生成的场景都必须完成 references/validation-sop.md 的验证。只有 is_publishable: true 的场景才能被导入;is_valid: true 但带有警告的场景不具备导入能力。
  2. 动态 PAD 接收:新生成的场景默认启用动态 PAD 接收。如果缺失用户指令,不得静默禁用该功能。

运行依赖

插件基于 Node.js 运行,且对上游依赖有特定版本要求:
* Node.js 版本需 >= 20。
* 需要以下 DSH 生态组件(版本要求 >=):
* @deepseek-ai/cordis
* @deepseek-ai/dsh-skill
* @deepseek-ai/dsh-tools

结语

该插件通过代码化的规则和确定性工具,解决了场景生成的规范性问题。更多细节请查阅插件目录页或GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜