mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-01 06:47:29 +00:00
## rtchild(R1–R13)
第三种、**独立**的子 agent 类型,面向语音/视频通话:内核只要文本流,
不定音频(TTS/播放由插件负责)。
- R1 CapRT 能力位 + AgentConfig.IsRealtime;AssignRealtime 两侧校验
- R2 rtSlot 单槽覆盖(latest-wins,从不排队)
- R3 独立 ctx + rtLoop + SpawnRTChild/StopRTChild
- R4 ChatStream 逐块 → outputch(rt).Execute(text)
- R5 打断 = 原地截断,不重试
- R6 工具执行期不可打断(suppressedCancels 让守卫可观测)
- R7 普通上下文 + 窗口裁剪(旧内容不进模型,**原文保留**)
- R9 CloseRTChild → L4 信号 + rt_transcript 按需分页取
- R10 notify_parent(L4,注册一次,停即注销)
- R11 闲置零 token
- R13 rt_children 管理工具(父专属)
刻意**不做** rtPage/anchor/degraded_resets(过设计,已裁定);
不用四级中断阶梯(preemptCooldown+同级不抢占会让 ~75% 的 rt 打断
静默退化为排队)。
## 四类 agent 各自可配模型源
core.agent.llm.{main,resident,rt,child}_provider,语义是**优先不是独占**:
该源排到候选链最前,其余源仍作回退。硬锁定会让"首选源抖一下"变成
"这个 agent 彻底不工作",而多源回退链正是本仓为此建立的机制。
名字写错 ⇒ 回退默认源 + 记日志(不静默)。子 agent 未配置时继承父的。
★ 顺带修掉一个真缺陷:spawn.go 原来直接 a.provider.Chat(),
**普通子 agent 完全绕过 provider 回退链** —— 它是唯一绕过的地方:
默认源抖一次整条子任务就"执行失败",而主 agent 同刻能自动换源。
## 驻留子残余任务四态 + 通道三态
残余任务:keep / takeover(接手,keep 的明确别名)/ stash(暂存到各自
原通道)/ drop。stash 必须**逐条按各自 OutputChannel 归位** —— 一个子
可能同时收 qq 和 webui,混存会让"接回 qq 的人"拿到本该给 webui 的活。
通道:release(零值,向后兼容)/ suspend(挂起,暂存保留)/ takeover
(接回父并立即释放暂存)。原来是无条件 release,于是只有两种坏结局:
通道一直没人分配(消息无人处理且无提示),或刚好被别的 agent 抢到。
一次定完不留窗口:FinishResidentWith → DestroyResidentWith →
teardownResidentWith。任一环退回不带 disp 的旧函数,disp 就被丢掉、
通道被无条件释放 —— 而 stash 的暂存正挂在那条通道上(实际踩过)。
## 修复"手写字段白名单"丢值(7 处)
同一类缺陷:不传整个结构体,而是手写一份"允许通过的字段清单"。
危险在于**写漏了不报错** —— 字段静默归零,故障出现在很远的地方。
- corehandler.go outputRegister: ChannelDef{NoMemory,Cleaner} → 整体传
- pubSdkInjectOpts: 逐字段摊平丢 ScenePolicy/SecurityProfile → 收整个 injectParams
- injectParams/injectMediaParams: 结构本身缺字段 → 补齐 + asInjectParams()
- 配套反射判据 TestSegment_RoundTripEveryField(取代手写断言,
原判据漏了 Phase/LLMText/FinalText/ToolCalls/ExtraKeyMediaBlocks/ExtraBag)
## 压缩偏离设计
CompressResident 原为截断,与设计(LLM 摘要替换)不符。改走
PlanCompaction → summarizeForCompaction(用子自己的 provider)→
ApplyCompaction,失败回退 TrimKeepRecent。顺带修 ApplyCompaction 的
锁重入 panic 与双重解锁。
并修一处真实生产数据竞争:ctxFullSignaled 由父 goroutine 写、
子调度 goroutine 读,加 ctxFullMu。
## 判据
新增约 70 条。全部验证过能变红(变异测试),包括:
- TestSegment_RoundTripEveryField 的防腐蚀:fullStageContext 反射断言
每个字段非零,否则新字段永远不会被覆盖("假绿")
- TestPreferredProvider_PutsSourceFirstAndKeepsFallbacks 成对断言
"在首位且回退仍在"—— 只断言前者的话,硬锁定也会绿
## 判据自身的坑(两次偶发红,都不是产品缺陷)
1. SpawnResident 末尾 Start(),子会在两次 enqueue 之间取走一条
→ "暂存 0 条"。修法:cancel + waitSchedulerStopped。
(offload_test.go 早有记录,我没先读就重踩了一遍)
2. TaskPrompt 异步投递,可能在清空队列之后才到 → "多 1 条"。
靠探针打印内容才认出是 TaskPrompt。修法:本文件用 spawnQuietResident。
go build/vet/gofmt 干净;go test ./... -count=1 -race = 62 包 ok / 0 FAIL / 0 RACE
115 lines
4.2 KiB
Go
115 lines
4.2 KiB
Go
package proc
|
||
|
||
// 判据:**InjectOptions 的每一个字段都必须能跨进程传过去**。
|
||
//
|
||
// 背景(2026-10-30 审计):`pubSdkInjectOpts` 曾逐字段摊平传参
|
||
// (noMemory, policy, recallPolicy, cleanerName, priority),于是新增字段时
|
||
// 没人被提醒去接 —— 实际漏了 ScenePolicy 与 SecurityProfile。
|
||
//
|
||
// 后者尤其严重:QQ 插件的 owner/guest 档位就是靠 InjectOptions.SecurityProfile
|
||
// 选的,漏了等于「插件声明了档位、注入时带了、内核从没收到」,策略静默不生效。
|
||
//
|
||
// 现在签名接收整个 injectParams,新增字段时编译器会在这里提示。
|
||
|
||
import (
|
||
"testing"
|
||
|
||
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
|
||
)
|
||
|
||
// TestPubSdkInjectOpts_CarriesEveryField 钉住整体映射:
|
||
// injectParams 的每个 opt 字段都必须出现在输出的 InjectOptions 里。
|
||
func TestPubSdkInjectOpts_CarriesEveryField(t *testing.T) {
|
||
in := injectParams{
|
||
NoMemory: true,
|
||
ContextPolicy: "prune",
|
||
RecallPolicy: "none",
|
||
ScenePolicy: "none",
|
||
CleanerName: "voice-cleaner",
|
||
Priority: "L2",
|
||
SecurityProfile: "qq.guest",
|
||
}
|
||
got := pubSdkInjectOpts(in)
|
||
|
||
if !got.NoMemory {
|
||
t.Error("NoMemory 丢失")
|
||
}
|
||
if got.ContextPolicy != "prune" {
|
||
t.Errorf("ContextPolicy = %q", got.ContextPolicy)
|
||
}
|
||
if got.RecallPolicy != "none" {
|
||
t.Errorf("RecallPolicy = %q —— 漏传则插件声明的召回策略静默失效", got.RecallPolicy)
|
||
}
|
||
if got.ScenePolicy != "none" {
|
||
t.Errorf("ScenePolicy = %q —— 漏传则插件声明的场面策略静默失效", got.ScenePolicy)
|
||
}
|
||
if got.CleanerName != "voice-cleaner" {
|
||
t.Errorf("CleanerName = %q", got.CleanerName)
|
||
}
|
||
if got.SecurityProfile != "qq.guest" {
|
||
t.Errorf("SecurityProfile = %q —— 漏传则插件声明的安全档位**永不生效**"+
|
||
"(QQ owner/guest 就是走这条)", got.SecurityProfile)
|
||
}
|
||
// 外部插件的优先级必须被夹到 L1..L3(L4 内核独占)。
|
||
if got.Priority == "L4" {
|
||
t.Error("外部插件竟然传出了 L4 —— 优先级夹取失效")
|
||
}
|
||
}
|
||
|
||
// TestPubSdkInjectOpts_MediaPathKeepsOpts 钉住媒体注入路径同样不丢字段。
|
||
//
|
||
// 媒体路径用 injectMediaParams(多 Blocks/BlocksRef),曾经因为类型不同
|
||
// 而无法复用同一个转换函数 —— 那正是漏字段的温床。
|
||
func TestPubSdkInjectOpts_MediaPathKeepsOpts(t *testing.T) {
|
||
m := injectMediaParams{
|
||
NoMemory: true,
|
||
ScenePolicy: "none",
|
||
SecurityProfile: "qq.owner",
|
||
}
|
||
got := pubSdkInjectOpts(m.asInjectParams())
|
||
if !got.NoMemory {
|
||
t.Error("媒体路径 NoMemory 丢失")
|
||
}
|
||
if got.ScenePolicy != "none" {
|
||
t.Errorf("媒体路径 ScenePolicy = %q", got.ScenePolicy)
|
||
}
|
||
if got.SecurityProfile != "qq.owner" {
|
||
t.Errorf("媒体路径 SecurityProfile = %q —— 媒体注入同样要带档位", got.SecurityProfile)
|
||
}
|
||
}
|
||
|
||
// TestInjectParityWithSDK 是**防复发**判据:injectParams/injectMediaParams
|
||
// 必须覆盖 InjectOptions 的全部字段。
|
||
//
|
||
// 做法:构造一个"所有字段都非零"的 InjectOptions,逐个读出名称与值,
|
||
// 确认转换后不丢。新增 SDK 字段而没改这里时,本判据会红。
|
||
func TestInjectParityWithSDK(t *testing.T) {
|
||
// 全字段非零(新字段加进 SDK 后,这里也要加 —— 判据会提示)
|
||
want := pubsdk.InjectOptions{
|
||
NoMemory: true,
|
||
ContextPolicy: "prune",
|
||
RecallPolicy: "none",
|
||
ScenePolicy: "none",
|
||
CleanerName: "c",
|
||
Priority: "L2",
|
||
SecurityProfile: "p",
|
||
}
|
||
in := injectParams{
|
||
NoMemory: want.NoMemory, ContextPolicy: want.ContextPolicy,
|
||
RecallPolicy: want.RecallPolicy, ScenePolicy: want.ScenePolicy,
|
||
CleanerName: want.CleanerName, Priority: want.Priority,
|
||
SecurityProfile: want.SecurityProfile,
|
||
}
|
||
got := pubSdkInjectOpts(in)
|
||
// InjectOptions 含 map 字段(不可用 ==),逐字段比。
|
||
if got.NoMemory != want.NoMemory ||
|
||
got.ContextPolicy != want.ContextPolicy ||
|
||
got.RecallPolicy != want.RecallPolicy ||
|
||
got.ScenePolicy != want.ScenePolicy ||
|
||
got.CleanerName != want.CleanerName ||
|
||
got.Priority != want.Priority ||
|
||
got.SecurityProfile != want.SecurityProfile {
|
||
t.Fatalf("字段不齐:\n got = %+v\nwant = %+v", got, want)
|
||
}
|
||
}
|