事故现场图绘制组件

完全离线，数据不出门

以 WebAssembly 形式交付，全部运算在客户自有服务器上完成，不依赖任何外部云端接口。事故现场图像与案件数据全程留在客户内网， 断网环境同样可用，满足公安、保险等行业对数据本地化的合规要求。

私有化部署，兼容信创生态

提供 Linux 平台可执行程序，一条命令启动服务，不依赖容器或额外中间件。

• 兼容主流操作系统：Ubuntu 20.04 / 22.04 LTS、麒麟 OS V10、统信 UOS、深度 Deepin
• 支持 x86_64（含兆芯等国产 x86 平台）及 ARM64（鲲鹏、飞腾等）架构
• 部署到客户自有物理机或内网服务器，无订阅云服务，无使用量上报
• License 与服务器硬件绑定，授权可精确控制到机器级别
• 无需安装任何运行时环境（无需 JDK、Python、Node.js 等），解压即可运行；资源占用极低，现有服务器通常无需升级即可直接部署

集成只需三步

<!-- 直连模式（无 nginx）：src 指向 HandyService Browser Port -->
<!-- 代理模式（nginx HTTPS）：src 改为 "https://your-domain/handydoc/HandyDoc.html" -->
<script>
  window.HD_HOST_OPTS = {
    src:      "http://your-server:8787/HandyDoc.html",
    tokenApi: "/api/hd-token"
  };
</script>

<iframe id="hd-frame"
  allow="clipboard-read; clipboard-write; storage-access"
  referrerpolicy="strict-origin-when-cross-origin">
</iframe>

<script src="/assets/handydoc-host.js"></script>

<script>
  hdWhenNativeReady().then(async () => {
    await hdInit("case-20250101-001");
  });
</script>

不需要修改现有后端框架，不引入新的前端依赖，现有任意技术栈均可接入（Vue、React、原生 HTML 均可）。

主要功能

事故现场图绘制

内置专业绘图工具，支持道路、车辆、标注等元素

AI 交通元素识别

对导入的现场照片进行 AI 分析，自动定位车辆、道路标线等交通元素位置，辅助快速完成现场图绘制

现场照片导入

从本地或程序传入照片，作为绘图底图

图表导出

导出 JPG 图片，支持竖版 / 横版 / 实景记录 / 实景俯瞰多种格式

案件数据管理

读写事故时间、地点、天气、勘查员等结构化字段

数据包导入导出

完整案件数据以 ZIP 格式导出 / 导入，支持跨设备迁移

UI 定制

可控制标题栏、导入按钮的显示，融入集成方界面风格

安全机制

部署架构

集成方服务器（客户内网）
  ├── HandyService（单进程，无外部依赖）
  │     ├── :8787  浏览器业务口（托管 WASM 页面）
  │     └── :8788  Token 口（仅集成商后端可访问）
  │
  ├── 集成方后端（已有系统）
  │     └── /api/hd-token  → 代理转发至 :8788
  │
  └── 浏览器
        └── iframe 加载 HandyDoc WASM → 与 :8787 通信

适用场景

技术规格

服务语言

Rust（单进程，无运行时依赖）

前端交付

WebAssembly，运行于标准浏览器，无需插件

支持平台

Linux x86_64 / ARM64；Ubuntu 20.04 / 22.04 LTS、麒麟 OS V10、统信 UOS、深度 Deepin 等

硬件要求

物理 TPM 2.0 芯片

网络要求

内网即可，无需访问公网

浏览器支持

Chrome 90+ / Edge 90+（推荐，完整 WebGPU 支持）；Firefox 120+（WebGPU）；Firefox 89–119 可运行但 AI 识别功能降级为 CPU 模式

集成方式

iframe + JS 宿主脚本，与宿主页完全解耦

服务器配置参考

绘图计算全部在用户浏览器端完成，服务器主要承担静态文件托管与会话管理，资源消耗较低。 以下为按并发会话数划分的推荐配置（基于 Ubuntu 22.04，仅 HandyService）。

并发会话以 License 授权的 max_concurrency 为上限；若与其他业务系统合并部署，建议在上述配置基础上适当提升内存。