homeagent-sdk

jianf/homeagent-sdk

Fork 0

mirror of https://gitcode.com/JianFeeeee/homeagent-sdk.git synced 2026-09-20 17:08:01 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	e50bffa34f	fix(deepsearch): 只关自己拉起的 SearXNG；条数改由插件侧截断两个都由「真调用/真测试」暴露，且都会让线上搜索表现为「后端不可用」。一、归属：接管不等于拥有（例：E2E 测试把生产后端带走）旧实现只要探活成功就认领关闭责任 → 同机第二个实例（测试拉起的插件、另一个 daemon）退出时就 docker compose stop 掉线上正在用的后端。实测：跑一次 `go test ./internal/plugins/ -run TestRealPlugin_DeepSearch`，teardown 即关停 127.0.0.1:8888，用户看到的就是「搜索后端起不来」。修：只有真正执行过 `docker compose up -d` 的实例才算「我们起的」；探到已在运行只接管。二、条数：SearXNG 不认 count/limit（count/max_results 形同虚设）实测 ?count=3、?limit=3、不带参数返回完全相同的 35 条，所以截断必须在插件里做。旧实现把 count 当 limit 参数发给 SearXNG 就以为生效了 → 模型每次吞 35~58 条带摘要结果，还会把「命中 N 条」当成「拿到了 N 条」报给用户（实测发生过）。修：新增 limitResults（默认取 max_results，上限 20）；输出改成「命中 N 条，返回前 M 条」；不再发无意义的 limit 参数。验证：22 项单测全过、-race 干净、vet/gofmt 干净；两条归属测试做过扰动（把旧语义放回去后必红，并如实打出它执行的 `docker compose stop -t 2`）；内核 E2E 三条通过且跑完 healthz 仍 200、容器未重启；线上 1.1.2 实测 count=3 → 「命中 40 条，返回前 3 条」。版本 1.1.0 → 1.1.2。	2026-09-13 09:55:27 +08:00
JianFeeeee	7c0b7a1fb0	feat(deepsearch): 联网检索插件 + SearXNG 生命周期托管把原 websearch 示例改名为 deepsearch（目录/go.mod/plg.json/工具前缀/README 全量对齐，工具名 websearch_* → deepsearch_*）。新增 searxng.go：插件自己托管搜索后端 - 启动探 healthz：已在跑则直接接管（不重启），没跑就 docker compose up -d 并等就绪 - 关闭动作注册为 stop handler（幂等、限时 4s < 内核 5s 宽限期） - 配置 manage_searxng / searxng_dir / stop_searxng_on_exit - 崩溃/被 kill 时不关后端（下次启动接管）：安全失败方向 - 可注入 cmdRunner + 时间预算，8 项单测离线覆盖接管/拉起/失败/幂等/保留契约依据（internal/plugin/proc）：停止插件 = plugin.stop → RunStopHandlers（LIFO、幂等）→ Stop() → exit(0)，宽限期 5s；stdin 关闭同路径。验证：19 项单测（18 通过 + 1 联调跳过）、-race 干净、vet/gofmt 干净；内核 E2E 真调用返回 58 条/37 条、58/58 带摘要；线上 daemon 实测 stop handler 与冷启动（约 3s）。	2026-09-12 23:16:23 +08:00

Author

SHA1

Message

Date

JianFeeeee

e50bffa34f

fix(deepsearch): 只关自己拉起的 SearXNG；条数改由插件侧截断

两个都由「真调用/真测试」暴露，且都会让线上搜索表现为「后端不可用」。

一、归属：接管不等于拥有（例：E2E 测试把生产后端带走）
  旧实现只要探活成功就认领关闭责任 → 同机第二个实例（测试拉起的插件、另一个 daemon）
  退出时就 docker compose stop 掉**线上正在用的**后端。实测：跑一次
  `go test ./internal/plugins/ -run TestRealPlugin_DeepSearch`，teardown 即关停
  127.0.0.1:8888，用户看到的就是「搜索后端起不来」。
  修：只有真正执行过 `docker compose up -d` 的实例才算「我们起的」；探到已在运行只接管。

二、条数：SearXNG 不认 count/limit（count/max_results 形同虚设）
  实测 ?count=3、?limit=3、不带参数返回**完全相同的 35 条**，所以截断必须在插件里做。
  旧实现把 count 当 limit 参数发给 SearXNG 就以为生效了 → 模型每次吞 35~58 条带摘要结果，
  还会把「命中 N 条」当成「拿到了 N 条」报给用户（实测发生过）。
  修：新增 limitResults（默认取 max_results，上限 20）；输出改成
  「命中 N 条，返回前 M 条」；不再发无意义的 limit 参数。

验证：22 项单测全过、-race 干净、vet/gofmt 干净；两条归属测试做过扰动（把旧语义放回
去后必红，并如实打出它执行的 `docker compose stop -t 2`）；内核 E2E 三条通过且
**跑完 healthz 仍 200、容器未重启**；线上 1.1.2 实测 count=3 → 「命中 40 条，返回前 3 条」。

版本 1.1.0 → 1.1.2。

2026-09-13 09:55:27 +08:00

JianFeeeee

7c0b7a1fb0

feat(deepsearch): 联网检索插件 + SearXNG 生命周期托管

把原 websearch 示例改名为 deepsearch（目录/go.mod/plg.json/工具前缀/README 全量对齐，
工具名 websearch_* → deepsearch_*）。

新增 searxng.go：插件自己托管搜索后端
- 启动探 healthz：已在跑则直接接管（不重启），没跑就 docker compose up -d 并等就绪
- 关闭动作注册为 stop handler（幂等、限时 4s < 内核 5s 宽限期）
- 配置 manage_searxng / searxng_dir / stop_searxng_on_exit
- 崩溃/被 kill 时不关后端（下次启动接管）：安全失败方向
- 可注入 cmdRunner + 时间预算，8 项单测离线覆盖接管/拉起/失败/幂等/保留

契约依据（internal/plugin/proc）：停止插件 = plugin.stop → RunStopHandlers（LIFO、
幂等）→ Stop() → exit(0)，宽限期 5s；stdin 关闭同路径。

验证：19 项单测（18 通过 + 1 联调跳过）、-race 干净、vet/gofmt 干净；内核 E2E 真调用
返回 58 条/37 条、58/58 带摘要；线上 daemon 实测 stop handler 与冷启动（约 3s）。

2026-09-12 23:16:23 +08:00

2 Commits