线损分摊核对 PerryLink/dsh-power-loss-split

dsh-power-loss-split — 线损电量拆分与考核表校验

dsh-power-loss-split 读取一条线路或一台配变在某一个抄表周期内的数据——供电量、售电量、填报的线损电量和线损率，以及资料里带上来的计量点清单——然后对这些资料做算术和区间校验：电量平衡、线损率、计量点求和、你配置的线损率区间、三相不平衡。每条结论都带上它用到的数字和容差，方便复核的人自己再算一遍；凡是没能跑起来的校验，都会列进 skipped，不会悄悄放过。

它能回答什么

| 你问 | 它答什么 |
| 填报的线损电量和供电量 − 售电量对不上。三个数里哪个错了？ | PL-001 不会说。它报出差额——供电量 1000 kWh − 售电量 900 kWh = 100 kWh，与填报的线损电量 50 kWh 相差 50 kWh——再拿它和容差 toleranceKwh 比。这个容差默认是 0，所以三个数必须完全一致（报表以万 kWh 为单位时，四舍五入的差会留下来，所以要配一个非零容差）。这条规则只做减法：它不判断三个数里哪个对，也不检查读数是不是同一周期（抄表同期性）。 |
| 线损率填的是 5.00%，可线损电量 ÷ 供电量算出来是 6.25%。是分母有问题吗？ | PL-002 把除法摆出来：它算线损电量 ÷ 供电量 × 100，报出与填报线损率的差额，单位是百分点，并允许 tolerancePoints 0.01 个百分点用于四舍五入——四舍五入规则本身另有出处，来自 GB/T 8170-2008，本包同样没有它的原文。它不判断分母的口径对不对（口径，比如无损电量该不该扣掉）：这得在资料里写明，或者配置进去。 |
| 我们这条线的线损率我看着偏高。工具会报吗？ | 单靠它不会。PL-003 只拿线损率和你配置的区间（minRate / maxRate）比；两者默认都是 0，也就是没配置，这时这条规则会连同原因列进 skipped，不会悄悄放过。就算配了，它的级别上限也是 info：命中只说明线损率落在你设的区间之外，不代表线损异常。考核指标由你所在单位按线路、按年度下达，所以没有硬编码任何指标值。 |
| 计量点清单加起来比填报的售电量少。是漏了某个计量点吗？ | PL-004 只报差额，别的不管：它把带电量值的计量点加起来，再和填报的售电量比——没给售电量时就和供电量比——允许 toleranceKwh（默认 0）。漏掉一个计量点、重复计了一个、读数抄在不同时间（抄表不同期），产生的差额都一样，所以原因得手工查；这条规则只做加法。 |
| 表格里只有 A 相和 B 相的数值。不平衡校验会做什么？ | PL-005 会把自己列进 skipped：它需要名为 A、B、C 的计量点，相位数少于三个就跑不起来。就算三个都齐了，限值 maxUnbalancePercent 出厂时也没配置（0），规则会再次进入 skipped。你一旦设了限值，它就计算（最大值 − 最小值）÷ 最大值，把这条公式连同发现一起打印出来，并且最高只到 info —— 它不判断不平衡是否构成缺陷。 |

遵循的标准

| 文档 | 编号 | 引用它的规则 |
| 《电力网电能损耗计算导则》 | DL/T 686-2018 | PL-001, PL-002, PL-003, PL-004, PL-005 |
| 《数值修约规则与极限数值的表示和判定》 | GB/T 8170-2008 | PL-002 |

边界： 这个插件对单个计量周期的线损数据做算术与区间校验 —— 电量平衡、线损率、电表清单求和、相不平衡 —— 并在每条发现里展示计算过程。它不是计量工具，也不是计量故障工具（没有探针，没有 AMI 集成，没有硬件模型），也不判断某个线损数值是否合理、是否发生了篡改。它读取电子表格导出文件，报告哪些求和不闭合。

⚠️ 在相信报告里的引文之前，请先读这段

这个插件规则包里的每一条 excerpt 都明说了：没有拿到条款原文。 插件校验的两条关系 —— 线损电量 = 供电量 − 售电量 和 线损率 = 线损电量 ÷ 供电量 × 100 —— 是定义性的，其规范出处是 DL/T 686-2018《电力网电能损耗计算导则》。该标准现行有效，目录也已核实（第 3 章是术语和定义，第 8 章是电力网电能损耗分析与降损措施效果计算），但正文没有免费公开，所以读不到任何逐字条款。

与其转述一段引文，这个规则包选择在 excerpt 字段里直接说明这一缺口，把诚实的推理写进 note。因此所有内容最高只到 warn（由原理推导）或 info（本地配置）。有测试断言：没有任何规则声称自己拥有并不存在的引文。拿到标准正文后，必须做两件事：把每条 excerpt 换成真实条款，并把 kind 提升为 direct。 在那之前，一条发现的意思是「这两个数不闭合」，而不是「你违反了标准」。

评定阈值是你的，不是标准的。 线损目标由企业或其上级按线路、按年度下达，所以 PL-003 的区间和 PL-005 的不平衡限值出厂时都是空的，跑不起来的规则会在 skipped 里说明，而不是悄悄通过。

兼容性

| 层面 | 状态 |
| Harness | 对等范围 >=0.1.2-rc.1 <0.2.0 \|\| >=0.2.0-0 <0.3.0 —— 已验证同时接受 0.2.0-rc.2 和 0.2.1-alpha.1。engines.dsh 故意不声明：它没有读取方，也无法拒绝宿主 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全部（纯 ESM；无原生代码，无网络，无模型调用） |
| 工具模式 | 在 native、ptc 和 both 下都能用；按周期批量处理时用 ptc |

功能说明

注册 power_loss_split 工具。读取某一周期的数据——供电量、售电量、填报线损、填报线损率，以及可选的表计清单——套用带版本号的规则包，返回报告。

| 规则 | 检查内容 | 严重级别 | 依据类型 |
| PL-001 | 供电量 − 售电量 = 线损电量 | warn | principle |
| PL-002 | 线损电量 ÷ 供电量 × 100 = 线损率 | warn | principle |
| PL-003 | 线损率落在你配置的区间内（默认关闭） | info | local |
| PL-004 | 表计清单合计等于填报售电量（或供电量） | warn | principle |
| PL-005 | 三相不平衡度在你配置的限值内（默认关闭） | info | local |

发现项始终带上数字：供电量 1000 kWh − 售电量 900 kWh = 100 kWh，与填报的线损电量 50 kWh 相差 50 kWh。审核人如果没法自己重算一遍，就判断不了这条发现项，所以算式直接写进文本里。

安装

dsh plugin --profile <name> add dsh-power-loss-split
dsh --profile <name> --dump-config | grep 'dsh-power-loss-split'

配置

| 键 | 类型 | 默认值 | 说明 |
| rulesFile | string | rules/power-loss-split.yaml | 规则包路径，相对于包根目录 |
| disabledRules | string[] | [] | 要停止运行的规则 id；每个都会出现在 skipped 里 |
| onlyRules | string[] | [] | 只运行这些规则 id；留空则运行全部规则 |
| skipNotes | string | "" | 附加到每条 skipped 原因后面的备注 |
| timeoutMs | number | 120000 | 协作式工具超时预算 |

几个值得了解的规则级参数：

- PL-001 / PL-004 的 toleranceKwh —— 允许的舍入余量。取零要求完全相等；数据以万 kWh 填报、带有舍入时，就该设置它。
- PL-002 的 tolerancePoints —— 以百分点计的余量，默认 0.01。
- PL-003 的 minRate / maxRate —— 你今年给这条线路定的评估区间。maxRate 取 0 表示该规则不运行。
- PL-005 的 maxUnbalancePercent —— 你给这个电压等级定的不平衡度限值。取 0 表示该规则不运行。

素材格式

工具接受 JSON 或 YAML：

name: 10kV 某某线 supplied: 120000 # 供电量 kWh sold: 114000 # 售电量 kWh loss: 6000 # 线损电量 kWh lossRate: 5 # 线损率 % meters:
- { 名称: 1号配变, 电量: 60000 }
- { 名称: 2号配变, 电量: 54000 }
- { 名称: A, 电量: 100 } # A/B/C rows drive PL-005
- { 名称: B, 电量: 98 }
- { 名称: C, 电量: 96 }

数字也能从字符串里读出来，所以表格导出的内容可以直接用：1,200.5、1200 kWh、全角数字 １２３４、5% 和 12.5万 都能解析。不是数字的单元格（—、空白）直接视为缺失，受影响的检查会报告它没能做什么。

规则来源

规则数据放在 rules/power-loss-split.yaml。规则包的头部完整说明了引用依据的缺口，每条规则的 note 重复其中对该规则重要的部分。加载时的守卫通常强制要求「摘录必须是至少八个字符的真实引用」，却分不清引用和描述——所以这个包靠头部、每条规则的说明，以及一个测试来兜底：断言每个 excerpt 都承认这段间隔。

属于企业版的阈值故意留空。阈值未设置的规则会在 skipped 里报告自己，这样「没有发现」就绝不会悄悄变成「什么都没检查」。

故障排查

- 某条发现说合计对不上，但表格看着没问题。 对比计算周期：抄表日期和供电量数字的日期不一致，产生的正是这个差异。插件只报告这段间隔，它看不到你的抄表日历。
- PL-002 在某个看起来正确的费率上触发。 分母取的是供电量。如果你的数字用了别的基数（比如扣除未变压电量的供电量），那是申报范围的问题，不是算术问题——在材料里给出范围，或者禁用这条规则。
- PL-003 或 PL-005 从不运行。 它们的阈值为空。设置这条线路的考核区间和这个电压等级的不平衡限值。
- 插件装上了，但工具一直不出现。 检查 main 是否指向 lib/index.mjs，以及 pnpm run build 是否生成了它；main 写错会让加载器静默跳过入口。
- dsh plugin add 以不兼容为由拒绝这个包。 peer 范围覆盖 0.1.x 和 0.2.x；如果你的运行时不在其中，显式授予豁免： dsh plugin --profile <name> allow-version dsh-power-loss-split@0.1.0 --dsh-version <runtime> --accept-risk
- check 报告 manifest-peers 失败。 静态检查器比对的是一个硬编码的 peer 范围，早于 0.2 系列。运行时在安装时强制校验 peer 兼容性，所以声明的范围才是正确的；这是 dsh-plugin-dev 里已知的上游问题。

开发

pnpm install
pnpm run typecheck # tsc --noEmit
pnpm test # vitest, paired fixtures per rule
pnpm run build # tsdown -> lib/index.mjs + lib/index.d.mts
node ../scripts/sync-shared.mjs dsh-power-loss-split # refresh src/shared from ../_shared

许可证

Apache License 2.0 © 2026 dsh-power-loss-split contributors。