Repository navigation
v1.2.0 — browser_cookies:读/设/删 cookie(凭据面写进 SECURITY)
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 verify575 项断言,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 附件。