
3 分钟上手 kkFileView浏览器里看 CAD、画批注的完整流程【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileViewkkFileView 是一款基于 Spring-Boot 的通用文件在线预览项目。把一份 DWG 图纸丢给它你在浏览器里就能打开它并且直接在图纸上手绘批注——不用装任何 CAD 软件。下面按先看效果、再三步跑起来、最后调配置和避坑的顺序讲清楚整个流程。一、图纸在浏览器里变成什么转换链路很短记住三句话就够kkFileView 收到 DWG、DXF 等 CAD 文件后由后端转换引擎默认 aspose-cad也可切到 cadviewer把它转成SVG 或 PDF转换结果缓存在本地前端用矢量方式渲染 SVG随便放大缩小线条都不糊转成 PDF 后走 PDF.js 渲染打印、缩放都很方便批注层叠加在预览之上你画完标记后保存成批注文件下次打开同一张图可以重新加载不用把图导出再改。下面是图纸在线渲染后的实际效果二、三步把预览和批注跑起来1. 启动 kkFileView 服务源码获取git clone https://gitcode.com/GitHub_Trending/kk/kkFileView按 README.cn.md 里的说明构建启动默认服务端口是8012。部署时想改参数直接设环境变量即可比如KK_CAD_PREVIEW_TYPE、KK_CAD_TIMEOUT、KK_CAD_THREAD不用动代码。2. 上传 CAD 文件触发转换打开首页上传一份 DWG后端会异步转换默认5 个线程、90 秒超时对应cad.thread和cad.timeout两个配置项后面详述。大图纸转换要等一会超时会直接失败所以大文件场景建议先把超时调大。3. 打开预览页开始手绘批注点进预览页顶部工具栏里找到红线圈选、箭头、便利贴一类的标记工具直接在图纸上画。画完点保存批注生成批注文件下次打开同一张图用加载批注就能把上一轮标记恢复出来。整个协作闭环是画 → 存 → 分享链接 → 对方加载。三、CAD 预览模式怎么选、超时怎么设真正需要动的配置只有三行都在 server/src/main/config/application.propertiescad.preview.type ${KK_CAD_PREVIEW_TYPE:svg} cad.thread ${KK_CAD_THREAD:5} cad.timeout ${KK_CAD_TIMEOUT:90}配置默认值作用cad.preview.typesvg选svg缩放不糊、批注跟手选pdf便于打印和正式交付标注cad.thread5同时转换的图纸数服务器弱就调小cad.timeout90秒单张图纸的转换超时大图纸调大选型经验日常看图、随手批注用svg要给客户打印签字版用pdf。这两项支持动态生效改完不用重启。四、两种转换引擎怎么切cad.conversionmodule决定后端用哪套引擎1默认aspose-cad内置开箱即用支持 dwg/dxf/dwf/iges/igs/dwt/dng/ifc/stl/plt 等最多格式但吃服务器性能2cadviewer 引擎支持的格式偏少dwg/dxf/dwf对服务器压力小需要自行下载转换包并配好cad.cadconverterpathLinux 下注意目录大小写和字体字体放到cad.file.path下的fonts目录。切完引擎记得重启这类基础配置不属于动态生效范围。五、上线前容易踩的 4 个坑 ⚠️许可证问题开源集成的是 aspose-cad 测试版本商用请自行购买授权README 里有明确说明大图纸超时默认 90 秒建筑总图、机电综合图很容易超cad.timeout按实测往上调批注文件在服务器本地画完的批注跟着文件存在服务器目录里和file.dir目录一起定期备份别只备份数据库敏感图纸需要外发时开启水印cad.watermark同目录里的watermark.*控制文字、透明度、间距。六、快速回顾清单✅ 预览模式看图用svg打印交付用pdf✅ 转换引擎默认 aspose-cad 最省事服务器吃紧再评估 cadviewer✅ 上线前确认授权、调大cad.timeout、批注和文件目录一起备份。现在打开 README.cn.md 按构建说明把服务拉起来上传一份 DWG10 分钟内你就能在浏览器里画出第一笔批注。【免费下载链接】kkFileViewUniversal File Online Preview Project based on Spring-Boot项目地址: https://gitcode.com/GitHub_Trending/kk/kkFileView创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考