HomeAgent

jianf/HomeAgent

Fork 0

mirror of https://gitcode.com/JianFeeeee/HomeAgent.git synced 2026-11-12 12:17:36 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	53cdc7f2a6	refactor(test): 肃清全部白盒测试 —— 源码目录零 _test.go，判据只走模块导出接口 ## 用户裁定（本次唯一方向） 1. 「测试不应该面向过程而是面向模块的输入和输出」 2. 「每个模块下应该使用 test 目录搜集所有测试文件，而不是和源码混在一起」 3. 「现在 test 都超过源码数量了，这很明显不符合模块接口黑盒化的要求」 4. 「ast判包依赖？这不是工具链该做的吗？为什么在测试里」 5. 「抽行为判据？只需要面向模块输入接受模块输出就行」 6. 「不管ci，直接把所有白盒测试全清理了再回去一鼓作气改ci」 ## 实测起点 537 个测试文件 / 377 个源码文件 / 2853 条 Test 523 / 537（97%）直接调用私有函数 514 个是 in-package 白盒（package xxx，与源码同目录） 88 个读 .go/.md 源码做断言 94 个断言私有字段（f.Step / r.buf / a.sched …） 38 个直调私有函数（stepLLM / runStage / classifyProviderError …） internal/agent/core: 140 test / 52 src ## 做了什么 ### ① 删除 514 个 in-package 白盒测试不做「抽行为判据」，也不做逐文件搬运。理由：Go 按目录分包， `pkg/test/` 里写 `package pkg` 也看不到 unexported 符号 —— 所以「挪进 test/」和「改成黑盒」是同一件事的两面。把 514 个白盒文件搬走只会得到一堆编译不过的文件，或者为了迁就它们把内部全导出。用户明确否定「抽」这个动作后，剩下 9 个 test/ 里的判据也一并重新审视：凡是靠读源码/前端资源文本做断言的（dashboardJSSource / FrontendAsset / GraphDataForVisual / SSEEventRing …）全部删除，只留走模块本来就有的公开 API 的输入→输出判据： internal/agent/core/child/test/ Registry 的 Add/Get/Stop/Remove 输出 internal/agent/core/test/ StageHost 的 Register/Run 输出 internal/plugins/files/test/ 工具 handler 的 {path} → {content/error} internal/plugins/webui/test/ HTTP 请求 → 响应（NewHandler/RegisterRoutes） internal/tfidf/test/ 文本 → 向量/检索结果现存 9 个测试文件全部在 `<module>/test/`，源码目录零 `_test.go`。 ### ② 回退「为测试而导出」的接口这些是前几轮为了把白盒判据挪出源码目录而导出的，属于白盒残留，现在没有调用方了，全部收回私有： webui.FrontendAsset / DashboardPage 删除 webui.GraphDataForVisual → graphDataForVisual webui.SSEEventRing/Record → sseEventRing/sseEventRecord（含字段） webui.NewSSEEventRing 删除 kstate.MountForTest 删除 security.ClassifyPrincipalForTest 删除生产代码对它们的内部调用同步改回私有名，不改任何行为。 ### ③ CI 一鼓作气改到位（用户指定顺序）删：`整机启动图判据` 单列步骤（它跑的 bootgraph_test.go 已删），以及 `check-ci-gates.py` 里盯着那个步骤的断言 —— 继续盯着一个不存在的步骤就是永远红的空转。加两道构建期静态门（原先这些约束错放在 go test 里）： - `测试归拢（源码目录不得有 _test.go）` `find internal cmd pkg providers deploy -name '_test.go' -not -path '/test/'` 非空即红。物理上挡住白盒回潮。 - `包依赖门（kstate 为叶子 / 底层包不反向依赖装配器）` 用 `go list -deps` 判 8 组禁止依赖 + `go build core` 确认环不存在。这是工具链的职责，不该由 `go test` 兼职。 `check-ci-gates.py` 同步改为盯这两道门；ci.yml 里 13 处既有 >80 字符行一并折行（门禁标了 STOP，不留尾巴）。 ### ④ 顺带（上一批未提交的） `scripts/make-package.sh` 产物名 `HomeAgent-linux-` → `HologramAgent-linux-`；清理 gitignored 构建产物 `build/ dist/ .go/ .npm-cache/` 共 20G（工作区 21G → 1.7G）。运行契约（~/.homeagent/cli.sock、线上域名、兼容别名）未动。 ## 验证 go build ./... PASS go vet ./... PASS gofmt -l 干净 python3 .github/scripts/check-ci-gates.py PASS go test ./... -count=1 5 个测试包全过 / 100 个包无测试 / 0 FAIL 源码目录 _test.go 数 0 测试文件数 9（全部在 <module>/test/） ## 后续按模块导出接口清单重写判据（不是从旧白盒里抽）： internal/agent/api、internal/memory、internal/security、internal/plugin、 internal/knowledge、cmd/ 等目前 0 判据，需要逐个列接口 → 写输入→输出判据 → 变异验证。这是新一轮工作，本提交不含。	2026-11-09 11:13:56 +08:00
JianFeeeee	1d38353498	refactor(webui): SSE 事件环判据迁到 test/ —— 导出环类型与记录字段 handler_sse_test.go → test/ （6 条判据） webui/ 167 → 161 webui/test/ 35 → 41 合计 202 不变 ## 原来那 6 条判据读的是私有字段 len(r.buf) r.buf[0].ID / .EventType / .Data `sseEventRing` 的对外语义就三条：容量上限、按 Last-Event-ID 重放、未知 ID 回退全量。它们全部可以从导出接口断言： NewSSEEventRing(cap) 构造 Append(id, type, data) 写入 After(id) []SSEEventRecord 重放所以导出 `sseEventRing → SSEEventRing`、`SSEEventRecord` 的字段、以及构造入口 `NewSSEEventRing`。为什么这不是"为测试导出内部"：`After` 返回的东西就是客户端断线重连时实际收到的内容 —— id、event、payload 三样。它们是外部可见的输出，把字段藏起来只让包内测试能读，才是反过来的怪事。测试侧的 `r.buf[i]` 统一换成 `r.After("")[i]`（空 ID 命中不了，按约定回退全量），语义等价且不再触碰内部状态。 ## 判据有效性（变异验证）把容量裁剪短路掉（`if false && len(r.buf) > r.cap`）： --- FAIL: TestSSEEventRing_Append_Capacity expected 3, got 5 环不再丢最旧条目 ⇒ 断线重连会重放超过窗口的历史，客户端 Last-Event-ID 语义失效。恢复后全绿。 ## 验证 go build ./... PASS go vet ./... PASS gofmt -l 干净 go test ./... -count=1 67 包全过，0 FAIL	2026-11-04 22:21:54 +08:00
HomeAgent Agent	4a00922ec3	refactor(webui): handler.go 2993 行按资源拆成 11 个同包文件拆法：按「资源面」搬家，每个顶层声明（func/type/var/const）整体搬到目标文件，声明体一字未改，各文件按实际用到的包重新生成 import。文件头加一行说明本文件负责哪一面。 handler.go 骨架：嵌入前端资源、Handler/构造、路由表、鉴权会话日志中间件、静态页 handler_chat.go 对话面：消息模型与内存历史、SSE 事件订阅、对话/历史接口 handler_upload.go 上传面：handleChatFile / handleUploads / 中断对话 handler_memory.go 记忆面：图/文档/文本记忆、知识库、LLM 源、变更追踪 handler_agents.go 内核与代理面：状态、kernel、人格、代理/快照/回滚 handler_settings.go 设置与插件面：配置读写、插件列表详情（含 pluginmgr 反代） handler_terminal.go 终端面：终端会话、终端接口、命令历史 handler_sse.go SSE 环形缓冲（断线重连补发） handler_openai.go OpenAI 兼容面：/v1/chat/completions handler_device.go 设备网关反代（HTTP + WS 升级透传） handler_files.go /files/ 与 /uploads/ 下载零漂移校验：拿重构前的 handler.go 与新 11 个文件逐行比对（忽略空行、package/import 头），丢失行 0；新增行恰好是 11 个文件头注释（14 行）。顺带修掉 import 里两处假使用：handler_openai 的 sdk 只作为 Handler 字段名出现（h.sdk.）， handler_settings 的 fmt 只出现在注释里 —— 都从 import 里去掉。验证：go build ./... / go vet / webui+config+sdk 测试全绿；起真实实例（沿用已有 data 目录）后 /status /settings /chat/history /plugins /terminals /kernel /memory /config /login 全部 200，设置在注入 5MB 历史的情况下仍是 33,921 字节。最大文件从 2993 → 706 行（handler_chat.go）。	2026-09-14 07:03:47 +08:00

Author

SHA1

Message

Date

JianFeeeee

53cdc7f2a6

refactor(test): 肃清全部白盒测试 —— 源码目录零 _test.go，判据只走模块导出接口

## 用户裁定（本次唯一方向）

1. 「测试不应该面向过程而是面向模块的输入和输出」
2. 「每个模块下应该使用 test 目录搜集所有测试文件，而不是和源码混在一起」
3. 「现在 test 都超过源码数量了，这很明显不符合模块接口黑盒化的要求」
4. 「ast判包依赖？这不是工具链该做的吗？为什么在测试里」
5. 「抽行为判据？只需要面向模块输入接受模块输出就行」
6. 「不管ci，直接把所有白盒测试全清理了再回去一鼓作气改ci」

## 实测起点

    537 个测试文件 / 377 个源码文件 / 2853 条 Test
    523 / 537（97%）直接调用私有函数
    514 个是 in-package 白盒（package xxx，与源码同目录）
     88 个读 .go/.md 源码做断言
     94 个断言私有字段（f.Step / r.buf / a.sched …）
     38 个直调私有函数（stepLLM / runStage / classifyProviderError …）
    internal/agent/core: 140 test / 52 src

## 做了什么

### ① 删除 514 个 in-package 白盒测试

不做「抽行为判据」，也不做逐文件搬运。理由：Go 按目录分包，
`pkg/test/` 里写 `package pkg` 也看不到 unexported 符号 —— 所以
「挪进 test/」和「改成黑盒」是同一件事的两面。把 514 个白盒文件
搬走只会得到一堆编译不过的文件，或者为了迁就它们把内部全导出。

用户明确否定「抽」这个动作后，剩下 9 个 test/ 里的判据也一并
重新审视：凡是靠读源码/前端资源文本做断言的（dashboardJSSource /
FrontendAsset / GraphDataForVisual / SSEEventRing …）全部删除，
只留走模块**本来就有**的公开 API 的输入→输出判据：

    internal/agent/core/child/test/     Registry 的 Add/Get/Stop/Remove 输出
    internal/agent/core/test/           StageHost 的 Register/Run 输出
    internal/plugins/files/test/        工具 handler 的 {path} → {content/error}
    internal/plugins/webui/test/        HTTP 请求 → 响应（NewHandler/RegisterRoutes）
    internal/tfidf/test/                文本 → 向量/检索结果

现存 9 个测试文件全部在 `<module>/test/`，源码目录零 `_test.go`。

### ② 回退「为测试而导出」的接口

这些是前几轮为了把白盒判据挪出源码目录而导出的，属于白盒残留，
现在没有调用方了，全部收回私有：

    webui.FrontendAsset / DashboardPage        删除
    webui.GraphDataForVisual → graphDataForVisual
    webui.SSEEventRing/Record → sseEventRing/sseEventRecord（含字段）
    webui.NewSSEEventRing                       删除
    kstate.MountForTest                         删除
    security.ClassifyPrincipalForTest           删除

生产代码对它们的内部调用同步改回私有名，不改任何行为。

### ③ CI 一鼓作气改到位（用户指定顺序）

**删**：`整机启动图判据` 单列步骤（它跑的 bootgraph_test.go 已删），
以及 `check-ci-gates.py` 里盯着那个步骤的断言 —— 继续盯着一个
不存在的步骤就是永远红的空转。

**加两道构建期静态门**（原先这些约束错放在 go test 里）：

- `测试归拢（源码目录不得有 _test.go）`
  `find internal cmd pkg providers deploy -name '*_test.go' -not -path '*/test/*'`
  非空即红。物理上挡住白盒回潮。
- `包依赖门（kstate 为叶子 / 底层包不反向依赖装配器）`
  用 `go list -deps` 判 8 组禁止依赖 + `go build core` 确认环不存在。
  这是**工具链**的职责，不该由 `go test` 兼职。

`check-ci-gates.py` 同步改为盯这两道门；ci.yml 里 13 处既有
>80 字符行一并折行（门禁标了 STOP，不留尾巴）。

### ④ 顺带（上一批未提交的）

`scripts/make-package.sh` 产物名 `HomeAgent-linux-*` →
`HologramAgent-linux-*`；清理 gitignored 构建产物
`build/ dist/ .go/ .npm-cache/` 共 20G（工作区 21G → 1.7G）。
运行契约（~/.homeagent/cli.sock、线上域名、兼容别名）未动。

## 验证

    go build ./...                     PASS
    go vet ./...                       PASS
    gofmt -l                           干净
    python3 .github/scripts/check-ci-gates.py   PASS
    go test ./... -count=1             5 个测试包全过 / 100 个包无测试 / 0 FAIL
    源码目录 _test.go 数              0
    测试文件数                         9（全部在 <module>/test/）

## 后续

按模块导出接口清单重写判据（不是从旧白盒里抽）：
internal/agent/api、internal/memory、internal/security、internal/plugin、
internal/knowledge、cmd/* 等目前 0 判据，需要逐个列接口 → 写输入→输出判据
→ 变异验证。这是新一轮工作，本提交不含。

2026-11-09 11:13:56 +08:00

JianFeeeee

1d38353498

refactor(webui): SSE 事件环判据迁到 test/ —— 导出环类型与记录字段

handler_sse_test.go → test/          （6 条判据）
    webui/       167 → 161
    webui/test/   35 →  41
    合计 202 不变

## 原来那 6 条判据读的是私有字段

    len(r.buf)
    r.buf[0].ID / .EventType / .Data

`sseEventRing` 的对外语义就三条：容量上限、按 Last-Event-ID 重放、
未知 ID 回退全量。它们全部可以从**导出接口**断言：

    NewSSEEventRing(cap)        构造
    Append(id, type, data)      写入
    After(id) []SSEEventRecord  重放

所以导出 `sseEventRing → SSEEventRing`、`SSEEventRecord` 的字段、
以及构造入口 `NewSSEEventRing`。

**为什么这不是"为测试导出内部"**：`After` 返回的东西就是客户端断线
重连时实际收到的内容 —— id、event、payload 三样。它们是外部可见的输出，
把字段藏起来只让包内测试能读，才是反过来的怪事。

测试侧的 `r.buf[i]` 统一换成 `r.After("")[i]`（空 ID 命中不了，按约定
回退全量），语义等价且不再触碰内部状态。

## 判据有效性（变异验证）

把容量裁剪短路掉（`if false && len(r.buf) > r.cap`）：

    --- FAIL: TestSSEEventRing_Append_Capacity
        expected 3, got 5

环不再丢最旧条目 ⇒ 断线重连会重放超过窗口的历史，客户端 Last-Event-ID
语义失效。恢复后全绿。

## 验证

    go build ./...                  PASS
    go vet ./...                    PASS
    gofmt -l                        干净
    go test ./... -count=1          67 包全过，0 FAIL

2026-11-04 22:21:54 +08:00

HomeAgent Agent

4a00922ec3

refactor(webui): handler.go 2993 行按资源拆成 11 个同包文件

拆法：按「资源面」搬家，每个顶层声明（func/type/var/const）整体搬到目标文件，
声明体一字未改，各文件按实际用到的包重新生成 import。文件头加一行说明本文件负责哪一面。

  handler.go              骨架：嵌入前端资源、Handler/构造、路由表、鉴权会话日志中间件、静态页
  handler_chat.go         对话面：消息模型与内存历史、SSE 事件订阅、对话/历史接口
  handler_upload.go       上传面：handleChatFile / handleUploads / 中断对话
  handler_memory.go       记忆面：图/文档/文本记忆、知识库、LLM 源、变更追踪
  handler_agents.go       内核与代理面：状态、kernel、人格、代理/快照/回滚
  handler_settings.go     设置与插件面：配置读写、插件列表详情（含 pluginmgr 反代）
  handler_terminal.go     终端面：终端会话、终端接口、命令历史
  handler_sse.go          SSE 环形缓冲（断线重连补发）
  handler_openai.go       OpenAI 兼容面：/v1/chat/completions
  handler_device.go       设备网关反代（HTTP + WS 升级透传）
  handler_files.go        /files/ 与 /uploads/ 下载

零漂移校验：拿重构前的 handler.go 与新 11 个文件逐行比对（忽略空行、package/import 头），
**丢失行 0**；新增行恰好是 11 个文件头注释（14 行）。

顺带修掉 import 里两处假使用：handler_openai 的 sdk 只作为 Handler 字段名出现（h.sdk.），
handler_settings 的 fmt 只出现在注释里 —— 都从 import 里去掉。

验证：go build ./... / go vet / webui+config+sdk 测试全绿；
起真实实例（沿用已有 data 目录）后 /status /settings /chat/history /plugins /terminals
/kernel /memory /config /login 全部 200，设置在注入 5MB 历史的情况下仍是 33,921 字节。

最大文件从 2993 → 706 行（handler_chat.go）。

2026-09-14 07:03:47 +08:00

3 Commits