AskaEth/Cyrene_v2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
789 Commits 7 Branches 0 Tags
39ae883a4e14faf37dcc00d57daadb87e77663ba
Commit Graph
10 Commits
Author SHA1 Message Date
AskaEth 33ea7a830f style(search): 修 zhipu.go 的 gofmt 对齐（改动前即存在的格式债）
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
spec 字面量的三行对齐空格多余，gofmt -l 一直报它。零语义变更：
只删多余空格，gofmt -l 现已全干净。
 2026-10-07 13:42:58 +08:00
AskaEth ce9af42945 feat(search): 新增腾讯云·元宝搜索与秘塔搜索两家 provider
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
接入位表六家扩到八家，端点形状与错误码一字未改（契约 v0.87，仅两处名单）。

- tencent_wsa：POST {base}/SearchPro + Authorization Bearer，零签名。
  两条官方口径决定实现：HTTP 状态码恒 200（判失败只能读 Response.Error.Code）；
  Pages 是「JSON 字符串数组」需二次解析。错误码按官方表分类
  （UnauthorizedOperation/AuthFailure.* = 凭据、ResourceUnavailable = 欠费、
  RequestLimitExceeded* = 限流），文案只带 code 不带上游 Message。
- metaso：POST {base}/api/v1/search，响应 schema 仅第三方来源且互相打架，
  实现走宽松解析（数组候选与字段名回退），逐处标「未实测」。
- 零新 env 键：两家只走 $DATA_DIR/config/plugins/web-search.json，
  .env / .env.example 未动；组合根 websearch_providers.go 零功能改动。
- 契约 v0.87：values.provider 合法闭集与 plugin.providers 候选各加两条，
  计数不变（14 + 25 + 40 = 79）。
 2026-10-07 13:42:41 +08:00
AskaEth c68387a69a feat(search): 面板上终于能改「结果条数上限」（原来改了会被静默丢弃）
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
真缺陷（上一片登记）：`maxResults` 在面板上**根本改不了** —— ① 字段表里没有这个
字段（UI 不显示输入框）；② `saveProvider` 只并 provider/apiKey/baseUrl/enabled；
③ `mergeSelectionPatch` 只处理 primary/fallback ⇒ **手工塞进 values 也会被静默丢弃**
（文件不变、也不报错）。「我改了它却没变」正是要消灭的那种假话。

- `panel.go`：表单加 `{Key: FieldMaxResults, Type: sdk.FieldNumber, Min: 1}`（**SDK 本就有
  数字类型**，未自造；前端本就渲染 number ⇒ **不需要改前端**）。刻意不设 `Default`
  （设了会让一次「只改 key」的保存把默认值固化进文件、还可能盖掉 `.env`）。
- `websearch_selection.go`：`mergeSelectionPatch` 里按**三态**落 `maxResults` ——
  缺位/null ⇒ **不改动**；正整数（含整数字符串）⇒ 采用；0/负数/小数/空串/非数/
  布尔/数组 ⇒ **400 `invalid_payload`** 且**盘上一字节不动**（绝不静默忽略）。
- `reauth` 回填该值（否则一保存就把上限清掉）。
- `.env.example`：该键的示例值与「默认 5」注释同步为 **10**（代码默认已改；⚠️ `.env` 未动）。

验收（主会话复跑 + 亲自变异）：**整树 `go build ./...` 通过**；三包 vet/测试绿；
端到端「面板存 20 ⇒ 模型要 50 也只给 20、要 3 给 3」（走真 action hub → 落盘 →
热重载 → WithSearchMaxResults → 真 dispatcher，未重启后端）；
我用 -overlay 把 `f.MaxResults = maxResults` 摘掉 ⇒ 两条用例变红
（「面板给的值必须真的落盘」/「回填的 maxResults = 5, want 20」）。

⚠️ 已知取舍（如实登记）：**清空输入框 = 400**（后端按「非数 ⇒ 报错」拒），因此面板上
没有「去掉上限」的手势 —— 要回到 `.env` 兜底得改文件；要支持「清空 = 去掉覆盖」
需另定哨兵语义，未自行发挥。
⚠️ 契约面已变更（面板声明多一个 number 字段 + saveProvider 的 values 多一个可写键 +
响应多一个回显键）⇒ 主会话登记。
 2026-10-07 11:10:56 +08:00
AskaEth 2c56bc9704 fix(search): 「上游没给链接」不再被当成「没有结果」（真机 no results 的根因）
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
真机现象：她自主思考的 4 次 web-search 全部报
`search: no results (provider=zhipu)`，而同一查询直连上游返回 10 条。

根因：`Finalize` 把「link 为空」当成「不是一条结果」整条丢弃。而智谱
`search_std` 的 `search_result[].link` 在真机上**经常整批是空串**（实测同一
payload 连打 6 次：10 条全空 link，title/content 齐全；换查询也见过 6/10 空）。
⇒ 10 条被整批丢光 ⇒ 工具层如实报「一家都没查到」——**那是谎报**。

为什么面板探针是 ok：探针走 `search.Probe → p.Search`，**不过 Finalize**；
工具走 `Execute → p.Search → Finalize`。同一份上游、同一份解析代码，两条路
给出相反结论 —— 探针对这一类缺陷**结构性失明**，以后不能拿探针通不通推断
工具通不通。

修法：无链接条目**照原样保留**（title/content 对模型仍有用，链接空着就空着，
**绝不编一个出来**）；判据改为「link/title/content/snippet **全空**的空壳行才
不算结果」；无链接条目不参与按 link 的去重（没有链接就没有判同身份，宁可重复
也不静默吞）。「空结果 ≠ 成功」**未放宽**：真·空 search_result 仍报 ErrNoResults。

验收（主会话复跑 + 亲自变异）：go build ./... + vet 绿；io 与 search 两包绿；
我用 -overlay 把判据退回缺陷形态 ⇒ TestWebSearch_ZhipuLinklessResultsAreNotNoResults
变红，报错串与真机逐字相同。子代理另用真 key 走 in-process 工具路径实测：
三条当时失败的查询现在各回 10 条。

⚠️ 本修复要等下次 build + restart 才真机生效（现在跑的还是老产物）。
⚠️ 其他四家是否也有空 link 形态未验（无 key）；修复是通用的。
 2026-10-07 10:28:36 +08:00
AskaEth bc1dee3f56 refactor(search): provider 配置面去 env 化 —— 加新家不再需要动 .env
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
动因：`.env` 已冻结（基础键不加/不改/不删），而「加一家 provider」原本会逼出
新的 env 键（一家一个 struct 字段 + searchProviderVector 逐家读 + 逐家写死的
switch）⇒ 想接腾讯云元宝/秘塔就只能破红线。面板本来就该是插件配置的一等来源
（$DATA_DIR/config/plugins/web-search.json），故让**文件成为权威**。

- plugins/tools/io/search/registry.go：接入位表加 defaultBaseURL（「没配 baseUrl
  回落代码默认值」从此只有一个出处）；新增 Descriptor(s)/DefaultBaseURL。
- cmd/cyrene/websearch_providers.go（新）：按接入位表逐家算出生效投影 ——
  加一家时这里**零改动**，这正是本片的核心；顺手把 wire_io_tools.go 从 430 行
  降到 342（它逼近 §10 的 500 行上限）。
- cmd/cyrene/wire_plugin_actions.go / websearch_action_data.go /
  websearch_selection.go：基地址判定统一走「文件值 → 接入位默认值」的进位链；
  checkPrimaryUsable 判据不放松（真没配齐仍 400 primary_not_configured）。

🔴 **一处对我任务书的纠正（子代理提出、我采纳）**：我要求「既有 6 家在文件里
没有该条目时仍回落 .env」。仓库现状**没有**这层回落，且有回归用例把它钉死
（TestWireIOTools_PanelConfigClearedProviderDoesNotReviveFromEnv：「文件里没有
的家不得从 .env 复活」）。本片按「不改变既有行为」实现 —— 我的要求才是错的：
文件一旦存在就是权威，env 只在文件缺失/为空时播种。

验收（主会话复跑 + 亲自变异）：go build ./... + 两包 vet 绿；search 包与
cmd/cyrene 全绿；我用 -overlay 让文件里的 apiKey 被忽略 ⇒ 4 条用例变红
（含「无 env 字段的家只认文件也能进注册表」这条核心判据）。

⚠️ 新家仍未接：腾讯云元宝（tencent_wsa）/ 秘塔（metaso）两片随后串行落地。
 2026-10-07 10:18:58 +08:00
AskaEth c46053e276 feat(admin): 搜索提供商下拉/多选/表格显示中文名（值仍是 ASCII id）
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
主人报障：「为什么中文搜索接口……下拉菜单里全给的英文名？你甚至不愿意带个括号
把中文名写上去」。根因不是漏写文案，而是整条链路没有「显示名」的位置：字段
声明只有 optionsFrom，候选动作回的就是 KnownNames() 的纯 id 数组。

- 后端：候选改为对象数组 {value,label}；label 表与接入位表同源（键用
  NameSearXNG 等常量），未知 id 原样回。value 逐字等于 KnownNames()。
- 前端：下拉/多选「显示 label、写 value」；表格单元格按 value→label 索引显示，
  查不到回落显示原值。多选从裸输入框改成「候选开关 + 落盘值输入框」。
  解码器本就兼容裸字符串/{value,label}/{id} 三形状 ⇒ 其他插件零影响。

中文名逐字：SearXNG 本地兜底（searxng）/ 智谱 BigModel（zhipu）/
阿里云 IQS 信息查询（aliyun_iqs）/ 博查 Bocha（bocha）/
火山引擎·豆包搜索（volcengine）/ 百度千帆 AI 搜索（baidu_qianfan）。

验收（主会话复跑 + 亲自变异）：go build ./... + vet 绿；search 包测试绿；
tsc --noEmit 0 错；新渲染测试 26 checks + 既有 plugin panel 55 / data 90 /
schema values 40 / channel config 70 全绿。我用 sed 把 values.ts 的
option.value 全换成 option.label ⇒ 渲染测试红（「点选把候选项的 id 追加到
降级链末尾」got="bocha, 智谱 BigModel（zhipu）"）—— 这正是会把配置文件写坏的
错法；还原后 md5 一致且绿。

⚠️ 契约面变更（我在 Docs/api-client.md 登记）：plugin.providers 候选响应形状
字符串数组 → 对象数组；label 仅供显示、value 才是落盘值。
⚠️ 已知边界：viewer 角色看不到 form 区块 ⇒ 表格对 viewer 仍显示裸 id（未做）。
⚠️ 真机浏览器点击未跑（项目无 jsdom）⇒ 建议刷新管理页点一次确认观感。
 2026-10-07 10:08:19 +08:00
AskaEth 25aa50e532 feat(search): 智谱 provider 按官方 schema 加固（请求补确证字段 + 错误码分档）
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
官方文档逐页确证后落地的四件（分册 11 的「官方 schema 确证（2026-10-07）」）：
- 请求补 search_intent:false（官方标 required，缺发可能触发 1213）与
  content_size:medium；count 仅 1–50 透传，越界不发该字段；
  search_query >70 rune 直接报错且**不发请求**；
- 响应按官方收窄：摘要只认 snippet/summary/abstract 候选（官方响应**没有**
  snippet），publish_date 入 Published；
- 错误码分档：1000/1001/1003⇒unauthorized、1113⇒quota_exceeded、
  1302/1305⇒rate_limited。🔴 1113 与 1302/1305 **同为 HTTP 429** ⇒ 只看状态码
  分不开「该充值」与「该退避」，必须读 error.code（码同时进日志文案）；
- media/icon/refer 当前一律不投影（Result 没有「来源站点」位；要投影应给
  Result 加字段 + 同步契约，不许塞进 Snippet —— 否则摘要位会被站点名恒填满）。

另修两处过期注释（providers_test.go 仍写「只发 search_engine/search_query」）。

验收（主会话复跑 + 亲自变异）：go vet 绿；search 包与调用方 io 包全绿；
我用 -overlay 删掉 1113⇒quota_exceeded 映射 ⇒ TestZhipuErrorCodeMapping 变红
（欠费被误报成限流、探针码 rate_limited）。

⚠️ 候选键容错暂未删除：官方已排除的键保留到**真机实测通过后**再收窄（现无 key）。
⚠️ 真机未跑：仍只打 httptest，官方真实响应形态未实测。
 2026-10-07 09:59:24 +08:00
AskaEth a30f4a49ff feat(search): provider 热重载 + primary/fallback（W3） 
- 保存被包成事务：快照 → 落盘 → 按新配置重建工具 → 原子替换注册表条目（registry.ReplaceTool
  窄方法，保留运行期 Policy）；下一轮即生效，不要求重启
- 若新配置会让后端下次起不来（主家未配齐 fail-fast）⇒ 文件按字节回滚 + 409 config_unstartable
- 声明面补 primary + fallback[]（可配可生效）；否决「另开 form」方案（会破坏既有 reauth 回填）
- 主 provider 解析口径核查结论：没被 PLG-4 改坏（顺手修了一处日志缺陷）
- 4 个变异自检（丢 Policy/不换条目/回滚 no-op/忽略 fallback）
 2026-10-06 15:59:12 +08:00
AskaEth 120d926cf8 feat(search): 搜索 provider 可变源 + 插件声明面板（PLG-4） 
- 新增 $DATA_DIR/config/plugins/web-search.json（0600 + temp+rename，文件名 = 插件 id）
- 组合根改「先读可变源、缺失回落 .env 播种」；**不新增任何 env 键**（.env 已冻结）
- 多实例：每家 provider 独立 key/baseURL/启用态 + 「测试连通」探针
- 用 PLG-1 的声明库给出该面板的 adminPanels 声明；动作名交给 PLG-2 的通用动作端点分发
  （本片自己不开路由）

⚠️ 本片自认越界：改了 cmd/cyrene/wire_web_search_test.go（既有测试，为适配 DataDir）；
  另有 design/28 的相关注册留给主会话。
 2026-10-06 09:04:04 +08:00
AskaEth 69a3b73777 feat(search): 原生 provider 层（searxng/智谱/阿里IQS/博查/火山/百度）+ 降级链（契约无改动） 
主人定调「先把原生的做进插件，MCP 路线等后端 MCP 完善后再接」。
- 新包 plugins/tools/io/search/：一 provider 一文件 + 共享 http/提取器 + 归一化 Result；域名过滤/去重/排序**归一化后统一做一次**
- 配置 15 键：WEB_SEARCH_PROVIDER(默认 searxng)/_FALLBACK/_MAX_RESULTS + 五家 ×(API_KEY/BASE_URL)；WEB_SEARCH_TIMEOUT 语义改为「**每次上游尝试**」（降级链才有意义）
- 硬语义：未注册/未配置的主 provider ⇒ **启动期报错**（不许静默回落）；off ⇒ 不注册工具；缺 key 的家不进可用清单；降级链**如实标实际应答的 provider**（变异：拿主力冒充 ⇒ 测试红「provider = zhipu, want bocha」）
- 密钥绝不进日志/响应（有断言）；错误分类（鉴权/限流/额度/网络）+ **空结果 ≠ 成功**（变异暴露过一个死分支⇒下移到 searchWith 修掉）
- searxng 真机 e2e 通过（provider=searxng 5 条）；**其余五家无 key ⇒ 如实标未实测**；契约无改动（无新端点、工具 schema 不变）
- 注册表留好 B 档接入位（tavily/exa/firecrawl/serper/serpapi），并有「未登记⇒启动报错」的防回归断言
 2026-10-05 22:38:20 +08:00