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