mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-12 20:27:30 +00:00
3384cee62a
## 方向
「面向模块输入接受模块输出」：只调模块**本来就有**的导出接口，
输入 → 断言可观察输出。不从旧白盒里抽、不读源码、不引用文档、
不构造内部结构、不为测试导出任何新符号。
4 个文件全部放 `<module>/test/`，源码目录仍零 `_test.go`。
共 23 条判据，每模块 1 个文件。
## 各模块的接口清单与判据
### internal/config —— NewConfigRegistry / PluginConfig
TestCoreSetGetDelete Set → Get → Delete → Get=nil
TestPluginNamespaceIsIsolated 两插件同名 key 不串台；核心表看不到插件键
TestPluginListByPrefix List 只返回匹配前缀的键
TestDefRoundTripPreservesSecret RegisterDef → ListDefs 保住 Secret
TestSecretValueIsNotPlaintextOnDisk Set → GetSecret 往返 + DB 里无明文
**判据按真实契约写**：插件表由 `RegisterDef` 创建，`Set` 不隐式建表。
第一版没先 RegisterDef，实测 `no such table: config_alpha` —— 不是缺陷，
是我把装配顺序当成了实现细节。判据里显式写了这条契约。
### internal/knowledge —— NewStore(root) / Add / List / Stats / Remove / Search / Categories
TestAddThenListAndStats Add → List/Stats
TestRemoveActuallyRemoves Remove → 空；二次 Remove 报错
TestPathTraversalIsRejected ".." / "." / 空名 必须被拒
TestCategoriesIncludeIntermediateLevels tech/go/叶名 ⇒ tech、tech/go 都出现
TestSearchRanksRelevantAboveUnrelated 只问排序，不钉数值
`TestSearchRanksRelatedAboveUnrelated` 直接对治 engineering-lessons §1.1
那个坑：16 条判据全绿而检索结果完全无关（分数全挤在 0.75~0.79）。
**判据写错过一次并修正**：`Categories()` 返回的是**父路径**，
`tech/go/concurrency` 条目的 Category 是 `tech/go`，不含叶名。
第一版断言叶名也在列表里 ⇒ 红。查实现后按真实契约改成两层。
### internal/memory/distill —— 纯函数，输入输出就是全部语义
TestBlockTextRoundTrip ToMemoryBlock → BlockSubject/Dimension/Value
TestBlockIDDependsOnSubject 不同主语不得撞 ID（静默数据丢失）
TestBlockIDIsDeterministic 同输入同输出
TestDimensionValueEdgeCases 无 '=' / 空维度 / 多 '='
TestSentenceBlockIDIsStable 原句块 ID 稳定
TestNormalizeDimensionIsIdempotent 归一幂等
### internal/agent/api —— 纯函数 + ProviderManager 公开状态机
TestEstimateTokensIsMonotonic 更长文本不得更少 token
TestTruncateByTokensRespectsBudget 截断后不超预算
TestModelContextWindowAlwaysPositive
TestIsValidSourceConfig 四字段 + URL scheme 真值表
TestRegisterGetListDefault 注册顺序/按名取回/默认源切换
TestAvailabilityStateMachine MarkUnavailable → 不可用 → Reset 恢复
TestProviderErrorCarriesStatusAndMessage
`ProviderManager` 用的是真 `NewProviderManager()` + 满足 `Provider`
接口的 stub，不碰 `m.status`、不用任何 ForTest 钩子。
## 变异验证（每条至少一次，改回旧实现必须红）
config ListDefs 丢 Secret → ★ Secret:true 在 RegisterDef → ListDefs 后丢失
knowledge normalizeName 放行 ".." → ★ Add("..") 被接受了 —— 路径可逃出知识根
distill BlockID 丢 subject → ★ 不同主语得到同一个 BlockID
api 漏 URL scheme 校验 → ★ ftp://x 判成了 true
全部还原后复跑全绿。
## 验证
go build ./... PASS
go vet ./... PASS
gofmt -l 干净
python3 .github/scripts/check-ci-gates.py PASS
go test ./... -count=1 9 个测试包 / 100 个包无测试 / 0 FAIL
4 个新包 -race 全绿
lens 4 个新文件 LSP 0 诊断
106 lines
3.2 KiB
Go
106 lines
3.2 KiB
Go
package test
|
||
|
||
// internal/knowledge 的黑盒判据：NewStore(root) → Add → 可观察输出。
|
||
// 不读 .index.json、不碰 s.items、不引用文档。
|
||
|
||
import (
|
||
"testing"
|
||
|
||
"github.com/JianFeeeee/HologramAgent/internal/knowledge"
|
||
)
|
||
|
||
func newStore(t *testing.T) *knowledge.Store {
|
||
t.Helper()
|
||
return knowledge.NewStore(t.TempDir())
|
||
}
|
||
|
||
// TestAddThenListAndStats：Add 之后 List / Stats 必须反映该条目。
|
||
func TestAddThenListAndStats(t *testing.T) {
|
||
s := newStore(t)
|
||
if err := s.Add("tech/go/gc", "Go 的垃圾回收使用三色标记"); err != nil {
|
||
t.Fatalf("Add: %v", err)
|
||
}
|
||
got := s.List()
|
||
if len(got) != 1 || got[0] != "tech/go/gc" {
|
||
t.Fatalf("★ List = %v，期望 [tech/go/gc]", got)
|
||
}
|
||
st := s.Stats()
|
||
if st["knowledge_count"] != 1 {
|
||
t.Fatalf("★ knowledge_count = %v，期望 1", st["knowledge_count"])
|
||
}
|
||
}
|
||
|
||
// TestRemoveActuallyRemoves：Remove 之后 List 不再含该条目，且二次 Remove 报错。
|
||
func TestRemoveActuallyRemoves(t *testing.T) {
|
||
s := newStore(t)
|
||
if err := s.Add("a", "内容A"); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if err := s.Remove("a"); err != nil {
|
||
t.Fatalf("Remove: %v", err)
|
||
}
|
||
if got := s.List(); len(got) != 0 {
|
||
t.Fatalf("★ Remove 后 List = %v，期望空", got)
|
||
}
|
||
if err := s.Remove("a"); err == nil {
|
||
t.Fatal("★ 删除不存在的条目应报错，实际返回 nil")
|
||
}
|
||
}
|
||
|
||
// TestPathTraversalIsRejected：名字里的 ".." 不得逃出知识根目录。
|
||
//
|
||
// 这是真实事故形态：早期 Remove("..") 直接删掉整个 data 目录。
|
||
func TestPathTraversalIsRejected(t *testing.T) {
|
||
s := newStore(t)
|
||
for _, name := range []string{"..", "../escape", "a/../b", ".hidden", ""} {
|
||
if err := s.Add(name, "x"); err == nil {
|
||
t.Fatalf("★ Add(%q) 被接受了 —— 路径可逃出知识根", name)
|
||
}
|
||
}
|
||
if got := s.List(); len(got) != 0 {
|
||
t.Fatalf("★ 非法名字留下了条目：%v", got)
|
||
}
|
||
}
|
||
|
||
// TestCategoriesIncludeIntermediateLevels：分类树必须给出中间层。
|
||
func TestCategoriesIncludeIntermediateLevels(t *testing.T) {
|
||
s := newStore(t)
|
||
if err := s.Add("tech/go/concurrency", "goroutine 调度"); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
cats := s.Categories()
|
||
// Category 是**父路径**：tech/go/concurrency 条目的 Category 是 tech/go。
|
||
want := map[string]bool{"tech": false, "tech/go": false}
|
||
for _, c := range cats {
|
||
if _, ok := want[c]; ok {
|
||
want[c] = true
|
||
}
|
||
}
|
||
for c, hit := range want {
|
||
if !hit {
|
||
t.Fatalf("★ Categories() = %v，缺中间层 %q", cats, c)
|
||
}
|
||
}
|
||
}
|
||
|
||
// TestSearchRanksRelevantAboveUnrelated：只问排序，不钉数值。
|
||
//
|
||
// 分数全挤在 0.75~0.79 时 16 条判据全绿而检索结果完全无关 ——
|
||
// 所以判据必须断言「相关条目排在无关条目之前」。
|
||
func TestSearchRanksRelevantAboveUnrelated(t *testing.T) {
|
||
s := newStore(t)
|
||
if err := s.Add("billing/invoice", "账单服务的发票重试策略与对账流程"); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if err := s.Add("auth/session", "登录会话的过期时间与刷新令牌"); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
hits := s.Search("发票 重试 账单", 2)
|
||
if len(hits) == 0 {
|
||
t.Fatal("★ 检索无结果")
|
||
}
|
||
if hits[0].Name != "billing/invoice" {
|
||
t.Fatalf("★ 排第一的是 %q，期望 billing/invoice（检索判别力失效）", hits[0].Name)
|
||
}
|
||
}
|