feat(dsh): spawn_teammate 角色 persona 自动注入 + 测频带外饱和边界登记
CI / 静态门禁 (pre-commit) (push) Failing after 3m46s
CI / 主机侧单测 (MSVC) (push) Successful in 30s

一、子 Agent 角色自动注入(本批主线)

dsh-plugin-subagent-roles fork(仓库 .dsh/plugins/)新增事件路径注入:
spawn_teammate 的 prompt 首行写 @role:<角色id>,插件在子会话首轮模型
请求组装之前把 .dsh/roles/<id>.md 的 persona 注入其系统提示词,并应用
工具白名单。此前只有 subagent_role 路径自动注入,team 路径需 Lead 手工
拼接 persona,本批把两条路径拉齐。

实现要点(细节见 docs/环境与部署/子Agent角色自动注入实现说明.md):
- 在 lead 会话的 tool/call(spawn_teammate) 截获 @role 标记,在
  subagent/catalog 拿 childId 后经 agents.get(childId) 注入——子会话侧
  user/message 必然晚于首轮 system/message,只能在 lead 侧接力。
- tools.restrict() 只校验全局工具名,ops_* 等作用域工具混入会整批抛错;
  降级为解析报错尾部 known global tools 求交集后重试。
- 保留子会话 @role 标记兜底路径(第 2 步起生效)+ 双去重集合。
- 诊断日志 ~/.dsh/role-inject-diag.log,一次健康注入 4 行。

配套文档与口径:
- 新增 docs/环境与部署/子Agent角色自动注入实现说明.md(实现参考 +
  排障速查,9 章),docs/README.md 索引挂载。
- AGENTS.md 委派策略改为自动注入口径(无需手工拼接)。
- .dsh/roles/README.md 删去"调用预算"列:budget.js 的 arm() 只由
  subagent_role 委派路径调用,teammate 路径不挂账,原列是假上限承诺;
  改加脚注指向实现说明 §1.1。

二、测频幅值门放宽至 5 V + 带外饱和边界登记(freq.h)

- FREQ_AMP_MIN 50 V -> 5 V(用户裁定 2026-11-13):台架低端注入(标定
  用 5~25 V 档)与低负荷工况也能测频;浮空二次域噪声几十 mV,仍差两个
  数量级,噪声不测频的本意不变。
- 注释同步登记:IA 回退候选同拿 5.0 比较,二次电流 0.5~2 A 够不到
  "5 A",只注电流实际不回退测频(电流域门限另裁);窗环钳位区间
  [72,96] 只对 41.7~55.6 Hz 满足整倍条件,带外读数饱和钉沿。
- docs/算法/采集与算法层设计说明.md 新增 §7.3 准确测频带与带外饱和
  (60 Hz 实证钉 ~55;用户裁定不改参数,只登记边界)。

验证:/keil-build 0 错误 0 警告(Code=256592 RO=32036 RW=2088
ZI=152584);pre-commit 52 钩子全绿(含 3 根 manual 阶段:cppcheck、
test-cppcheck、test-coverage)。
This commit is contained in:
2026-11-14 10:07:27 +08:00
parent e00531999d
commit 9f68b7bc03
6 changed files with 334 additions and 33 deletions
+24 -12
View File
@@ -19,7 +19,8 @@
* 跳变假值,本拍不入窗;
* - 幅值门:源相量有效值 < FREQ_AMP_MIN 判"无有效波形"(浮空输入/PT 断线),
* 停止更新、valid 清零、读数保持 → 台架浮空 rms≈0 不发散;
* - 信号源优先级:UA 基波 → IA 基波(UA 无幅值时用 IA,台架只注电流亦可测频)。
* - 信号源优先级:UA 基波 → IA 基波(UA 无幅值时用 IA;工程量域下 IA 候选
* 需二次电流达到门限数值,见 FREQ_AMP_MIN 注释)。
*
* ⚠ 本层**纯算法**:不碰寄存器、不碰 RTOS、不自己取数(输入 = phasor 使用区)
* → 主机侧可免桩纯逻辑单测。
@@ -28,6 +29,11 @@
* 创建日期:2026-10-12(B8)
* 修改记录:
* v1.0 2026-10-12 DTU 项目组 创建:相位解缠绕测频 + 滑动平均 + 幅值门
* v1.1 2026-11-13 DTU 项目组 幅值门 50 V → 5 V(用户裁定,台架低端注入
* 也能测频);其余判据不变
* v1.2 2026-11-13 DTU 项目组 纯注释:登记窗环钳位区间的带外饱和边界
* (60 Hz 实证钉 ~55;算法与参数不改,
* 设计说明 §7.3)
*/
#ifndef FREQ_H
@@ -50,22 +56,28 @@
#define FREQ_INST_MIN_HZ 35.0f
#define FREQ_INST_MAX_HZ 65.0f
/* 幅值门限(有效值,**二次值 V 口径**,下游常数按工程量重定的结果,依据
/* 幅值门限(有效值,**二次值 V 口径**,依据
* `docs/算法/采集与算法层设计说明.md` §13.7 表第 1 行):
* 低于该值判"无有效波形"。取值 50 V = 0.5×Un(相电压标称 100 V,与
* App/algo/prot_set.c 头部量纲基准同源):正常带载 UA 在 0.9~1.1×Un,
* 50 V 之下只可能是断保险/PT 空载/浮空噪声(浮空实测 ~1.7 V 引脚域、
* 二次域更小),不会吃掉正常纹波(纹波谷值远大于 0.5×Un)。
* ⚠ 过渡期行为(eng=0,两点标定完成前):帧值还是引脚电压(≤5 V < 50 V),
* 本门**恒失效** → freq_valid()=0 → OF/UF 按"必不启动"填充复位——与未标定即闭锁
* 同向(判据链本就停走),不构成额外风险;标定后自动恢复本意。
* 数值沿用原 50.0f 属巧合(原为"远小于千级码值"的拟定值),不是漏改。 */
#define FREQ_AMP_MIN 50.0f
* 低于该值判"无有效波形"。取值 5 V = 0.05×Un(相电压标称 100 V,与
* App/algo/prot_set.c 头部量纲基准同源):2026-10-25 曾按工程量重定为
* 50 V = 0.5×Un,2026-11-13 用户裁定放宽到 5 V,让台架低端注入(标定用
* 5~25 V 档)与低负荷工况也能测频;浮空噪声实测二次域几十 mV,仍差两个
* 数量级 → "噪声不测频"的本意不变,带载 UA(0.9~1.1×Un)远在门上。
* ⚠ 候选共用数值:IA 回退候选同拿 5.0 比较——二次电流域 0.5~2 A 够不到
* "5 A",台架只注电流实际不回退测频;电流域自己的门限另裁,勿在此顺改。
* ⚠ eng=0 期间(未标定,帧值还是引脚电压,满幅 < 3.3 V)仍低于本门 →
* freq_valid()=0 → OF/UF 按"必不启动"填充复位——与未标定即闭锁同向;
* 标定(eng=1)后按本门限正常放行。 */
#define FREQ_AMP_MIN 5.0f
/* 相位增量滑窗环容量(拍):96 拍 = 96 ms 上限。实际平均窗长**自适应**
* (freq.c fq_read_freq:K_eff = round(8·Fs/(2·f_hat)),45~55 Hz 段 73~89 拍),
* 使窗长恰为 DFT 负序泄漏纹波周期 fs/(2f) 的整数倍 -> 纹波相消。
* 保护定值延时 ≥100 ms,~90 ms 窗不影响动作时序判据。 */
* 保护定值延时 ≥100 ms,~90 ms 窗不影响动作时序判据。
* ⚠ 钳位区间 [FREQ_AVG_MIN, FREQ_AVG_TAPS] 只对 41.7~55.6 Hz 满足整倍条件:
* 带外窗非纹波周期整数倍 -> 读数饱和钉沿(高侧 ~55、低侧 ~43.5,且带外
* freq_valid() 仍为 1,数值不可消费)。2026-11-13 台架 60 Hz 实证与
* 「参数不改」裁定见 docs/算法/采集与算法层设计说明.md §7.3。 */
#define FREQ_AVG_TAPS 96u
/* 自适应窗长下限(拍):K_eff 钳位区间下界(启动段窗未满时按已有拍数)。 */