|
|
6538f01555
|
docs(web-access): sync site-pattern baselines off the retired Playwright fallback (#86)
## What / 变更内容
S31（#85）把 `web-access` 技能升到 v3.0.0，删掉了 `SKILL.md` 与
`references/browser-tools.md`
里「用户手工启动带 `--remote-debugging-port` 的 Chrome + Python Playwright」的回落路径，但
**5 个 per-site 基线文件未同步**，仍然引导 Agent 在正文抽取（以及部分站点的登录态复用）上
回落到已废弃的 Playwright / 外部 CDP：
- `references/site-patterns/zhihu.com.md`
- `references/site-patterns/weibo.com.md`
- `references/site-patterns/bilibili.com.md`
- `references/site-patterns/xiaohongshu.com.md`
- `references/site-patterns/feishu.cn.md`
本 PR 把这 5 处旧表述替换为已落地的内置浏览器能力：
- 正文抽取 → `BrowserAct(page.extract-text)`（format/maxBytes/nextCursor 分页）
- 知乎/B站的「批量回答/评论」抽取 → `BrowserAct(page.element, op: all-inner-texts,
selector: loc=css:...)`
（九 op 判别式命令的只读档，一次拿全部匹配元素文本）
- 登录态未授予 `browser.import.*` 时的处置，由「直接回落 / 回落 CDP」改为「如实告知用户无法复用
登录态，按未登录继续或放弃」，与 `references/browser-tools.md` 里 `BrowserImport` 一节已修好的
措辞对齐
- 各文件 `历史更新` 追加一条同步记录；`SKILL.md` 版本号 `3.0.0` → `3.0.1`
（只改 `references/*`，未改 `SKILL.md`/`SKILL.zh-CN.md` 正文，`source_hash` 不受影响）
`references/browser-tools.md` 现存的 2 处 "Playwright" 字样经核实均为**已移除**的历史性陈述
（"…并移除 Python Playwright 回落"、"无需…Python / Playwright"），不构成误导性指令，本 PR
未改动该文件。
Refs: desirecore/desirecore#2074, #85
## Test plan / 测试计划
- [x] 通读改动后的每个 site-pattern 文件：新写法对应的能力（`page.extract-text` /
`page.element`
op: `all-inner-texts`）均已在 v3.0 落地，未引用不存在的参数
- [x] `compute_source_hash` 只 hash `SKILL.md` frontmatter 之后的 body +
i18n strings，本次只改
`references/*.md`，不触发 source_hash drift
- [ ] CI（i18n validate）
- [x] CLA
|
2026-08-19 20:22:27 +08:00 |
|
|
|
b2865d501d
|
fix(web-access): 修正内置浏览器工具文档与客户端版本门控 (#73)
跟进 desirecore/desirecore#1718 的 Codex review，修掉 web-access v2.1.0 正文中 4 处与真实工具实现不符的地方（均对照 desirecore@origin/dev 源码核实）：
- 补 market.required_client_version: 10.0.98，避免老客户端把可用的 v2.0 换成调用不存在工具的说明
- BrowserImport 动作名修正：真实枚举 discover/create_plan/dry_run/apply/rollback/list_plans，无 'plan'；domains 由 create_plan 消费；planId 前缀 bimp_
- input.wheel 示例补 x/y（schema 硬要求），capabilities 示例补 browser.input.pointer.wheel 并说明显式列表是做减法
- BrowserImport 降级为需额外授权的可选路径：browser.import.* 不在 agentDefault 内且 agentElevated 在工具层零引用，登录态默认改回 L3-fallback CDP
skill 2.1.0 → 2.1.1，manifest 1.2.19 → 1.2.20，human-locked 的 en-US 已重新对齐 source_hash。
|
2026-08-07 23:54:03 +08:00 |
|
|
|
af4176bbd7
|
feat(web-access): 迁移到内置受管浏览器工具（v2.1.0） (#72)
## 变更说明 / Description
### 中文
客户端 v10.0.98（desirecore/desirecore#1596）停用了旧的 `BrowserListTabs` /
`BrowserNavigate` / `BrowserEval` / `BrowserClick` / `BrowserScreenshot`
/ `BrowserScroll` / `BrowserSetFiles` / `BrowserCloseTab` 及其 cdp-proxy
后端，调用会直接返回「该旧 BrowserXxx/cdp-proxy 入口已停用」。而 web-access v2.0.2 的
`provides.tools` 仍声明这批工具——技能激活后注入的是一组必然失败的工具。
本次把 `provides.tools` 换成统一浏览器工具，并同步正文与参考文档：
- `provides.tools`：`BrowserManage` / `BrowserSnapshot` / `BrowserAct` /
`BrowserImport` / `BrowserShare` + 保留 `SitePatternRead` /
`SitePatternWrite` / `LocalBookmarks`
- 中英文 SKILL 正文同步改写（L0 / 能力描述 / 决策树 / 四层策略表 / L3-fast 速查 / 反模式）
- `references/browser-tools.md` 整篇重写为新 API + 实测边界
- 5 份站点经验（小红书 / B站 / 微博 / 知乎 / 飞书）的流程改用新工具
- 版本 2.0.2 → 2.1.0，`updated_at` 更新，i18n `source_hash` 重算
**L3-fast 的定位相应收窄**：内置浏览器负责「到达 + 交互 + 截图 + 隔离」，抽取长正文仍回落 Jina
Reader（公开页）或 Playwright（登录态）——理由见下方实测。
### English
Client v10.0.98 retired the legacy `BrowserXxx` tools and the cdp-proxy
behind them, so web-access v2.0.2 was injecting a set of tools that
always fail. This PR migrates `provides.tools` to the unified browser
tools and rewrites the body, the browser-tools reference, and the five
site-pattern playbooks accordingly. L3-fast is re-scoped to
navigation/interaction/screenshots; bulk text extraction still falls
back to Jina Reader or Playwright.
## 测试方式 / Test Plan
在客户端 v10.0.98 + `electron-embedded` Provider 上实测：
- [x] `provides.tools` 里 8 个工具 ID 全部在 builtin registry 中存在
- [x] 把本 PR 的技能装进 dev 实例，带 `skillIds:['web-access']` 驱动智能体：真实调用
`BrowserManage(create_space)` → `BrowserManage(start_session)` →
`BrowserAct(tab.navigate)` → `BrowserManage(close_session)`，全部 success
- [x] `scripts/i18n/validate-i18n.py` 全仓库通过（中英文标题数一致、source_hash 一致）
文档中记录的边界均来自实测，而非推测：
| 边界 | 实测现象 |
|------|---------|
| 截图前必须 `tab.activate` | 标签页默认停在 `(-10000,-10000,1x1)`，直接截图卡满 30s
deadline 并触发 `browser.host.gone`，之后全部 `BROWSER_TAB_HOST_NOT_FOUND` |
| `page.evaluate` 不是取文通道 | 每次调用需人工审批；字符串/对象返回值被替换为
`[REDACTED:browser-runtime-value]`，仅 number/boolean/null 穿透 |
| `accessibility` 快照真实页面不可用 | example.com 正常返回 StaticText；维基百科条目一律
`BROWSER_RESULT_TOO_LARGE`（2 MB 上限，且 `depth` 参数被宿主忽略） |
| `semantic` 快照不含正文 | 只列 button / input / a 等可交互元素 |
## 风险与回滚 / Risk and rollback
- 纯技能内容变更，无脚本或清单结构改动
- 需要客户端 v10.0.98+；旧客户端装到本版会拿到一组不存在的工具名（旧客户端上原本那批工具也已失效，不构成回退）
- 回滚即 revert 本 PR
|
2026-08-07 23:53:28 +08:00 |
|
|
|
0100aec989
|
feat(web-access): v2.0 — Skill-Scoped 工具门控 + cdp-proxy 子模块 + BrowserXxx 工具家族
升级 web-access 技能 v1.1.2 → v2.0.0，与 desirecore/desirecore PR #536 同步。
新增内容（在 i18n 1.1 schema 下保持双语一致）：
- SKILL.md / SKILL.zh-CN.md：补充 BrowserXxx 工具家族说明、L3-fast vs L3-fallback
分层策略（默认 BrowserXxx，复杂场景兜底 Python Playwright）、SKILL 激活前后的
hidden 工具门控行为、SitePattern 三层学习库语义
- frontmatter 新增 `provides.tools`：声明 11 个 hidden 工具（8 个 BrowserXxx +
SitePatternRead/Write + LocalBookmarks），客户端按 Skill 激活解锁
- references/browser-tools.md：8 个 BrowserXxx 工具的完整参数与典型用法
- references/site-patterns/ 5 个基线站点模板：xiaohongshu / bilibili / weibo /
zhihu / feishu，含 _index 总览
manifest.json：stats.lastUpdated 同步到 2026-05-06。
关联：
- 主仓库 PR：desirecore/desirecore#536
- ADR-027 Node CDP 代理子模块（desirecore-docs）
|
2026-05-06 12:05:39 +08:00 |
|
