01-现场成图的定位与价值-机房工勘

从「回来补图」到「现场成图」：nVisual DCDesigner 在机房工勘与机房设计中的定位与价值

摘要：机房工勘的信息要在现场与办公室之间搬运两次------现场到纸、纸到 CAD，每搬一次丢一层精度。nVisual DCDesigner（机房工勘记录器，idc-2d-modeler）把这件事改成「现场边量边画、一次成型」：按毫米实测建模、规则内建的布局、交付前自检、一份数据多路输出。本文给出它的整体定位、能力全景与三类角色视角下的价值，并明确它不替代什么。

一、机房工勘的老问题：信息被搬运了两次

机房工勘的现场工作，通常是这样的：卷尺量完，记在纸上或手机备忘录里；回到办公室，再照着记录在 CAD 里描一遍。

这个过程里，信息被搬运了两次：

现场 → 纸：记录时省字。写「1.2 米」而不是 1200mm，勾一个「约 40 台」而不是逐台编号；
纸 → CAD：转录时靠记忆补全。通道哪条宽记不清、机柜正面朝哪边记不清、某排离墙多少记不清。

两次搬运叠加的结果，是交付出去的图纸只能算「示意图」：尺寸经不起追问，编号可能串排，冷热通道可能画反。而工勘图的用途恰恰是被追问------甲方要核对、施工要照着放设备、后续运维要按图找资产。图上的每一处不确定，都会在某个环节变成返工。

DCDesigner 的出发点很朴素：把「记录---转录---出图」压成一步，让信息在现场一次成型。实测尺寸直接变成建模输入，规则判断交给软件，图纸从输入的那一刻起就是精确的。

二、DCDesigner 是什么：一句话定位与三个设计立场

2.1 一句话定位

DCDesigner 是一个零依赖、免安装的机房工勘记录工具：按工勘思维引导，把现场机房平面按实测尺寸精准记录下来，并在此基础上完成布局校核、合规自检与成果交付。后端有两个等价实现------Go 单文件可执行程序（静态资源内嵌，双击即用）或零依赖 Node.js（无需 npm install），前端是原生 HTML5 Canvas（无需构建）。

「记录器」这个自我定位很重要：它的主场是工勘与平面布置，DXF 输出是 1:1 毫米图、可以进 CAD 继续深化，而不是要替代 CAD 做施工图设计。

2.2 三个设计立场

立场一：数据是唯一事实来源。 平面图、3D 预览、DXF 图纸、CSV 工程量清单、合规校验报告、提交到平台的成果包，全部由同一份项目数据派生。不存在「图上一套、表里一套」的可能------因为根本只有一套。现场改一次，改的是数据，下次导出即同步。

立场二：工程规则内建，而不是靠人记。 冷通道是两排机柜正面相对、热通道是背面相对；封闭通道的端门有几种形态；实体设备之间不允许重叠；改通道宽时机柜应该跟着走------这些在传统流程里靠师傅口口相传、靠画图人自己记得住的约定，在这里由软件执行与检查。

立场三：本地优先、数据主权清晰。 项目以 JSON 文件保存在本机（或程序旁 data/ 目录），通过系统文件对话框存取；AI 功能使用用户自己的 API Key，只存在浏览器 localStorage，服务端只做无状态转发、不落盘不记日志；平台回传经本机服务代理。对内外网隔离、数据不便出内网的机房项目，这一条往往比功能多少更重要。

三、能力全景：从现场采集到平台回传的一条线

把能力按工程阶段组织，可以得到这样一张全景表：

阶段

能力

关键机制

现场采集

四步工勘向导（量房间→记机柜→记桥架→核对保存）

实测内空长宽+墙厚生成房间；排数驱动 POD 批量生成；编号模板自动递增；向导步骤随刷新保持

精确录入

毫米级坐标与尺寸可溯源

西南角内表面为原点、X 东 Y 北；画墙/桥架可键盘输入实测长度回车；100mm 捕捉 + 600mm 模数网格；实时净距与墙距标尺

布局设计

规则化排布与批量操作

冷热通道自动交替；实体互斥推挤；通道宽联动整排；格式刷、六向对齐、多选拖动/复制

校核

合规自检与实时布局检查

20 条规则 / 7 大类；阈值可配置；问题点击定位；编辑落定后自动复跑重叠与越界

交付

四类交付物

2D 全景 PNG（8192px 基准）、DXF 图纸（17 图层、1:1 毫米）、CSV 清单（汇总+明细）、3D 全景导出

协同与沉淀

AI 建模、Agent 接口、平台回传

自然语言生成/改图；22 条指令契约；一键提交 nVisual Studio 资源库

工程化

单文件、离线、多语言、安全发布

Windows/macOS/Linux 六个平台产物；中文/英文/阿拉伯语/西班牙语；可选资源加密+离线授权

这张表里最值得注意的是闭环：现场采集的数据，不需要在中间换任何一次载体，就能一路走到校核、导出和平台入库。每一次转换都只是同一份数据的重新表达，而不是信息的重新录入。

四、对不同角色的价值

4.1 工勘与施工：图纸在现场就成型

对做工勘的人，价值体现在三个「不用」：

不用回来补参数：向导第 4 步会自动统计墙体段数、门窗樘数、机柜台数与总功率，对着现场照片核一遍即可保存；
不用重复录入：编号模板（如 A##、101-A##）自动递增，POD 批量生成的机柜带统一属性和通道宽，格式刷可把一台机柜的电气配置刷给整排；
不用怕记错规则：冷热通道关系、封闭通道端门、柜间距与通道宽由软件按输入参数计算，画反、串排这类「经典错误」被结构性地消掉。

现场允许联网就直接用在线版，不允许联网就用单文件离线版，数据都留在本机。

4.2 设计与售前：方案调整的边际成本很低

机房设计早期最频繁的动作是「改」：通道加宽 200mm、某排从 12 台改 14 台、把几台机柜换成列间空调、加一条桥架。在 DCDesigner 里：

改通道宽，西/南侧排锚定不动、远侧整排自动平移，多排 POD 级联跟随，通道带自身同步伸缩；
机柜可以右键原位替换为柱子/列间空调/列头柜，也可以反向替换回机柜，替换后按排位置重排编号（保留排号与前后缀）；
删除机柜后可用「检测空位补插」按剩余机柜最窄间距外推缺失槽位，虚线预览后一键补插。

改完立即能出 2D 全景图和 3D 效果图------3D 支持实景与素模（BIM）两种风格，素模带构件轮廓线、按专业族分色，适合方案汇报场景。

4.3 交付与运维：成果可核、可查、可入库

交付环节最容易被打回的是「对不上」和「算不清」。对应地：

对得上：所有尺寸按真实毫米建模，DXF 是 1:1 毫米图，坐标与画布一致（西南角原点）；
算得清：CSV 清单分工程信息、工程量汇总、设备明细三部分，机柜/列头柜/UPS/蓄电池/灭火器/空调/风口逐台列出，可溯源；
查得到：项目 JSON 结构化保存勘测人、日期、园区楼宇、层高、供电容量、制冷架构等信息，图纸导出自动带落款；
进得去平台：顶栏「提交 nVisual Studio」把工勘 JSON 一键回传资源库，平台按机柜 U/宽深高匹配型号并还原对象，本地成果变成长期资产。

五、它不是什么：边界与误用提醒

可信的工具介绍必须说清楚边界：

不是 CAD 替代品。它输出 1:1 毫米 DXF，供 CAD 继续深化；但复杂施工详图、节点大样、结构计算不在能力范围内。
不构成规范符合性结论。合规自检的 20 条规则全部使用可配置的经验阈值（默认值如柜前 900mm、柜后 600mm、冷通道 1200mm、热通道 900mm），报告页脚明确注明「阈值为经验参考值，不构成规范符合性结论」；规则代码只做比较，不把规范解读硬编码进判断逻辑。
3D 是只读查看器。3D 视图用于空间校核与汇报，不可编辑；所有编辑仍在 2D 完成，3D 由 2D 数据派生。
多人共用一套服务端有已知风险。手工编辑互不影响，但 AI 指令中继是全局单队列单活动页面，data/*.json 是共享命名空间（同名项目会互相覆盖、无鉴权）。项目文档给出了完整的风险分析、适用场景判定与三种隔离方案；对 AI 有多人并发需求的团队，建议每人一套服务。
它是记录器，不是决策者。制冷量够不够、UPS 冗余是否合理，工具能提示、能自检、能把问题定位到对象，但最终判断仍应由设计与专业审核完成。

六、结论：工勘工具的价值判据

评价一款机房工勘工具，可以问四个问题：

现场量到的数字，有没有被完整、无损地带到图纸上？
图纸上的每个尺寸，能不能被追问、被定位、被复算？
改一次设计，有多少地方需要人工同步？
交付出去的东西，能不能不返工地进入下一环节（CAD、算量、资源库）？

DCDesigner 的设计几乎都在回答这四个问题：毫米级实测建模解决第一个，坐标系与标尺体系解决第二个，单一数据源与规则内建解决第三个，四类交付物与平台回传解决第四个。

它不是功能最多的工具，但在「机房工勘记录」这件事上，功能密度与流程贴合度是它最有说服力的部分。

附：事实来源与核验方式

定位、设计立场、能力全景、边界条款：README.md（「工勘思维设计」「建模对象」「合规自检与校验报告」「提交到 nVisual Studio」「运行方法」等节）
工具自带四种语言：public/js/i18n/；版本与发布日期：public/version.json、latest.js（当前 1.12.0 / 2026-10-09）
单文件与零依赖：main.go（//go:embed 内嵌资源）、server.js、package.json
合规阈值默认值：public/js/checks.js 的 DEFAULT_CFG
多人共用服务端的风险与隔离方案：README.md「多终端/服务器部署注意」（含风险清单、场景判定与三种隔离方案）、tests/agent-multiuser.test.mjs
可复现核验（仓库根目录执行）：

npm test # 纯逻辑单测（编号/导出/自检/AI/平台回传等） npm start # 方式二：Node 版启动，浏览器打开 http://localhost:3999

本系列其余 9 篇分别从工勘向导、尺寸可信度、数据模型、布局自动化、3D 校核、合规自检、交付物、AI 分工、平台闭环等角度展开，索引见同目录 README.md。