附录 A 术语表

附录 A 术语表

全书术语按主题分六组收拢。每条给一句话定义加出处章节，细节回正文查；跨组同义的词条互相参见。口径与正文的「学习目标」措辞保持一致，可直接当复习提纲用。

一、语法与循环

• act / extract / observe（三原语）：网页智能体一切操作降解出的三个动词——执行、抽取、观察；换框架只换方言不换语法（第 1.1 节）。
• Agent 循环：感知、决策、行动、终止判断四阶段转起来的 while 循环，浏览器智能体的执行内核（第 2.1 节）。
• 元素索引（编号点击）：感知阶段把可交互元素整理成带编号的候选清单，模型用编号引用目标（第 1.2 节）。
• 结构化快照：以无障碍树为骨架的文本页面表示，比 DOM 干净、比截图便宜，元素可用 ref 引用（第 4.1 节）。
• a11y tree（无障碍树）：浏览器为辅助技术维护的语义树（角色、名称、状态），结构化快照的数据源（第 4.1 节）。
• ref：结构化快照里元素的稳定引用标识，与编号点击同构（第 4.2 节）。
• Set-of-Mark（SoM）：给截图元素编号标注的做法，视觉与结构化两流派的桥（第 5.1 节）。
• 靶场：本地自制测试页构成的全书示例环境——你拥有全部权限的站点，天然合规（第 0.2 节）。

二、信任与安全

• 敏感数据确认：任务文本只写占位符、真值晚绑定、历史与日志脱敏的机制（第 2.2 节）。
• 人工介入三形态：前置审批、执行前确认、事后审计——人在流程里的三个挂点（第 2.2 节）。
• 确认门：决策与行动之间的确定性闸门，高危动作须人工应答（第 2.2 节）。
• 域名白名单：把导航与请求限制在显式枚举的域名内，应用层与网络层各设一道（第 2.2、7.2 节）。
• 登录态：Cookie 与 storage 构成的会话状态，Agent 最贵的缓存（第 7.1 节）。
• storageState：Playwright 的会话状态导出与恢复机制，会话复用的载体（第 7.1 节）。
• 会话复用：storageState 持久化后任务带状态启动，把登录从每次任务中摘出（第 7.1 节）。
• 凭证注入：凭证从环境变量或密管系统进入运行时的方式，绝不硬编码（第 7.1 节）。
• 沙箱：Agent 浏览器的隔离执行环境——容器封装、资源限额、网络策略（第 7.2 节）。
• 一次性会话：一任务一全新 context、结束即销毁的隔离形态（第 7.2 节）。

三、检测与合规

• 浏览器指纹：UA、Canvas、WebGL、字体、硬件参数等组合成的环境唯一标识（第 8.1 节）。
• headless 特征：无头模式的信号集合（webdriver 标记、调试协议痕迹等），「非人类环境」的判定依据（第 8.1 节）。
• stealth：环境一致性、headless 收敛、行为模拟三类手段的统称；仅限自有与授权站点使用（第 8.2 节）。
• 身份呈现：自动化流量如实可核实的标识（UA 声明、联系方式），正面做法（第 8.2 节）。
• 授权三要素：站点、账号、操作——判定「有权访问」的三个维度，缺一即越界（第 8.2 节）。
• 审计三问：做了什么、为什么、哪一步——留痕系统必须能回答的三个问题（第 8.3 节）。
• 速率礼仪：访问频率与方式控制在对站点方可接受的范围内，全局与按域名两档（第 8.2、10.1 节）。
• 审计留痕（事件溯源）：每动作一条只追加事件（含决策依据与证据指针），回放即真相（第 8.3 节）。

四、验证与恢复

• 断言三层：结构断言（代码）、视觉断言（截图）、自然语言断言（模型判读）的分层验证（第 6.1 节）。
• 结果等价断言：断言目标达成的等价类而非路径一致——Agent 场景的断言口径（第 6.1 节）。
• 信息保真三件套：断言失败瞬间落盘的截图、快照、日志证据（第 6.1 节）。
• 失败分类学：瞬态网络、选择器漂移、指令歧义（另列权限与模型误判）的分类与反应路由（第 6.2 节）。
• 选择器漂移：页面改版导致定位失效的失败类，同参重试无效须换感知（第 6.2 节）。
• 重试回退链：L0 同参重试、L1 observe 重定位、L2 人工工单的三级递进（第 6.2 节）。
• 人工工单（异常工单队列）：L2 转出任务进入的低优先级人工队列，带证据、结论回写知识库（第 6.2、10.1 节）。
• 超时预算：任务、步骤、重试三层的显式时间上限，救援行动的时间线（第 6.2 节）。
• 死循环治理：步数上限、重复检测、状态相似度、进度断言加「先提示再终止」的专案（第 6.2 节）。

五、测试与固化

• 固化：把稳定流程从每步计费的 Agent 路径搬进零边际成本的代码路径（第 3.3、9.1 节）。
• observe 缓存：以指令为键缓存观察候选，命中零模型调用、失效回退刷新（第 3.3 节）。
• 固化覆盖率：固化步骤执行次数除以总步骤执行次数，「系统在变便宜还是变贵」的体征指标（第 3.3 节）。
• E2E（端到端测试）：从用户视角对完整流程的回归验证，断言确定性、可无限回归（第 9 章）。
• flake：同一输入不同运行不同结果的失败形态，比稳定失败更贵——腐蚀信号（第 11.1 节）。
• 复核流：感知断言失败先进待复核队列、人工确认后才升级的分级处置（第 6.1、9.2 节）。
• 回归任务集：固化测试按冒烟、全量、发布三层的组织与运行节奏（第 9.1 节）。
• 隔离区（quarantine）：flake 与毒丸任务的隔离队列，带归因工单与期限，不许「留着不管」（第 11.1 节）。
• 稳定率：单用例通过率与隔离运行对照差的度量口径，门禁的一等指标（第 11.1 节）。

六、运行与运营

• 实例池：浏览器实例的上限、预热、回收管理；context 是分配与隔离单元（第 10.1 节）。
• 速率协调（令牌桶）：固定速率补令牌、动作先取后行的限速器，护自己也护对方（第 10.1 节）。
• 失败隔离：异常锁死在任务边界（context 销毁、worker 不死、全局熔断）的三层结构（第 10.1 节）。
• 毒丸任务：连续毒死多个执行单元的病态任务，隔离进 quarantine 不再重派（第 10.1 节）。
• 错误 taxonomy：网络、选择器、权限、业务逻辑、模型误判的五类归档，分类即处置路由（第 11.2 节）。
• 告警分级：红（立刻响应）、黄（当日处理）、蓝（周度回顾）三级，红色必须少而准（第 11.2 节）。
• 成本台账：按任务、通道、步骤三口径聚合的 token 记账，预算熔断的数据面（第 10.2 节）。
• 成本三成分：感知输入（快照对截图差数倍）、决策输出、重试放大的成本解剖（第 10.2 节）。
• 模型分级：常规步用便宜模型、难步用强模型的显式路由（第 10.2 节）。
• 熔断：失败率或预算超阈值时暂停消费的全局自保机制，接告警分级（第 10.1、11.2 节）。
• 看板四指标：任务成功率、平均步数、token 成本、固化覆盖率的体检组合（第 11.2 节）。
• 灰度发布：百分之一、十分之一、全量的流量阶梯，晋级判据用指标写死（第 11.3 节）。
• 影子运行：新旧模型并行跑同任务集、对照指标后再生效的变更流程（第 11.3 节）。
• 回滚单元：版本、缓存、配置三层的退回对象；模型变更加影子运行与提示词版本化（第 11.3 节）。
• SOP 文档：值班手册、故障预案、升级路径的成文运营材料，演练有时效要求（第 11.3 节）。