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 倉庫。

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

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

小夜