DTML Studio
当前版本：5.5.1 · 单文件离线版 · 2026-07-30
DTML Studio 是一个在浏览器本地运行的 DTML 工程工具。它可以查看工程结构、分析 XML、合并 DTML、追加 3DT，并从 3DT 文件夹生成新的 DTML 工作副本。文件处理发生在本机浏览器中，工具不会把工程上传到服务器，也不会直接覆盖原文件。
直接下载单文件 HTML · SHA-256 校验文件 · 发布清单
工作台效果
适合解决什么问题
- 快速检查
.dtml/.xml的ProjectTree、设置、材质、植被等结构。 - 按标签统计节点，并查看选中节点的属性与 XML 内容。
- 将多个 DTML / XML 文件合并到当前工作副本，并提示坐标系、重复 ID 和唯一配置覆盖风险。
- 将 3DT 文件夹追加到现有工程，可选择保留目录层级或平铺图层。
- 从 3DT 文件夹生成 DTS 兼容工程预览，并导出完整工程、当前标签或勾选内容。
快速开始
- 下载 ZIP 并完整解压。
- 使用最新版 Microsoft Edge 或 Google Chrome 打开
DTML-Studio-v5.5.1.html。 - 选择“打开工程”检查或合并现有文件；也可以选择“新建工程”从 3DT 文件夹生成预览。
- 在左侧检查工程树，在右侧核对分析报告、属性详情和操作结果。
- 点击页面右上角“导出”，将结果保存为新文件。
- 在 DTS Explorer 或目标运行环境中重新打开导出结果，核对结构、资源路径、坐标系和空间位置。
主要工作流
| 工作流 | 输入 | 结果 |
|---|---|---|
| 查看与分析 | .dtml / .xml | 工程树、属性、标签统计与诊断 |
| 合并工程 | 主工程 + 一个或多个 DTML / XML | 更新后的内存工作副本 |
| 追加 3DT | 主工程 + 3DT 文件夹 | 增加 TileLayer 的工作副本 |
| 新建工程 | 3DT 文件夹、工程名、EPSG | 可检查并导出的 DTML 预览 |
| 选择性导出 | 当前标签或树中勾选节点 | 独立 XML 文件 |
必须了解的工程交付约定
DTML Studio 下载的是浏览器单文件工具。受浏览器安全模型限制，它可以导出 .dtml 文件，但不能自动在导出位置创建同名伴随目录。
当 DTS Explorer 或下游流程要求完整工程约定时，请确保最终成果同时包含：
text
项目名.dtml
项目名_files\即使 3DT 使用绝对路径且不复制资源，也应创建同名 _files 目录。若使用相对路径，还必须让资源目录与 DTML 中的 TileLayer/FilePath 保持一致。不要把“网页已导出文件”视为“目标环境已完成验收”。
坐标系与资源路径
- 合并前确认主工程与待合并文件的
ProjectSettings / CRSWKT一致；不一致时继续合并可能导致空间偏移。 - 新建工程时应选择与源数据一致的 EPSG，不确定时不要随意转换坐标系。
- 绝对路径依赖原始 3DT 所在位置，移动工程后可能失效。
- 相对路径模式要求导出的
.dtml与资源目录保持工具提示的相对层级。
下载完整性
| 项目 | 值 |
|---|---|
| 工具版本 | 5.5.1 |
| 单文件大小 | 537,074 字节 |
| 单文件 SHA-256 | 3CB3BF82E40430B3624B4F757717EF67CC90E3B542018792C1F5BBC518CA2CBE |
| 资源依赖 | 无；78 个界面图标已内嵌 |
| 联网要求 | 无 |
| 推荐浏览器 | 最新版 Microsoft Edge / Google Chrome |
ZIP 包的 SHA-256 以随包发布的校验文件为准。
本次发布验证
- 单文件 HTML 完整存在，版本标识为
v5.5.1。 - 全部界面图标已内嵌，没有
Icons文件夹或外部 CDN 依赖。 - 内联 JavaScript 已通过语法解析检查。
- VitePress 发布页、下载文件、校验文件和发布清单均纳入站点构建与链接检查。
以上属于发布包的结构与静态验证。最终工程仍需在实际 DTS Explorer、数据集和坐标系下完成运行验收。
已知限制
- 文件夹选择依赖浏览器的
webkitdirectory能力，建议使用 Edge 或 Chrome；其他浏览器的行为可能不同。 - 工具只处理用户主动选择的本地文件，不会自动发现 DTS 工程或修复错误资源路径。
- 合并唯一配置时需要覆盖目标工程中的同类配置，请先保留原始工程备份。
- 这是未签名的 HTML 工具，不包含自动更新；升级时请重新下载并核对版本与 SHA-256。
反馈
如遇到解析失败、坐标系提示异常、合并结果不符合预期或 DTS Explorer 无法打开，请通过顶部“投稿”入口反馈，并附上工具版本、浏览器版本、脱敏后的错误提示和最小复现文件。