Skip to content

v1.2.0 — browser_cookies:读/设/删 cookie(凭据面写进 SECURITY)

Choose a tag to compare

@angelky7 angelky7 released this 30 Oct 12:10
· 59 commits to main since this release

v1.2.0

新工具 browser_cookies(读/设/删 cookie,roadmap 1.1.0 第 3 条,零新权限)。

这一版改了 extension/——扩展必须重装(新增了 cookie 三条命令);插件也要更新到 1.2.0。

browser_cookies

action: "get" | "set" | "remove",用途是复制登录态、清理站点状态、跨标签共享会话——BrowserSkill 明确没有的能力。

  • 三条扩展命令,不是一条带 action:cookies.get / cookies.set / cookies.remove。写/读分类与只读闸门都按命令名判,三条各有名字,对账台才盯得住。
  • get:Network.getCookies(urls:[tab.url]),只回这一页可见域的 cookie(count === total);domain 参数做子串过滤、大小写不敏感。值原样进模型可见文本——cookie 值就是凭据(session token 也在里面),这是这条工具的定义(复制登录态靠它),不是副作用;SECURITY.md 中英都已写明「敏感级别等同页面密码」。
  • set:需要 url 或 domain 锚点(都缺直接报错,一次 CDP 都不发);sameSite 只收 Strict/Lax/None;expires 是 Unix 秒、省略即会话 cookie。浏览器拒绝(success:false)时如实报错并给常见原因(Secure 配了 http 锚点、domain 与页面不同源、SameSite=None 没开 secure),不假装成功。
  • remove:CDP 的 deleteCookies 不回执删没删到——按同一片可见范围复查一次,remaining 如实报(>0 时 left 列出还剩哪颗在哪个域);复查失败报 remainingChecked:false,不假装删干净。
  • 分类按既定判据:cookies.set / cookies.remove 是幂等的(重设同一颗、重复删同一颗,结果不变),所以 effectState 按「重试会不会造成额外损害」算只读;但它们改浏览器状态,所以只读档(readOnly: true)拒。cookies.get 进只读白名单(读浏览器状态,无副作用)。
  • 工具面按 action 分发到三条命令,三条各写一个字面量调用点——verify_surface 对账的是 controller.execute('命令名') 字面量,动态拼名字会让「扩展实现了但 agent 拿不到」那条断言瞎掉(实现时它当场抓到了第一版)。

验证

  • npm run verify 575 项断言,exit 0(548 → +20 cookie 行为台、+3 策略成对断言、+2 render 契约、+2 数量对账)。
  • 新台 verify_cookies.mjs(20 项):假件按真 CDP 响应形状回(Network.getCookies 的 cookies 在顶层,不是 Runtime.evaluate 那种 {result:{value}} 信封——套错信封的假件测不出真行为),断言 CDP 参数逐字段透传、锚点缺失零 CDP 派发、浏览器拒绝不假成功、同名多颗只删锚点匹配的那颗、复查失败不假报删干净。
  • verify_render_contract 铺满 22 条工具:cookie 的名字与值都必须出现在模型可见文本里(不许只报「N cookies」的计数——那是 render 只写摘要的老毛病)。
  • 变异测试:把 cookies.get 踢出只读白名单 → policy 红;remove 复查造假(永远报 remaining:0)→ 2 红(正好暴露「还剩 .shop.test 那颗」被谎报成删干净)。

安装

dsh plugin --profile web add @angelky7/dsh-browser-control@1.2.0
# 撞上 ERR_PNPM_NO_MATCHING_VERSION(镜像滞后)时,这一次显式走官方源:
dsh plugin --profile web add @angelky7/dsh-browser-control@1.2.0 --registry=https://registry.npmjs.org/

ERR_PNPM_NO_MATURE_MATCHING_VERSION 是 24 小时包龄闸门,不是包坏了——判别见 README。

扩展:解压 DSH-Browser-Control-v1.2.0.zip → chrome://extensions → 开发者模式 → 移除旧版(或点扩展卡片上的刷新)→「加载已解压的扩展程序」。

资产校验和

资产 大小 SHA-256 MD5
DSH-Browser-Control-v1.2.0.zip 63 202 B e10e89231d7d608cbd051737a670e4ab5c83917356d9067bfd93134678564d40 449874d1decd5501f192c6c6cabe8957
dsh-browser-control-plugin-v1.2.0.zip 208 617 B 229fd23a1cb2339bbed3b252c98570000ccc4eb8d0ab0bbdc9de07811ce50e38 263bc8b998c2b26a6721d3a4f54c896f

发布前本地解包复验(zip 头、CRC、无反斜杠条目、插件包含 cordis.patch.yml、扩展 manifest version 为 1.2.0),发布后匿名重下逐字节比对。按惯例不放 .sha256 附件。