枚举文件存储设备号#

验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14

用途与场景#

枚举中心文件存储区 files/device/ 下已有的设备号目录。当前 Web 的共享「设备号选择器」在展开时调用本操作，供「设备文件备份」等页面选择设备。它与设备资产库（票 10 的 data-acquisition-device 表）无外键关系——只反映文件系统现有目录，无目录的设备不会出现。

使用位置#

页面/功能	角色或空间分支
设备号选择器展开时拉取（共享组件）	登录用户
消费页面（设备文件备份）（filter 表单设备号源）	登录用户

端点#

GET /main-service/main-api/v1/general/device/data-acquisition-device/listDeviceNos — 枚举中心文件存储区 files/device/ 下已有的设备号目录。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 device · v1-general 通用接口（v1）；业务语义（wire 惯例、限频、租户声明等）见设备业务 · v1-general 通用接口（v1）。

动线与完成判据#

status=200 且 data 数组可消费即读取结束；[] 为成功空态。Web 选择器在展开时拉取并本地过滤（fetchOn: "open"、filterLocally）。数据范围是服务器本地文件系统全量目录，不受租户拦截器约束（非数据库资源，见业务页）；结果有服务端 3 秒缓存。

错误与边界#

认证失败。目录扫描 IO 异常被捕获记日志并以已收集列表返回，不报错。读取无副作用，可重试。

调用关系与资源清理#

无长连接资源。选中的设备号供按设备与类型列出设备文件使用。

已知缺口#

3 秒缓存窗口内的可见性延迟为已核实现行行为；目录与设备资产库（票 10）的对应关系无服务端校验——目录名可含任意白名单字符串，未与设备表比对；文件系统扫描在大量目录下的性能未核验。