feat(dsh): spawn_teammate 角色 persona 自动注入 + 测频带外饱和边界登记
一、子 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:
+24
-12
@@ -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 钳位区间下界(启动段窗未满时按已有拍数)。 */
|
||||
|
||||
Reference in New Issue
Block a user