DTS Hub

主题

DTS Engine 自动发布双 Skill ​

给 AI 一个数据文件或目录，它会先识别数据类型和依赖，生成可解释的推荐参数计划；只有在你确认计划后，才调用 DTS Engine 的后台程序发布，并检查进程、产物和失败记录。

版本： 2.0.1 · 适用环境： Windows、DTS Engine 7.0、Codex

两个 Skill 如何配合 ​

Skill负责什么不负责什么
dts-engine-auto-publisher数据体检、类型与子类型识别、依赖发现、质量策略选参、任务拆分和计划解释未确认时不执行发布，不把格式识别冒充业务语义识别
dts-engine-command-generator把已确认计划转换为 EngineMaster / EngineWorker 后台命令，执行、记录日志并验收产物不猜数据类型，不绕过阻塞项，不启动 Engine UI

默认流程是：

text
指定文件或目录
  → 自动识别与推荐参数
  → 展示计划、依据、警告和阻塞项
  → 用户确认具体计划
  → 后台发布
  → 检查退出状态、3DT、failed-data.txt 和内容验收边界

.aconf 是 DTS Engine UI 工程，打开后会唤起 Engine UI；这两个 Skill 使用后台命令链路，不需要把 .aconf 转换成任务。Skill 会把 .aconf 样本用于参数校准和回归证据，但不会把它作为日常发布入口。

安装 ​

下载 ZIP 并解压，会得到一个包含两个 Skill 的目录：

text
dts-engine-skill/
├── dts-engine-auto-publisher/
│   ├── SKILL.md
│   ├── agents/openai.yaml
│   ├── references/
│   └── scripts/New-DtsEnginePublishPlan.ps1
└── dts-engine-command-generator/
    ├── SKILL.md
    ├── agents/openai.yaml
    ├── references/
    └── scripts/

把其中两个 Skill 文件夹分别复制到：

text
%USERPROFILE%\.codex\skills\dts-engine-auto-publisher
%USERPROFILE%\.codex\skills\dts-engine-command-generator

已有同名目录时先备份，不要静默覆盖。安装后重新打开 Codex 或新建任务。其他兼容 Skill 的 AI 客户端，请按该客户端的技能目录规则安装这两个文件夹。

页面上方也提供“AI 辅助安装”：把安装指令复制给具备联网和本地文件权限的 AI，它会先校验文件大小与 SHA-256，并在覆盖旧版本前请求确认。

最简单的用法 ​

直接告诉 AI 输入数据、目标格式和输出位置：

text
把 E:\Data\Oblique 发布为 3DT，输出到 E:\Output，使用均衡策略。先给我看计划，不要执行。

AI 应先返回数据类型、置信度、输入输出、关键参数、参数依据、警告和阻塞项。检查无误后再说：

text
确认按此计划发布。

发布完成后可以继续问：

text
数据发布完了吗？请分别报告进程、产物和内容验收状态。

常见场景 ​

需求推荐说法
发布单个数据集分析 E:\Data\Building.ifc，推荐参数并生成发布计划。
发布同类目录分析 E:\Data\PointCloud，按均衡策略拆分任务，先不要执行。
发布混合目录分析 E:\Data\Mixed，按数据类型分别生成 3DT 发布计划。
强调画质按 quality 策略规划，但不要改变坐标系、加密和业务语义。
强调效率按 performance 策略规划，并说明哪些参数会降低细节。
人工指定语义这个 FBX 是骨骼动画，请按 skeletal 处理。
复核已有计划使用 dts-engine-command-generator 审查这个 plan.json，只生成命令，不执行。

支持规划的主要类型包括地形影像、倾斜摄影、Max/通用模型、BIM/CAD、点云、资源点、矢量、海洋、骨骼动画和 3DGS。不同类型的本机运行证据等级不同，页面中的“支持规划”不等于所有类型都已完成端到端发布验证。

推荐参数如何产生 ​

识别时先确定主数据上下文，再解释伴随文件。地形或倾斜摄影主目录中的 SHP，优先按外裁、内裁、水域或其他辅助范围处理，不会仅凭点、线、面几何类型拆成道路或资源任务。若同一主目录还包含 VTPK，VTPK 可以作为独立矢量切片任务保留；用途不明的 SHP 会进入阻塞项等待确认。

参数按下面的优先级合并：

  1. 用户明确覆写。
  2. 数据元信息或内容检测。
  3. quality、balanced、performance 策略推荐。
  4. DTS Engine 默认值。

默认值只是未覆写时采用的值，不限制示例和合法取值范围。质量策略只影响画质与效率参数；坐标系、对象 ID、数据库、加密和业务语义不会被策略档偷偷改变。

以下情况会停止在计划阶段，等待确认：

  • Max、FBX、3DM 等文件无法确认建筑、地面、树、水、室内、管线或动画语义。
  • SHP 无法确认是资源点、普通矢量、裁切范围还是海洋范围。
  • 倾斜摄影存在多个裁切 SHP，或裁切语义、坐标系不明确。
  • 投影数据缺少坐标系，或 DOM、DEM、裁切数据坐标系不一致。
  • RVT、DGN、MAX 等外部软件依赖无法确认。
  • 计划中仍有任何 blockers。

高级：直接运行脚本 ​

只生成计划，不运行 Engine：

powershell
& ".\dts-engine-auto-publisher\scripts\New-DtsEnginePublishPlan.ps1" `
  -InputPath "E:\Data\Input" `
  -OutputRoot "E:\Data\Output" `
  -Profile balanced `
  -PlanPath ".\plan.json"

审查已确认计划并生成命令：

powershell
& ".\dts-engine-command-generator\scripts\Build-DtsEngineCommand.ps1" `
  -PlanPath ".\plan.json"

真正执行时必须显式传入确认值：

powershell
& ".\dts-engine-command-generator\scripts\Invoke-DtsEngineJob.ps1" `
  -PlanPath ".\plan.json" `
  -JobId "job-id" `
  -ConfirmPublish PUBLISH

不建议手工拼接命令字符串。脚本会把参数和值分开转义，默认拒绝可能导致后台任务不退出的 udp 参数，并按实际安装位置发现 EngineMaster.exe 和 EngineWorker.exe。

验收标准 ​

层次检查内容
进程层程序存在、成功启动、未超时、退出码为 0
产物层存在非空 .3dt，所需属性文件完整，failed-data.txt 不存在或为空
内容层坐标范围、对象和属性数量、纹理、碰撞、拾取等符合任务目标

脚本可以完成基础结构检查，但视觉和业务语义仍需要相应查看器或 DTS 平台复核。倾斜摄影还要确认金字塔文件与瓦片目录完整，不能只看到顶层 .3dt 就判定成功。

兼容性与证据边界 ​

  • 当前包在 Windows 与 DTS Engine 7.0 安装结构上完成了计划生成和后台命令生成回归。
  • FBX/Max 建筑配置已有本机后台产物证据；其他类型按 sample-derived 或 inferred 标记，直到各自完成端到端回归。
  • 本次回归确认地形与倾斜摄影目录中的辅助 SHP 不会再被错误拆成道路或资源任务；独立 VTPK 仍会保留为矢量切片任务，语义或坐标系不明确的 SHP 会阻塞并要求确认。
  • 该包不包含 DTS Engine、测试数据或商业模型。DTS 软件与输入数据沿用各自许可，本 Skill 包未附独立开源许可证。