Files
HomeAgent/internal/agent/core/scenepolicy_test.go
JianFeeeee 3f834794c5 refactor: SDK module 路径统一改为 hologramagentsdk(59 文件 + go.mod)
## 为什么必须做

SDK 仓(独立仓库)已把 module 从 `github.com/JianFeeeee/homeagentsdk`
改名为 `hologramagentsdk`。主仓通过 `replace` 直接引用它的**物理目录**:

    replace github.com/JianFeeeee/homeagentsdk => ./third_party/homeagent-sdk

一旦 SDK 侧改成新 module 名,主仓立刻炸:

    go: ./third_party/homeagent-sdk@ used for two different module paths
        (github.com/JianFeeeee/hologramagentsdk and github.com/JianFeeeee/homeagentsdk)

Go **不允许**同一目录被两个 module 路径 replace。所以不能"新旧并存",
只能把主仓 59 个文件的 import 全部改到新名,并删掉旧 replace。

## 一个被证伪的前提

我最初按"third_party/homeagent-sdk 是独立仓库,不能在此仓修改其源码"
来处理,并因此判断两个仓的改动可以隔离。实际上主仓是靠 `replace` 指向
该目录的物理副本 —— **两个仓的改动不可能真正隔离**:SDK 侧改 module 名,
主仓必然跟着改 import。

这个前提应该在做任何改动之前用 `go list -m` 验证,而不是假设。

## 连带修掉两处

| 缺陷 | 性质 |
|---|---|
| `TestLuaSDKMockSingleSource` 失败 | SDK 的 `sdk/lua/sdk.lua` 变了,主仓内嵌副本未同步(跑 `scripts/sync-lua-sdk.sh` 修复) |
| `sdkModuleNames` 分散两处 | 已在 SDK 仓合并为单一数据源(见 SDK 仓 725732b) |

第一条是**副本一致性判据抓到的**,不是我自己发现的 —— 这类判据的价值在此:
两个仓必然有副本,靠人记住"改了 A 要同步 B"是做不到的。

## 验证

- `go build ./...` / `go vet ./...` 干净
- `go test ./... -count=1`:**58 包 0 失败**
- `internal/plugin`(Lua SDK 副本一致性)+ `internal/sdk` 全绿
- 主仓 `third_party/homeagent-sdk/` 与 SDK 仓 `main` 无差异
2026-10-23 15:51:02 +08:00

145 lines
4.9 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

package core
// ScenePolicy 声明项的判据(R6)。
//
// 缺口事实(穷举确认,非查漏):ChannelDef 已有 NoMemory/ContextPolicy/
// RecallPolicy 三件套,唯独没有「这条通道是否参与场面识别」;
// situationFeaturesFor 里只要 evt.Source != "" 就无条件塞 chan 特征。
// ⇒ chan:system / chan:kernel / chan:timer 这类内部信噪通道
// 也在参与场面聚类(现网 65 个键里就有 chan:system、chan:kernel、chan:timer)。
//
// 判据参照物在生产代码之外:期望值是「声明 none 的输入不产生任何场面特征」、
// 「未声明的输入行为逐字节不变」这两条不变量,不引用被测实现。
import (
"testing"
agentIO "github.com/JianFeeeee/HologramAgent/internal/agent/io"
pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk"
)
func scenePolicyNoneEvent() *agentIO.InputEvent {
return &agentIO.InputEvent{
Source: "system",
Payload: map[string]interface{}{"scene_policy": "none"},
}
}
// R6 核心:声明 none 的输入不产生任何场面特征。
func TestScenePolicyNone_NoSituationFeatures(t *testing.T) {
a := &Agent{io: agentIO.NewIOManager()}
evt := scenePolicyNoneEvent()
if feats := a.situationFeaturesFor(evt, "帮我看下定时器", ""); len(feats) != 0 {
t.Fatalf("声明 scene_policy=none 的输入仍产出了 %d 个场面特征: %+v —— "+
"内部信噪通道会参与场面聚类,把无关场面撑出来", len(feats), feats)
}
}
// none 必须连时段(part) 都不产:一个不参与场面识别的通道
// 不该在 situation_evidence / scene_features 里留下任何足迹。
func TestScenePolicyNone_NoPartFeatureLeak(t *testing.T) {
a := &Agent{io: agentIO.NewIOManager()}
feats := a.situationFeaturesFor(scenePolicyNoneEvent(), "任意内容", "")
for _, f := range feats {
if f.Kind == "part" {
t.Errorf("scene_policy=none 仍产出了时段特征 %q", f.Key())
}
}
}
// none 时工具场景也不该派生。
func TestScenePolicyNone_NoToolScene(t *testing.T) {
a := &Agent{io: agentIO.NewIOManager()}
keys := a.sceneKeysFor(scenePolicyNoneEvent(), "cmd_run")
for _, k := range keys {
if k == "tool:cmd_run" || k == "chan:system" {
t.Errorf("scene_policy=none 仍派生了场景键 %q", k)
}
}
}
// 声明 none 时,显式 payload["scene"] 也不该被采纳——
// 否则通道声明形同虚设(注入点声明与通道声明必须一致,通道是更宽的闸)。
func TestScenePolicyNone_OverridesExplicitScene(t *testing.T) {
a := &Agent{io: agentIO.NewIOManager()}
evt := scenePolicyNoneEvent()
evt.Payload["scene"] = "chan:qq"
keys := a.sceneKeysFor(evt, "")
for _, k := range keys {
if k == "chan:qq" {
t.Error("通道声明 scene_policy=none 后,注入点显式声明的 chan:qq 仍被采纳;" +
"通道级闸门应覆盖注入点级声明")
}
}
if feats := a.situationFeaturesFor(evt, "", ""); len(feats) != 0 {
t.Errorf("scene_policy=none 仍产出特征 %+v", feats)
}
}
// 未声明时行为必须逐字节不变(零值 = 保持现状 = 参与)。
// 这是「纯追加」承诺的护栏:老插件不填 ScenePolicy,行为不能有任何变化。
func TestScenePolicyUnset_BehavesExactlyAsBefore(t *testing.T) {
a := &Agent{io: agentIO.NewIOManager()}
evt := &agentIO.InputEvent{
Source: "qq",
Payload: map[string]interface{}{},
}
feats := a.situationFeaturesFor(evt, "老大在吗", "")
if len(feats) == 0 {
t.Fatal("未声明 scene_policy 的输入不应失去场面特征(零值必须等价既有行为)")
}
var hasChan bool
for _, f := range feats {
if f.Kind == "chan" {
hasChan = true
}
}
if !hasChan {
t.Errorf("未声明时应照旧产出 chan 特征,实际: %+v", feats)
}
keys := a.sceneKeysFor(evt, "")
if len(keys) == 0 || keys[0] != "chan:qq" {
t.Errorf("未声明时应照旧派生 chan:qq,实际: %v", keys)
}
}
// 显式 auto 与未声明等价。
func TestScenePolicyAuto_SameAsUnset(t *testing.T) {
a := &Agent{io: agentIO.NewIOManager()}
mk := func(policy string) []string {
payload := map[string]interface{}{}
if policy != "" {
payload["scene_policy"] = policy
}
return a.sceneKeysFor(&agentIO.InputEvent{Source: "qq", Payload: payload}, "")
}
unset, auto := mk(""), mk(pubsdk.ScenePolicyAuto)
if len(unset) != len(auto) {
t.Fatalf("auto 与未声明不等价: unset=%v auto=%v", unset, auto)
}
if len(auto) == 0 || auto[0] != "chan:qq" {
t.Fatalf("auto 应照旧派生 chan:qq,实际: %v", auto)
}
}
// SDK 常量与校验函数:形状须与 ContextPolicy/RecallPolicy 一致。
func TestScenePolicySDKShape(t *testing.T) {
if !pubsdk.ValidScenePolicy("") {
t.Error("空串应等价默认,校验须通过")
}
if !pubsdk.ValidScenePolicy(pubsdk.ScenePolicyNone) {
t.Error("none 应合法")
}
if !pubsdk.ValidScenePolicy(pubsdk.ScenePolicyAuto) {
t.Error("auto 应合法")
}
if pubsdk.ValidScenePolicy("prune") {
t.Error("未知取值应被拒(照 ContextPolicy 的严格度)")
}
}