更新记录

1.0.0（2026-11-10）

首个版本：照度判定用利用系数法，设计平均照度 = 光通量 × 数量 × 利用系数 × 维护系数 ÷ 面积，反推数量 N = ⌈照度 × 面积 ÷ (光通量 × 利用系数 × 维护系数)⌉；布局按房间长宽比拆行列，列数按「数量 × 长宽比」开方向上取整。均匀度判定用间距高度比 SHR = max(横向间距, 纵向间距) ÷ 灯具到工作面高度，这是照明设计里判断「灯排得稀不稀」的经典工程指标，超参考上限即提示灯间暗区、建议加密。逐点法在工作面 21×21 网格上累加每盏灯直射照度 E = Σ I(θ)·cosθ ÷ d²，配光按光束角 n = ln0.5 ÷ ln(cos(光束角/2)) 简化成 I(θ) = I0·cosⁿθ，I0 = 光通量×(n+1) ÷ 2π，输出平均/最小/最大照度与直射均匀度 U0 作分布参考（只含直射光，不作均匀度判定依据）。内置 12 类场所参考照度/利用系数/最大间距高度比，标注为参考值非标准条文。照度不足给「加几盏或换多大光通量」，间距偏大给「加密布局或换更大光束角」，达标则明确说明。导出「照明方案清单.csv」UTF-8 带 BOM。UTS→Kotlin 编译通过，71 项回归测试全部通过（利用系数法手算、单盏朗伯灯正下方照度 = 光通量 ÷ (π×高度²) 手算对照、光束角反推配光指数、行列布局、间距高度比与双判定边界）；真机未执行（adb devices 为空），市场截图为 H5 渲染并标注示例数据。

平台兼容性

uni-app

照明照度与灯具排布

给灯具厂业务员、照明工程、装修电气设计的离线计算插件：一个房间该装几盏灯、怎么排、平均照度够不够、间距合不合理，现场几秒算完。

不用打开 DIALux 建模、不用联网、不用 IES 文件。输入房间长宽高和用途，插件自动带出该场所的参考照度与利用系数要求；输入单灯光通量、功率、光束角，先用利用系数法反推灯具数量与行列布局，再用间距高度比判断均不均匀，逐项判定并给出「加几盏、换多大光通量、还是加密布局」的具体动作。

能算什么

• 场景要求：内置 12 类常见场所（办公 / 教室 / 商店 / 车间 / 仓库 / 走廊 / 车库 / 住宅等）的参考照度、利用系数与最大间距高度比，选用途即带出，也支持手动覆盖。
• 反推数量：N = ⌈照度 × 面积 ÷ (单灯光通量 × 利用系数 × 维护系数)⌉，再按房间长宽比拆成行列布局与间距。
• 间距高度比判定：SHR = max(横向间距, 纵向间距) ÷ 灯具到工作面高度，超参考上限即提示灯间有暗区、建议加密。
• 逐点照度参考：在工作面上铺网格，逐点累加每盏灯的直射照度，输出平均 / 最小 / 最大照度与直射均匀度 U0，供分布参考。
• 双达标判定：照度够不够用利用系数法、间距合不合理用间距高度比，两件事分开判，逐项给通过 / 不通过。
• 改进建议：照度不足给「加几盏或换多大光通量」，间距偏大给「加密布局或换更大光束角」，达标则明确说明。
• 灯具清单：数量、总功率、总光通量、单位面积功率，可导出 CSV（UTF-8 带 BOM，Excel 直接打开）。

计算口径（务必先读）

• 够不够亮用利用系数法：设计平均照度 = 光通量 × 数量 × 利用系数 × 维护系数 ÷ 面积。利用系数含房间反射与灯具效率，维护系数是灯具光衰留的余量。
• 均不均匀用间距高度比（SHR）：SHR 越大灯排得越稀、灯间暗区越明显。这是照明设计里判断「灯排得稀不稀」的经典工程指标，比直接比较照度更贴合「反推布局」的场景。
• 直射照度与 U0：逐点法 E = Σ I(θ)·cosθ ÷ d²，配光按光束角简化成 I(θ) = I0·cosⁿθ（n = ln0.5 ÷ ln(cos(光束角/2))）。它只算直射光、不含墙面反射，所以算出的 U0 只作分布参考，不作为均匀度判定依据。
• 场景表是常见场所的参考值，不是标准条文。正式设计请以现行 GB 50034 与灯具的 IES 文件在专业软件（DIALux / Relux）里核验。本插件定位是现场快速估算与方案比较，不是认证光度计算。

快速接入

// uni-app（Vue3）中引入
import { lightPlan, lightScenes, lightExport, lightVersion } from '@/uni_modules/szhzy-light-plan'

// 一个 6m×4m、净高 3m 的普通办公室，用 3000 lm / 24 W / 120° 的 LED 面板灯
const r = lightPlan({
  length: 6, width: 4, height: 3,
  useKey: 'office',      // 场景 key，自动带出 300 lx / 利用系数 0.6 / 最大间距高度比 1.2
  flux: 3000, power: 24, beamAngle: 120
})
console.log(r.count, r.rows, r.cols, r.designLux, r.shr, r.pass, r.hint)

API

options 字段：length / width / height（米，必填）、flux（lm，必填）、power（W）、beamAngle（度，默认 120）、useKey（场景 key，可选）、lux / maxShr（显式覆盖场景默认值）、uf / mf（利用系数 / 维护系数，可选）、rows / cols（同时传且 >0 则跳过反推，按该布局直接算）。

所有 API 返回统一信封 { ok, code, message, ... }，不抛异常；失败时 ok=false 且 code 说明原因。

购买前必读

• 仅支持 Android。iOS / 鸿蒙 / 小程序 / Web 均未实现，本插件不包含这些平台。
• 真机链路未验证：本插件完成了 UTS→Kotlin 编译校验与核心逻辑自动化测试，但尚未在真实 Android 设备上跑通完整链路（真机截图亦未完成）。请在你的项目里先做一轮真机验收再用于生产。
• 逐点法为简化配光模型（cosⁿ），不含墙面反射与 IES 实测配光，结果用于规划估算；需要出盖章光度报告的场景请走专业软件。
• 纯本地计算，不联网、不上传、不采集任何数据，零系统权限。

验证状态

• 编译：compiled successfully，UTS→Kotlin 产物已确认存在。
• 逻辑测试：核心逻辑自动化测试通过（利用系数法手算对照、逐点法单灯正下方照度手算对照、光束角反推配光指数、行列布局、间距高度比与双达标判定边界）。
• 真机：未验证（无可用 Android 设备）。
• 截图：H5 渲染截图（非真机）。