AskaEth/Cyrene_v2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
661 Commits 7 Branches 0 Tags
4df8d6f53aabd1d7b66c19c257a677dc6ebcabbc
Commit Graph
9 Commits
Author SHA1 Message Date
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 378faf212e feat(browser): 取正文能力 + web-fetch 浏览器降级档接线（解封 Z5/B5）
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
Z5（c2e413e）把 web-fetch 的降级链与注入点做完了，但「取正文」入口缺失 ⇒
组合根拿不到 BodyRenderer、这一档实际关着（当时如实登记）。本片补上：

- internal/capability/browser/render.go：新增 Manager.RenderText(ctx,url)
  （导出的进程内能力）—— 先过 GuardURL（与全仓同一份 SSRF 判定源）、复用
  withSession/session、等 readyState=complete 之后才取 body.innerText；
  渲染失败 = 分类错误，渲染成功但正文为空 = 空串+无错（不冒充成功/失败）。
- cmd/cyrene/wire_body_fallback.go：适配器 + 挂载点，把 Manager 适配成
  io.BodyRenderer 并用 WithBrowserFallback 挂上；web_runtime 里把浏览器
  接线**上移到 io 工具集之前**（顺序颠倒会静默关死这一档）。
- plugins/tools/browser/tool.go：新增 Tool.Manager()，供组合根取驱动句柄。

开关口径（裁决，依据 design/28 §1 M5 / §7 判据 4 / §8 B5）：**有可用浏览器
就挂，没有就不挂**，不新增开关 ——
① 设计把 M5/B5 写成要落地生效的降级档，不是永远关着的空壳；
② 设计 §8 的可调项清单里没有这条降级档的开关，`.env` 已冻结 ⇒ 自造开关属
   「自行发挥」；
③ io 库层「不传 = 默认关」的语义一字未改，本片只把组合根从「永远关」改成
   「没来源就关」，并留带来源的 WARN（reason=no-usable-browser）。
⚠️ 若日后要「有浏览器也需显式开启」，得先给设计定开关落点，代码侧一行改回。

验收（主会话复跑 + 亲自变异）：go build ./... + 三包 vet 绿；browser/io 两包
测试绿（cmd/cyrene 由子代理跑过全绿）；我用 -overlay 把 GuardURL 的判定对象
换成常量 URL（绕过被拒目标）⇒ TestManager_RenderTextBlockedURLRejectedBeforeAnyProcess
变红，证明判定确实**在起任何进程之前**跑。

⚠️ 生产端到端未验：按红线没重启后端、没起真 Chrome ⇒「真页面 → browser 取到
正文」这条链只有假 CDP + 组合根接线级证据。
⚠️ design/28 有 6 处表述与代码现状冲突（归属 web-fetch vs web-search、extract
动作归属、B5 排期、状态过期等），已登记待我同步文档。
 2026-10-07 09:59:56 +08:00
AskaEth c2e413ec38 feat(io): web-fetch 直连→浏览器渲染降级档 + fetchedBy 如实标注（Z5 机制）
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
- 降级链：直连失败 / 判定为动态页 ⇒ 浏览器渲染取正文；返回体带 fetchedBy=direct|browser，
  两条档的失败各自留痕（directError/browserError/browserSource/dynamicSuspect），**绝不静默替换**
- 被 SSRF 拒绝的目标**不换路**（红线）；渲染器缺位时如实报双失败
- 3 个变异自检（去掉动态页判据 / 去掉 SSRF 短路 / 掩盖双失败）
⚠️ **生产接不通**：internal/capability/browser 没有「取正文」入口（不在本片文件面）⇒
   开关默认关、不假装可用；解封形状已在报告里给出（加 RenderText ≈40 行）
 2026-10-07 09:34:47 +08:00
AskaEth 2d211c2d16 feat(backthink,browser): 自排工具面 C1-3 + 浏览器两处偏离收口（X2+X3 同文件一并落） 
X2 C1-3（自排工具面与提示词）：
- request_think（thinktool.go，照 transcode/tool.go 范式）+ reason 必填/urgency 闭集 + 双守门
  （安全闸 + owner 判定：群聊/陌生人一律拒）
- **成对**进两张唤醒态允许集（quiet + awake；CAPACITY_TOOL_SETS 是整体替换）
- 提示词抽共用段落 + 自排前缀优先（不枚举工具清单）；面板加 self_wake 标签与筛选轴
- 4 个变异自检（拿掉 owner 判定/只加一张表/放宽 urgency/前端标签恒等）

X3 收口（与 X2 共用 wire_services.go ⇒ 一并落）：
- 删掉第三份 SSRF 实现（guard.go），改由 io.ValidateRequestURL 唯一判定 + 薄门面（保两个错误身份）
- 浏览器会话挂进 a.close（真机：真 Chrome 被关、无残留、生产未扰动）
- a.wireBrowser() 归位到 wire_runtime.go，删掉 ioToolOptions 的临时挂点
- 5 个变异自检

顺带补提交 C1-2 漏掉的 internal/config/runtimeconfig/backthink_test.go（ed50053 漏 add）。
 2026-10-06 21:16:23 +08:00
AskaEth f1fbc249fd feat(browser): B1 接线 + B2 薄层工具面（V5）
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
- browsercfg 接进组合根：配置读 $DATA_DIR/config/plugins/browser.json（零 env）→ 探测（本机
  Chromium → 已在跑的 CDP）→ 不可用就不注册（原因码入日志）
- 自研最小出站 CDP 客户端（不 Enabled Runtime、隔离世界求值、不发 --enable-automation）+
  导航 + 截图 0600 落盘 + 指纹自检；工具 browser（open/screenshot/info，owner-only）
- 3 个变异自检（启动恢复 --enable-automation/无视可用性/空闲回收失效）
- 真机对照（两站各 1 次，**如实结论**）：两侧都 pass ⇒ 「headless 被拦 / headful 通过」**未被证明**；
  但测到两处硬差异：无头 UA 带 HeadlessChrome、screen 800 vs 2632；两模式 webdriver 均 false
  （把 L6 的推断变成实测）。跑完 0 残留 Chrome、无对外监听端口
⚠️ 未做：MCP 自动接入（口径委派未落地）/自动注入上下文/面板页/搜索降级/docker 配方/Windows 用
  pipe（Go ExtraFiles 不支持）；SSRF 落了第三份同策实现待收口；浏览器会话未挂进程关闭链
 2026-10-06 20:25:16 +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
AskaEth 8e6c77ad10 feat(search): web-search 接线本机 SearXNG 兜底 + 显式开关（她不再拿一把用不了的锤子）
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
Details
CI / Frontend (tsc + vite build) (push) Has been cancelled
Details 
主人报的故障：她调 web-search 必失败（no search endpoint configured）。根因两条：组合根从未注入 WithSearchEndpoint + 配置层根本没有搜索配置项。
- internal/config/websearch.go：WEB_SEARCH_ENDPOINT（默认本机兜底 http://127.0.0.1:38471）+ WEB_SEARCH_TIMEOUT；ResolveEndpoint() 三态裁决（可用/显式关闭/非法），非法值启动即报错
- cmd/cyrene/wire_io_tools.go：组合根唯一的 io 选项装配点；端点不可用 ⇒ WithoutSearch() + 带 source 的 WARN（只记键名与原因，不打印 URL 值）
- plugins/tools/io：新增 WithoutSearch()（**根本不进注册面** ⇒ 模型看不见）+ WithSearchTimeout()；协议解析逻辑一字未动
- 隐蔽坑（额外查出并修）：SearXNG 对 /?q= 回 308 → /search，重定向那一跳走**共享 SSRF 白名单** ⇒ 只注入端点照样被拦。改为**只给 web-search 一件**加宽自己的客户端与白名单，共享白名单与 http/web-fetch 客户端一字未动（有测试钉住它仍拒绝本机网关地址）
- .env.example 新增 2 键 + 注释说明「空串/off/none = 不注册」
- 真机 e2e 两次绿（SearXNG 返回 9 条）；变异：不注入端点 / 关闭态仍注册 / 默认值改错 / 不并入端点主机 / 重定向用共享白名单 ⇒ 5 条全红
 2026-10-05 20:29:21 +08:00