yunti-browser-runtime 0.1.3 → 0.2.1

package/docs/EXECUTION_PLAN.md

@@ -58,6 +58,267 @@
 | P5.1 | 已完成 | 本地默认免 bridge token |
 | P5.2 | 已完成 | 扩展 popup 与安装引导简化 |
 | P5.3 | 已完成 | 扩展首屏零配置 |
+| P6.0 | 已完成 | 0.2.0 产品方向护栏 |
+| P6.1.1 | 已完成 | `yunti_observe_page` schema、tool hints、bridge routing |
+| P6.1.2 | 已完成 | content-script DOM observer、文本树、字段状态、scroll 元数据、最小脱敏 |
+| P6.1.3 | 已完成 | fresh observe uid 兼容现有 click/hover/fill action |
+| P6.1.4 | 已完成 | 真实浏览器 `observe -> click uid -> observe/verify` 闭环 |
+| P6.2.1 | 已完成 | action result 兼容契约与主要 action 主路径结构化字段 |
+| P6.2.2 | 已完成 | `yunti_select` uid/selector/value/text 语义与失败诊断 |
+| P6.2.3 | 已完成 | `yunti_fill` / `yunti_fill_form` 字段状态、contenteditable、值保持诊断 |
+| P6.2.4 | 已完成 | `yunti_scroll` uid/coordinate/no-movement/partial/fallback 诊断 |
+| P6.2.5 | 已完成 | 异步 UI 的 `wait -> observe -> fresh uid` 恢复指导 |
+| P6.2.6 | 已完成 | `yunti_wait_for` 自身结构化 action result 与恢复语义 |
+| P6.2.7 | 已完成 | 结构化 action result 覆盖审计与真实浏览器闭环补验准备 |
+| P6.3.1 | 已完成 | Agent 默认工作流契约与可复制提示词 |
+| P6.3.2 | 已完成 | Tool Guide 最小用例：点击、填表、滚动找元素、切 tab、等待异步结果 |
+| P6.4.1 | 已完成 | DOM 脱敏策略深化，与 network/console redaction 对齐 |
+| P6.4.2 | 已完成 | learning memory / diagnostic artifacts 的 secret 边界收敛 |
+| P6.4.3 | 已完成 | raw CDP / screenshot 非默认脱敏诊断的提示与清理边界 |
+| P6.5.1 | 已完成 | 可选本地运行时控制台最小闭环 |
+| P6.5.2 | 已完成 | 控制台诊断增强第一刀 |
+| P6.5.3 | 已完成 | 控制台真实浏览器验收与 UX 收口 |
+| P6.6.1 | 已完成 | 浏览器扩展分发准备 |
+| P6.6.2 | 已完成 | 商店权限与隐私文案草案 |
+| P6.6.3 | 已完成 | 商店前权限策略决策 |
+| P6.6.4 | 后置 | Store candidate 权限 UX 设计 |
+| P7.1 | 已完成 | 0.2.0 npm/unpacked 发布收口 |
+
+当前 0.2.0 推进快照（2026-07-05）：
+
+- P6.2 最新完成切片：
+  - action result 主路径覆盖；
+  - `yunti_select` selector/value、uid/value、uid/text；
+  - select uid/selector 失败诊断与 disabled option 诊断；
+  - contenteditable fill；
+  - selector/uid fill 失败诊断与 `yunti_fill_form` 聚合诊断；
+  - uid scroll、scroll no-movement、directional `edgeHint`、结构化 `recoveryHint`、
+    机器可读 `decision` 和可执行 `suggestedRetry`；
+  - scroll partial movement 的 `partialMovement` 观察前置诊断；
+  - uid scroll 缺失/过期/不可解析目标的结构化恢复诊断；
+  - coordinate scroll 命中元素、滚动容器、document fallback 诊断和恢复提示；
+  - fill/select/scroll 异步 UI 的 `wait -> observe -> fresh uid` 恢复指导；
+  - uid/selector fill 不可编辑、隐藏、disabled、readonly 目标诊断；
+  - uid fill 填后值保持验证与 `VALUE_NOT_APPLIED` 长度级诊断；
+  - `yunti_observe_page` 字段状态、select 当前选中项与 `options[]` 提示。
+- P6.1：`yunti_observe_page` schema、tool hints、bridge routing、content-script observer
+  和 deterministic fixtures 已落地；真实浏览器 `observe -> click uid -> observe/verify`
+  闭环已在本机 `pytest-playwright` 环境下用临时 Node Playwright 1.58.0 补验通过。
+- P6.2：结构化 action result 正在按兼容优先的小切片推进；已覆盖主要单动作路径：uid click/hover/fill
+  keyboard/fill select、coordinate click/hover、selector hover/click/fill passthrough 和
+  scroll passthrough、type_text uid/selector fallback、press_key uid/selector fallback、
+  upload uid/selector path、coordinate drag、standalone `yunti_select` content-script
+  passthrough、aggregate `yunti_fill_form` summary；`yunti_select` 也已补齐 selector/value、
+  uid/value、uid/text 三条路径，并开始返回 uid 与 selector option miss / non-select target
+  的结构化失败诊断；更深语义已推进到 contenteditable fill、selector/uid fill 失败诊断、fresh
+  observed scroll container uid、scroll no-movement、directional `edgeHint`、结构化
+  `recoveryHint`、机器可读 `decision` 和可执行 `suggestedRetry` 诊断。
+- P6.2 第一轮 action result 覆盖、select uid/text、contenteditable fill 和 scroll
+  recovery diagnostics 已补齐；selector/uid fill 失败诊断和 `yunti_fill_form` 聚合诊断也已落地。
+  uid/selector fill 的不可编辑、隐藏、disabled/readonly 目标诊断也已补齐：失败时返回
+  `filled: false`、`ok: false`、`code: "TARGET_NOT_EDITABLE"`、`recoveryHint` 和
+  `nextStepHint`，并保留所有既有成功路径、兼容字段与 CDP fallback。下一步继续进入更深的
+  select/fill/scroll 语义增强与真实浏览器闭环补验。`yunti_observe_page` 也开始为字段类元素
+  暴露 `editable`、`fillable`、`readOnly`、`fillBlockReason`、select 当前选中项摘要和
+  `options[]` 摘要，让 agent 在填表或选择前先判断字段状态。
+- P6.2 uid fill 的填后验证已补齐：keyboard/contenteditable 路径会在派发输入后尽量读取
+  目标字段的长度级状态；如果页面框架、mask 或受控状态导致值没有保持，返回
+  `filled: false`、`ok: false`、`code: "VALUE_NOT_APPLIED"`、`expectedValueLength`、
+  `actualValueLength`、`recoveryHint.decision: "inspect-controlled-or-masked-field-before-retry"`
+  和 `nextStepHint`。该诊断不回传实际字段内容，只回传长度摘要；既有成功路径和兼容字段保持不变。
+- P6.2 scroll partial movement 诊断已补齐：当 `before` / `after` 可比较且 scroll
+  实际移动距离小于请求 `deltaX` / `deltaY` 时，结果保持 `ok: true`，并新增
+  `partialMovement`，包含 requested/actual delta、affected axes、`edgeHint`、
+  `decision: "observe-before-continuing-scroll"` 和 `nextAction: "observe-again"`。
+  该诊断用于提示 agent 先重新 observe 和比较滚动位置，再决定是否继续滚同一容器。
+- P6.2 uid scroll 失败诊断已补齐：当 uid 缺失、过期、隐藏或无法解析坐标时，
+  `yunti_scroll` 返回 `scrolled: false`、`ok: false`、`recoverable: true`、
+  `code: "UID_NOT_FOUND"` 或 `code: "UID_COORDINATES_UNAVAILABLE"`、`recoveryHint` 和
+  `nextStepHint`，提示重新 observe 并从 `scrollableContainers[]` 选择 fresh uid，或使用
+  document/coordinate fallback；既有成功 scroll、no-movement 和 partialMovement 路径保持兼容。
+- P6.2 coordinate scroll 命中/回退诊断已补齐：当传入 `x` / `y` 时，content script 会返回
+  `coordinateTarget`、`scrollContainerFound` 和必要时的
+  `coordinateScrollFallback: "document"`，让 agent 区分坐标是否真正命中嵌套滚动容器，
+  还是回退到 document 滚动。该切片只新增诊断字段，不改变既有 coordinate/document/uid
+  scroll 行为。
+- P6.2 coordinate scroll document fallback 恢复提示已补齐：当 handler 收到
+  `coordinateScrollFallback: "document"` 时，成功结果保持 `ok: true` /
+  `recoverable: false`，并新增 `coordinateFallbackHint` 与更明确的 `nextStepHint`，
+  指向 `yunti_observe_page` 和 fresh `scrollableContainers[]` uid，避免 agent 误以为
+  nested panel 已经被滚动。
+- P6.2 wait-observe 恢复指导已补齐：`yunti_get_tool_usage_hints`、Tool Guide 和 skill
+  现在明确要求异步渲染、校验、option 加载或新内容加载时，先用 `yunti_wait_for`
+  等待预期 text/selector/state，再调用 `yunti_observe_page`，最后用 fresh uid 继续
+  fill/select/scroll，而不是复用旧 uid 或盲目重复同一动作。
+- P6.2.6 已完成：`yunti_wait_for` 自身现在补齐结构化返回字段，保留既有
+  `found`、`text`、`selector`、`condition`、`value`、`waitedMs` 等兼容字段，同时新增
+  `action: "wait_for"`、`target`、`ok`、`recoverable`、`nextStepHint`；超时返回
+  `code: "WAIT_TIMEOUT"` 和 `recoveryHint`，让等待工具也能自然接入
+  `wait -> observe -> fresh uid` 恢复闭环。
+- P6.2.6 最新验证：`git diff --check` 通过；token 残留检查无输出；
+  `node --test tests/tool-handlers.test.js` 通过 42 个用例；
+  `node --test tests/bridge.test.js` 通过 66 个用例；`YUNTI_E2E=1 npm run test:e2e`
+  因当前环境缺少 Playwright/Chromium 跳过；`npm run release:check` 通过，覆盖
+  116 个 node:test 用例，其中 115 个通过、1 个真实浏览器 smoke 默认跳过，并完成 npm
+  package 与 extension zip 内容检查。
+- P6.2.7 目标：重新审计结构化 action result 覆盖面，确认
+  wait/click/hover/fill/select/scroll/type/press/upload/drag/fill_form 的成功和主要失败路径
+  都有可读的 `ok` / `code` / `recoverable` / `nextStepHint`，并整理真实浏览器闭环补验入口。
+- P6.2.7 已完成：新增 `docs/ACTION_RESULT_COVERAGE.md` 作为结构化 action result 覆盖矩阵，
+  覆盖 click、hover、fill、select、fill_form、wait_for、scroll、type_text、press_key、
+  upload_file、drag 共 11 个 action surfaces；新增 `npm run check:action-results` 和
+  `scripts/check-action-result-coverage.js`，并接入 `npm run release:check`，避免后续
+  上下文压缩或代码变更后忘记维护覆盖状态。
+- P6.2.7 最新验证：`npm run check:action-results` 通过，识别 11 行覆盖矩阵；
+  `npm run check` 通过；`git diff --check` 通过；token 残留检查无输出；
+  `YUNTI_E2E=1 npm run test:e2e` 因当前环境缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，覆盖 116 个 node:test 用例，其中 115 个通过、1 个
+  真实浏览器 smoke 默认跳过，并完成 npm package 内容检查 44 个文件和 extension zip
+  内容检查 13 个文件。
+- 下一步推进顺序：如果当前环境补齐 Playwright/Chromium，先关闭 P6.1.4 真实浏览器
+  `observe -> click uid -> observe/verify` 闭环；如果环境仍不可用，则进入 P6.3.1，
+  把 agent 默认工作流契约和可复制提示词沉淀成文档、Tool Guide 和 skill 引导。
+- P6.3.1 已完成：新增 `docs/AGENT_WORKFLOW_CONTRACT.md`，沉淀默认
+  `hints -> list targets -> observe -> act by fresh uid -> wait if needed -> observe -> verify`
+  操作循环、恢复规则、危险操作确认边界和可复制提示词；`yunti_get_tool_usage_hints`
+  新增 `workflow` topic、`defaultPageOperation`、`confirmationBoundary` 和
+  `copyableAgentPrompt`；`docs/TOOL_GUIDE.md` 和 packaged skill 已同步默认页面操作契约。
+- P6.3.1 最新验证：`node --test tests/bridge.test.js` 通过 67 个用例；`git diff --check`
+  通过；token 残留检查无输出；`YUNTI_E2E=1 npm run test:e2e` 因当前环境缺少
+  Playwright/Chromium 跳过；`npm run release:check` 通过，覆盖 117 个 node:test 用例，
+  其中 116 个通过、1 个真实浏览器 smoke 默认跳过，并完成 npm package 内容检查 45 个文件和
+  extension zip 内容检查 13 个文件。
+- 下一步固定为 P6.3.2：在 Tool Guide 和 skill 中补齐最小用例，包括点击、填表、
+  滚动找元素、切 tab、等待异步结果，并确保这些用例复用 P6.3.1 默认循环和 P6.2
+  结构化结果读取规则。
+- P6.3.2 已完成：`docs/TOOL_GUIDE.md` 和 packaged skill 已补齐五个最小用例：
+  Click、Fill Form、Scroll To Find、Switch Tab、Wait For Async Result；
+  `yunti_get_tool_usage_hints` 的 `workflow` topic 现在返回 `minimalUseCases`，
+  包含 `clickByUid`、`fillForm`、`scrollToFind`、`switchTab` 和
+  `waitForAsyncResult`，并由 `tests/bridge.test.js` 锁住关键规则。
+- P6.3.2 最新验证：`node --test tests/bridge.test.js` 通过 68 个用例；`git diff --check`
+  通过；token 残留检查无输出；`YUNTI_E2E=1 npm run test:e2e` 因当前环境缺少
+  Playwright/Chromium 跳过；`npm run release:check` 通过，覆盖 118 个 node:test 用例，
+  其中 117 个通过、1 个真实浏览器 smoke 默认跳过，并完成 npm package 内容检查 45 个文件和
+  extension zip 内容检查 13 个文件。
+- P6.4.1 已完成：`extension/dom-observer.js` 的 strict redaction 现在覆盖
+  page title、label、name、visible text、placeholder、value preview、select
+  selected value/text、options value/text、scrollable container name，以及 email、
+  phone、Luhn-valid payment-card-like 和 address-like 文本；balanced 保持 credential-like
+  默认保护，`off` 仍仅用于显式本地调试。
+- P6.4.1 最新验证：`node --check extension/dom-observer.js` 通过；
+  `node --test tests/dom-observer.test.js` 通过 6 个 DOM observer 用例；
+  `node --test tests/bridge.test.js` 通过 68 个用例；`git diff --check` 通过；
+  token 残留检查无输出；`YUNTI_E2E=1 npm run test:e2e` 因当前环境缺少
+  Playwright/Chromium 跳过；`npm run release:check` 通过，覆盖 119 个 node:test
+  用例，其中 118 个通过、1 个真实浏览器 smoke 默认跳过，并完成 npm package 内容检查
+  45 个文件和 extension zip 内容检查 13 个文件。
+- P6.4.2 已完成：`mcp/redaction.js` 的共享文本脱敏覆盖 Bearer、JWT、private key、
+  长 token-like、email、phone、Luhn-valid payment-card-like 和 address-like 内容；
+  learning memory 的 title/detail/tags/source 写盘前统一脱敏；console diagnostics 的
+  text/stack/args 缓存前统一脱敏；raw CDP events 保持明确的低层原始诊断例外，并要求调试后清理。
+- P6.4.2 最新验证：`node --check mcp/redaction.js`、`node --check mcp/memory.js` 和
+  `node --check mcp/bridge-hub.js` 通过；`node --test tests/bridge.test.js` 通过 70 个用例；
+  `git diff --check` 通过；token 残留检查无输出；`npm run check` 通过；`npm test`
+  通过，覆盖 121 个 node:test 用例，其中 120 个通过、1 个真实浏览器 smoke 默认跳过；
+  `YUNTI_E2E=1 npm run test:e2e` 因当前环境缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，并完成 npm package 内容检查 45 个文件和 extension zip
+  内容检查 13 个文件。
+- P6.4.3 已完成：`yunti_get_tool_usage_hints` 新增 raw CDP 和 screenshot 专项 guidance；
+  `yunti_get_cdp_events` 明确 raw payload、不默认脱敏、优先 sanitized diagnostics、按
+  `method` / `limit` 缩小范围，并在调试后用 `yunti_clear_cdp_events` 清理；`yunti_take_screenshot`
+  和 `yunti_capture_visible_tab` 明确截图是真实像素、不继承 DOM redaction，优先 viewport
+  和安全摘要，不把 raw image data 写入 learning memory。
+- P6.4.3 最新验证：`node --check mcp/tools.js` 通过；`node --test tests/bridge.test.js`
+  通过 71 个用例，新增 raw CDP / screenshot safety boundary usage hints 覆盖；
+  `git diff --check` 通过；token 残留检查无输出；`npm run check` 通过；`npm test`
+  通过，覆盖 122 个 node:test 用例，其中 121 个通过、1 个真实浏览器 smoke 默认跳过；
+  `YUNTI_E2E=1 npm run test:e2e` 因当前环境缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，并完成 npm package 内容检查 45 个文件和 extension zip
+  内容检查 13 个文件。
+- P6.1.4 最新验证：使用 `/opt/miniconda3/envs/pytest-playwright` 中已有的 Playwright
+  浏览器缓存，临时执行
+  `PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 npm install --no-save --package-lock=false playwright@1.58.0`
+  补齐 Node E2E 依赖；随后 `YUNTI_E2E=1 npm run test:e2e` 通过真实浏览器扩展
+  bridge smoke，覆盖 `observe -> click uid -> verify` 闭环。完整门禁也已通过：
+  `git diff --check`、token 残留检查、`npm run check`、`npm test`、
+  `YUNTI_E2E=1 npm run test:e2e` 和 `npm run release:check`。
+- P6.5.1 已完成：bridge 内置可选本地控制台 `/console` 和脱敏状态接口
+  `/console/state`；CLI 新增 `yunti-browser-runtime console`；控制台展示连接页面、
+  pending/queued runtime 请求、最近工具 activity、network/console/CDP 诊断数量，并提供
+  `cancel pending` 操作清理 runtime 仍在等待或排队的请求。控制台保持非必选，不改变 MCP
+  工具路径、扩展 popup 零配置路径或首跑安装路径。
+- P6.5.1 最新验证：`git diff --check` 通过；token 残留检查无输出；`npm run check`
+  通过；`npm test` 通过，覆盖 125 个 node:test 用例，其中 124 个通过、1 个真实浏览器
+  smoke 默认跳过；`YUNTI_E2E=1 npm run test:e2e` 通过 1 个真实浏览器 smoke；`npm run
+  release:check` 通过，并完成 npm package 内容检查 45 个文件和 extension zip 内容检查 13
+  个文件。
+- P6.5.2 已完成：控制台支持 `HEAD /console`，`/console/state` 返回 runtime version、
+  expected extension version、session extension version 和 warnings；扩展注册 session 时上报
+  `client.extensionVersion`；控制台页面展示 runtime/extension 版本与 warning 面板；doctor
+  JSON 和 human summary 增加 console URL；空状态指引改为 reload extension、打开/刷新
+  http/https 页面再运行 doctor。
+- P6.5.2 最新验证：`git diff --check` 通过；token 残留检查无输出；`npm run check`
+  通过；`npm test` 通过，覆盖 126 个 node:test 用例，其中 125 个通过、1 个真实浏览器
+  smoke 默认跳过；`YUNTI_E2E=1 npm run test:e2e` 通过 1 个真实浏览器 smoke；`npm run
+  release:check` 通过，并完成 npm package 内容检查 45 个文件和 extension zip 内容检查 13
+  个文件。
+- P6.5.3 已完成：`tests/e2e.test.js` 的真实浏览器 smoke 现在会加载扩展、注册真实页面、
+  检查 `HEAD /console`、读取 `/console` 页面和 `/console/state`，并验证 runtime version、
+  expected extension version、session extension version 都与 package version 一致，且不会出现
+  `NO_CONNECTED_PAGES` 或 `EXTENSION_VERSION_MISMATCH` warning。
+- P6.5.3 最新验证：`git diff --check` 通过；token 残留检查无输出；`npm run check`
+  通过；`npm test` 通过，覆盖 126 个 node:test 用例，其中 125 个通过、1 个真实浏览器
+  smoke 默认跳过；`YUNTI_E2E=1 npm run test:e2e` 通过 1 个真实浏览器 smoke；`npm run
+  release:check` 通过，并完成 npm package 内容检查 45 个文件和 extension zip 内容检查 13
+  个文件。
+- P6.6.1 已完成：浏览器扩展分发准备，已沉淀权限/隐私/商店材料清单和当前 manifest
+  差距审计，未改权限或上架。
+- P6.6.2 已完成：商店权限与隐私文案草案已沉淀为可审核、可复用的
+  store-facing 文案。
+- P6.6.3 已完成：商店前权限策略决策已沉淀，当前 npm/unpacked 路径保持完整能力；
+  当前 broad-permission manifest 不作为默认推荐商店提交版本。
+- P6.6.4 已后置到 post-0.2 / store-candidate track，不作为 0.2.0 发布硬门槛。
+- 当前固定进入 P7.1：0.2.0 npm/unpacked 发布收口，先完成版本 bump、发布文档更新、
+  release gates、真实浏览器 E2E 和 dry-run。
+
+## 压缩上下文恢复锚点
+
+如果上下文被压缩或切换线程，新的 agent 应先读取：
+
+1. `docs/PROJECT_STATUS.md` 顶部的 `Current Phase` 和 `Open Work`。
+2. 本文档的 `阶段总览`、`当前 0.2.0 推进快照` 和对应 P6 小节。
+3. `docs/NEXT_MAJOR_PLAN.md` 的 `Yunti-First Principle`。
+
+恢复后按以下节奏继续：
+
+1. 只做一个兼容优先的小切片。
+2. 先更新 `docs/EXECUTION_PLAN.md` 和 `docs/PROJECT_STATUS.md` 的目标与状态。
+3. 如果工具行为、schema、usage hint 或 agent 引导变化，同步更新
+   `mcp/tools.js`、`docs/TOOL_GUIDE.md` 和 `skills/yunti-browser-runtime/SKILL.md`。
+4. 每个切片保留既有兼容字段，不移除 CDP、截图、network、console、upload、tab control
+   等 Yunti 自身能力。
+5. 验证后再提交，并记录 skipped E2E 是否只是环境限制。
+
+当前下一步提示词：
+
+```text
+继续推进 yunti-browser-runtime 0.2.0。请先读取 docs/PROJECT_STATUS.md、
+docs/EXECUTION_PLAN.md 和 docs/NEXT_MAJOR_PLAN.md，只做一个兼容优先的小切片。
+当前锚点是 P7.1：0.2.0 npm/unpacked 发布收口。P6.6.1 已完成浏览器扩展分发准备，
+包括 manifest 权限审计、商店材料清单和 docs/EXTENSION_DISTRIBUTION.md。P6.6.2 已完成
+docs/EXTENSION_STORE_COPY.md，包含商店描述、权限说明、隐私草案、data disclosure
+和 reviewer notes。P6.6.3 已完成 docs/EXTENSION_PERMISSION_STRATEGY.md，结论是
+npm/unpacked 路径保持完整能力，商店候选版本另行设计 optional host access 和 optional
+network diagnostics；P6.6.4 后置到 post-0.2，不阻塞发布。P6.5.1 已完成可选本地控制台最小闭环，
+P6.5.2 已完成版本 warning、HEAD /console、doctor console URL 和空状态指引增强，
+P6.5.3 已完成控制台真实浏览器 E2E 验收。P6.1.4 真实浏览器 observe -> click uid ->
+observe/verify 闭环已补验通过。保留现有兼容字段，必要时更新
+mcp/tools.js、docs/TOOL_GUIDE.md、skills/yunti-browser-runtime/SKILL.md、
+docs/EXECUTION_PLAN.md 和 docs/PROJECT_STATUS.md，并运行规定门禁。不要把项目改成
+Page Agent 克隆，保持 Yunti local-first、MCP-native、真实 Chrome/Edge、
+细粒度 yunti_* 工具的特色。
+```
 
 ## P0.1 bridge token + CORS 收紧
 
@@ -1368,7 +1629,1104 @@ metadata 与当前 `package.json` 一致。
 
 ### 验收记录
 
-- 待执行。
+- `npm run release:check` 通过。
+- `npm run release:publish` 成功发布 `yunti-browser-runtime@0.1.3`。
+- 首次 `npm run release:verify-published` 遇到 npm registry 同步延迟；重试后返回 0。
+- `npm view yunti-browser-runtime version dist-tags.latest --registry=https://registry.npmjs.org/`
+  返回 `0.1.3`。
+
+## P6.0 0.2.0 产品方向护栏
+
+状态：已完成（2026-07-03）
+
+实现摘要：
+
+- 新增 `docs/NEXT_MAJOR_PLAN.md`，作为 `0.2.0 Best Browser Automation Runtime`
+  的持久执行契约。
+- 明确 `0.2.0` 是 Yunti-first 增强周期，目标是做最好用的本地浏览器自动化操作层，
+  而不是克隆某一个参考项目。
+- 明确参考范围扩展到 Playwright、Puppeteer、Selenium、CDP、browser-use、Page Agent、
+  BrowserGym 和浏览器扩展/本地运行时生态，吸收它们的可靠 action、locator/uid、
+  trace/debug、文本 DOM、benchmark fixture、权限透明和安装体验等优点。
+- 明确执行顺序：先参考 Page Agent / browser-use，把 P6.1 页面观察和 P6.2 indexed
+  action 主线做扎实；其他生态优点后续再分阶段吸收，避免一次性铺太大。
+- 明确不吸收的方向：默认不内置 LLM API key、不把细粒度 MCP 工具替换成单一
+  `execute_task`、不让 hub tab/side panel 成为必选项、不把远程多用户模式混入本地
+  单用户核心。
+- 明确必须保留 Yunti 自己的特色：细粒度 MCP 工具、真实 Chrome/Edge 状态、CDP、
+  截图、network/console 诊断、tab 控制、本地 bridge 路由和零配置本地安装。
+- 将 P6.1-P6.6 写入本执行计划和 `docs/ROADMAP.md`。
+- 将 `docs/PROJECT_STATUS.md` 的当前阶段更新为 `0.2.0` 规划状态。
+
+### 多视角审稿结论
+
+已从产品、架构/API、Agent 工作流、安全隐私、测试发布五个视角审阅 `0.2.0` 计划。
+共识如下：
+
+- 方向正确：Yunti-first、本地优先、MCP 原生、真实浏览器状态和细粒度工具必须保留。
+- 需要把“最好用”变成可验证承诺：更少误点、更少盲目重试、更清晰恢复、更低安装心智。
+- P6.1 必须前置最小安全基线，不能等到 P6.4 才处理 DOM observation 脱敏。
+- `yunti_observe_page` 需要字段级输入/输出契约、uid 生命周期、错误码和工具兼容矩阵。
+- P6.1/P6.2 需要 deterministic fixture，而不是只写能力描述。
+- P6.3 的 skill/tool hints 和可复制工作流提示词应在 P6.1 schema 合并时同步更新。
+
+### 目标
+
+避免上下文压缩或线程切换后丢失下一大版本方向，尤其避免因为阅读单一参考项目而偏离
+Yunti 自己的特色。后续实现应直接从仓库文档恢复目标、非目标、阶段顺序、验收标准和
+下一步。
+
+### 验收标准
+
+- 仓库中存在独立的下一大版本计划文档。
+- `ROADMAP`、`PROJECT_STATUS`、`EXECUTION_PLAN` 都指向或记录 `0.2.0` 方向。
+- 下一步明确从 P6.1 `yunti_observe_page` 开始。
+
+### 验收记录
+
+- `npm run release:check` 通过；公开文档残留检查、Markdown 相对链接检查、语法检查、
+  单测、npm pack 内容检查和 extension zip 内容检查均通过。
+
+## P6.1 Agent 友好的页面观察
+
+状态：实现中（首个 schema / hints / bridge routing 合约切片已落地）
+
+目标：
+
+新增 `yunti_observe_page`，返回适合外部 Agent 使用的页面观察结果：URL/title、页面
+尺寸、滚动位置、可交互文本树、稳定 uid、scrollable 容器信息和脱敏元数据。
+
+第一阶段以 Page Agent 的 PageController / browser-state 思路为主要参考，但实现要适配
+Yunti 的 MCP/extension/bridge 架构。
+
+### Page Agent 参考审计
+
+当前参考源：`alibaba/page-agent`。
+
+可吸收点：
+
+- `PageController.getBrowserState()`：把 URL/title、页面尺寸、滚动提示和可交互 DOM
+  文本合成一个面向 Agent 的观察结果。
+- `updateTree()`：把观察刷新与动作执行分开，适合作为 `observe -> act -> verify`
+  工作流的前置步骤。
+- `selectorMap` 与 simplified HTML：证明 indexed interactive elements 比原始 CSS
+  selector 更适合 Agent 使用；Yunti 需要适配成现有 uid 体系。
+- `data-scrollable`：对多面板业务系统很重要，应结构化进入 `scrollableContainers`。
+- prompt 规则：评估上一步结果、不要盲目重试、只有存在 pixels above/below 时再滚动。
+
+不复制点：
+
+- 不复制内置 LLM loop。
+- 不让 hub/sidebar/operator UI 成为必选项。
+- 不把 Yunti 收窄为单页任务工具；仍保留 tabs、CDP、network、console、screenshot、
+  file upload 和诊断能力。
+- 不追求 Page Agent API 兼容；只吸收思路并转成 Yunti 的 MCP 工具契约。
+
+### 文档先行约束
+
+在动功能代码前，先确认以下契约：
+
+- `yunti_observe_page` 是增量增强，不替换或破坏 `yunti_get_page_snapshot` 与
+  `yunti_take_snapshot`。
+- 第一版优先走 content script DOM collection，使基础页面观察不依赖 CDP attach。
+- 输出同时包含结构化字段和紧凑文本树，便于程序消费和 LLM prompt 消费。
+- uid 与最新 observation 绑定；uid 过期、缺失或不可见时，错误提示应引导重新调用
+  `yunti_observe_page`。
+- 默认不返回 password、token-like、credential-like 输入值；完整 DOM 脱敏策略放到
+  P6.4 深化。
+
+### 字段级契约草案
+
+输入：
+
+- `browserSessionId`：可选目标浏览器 session。
+- `mode`：默认 `viewport`；后续支持有边界的 `fullPage`。
+- `maxElements` / `maxTextLength`：默认限量，防止一次返回过多页面内容。
+- `includeHidden`：默认 false。
+- `includeTextTree` / `includeRects`：默认 true。
+- `redaction`：默认 `balanced`；`strict` 用于更强隐私；`off` 仅允许显式本地调试，
+  不进入默认 agent workflow。
+
+输出：
+
+- `observationId`、`browserSessionId`、`capturedAt`、`uidMapVersion`。
+- `page`：URL、脱敏 URL preview、title、origin、readyState。
+- `viewport`：width、height、devicePixelRatio。
+- `scroll`：x/y、page size、pixels/pages above/below。
+- `elements[]`：`uid`、`role`、`tag`、`name`、`text`、`label`、`placeholder`、
+  `valuePreview`、`valueRedacted`、`type`、`hrefPreview`、`rect`、`visible`、
+  `disabled`、`editable`、`checked`、`selected`、`scrollable`、`containerUid`。
+- `textTree`：面向 Agent 的紧凑文本树。
+- `scrollableContainers[]`：`uid`、`tag`、`name`、`rect`、`scrollTop`、
+  `scrollHeight`、`clientHeight`、`canScrollVertical`、`canScrollHorizontal`、
+  各方向剩余像素。
+- `limits`、`redactions`、`hints[]`、`warnings[]`。
+
+uid 生命周期：
+
+- uid 只对当前 `browserSessionId` 的最近一次 observe/snapshot 有效，不承诺跨刷新或跨
+  页面永久稳定。
+- action 应接受来自 `yunti_observe_page` 或 `yunti_take_snapshot` 的 uid，但错误提示
+  必须说明应重新 observe 还是重新 snapshot。
+- stale uid 使用结构化错误码，例如 `STALE_OBSERVATION_UID`，并提示重新
+  `yunti_observe_page`。
+- uid map 只放内存，不写入 learning memory、task history 或长期诊断日志。
+
+最小脱敏基线：
+
+- P6.1 默认 `balanced`，隐藏 password、hidden token、token/secret/auth/cookie/session/
+  api-key/credential/otp-like 值、JWT-like、Bearer-like、private-key-like 和长随机串。
+- DOM observation 默认使用属性白名单，不返回任意 attributes。
+- URL query 默认摘要化或局部脱敏。
+- DOM redaction 不代表 screenshot redaction；截图按真实可见像素处理。
+
+受限/降级状态：
+
+- content script 不可用、browser internal page、跨域 iframe 内容省略、session stale、
+  tab changed、无可见交互元素、页面仍在 loading、动作验证不确定时，都需要返回
+  `hints[]` 或结构化错误。
+
+### 本阶段不做
+
+- 不把 LLM task loop 放进 runtime。
+- 不引入必选 hub tab、side panel 或运行时控制台。
+- 不做完整 Playwright locator engine。
+- 不做大规模 benchmark harness，只做最小 fixture/smoke。
+- 不混入 remote multi-user browser orchestration。
+
+### 第一批验收
+
+- 文档确认 `yunti_observe_page` 的输出契约、uid 关系、默认脱敏和第一条 smoke 路径。
+- Page Agent 参考审计已沉淀为 Yunti 术语，不再依赖上下文记忆。
+- 首个实现切片只添加 MCP schema、`yunti_get_tool_usage_hints` observe-first 指引和
+  bridge routing 合约测试；不实现 content script DOM collector，不重写 action layer。
+- 后续代码实现再进入 content script collection、uid map 与 action 兼容、最小
+  `observe -> click uid -> observe` 闭环、测试和 skill/docs 更新。
+- P6.1 完成必须包括 schema 单测、bridge routing 单测、content fixture 单测、真实浏览器
+  smoke、skill 更新和 `yunti_get_tool_usage_hints` 更新。
+
+最新切片记录（2026-07-03）：
+
+- `mcp/tools.js` 已新增 `yunti_observe_page` 输入 schema，覆盖 `mode`、`maxElements`、
+  `maxTextLength`、`includeHidden`、`includeTextTree`、`includeRects` 和 `redaction`。
+- `yunti_get_tool_usage_hints` 已新增 `yunti_observe_page` guidance，并把
+  click/hover/fill 的 uid 说明更新为 observe/snapshot fresh uid。
+- `tests/bridge.test.js` 已覆盖工具 surface、observe usage hints schema，以及
+  `yunti_observe_page` 从 bridge 转发到 extension 的路由合约。
+- `extension/dom-observer.js` 已新增 content-script DOM observation MVP，返回 fresh uid、
+  compact text tree、viewport/document scroll、scrollable container metadata、balanced
+  redaction metadata 和恢复 hints。
+- `extension/content.js` 已接入 `yunti_observe_page`，`extension/manifest.json` 和
+  extension/package release gates 已纳入 `dom-observer.js`。
+- `tests/dom-observer.test.js` 已覆盖基础 DOM 观察、fresh uid、textTree、balanced
+  redaction、URL query 脱敏和 scroll metadata。
+- `tests/e2e.test.js` 已把 `yunti_observe_page` 加入 opt-in real-browser smoke。
+- 最新验证：`git diff --check` 通过；`npm run release:check` 通过，覆盖 70 个
+  node:test 用例，其中 69 个通过、1 个 real-browser smoke 按默认配置跳过；
+  `YUNTI_E2E=1 npm run test:e2e` 在当前环境因缺少 Playwright/Chromium 被跳过。
+- `extension/tool-handlers.js` 已把 `yunti_observe_page` 返回的 elements 写入最新页面
+  uid map，`yunti_click` / `yunti_hover` / `yunti_fill` 继续通过现有 uid resolver 使用
+  fresh observe uid，同时保留 `yunti_take_snapshot` 兼容路径。
+- `tests/tool-handlers.test.js` 已覆盖 `observe -> click uid` 的 background dispatcher
+  最小闭环，以及 missing uid 时提示重新 observe/snapshot。
+- `tests/tool-handlers.test.js` 也已覆盖最新 observation 替换旧 uid map：第二次 observe
+  后旧 uid 会失败并提示重新 observe/snapshot，新 uid 可以继续驱动现有 click 路径。
+- `tests/dom-observer.test.js` 已覆盖 hidden/offscreen targets：默认 viewport observe 会
+  排除隐藏和视口外元素，`fullPage` 可包含视口外元素，显式 `includeHidden` 才包含隐藏元素。
+- `tests/dom-observer.test.js` 已覆盖 redaction edge modes：balanced 会遮蔽 Bearer、
+  token-like、URL query secret 和长随机串，strict 会进一步遮蔽较长普通值，`off` 会返回
+  原值并带本地调试 warning。
+- `tests/e2e.test.js` 的 opt-in real-browser smoke 已改为先 observe，再用 observe uid
+  执行 click；本切片不重写 fill/select/scroll action layer。
+
+P6.1 真实浏览器闭环验证 runbook：
+
+- 验证目标：在真实 Chromium + unpacked extension 环境中跑通
+  `observe -> click uid -> observe/verify`，证明 content script observe 生成的 fresh uid
+  能驱动现有 `yunti_click` 路径，并且点击后的页面状态可以被后续读取验证。
+- 环境准备：安装 Playwright npm 依赖和 Chromium 浏览器二进制；如果本地只安装了项目依赖但
+  缺少浏览器二进制，应先执行 Playwright 的 Chromium 安装命令，再运行本 smoke。
+- 执行命令：`YUNTI_E2E=1 npm run test:e2e`。
+- 当前 smoke 行为：测试会启动本地 bridge、加载 unpacked extension、打开本地 fixture 页面、
+  调用 `yunti_observe_page` 找到 "Click me" fresh uid、用该 uid 调用 `yunti_click`，
+  再通过页面读回确认点击计数和填充值。
+- 成功判定：`real browser extension bridge smoke` 不再 skip，测试通过，并且 artifact
+  目录没有 failure screenshot 或 error log。
+- 环境缺口判定：如果输出 `install Playwright and Chromium before running
+  YUNTI_E2E=1 npm run test:e2e`，该结果只说明当前机器缺少真实浏览器验证依赖，不代表
+  P6.1 runtime 逻辑失败；在进入 P6.2 前应重新补跑或明确记录为环境限制。
+- 失败恢复：优先查看测试输出的 artifact 目录、`failure.png` 和 `error.log`；再确认 extension
+  是否加载、bridge URL 是否写入 extension storage、页面是否刷新注册、以及
+  `yunti_list_browser_targets` 是否能看到测试页面。
+
+详细范围、非目标和验收标准见 `docs/NEXT_MAJOR_PLAN.md`。
+
+## P6.2 稳定 DOM action 层
+
+状态：进行中（2026-07-03）
+
+目标：
+
+抽取并增强 DOM action 层，提高 click、hover、fill、select、contenteditable、scroll
+容器操作的稳定性，让动作结果更容易被 Agent 验证和恢复。
+
+第一阶段优先参考 Page Agent 的 click/input/select/scroll 事件序列；Playwright/CDP 风格
+的 auto-wait、trace 和更深诊断后续再逐步补。
+
+### Page Agent 参考审计
+
+可吸收点：
+
+- `clickElement()` 的 pointer/mouse/focus/click 顺序。
+- `inputTextElement()` 对 input、textarea、contenteditable 的分支和插入后验证思路。
+- `selectOptionElement()` 的 visible text 选择思路。
+- `scrollVertically()` / `scrollHorizontally()` 的容器优先滚动、边界判断和结果消息。
+
+不复制点：
+
+- 不引入隐藏细粒度工具的大型 action runner。
+- 不移除 selector、coordinate、CDP fallback。
+- 不把动作结果只做自然语言字符串；Yunti 应返回结构化结果，必要时附带人类可读 hint。
+
+### 文档先行约束
+
+- 保持现有 `yunti_click`、`yunti_hover`、`yunti_fill`、`yunti_select`、
+  `yunti_type_text`、`yunti_press_key`、`yunti_scroll` 工具名稳定。
+- 让 uid action 自然衔接 P6.1 `yunti_observe_page`。
+- 错误提示要帮助 Agent 判断下一步是重新 observe、scroll、wait、switch tab，还是使用
+  selector/coordinate fallback。
+- 保留 CDP、selector 和 coordinate fallback，不把动作层收窄成 page-only abstraction。
+
+### 本阶段不做
+
+- 不引入隐藏细粒度工具的大型 action runner。
+- 不要求用户打开 mandatory replay/trace UI。
+- 不移除现有 CDP fallback 能力。
+
+### 动作优先级与结果契约
+
+动作优先级：
+
+- P0：`observe -> click uid -> observe`。
+- P0：`observe -> fill uid -> verify value`，覆盖 input、textarea、contenteditable。
+- P0：页面滚动与 container 滚动恢复。
+- P1：select visible text/value、tab 选择/切换、新 tab 续接、等待与验证模板。
+- P2：把 console/network/screenshot/CDP 诊断接入“为什么没成功”的恢复建议。
+
+动作结果至少包含：
+
+- 当前兼容返回可以继续保留 `clicked`、`hovered`、`filled`、`selected`、`scrolled`、
+  `uid`、`selector`、`x/y`、`method`、`valueLength`、`before/after`、
+  `browserSessionId` 等现有字段。
+- P6.2 目标结构以增量方式收敛到：`action`、`browserSessionId`、`target`、`ok`、
+  `code`、`recoverable`、`nextStepHint`。
+- `target` 应能表达 uid、selector、coordinate 或 scroll container，不强迫单一路径。
+- 必要时包含 before/after 摘要，例如 scroll position、value length、selected option、
+  URL/title 变化、toast/dialog 状态。
+- 迁移期间不移除现有成功布尔值或 selector/coordinate 字段，避免破坏外部 Agent 和旧 workflow。
+
+`yunti_select` 兼容缺口：
+
+- 当前 selector/value 路径保留。
+- P6.2 已增加 `uid + value` runtime 路径，并写明如何与 `yunti_observe_page` 的 uid
+  衔接。
+- P6.2 已增加 `uid + visible text` runtime 路径；Agent 可以在 fresh uid 下传 `text`，
+  但 selector 路径仍保持 selector/value 兼容，不支持 selector/text。
+
+最新切片记录（2026-07-03）：
+
+- `yunti_get_tool_usage_hints` 已新增 P6.2 前置 action recovery guidance，不改写实际
+  action layer。
+- `yunti_click` / `yunti_hover` / `yunti_fill` hints 现在明确失败或无页面变化后应先
+  observe/verify，再根据情况 scroll、wait、switch tab、使用 selector/coordinate fallback
+  或询问用户，避免盲目重复同一动作。
+- `tests/bridge.test.js` 已覆盖 action recovery guidance，确保 fresh uid、stale/missing
+  uid、滚动、等待、tab 切换和 fallback 的恢复提示不会退化。
+- 最新验证：`git diff --check` 通过；`node --test tests/bridge.test.js` 通过 63 项；
+  `npm run release:check` 通过，覆盖 71 个 node:test 用例，其中 70 个通过、1 个
+  real-browser smoke 按默认配置跳过；`YUNTI_E2E=1 npm run test:e2e` 在当前环境因缺少
+  Playwright/Chromium 被跳过；token 残留检查无输出。
+- `yunti_get_tool_usage_hints` 已新增 action result contract guidance，明确当前 action
+  返回是 compatibility-shaped，P6.2 后续只能增量收敛到结构化 `action` / `target` /
+  `ok` / `code` / `recoverable` / `nextStepHint` / before-after 摘要，不能破坏现有
+  `clicked` / `filled` / `hovered` / selector / coordinate 返回字段。
+- 最新验证：`git diff --check` 通过；`node --test tests/bridge.test.js` 通过 64 项；
+  `npm run release:check` 通过，覆盖 72 个 node:test 用例，其中 71 个通过、1 个
+  real-browser smoke 按默认配置跳过；`YUNTI_E2E=1 npm run test:e2e` 在当前环境因缺少
+  Playwright/Chromium 被跳过；token 残留检查无输出。
+- `tests/tool-handlers.test.js` 已新增 dispatcher action result shape 测试，锁定当前
+  uid click、uid hover、uid fill 和 content-script scroll passthrough 的兼容返回字段，
+  作为后续增量加入结构化 `action` / `target` / `ok` / `nextStepHint` 字段前的回归保护。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 4 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 73 个 node:test 用例，其中 72 个
+  通过、1 个 real-browser smoke 按默认配置跳过；`YUNTI_E2E=1 npm run test:e2e` 在当前
+  环境因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 uid-based `yunti_click` 结果增量追加结构化字段：
+  `action: "click"`、`target`、`ok`、`recoverable`、`nextStepHint`，同时保留
+  `clicked`、`uid`、`x/y`、`browserSessionId` 兼容字段。
+- `tests/tool-handlers.test.js` 已更新 uid click 断言，确保结构化字段不会替代或破坏
+  既有兼容返回。
+- 最新验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js` 通过 4 项；
+  `npm run release:check` 通过，覆盖 73 个 node:test 用例，其中 72 个通过、1 个
+  real-browser smoke 按默认配置跳过；`YUNTI_E2E=1 npm run test:e2e` 在当前环境因缺少
+  Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 uid-based `yunti_hover` 结果增量追加结构化字段：
+  `action: "hover"`、`target`、`ok`、`recoverable`、`nextStepHint`，同时保留
+  `hovered`、`uid`、`x/y`、`browserSessionId` 兼容字段。
+- `tests/tool-handlers.test.js` 已更新 uid hover 断言，确保结构化字段不会替代或破坏
+  既有兼容返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 4 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 73 个 node:test 用例，其中 72 个
+  通过、1 个 real-browser smoke 按默认配置跳过；`YUNTI_E2E=1 npm run test:e2e` 在当前
+  环境因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 uid-based `yunti_fill` keyboard path 结果增量追加
+  结构化字段：`action: "fill"`、`target`、`ok`、`recoverable`、`nextStepHint`，同时保留
+  `filled`、`uid`、`method`、`value`、`browserSessionId` 兼容字段；本切片不改
+  select/contenteditable/scroll 语义。
+- `tests/tool-handlers.test.js` 已更新 uid fill keyboard path 断言，确保结构化字段不会替代或
+  破坏既有兼容返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 4 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 73 个 node:test 用例，其中 72 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 uid-based `yunti_fill` select path 结果增量追加
+  结构化字段：`action: "fill"`、`target`、`ok`、`recoverable`、`nextStepHint`，同时保留
+  `filled`、`uid`、`method: "select"`、`value`、`browserSessionId` 兼容字段；本切片不改
+  select 赋值、change/input 事件派发或 keyboard/contenteditable/scroll 语义。
+- `tests/tool-handlers.test.js` 已新增 uid fill select path 断言，确保结构化字段不会替代或
+  破坏既有 select 兼容返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 5 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 74 个 node:test 用例，其中 73 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 coordinate fallback `yunti_click` 结果增量追加
+  结构化字段：`action: "click"`、`target`、`ok`、`recoverable`、`nextStepHint`，同时保留
+  `clicked`、`x/y`、`method: "coordinate"`、`browserSessionId` 兼容字段；本切片不改坐标点击
+  的 CDP mouse event 派发语义。
+- `tests/tool-handlers.test.js` 已新增 coordinate click 断言，确保结构化字段不会替代或
+  破坏既有 coordinate fallback 兼容返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 6 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 75 个 node:test 用例，其中 74 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 coordinate fallback `yunti_hover` 结果增量追加
+  结构化字段：`action: "hover"`、`target`、`ok`、`recoverable`、`nextStepHint`，同时保留
+  `hovered`、`x/y`、`method: "coordinate"`、`browserSessionId` 兼容字段；本切片不改坐标 hover
+  的 CDP mouse move 派发语义。
+- `tests/tool-handlers.test.js` 已新增 coordinate hover 断言，确保结构化字段不会替代或
+  破坏既有 coordinate fallback 兼容返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 7 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 76 个 node:test 用例，其中 75 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 selector fallback `yunti_hover` 结果增量追加
+  结构化字段：`action: "hover"`、`target`、`ok`、`recoverable`、`nextStepHint`，同时保留
+  `hovered`、`selector`、`x/y`、`method: "selector"`、`browserSessionId` 兼容字段；本切片不改
+  selector 定位、scrollIntoView 或 CDP mouse move 派发语义。
+- `tests/tool-handlers.test.js` 已新增 selector hover 断言，确保结构化字段不会替代或
+  破坏既有 selector fallback 兼容返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 8 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 77 个 node:test 用例，其中 76 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 selector fallback `yunti_click` content-script passthrough
+  结果增量追加结构化字段：`action: "click"`、`target`、`ok`、`recoverable`、`nextStepHint`，
+  同时保留 content-script 返回的 `clicked`、`element` 字段，并追加 `selector`、
+  `method: "selector"`、`browserSessionId` 兼容字段；本切片不改 content-script click
+  的 `scrollIntoView`、`element.click()` 或失败返回语义。
+- `tests/tool-handlers.test.js` 已新增 selector click passthrough 断言，确保结构化字段不会替代或
+  破坏既有 content-script selector click 返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 9 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 78 个 node:test 用例，其中 77 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 `yunti_scroll` content-script passthrough 结果增量追加
+  结构化字段：`action: "scroll"`、`ok`、`recoverable`、`nextStepHint` 和
+  `browserSessionId`，同时保留 content-script 返回的 `scrolled`、`deltaX/Y`、`target`、
+  `before/after` 兼容字段；本切片不改 document/container 滚动选择、坐标命中或
+  `scrollBy` 派发语义。
+- `tests/tool-handlers.test.js` 已更新 scroll passthrough 断言，确保结构化字段不会替代或
+  破坏既有 scroll 返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 9 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 78 个 node:test 用例，其中 77 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 selector fallback `yunti_fill` content-script passthrough
+  结果增量追加结构化字段：`action: "fill"`、`target`、`ok`、`recoverable`、
+  `nextStepHint`、`selector`、`method: "selector"` 和 `browserSessionId`，同时保留
+  content-script 返回的 `filled`、`element`、`valueLength` 兼容字段；本切片不改
+  content-script fill 的 `scrollIntoView`、`setEditableText`、input/change 事件或
+  contenteditable 处理语义。
+- `tests/tool-handlers.test.js` 已新增 selector fill passthrough 断言，确保结构化字段不会替代或
+  破坏既有 content-script selector fill 返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 10 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 79 个 node:test 用例，其中 78 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 `yunti_type_text` uid path 和 content-script
+  passthrough 结果增量追加结构化字段：`action: "type_text"`、`target`、`ok`、
+  `recoverable`、`nextStepHint` 和 `browserSessionId`，同时保留 uid path 的 `typed`、
+  `uid`、`text`、`method` 兼容字段，以及 content-script 返回的 `typed`、`element`、
+  `textLength`、`mode` 兼容字段；本切片不改 CDP keyboard 派发、selector/coordinate/focused
+  fallback 或 content-script `setEditableText` 语义。
+- `tests/tool-handlers.test.js` 已新增 uid type_text 和 selector type_text 断言，确保结构化字段
+  不会替代或破坏既有 type_text 返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 12 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 81 个 node:test 用例，其中 80 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 `yunti_press_key` uid path 和 content-script
+  passthrough 结果增量追加结构化字段：`action: "press_key"`、`target`、`ok`、
+  `recoverable`、`nextStepHint` 和 `browserSessionId`，同时保留 uid path 的 `pressed`、
+  `uid`、`key` 兼容字段，以及 content-script 返回的 `pressed`、`key`、`element`、
+  `valueChanged` 兼容字段；本切片不改 CDP keyDown/keyUp 派发、selector/coordinate/focused
+  fallback 或 content-script key event 语义。
+- `tests/tool-handlers.test.js` 已新增 uid press_key 和 selector press_key 断言，确保结构化字段
+  不会替代或破坏既有 press_key 返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 14 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 83 个 node:test 用例，其中 82 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 `yunti_upload_file` uid path 和 selector path
+  结果增量追加结构化字段：`action: "upload_file"`、`target`、`ok`、`recoverable`、
+  `nextStepHint` 和 `browserSessionId`，同时保留 `uploaded`、`fileCount`、`filePaths`
+  兼容字段；本切片不改 `DOM.getNodeForLocation`、`DOM.querySelector`、`DOM.describeNode`
+  或 `DOM.setFileInputFiles` 上传语义。
+- `tests/tool-handlers.test.js` 已新增 uid upload_file 和 selector upload_file 断言，确保结构化
+  字段不会替代或破坏既有 upload 返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 16 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 85 个 node:test 用例，其中 84 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 coordinate `yunti_drag` 结果增量追加结构化字段：
+  `action: "drag"`、`target`、`ok`、`recoverable`、`nextStepHint` 和
+  `browserSessionId`，同时保留 `dragged`、`from`、`to`、`steps` 兼容字段；本切片不改
+  CDP `Input.dispatchMouseEvent` 的 mousePressed / mouseMoved / mouseReleased 派发语义。
+- `tests/tool-handlers.test.js` 已新增 coordinate drag 断言，确保结构化字段不会替代或破坏
+  既有 drag 返回，并锁定 mouse event 序列。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 17 项。
+- 最新完整验证：`npm run release:check` 通过，覆盖 86 个 node:test 用例，其中 85 个
+  通过、1 个 real-browser smoke 按默认配置跳过；extension zip 内容检查通过，包含 13 个文件；
+  npm package 内容检查通过，包含 42 个文件；`YUNTI_E2E=1 npm run test:e2e` 在当前环境
+  因缺少 Playwright/Chromium 被跳过；token 残留检查无输出。
+
+### Action result 覆盖清单（2026-07-03）
+
+已完成结构化字段的 action paths：
+
+- `yunti_click`：uid path、coordinate fallback、selector passthrough；保留 `clicked`、
+  `uid`、`selector`、`x/y`、`method`、`element` 等兼容字段。
+- `yunti_hover`：uid path、coordinate fallback、selector fallback；保留 `hovered`、
+  `uid`、`selector`、`x/y`、`method` 等兼容字段。
+- `yunti_fill`：uid keyboard path、uid select path、selector passthrough；保留 `filled`、
+  `uid`、`selector`、`method`、`value`、`valueLength`、`element` 等兼容字段。
+- `yunti_scroll`：content-script passthrough；保留 `scrolled`、`deltaX/Y`、`target`、
+  `before/after` 等兼容字段。注意 scroll 原有 `target` 是兼容字段，结构化字段只增量补
+  `action`、`ok`、`recoverable`、`nextStepHint`、`browserSessionId`。
+- `yunti_type_text`：uid CDP keyboard path、selector passthrough；保留 `typed`、`uid`、
+  `text`、`method`、`element`、`textLength`、`mode` 等兼容字段。
+- `yunti_press_key`：uid CDP keyboard path、selector passthrough；保留 `pressed`、`uid`、
+  `key`、`element`、`valueChanged` 等兼容字段。
+- `yunti_upload_file`：uid path、selector path；保留 `uploaded`、`fileCount`、`filePaths`
+  等兼容字段。
+- `yunti_drag`：coordinate path；保留 `dragged`、`from`、`to`、`steps` 等兼容字段。
+- `yunti_select`：standalone content-script passthrough；保留 `selected`、`element`、
+  `value` 等兼容字段。
+- `yunti_select`：uid/value 和 uid/text runtime paths；保留 `selected`、`uid`、
+  `value`、`text`、`selectedIndex` 等兼容字段，同时保留 selector/value 兼容路径。
+- `yunti_fill_form`：aggregate summary；保留 `filled`、`failed`、`results`、
+  `browserSessionId` 等兼容字段。
+
+本覆盖清单确认 P6.2 action result 第一阶段已覆盖主要 action surfaces，并且 `yunti_select`
+已完成 selector/value、uid/value、uid/text 三条操作路径；后续可以进入更深的
+fill/select/scroll 语义增强，但仍必须小切片推进，并保留兼容字段与 CDP fallback。
+
+最新验证：`git diff --check` 通过；`npm run release:check` 通过，覆盖 86 个
+node:test 用例，其中 85 个通过、1 个 real-browser smoke 按默认配置跳过；extension zip
+内容检查通过，包含 13 个文件；npm package 内容检查通过，包含 42 个文件；本切片只更新
+文档和 skill，不涉及真实浏览器行为，未额外运行 `YUNTI_E2E=1 npm run test:e2e`；token
+残留检查无输出。
+
+- `extension/tool-handlers.js` 已为 standalone `yunti_select` content-script passthrough
+  结果增量追加结构化字段：`action: "select"`、`target`、`ok`、`recoverable`、
+  `nextStepHint` 和 `browserSessionId`，同时保留 `selected`、`element`、`value`
+  兼容字段；本切片不改 content-script `selectElement` 的 value 设置或 input/change 事件
+  派发语义。
+- `tests/tool-handlers.test.js` 已新增 selector select 断言，确保结构化字段不会替代或破坏
+  既有 standalone select 返回。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 18 项。
+- 最新 full 验证：`git diff --check` 通过；`npm run release:check` 通过，覆盖 87 个
+  node:test 用例，其中 86 个通过、1 个 real-browser smoke 按默认配置跳过；extension zip
+  内容检查通过，包含 13 个文件；npm package 内容检查通过，包含 42 个文件；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token
+  残留检查无输出。
+- `extension/tool-handlers.js` 已为 aggregate `yunti_fill_form` summary 增量追加
+  结构化字段：`action: "fill_form"`、`target`、`ok`、`recoverable`、`nextStepHint`
+  和 `browserSessionId`，同时保留 `filled`、`failed`、`results` 兼容字段；本切片不改
+  逐字段 `fillByUid` 或 content-script selector fill 语义。
+- `tests/tool-handlers.test.js` 已新增部分成功/部分失败的 fill_form aggregate 断言，确保
+  结构化字段不会替代或破坏既有 aggregate summary 与 per-field results。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js`
+  通过 19 项。
+- 最新 full 验证：`git diff --check` 通过；`npm run release:check` 通过，覆盖 88 个
+  node:test 用例，其中 87 个通过、1 个 real-browser smoke 按默认配置跳过；extension zip
+  内容检查通过，包含 13 个文件；npm package 内容检查通过，包含 42 个文件；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token
+  残留检查无输出。
+- `mcp/tools.js` 已为 `yunti_select` 增加 P6.2 uid / visible text 前置契约：schema
+  继续要求当前 runtime 真实支持的 `selector` / `value`，并暴露 planned `uid` 和 `text`
+  参数说明；usage hints 明确当前 runtime 仍保持 selector/value 兼容路径，并记录 observe、
+  inspect options、wait、switch tab 的恢复路径；本切片不改 extension runtime 行为。
+- `tests/bridge.test.js` 已新增 `yunti_select` usage hints 断言，锁住 selector/value
+  兼容边界、planned uid/text 参数和可用选项检查提示。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/bridge.test.js`
+  通过 65 项。
+- 最新 full 验证：`git diff --check` 通过；`npm run release:check` 通过，覆盖 89 个
+  node:test 用例，其中 88 个通过、1 个 real-browser smoke 按默认配置跳过；extension zip
+  内容检查通过，包含 13 个文件；npm package 内容检查通过，包含 42 个文件；本切片只更新
+  schema、usage hints、文档和 skill，不改真实浏览器 runtime 行为，未额外运行
+  `YUNTI_E2E=1 npm run test:e2e`；token 残留检查无输出。
+- `extension/tool-handlers.js` 已为 `yunti_select` 增加 `uid + value` runtime path：
+  复用当前 `browserSessionId` 最新 observe/snapshot uid map 定位元素，只按 option
+  `value` 匹配并派发 `change` / `input` 事件；selector/value 兼容路径保持不变，本切片
+  不实现 visible text 选择。
+- `mcp/tools.js`、`docs/TOOL_GUIDE.md` 和 `skills/yunti-browser-runtime/SKILL.md`
+  已同步为 selector/value 与 uid/value 均可用，visible option `text` 仍为计划中能力。
+- `tests/tool-handlers.test.js` 已新增 uid select value path 断言，确保结果保留
+  `selected`、`uid`、`value`、`selectedIndex` 等兼容字段并追加结构化 action result。
+- `tests/bridge.test.js` 已更新 select usage hints 断言，锁住 schema 的 selector 或 uid
+  二选一路径，以及 visible text 仍 planned 的边界。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 85 项。
+- 最新 full 验证：`git diff --check` 通过；`npm run release:check` 通过，覆盖 90 个
+  node:test 用例，其中 89 个通过、1 个 real-browser smoke 按默认配置跳过；extension zip
+  内容检查通过，包含 13 个文件；npm package 内容检查通过，包含 42 个文件；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token
+  残留检查无输出。
+- `extension/tool-handlers.js` 已为 `yunti_select` 增加 `uid + visible text` runtime path：
+  复用 fresh uid 定位 select，通过 option 可见文本精确匹配并派发 `change` / `input`
+  事件；selector/value 和 uid/value 路径保持不变。
+- `mcp/tools.js`、`docs/TOOL_GUIDE.md` 和 `skills/yunti-browser-runtime/SKILL.md`
+  已同步为 selector/value、uid/value、uid/text 三条路径均可用，同时明确 selector
+  路径仍保持 selector/value 兼容。
+- `tests/tool-handlers.test.js` 已新增 uid select visible text path 断言，确保结果保留
+  `selected`、`uid`、`value`、`text`、`selectedIndex` 等兼容字段并追加结构化 action result。
+- `tests/bridge.test.js` 已更新 select usage hints 断言，锁住 schema 的 selector/value、
+  uid/value、uid/text 三条路径。
+- 最新 targeted 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 86 项。
+- 最新 full 验证：`git diff --check` 通过；`npm run release:check` 通过，覆盖 91 个
+  node:test 用例，其中 90 个通过、1 个 real-browser smoke 按默认配置跳过；extension zip
+  内容检查通过，包含 13 个文件；npm package 内容检查通过，包含 42 个文件；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token
+  残留检查无输出。
+- `yunti_select` uid 失败路径已开始返回结构化可恢复诊断：当 uid path 选项未命中时，
+  返回 `selected: false`、`code: "OPTION_NOT_FOUND"`、`matchMode`、`targetOption`、
+  `availableValues` / `availableTexts` 和 `recoveryHint`，提示先检查可用选项再重试；当
+  uid 指向非 select 元素时，返回 `code: "NOT_SELECT"` 和
+  `recoveryHint.decision: "use-select-element-or-selector-fallback"`。本切片保留
+  selector/value、uid/value、uid/text 成功路径和兼容字段，不恢复为抛错式失败。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js tests/bridge.test.js`
+  通过 93 项。
+- 最新 full 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 93 项；`npm run release:check` 通过，覆盖 98 个 node:test
+  用例，其中 97 个通过、1 个 real-browser smoke 按默认配置跳过；npm package 内容检查通过，
+  包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；`YUNTI_E2E=1 npm run
+  test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token 残留检查无输出。
+- `yunti_select` selector/value 失败路径已补齐结构化可恢复诊断：当 content-script
+  返回的实际值与目标 `value` 不匹配时，返回 `selected: false`、
+  `code: "OPTION_NOT_FOUND"`、`actualValue`、`matchMode: "value"`、`targetOption`
+  和 `recoveryHint`；当 selector 指向非 select 目标或 content-script 抛错时，返回
+  `code: "SELECTOR_SELECT_FAILED"` 与 `recoveryHint.decision:
+  "use-select-element-or-uid-fallback"`。本切片保留 selector/value 成功路径和既有兼容字段，
+  只在失败时追加结构化诊断。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js tests/bridge.test.js`
+  通过 95 项。
+- 最新 full 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 95 项；`npm run release:check` 通过，覆盖 100 个 node:test
+  用例，其中 99 个通过、1 个 real-browser smoke 按默认配置跳过；npm package 内容检查通过，
+  包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；`YUNTI_E2E=1 npm run
+  test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token 残留检查无输出。
+- P6.2 action path 覆盖清单已重新审计：主要 action result surfaces 均有结构化字段覆盖，
+  `yunti_select` 的 selector/value、uid/value、uid/text 路径均已落地并记录；下一步明确
+  转向更深 fill/select/scroll 语义增强，而不是继续停留在 select 缺口。
+- 最新覆盖审计验证：`git diff --check` 通过；`npm run release:check` 通过，覆盖
+  91 个 node:test 用例，其中 90 个通过、1 个 real-browser smoke 按默认配置跳过；
+  npm package 内容检查通过，包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；
+  token 残留检查无输出。本次为 docs-only 覆盖审计补记，未重新执行真实浏览器 E2E。
+- `yunti_fill` uid contenteditable 路径已开始进入更深语义增强：保持现有 CDP keyboard
+  输入流程不变，但当目标为 contenteditable 时返回 `method: "contenteditable"`，并附带
+  `before` / `after` textLength 摘要和更明确的验证提示。selector fill 和普通 keyboard
+  path 兼容字段保持不变。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js` 通过 22 项。
+- 最新 full 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 87 项；`npm run release:check` 通过，覆盖 92 个 node:test
+  用例，其中 91 个通过、1 个 real-browser smoke 按默认配置跳过；npm package 内容检查通过，
+  包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；`YUNTI_E2E=1 npm run
+  test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token 残留检查无输出。
+- `yunti_fill` 失败路径开始返回结构化恢复诊断：selector 抛错和 uid select option miss
+  不再只依赖外层通用 error，而是返回 `filled: false`、`ok: false`、`recoverable: true`、
+  `code`、`recoveryHint` 和 `nextStepHint`。select option miss 会附带
+  `availableValues` / `availableTexts`，帮助 agent 先检查可选项再重试。本切片保持所有成功
+  fill 兼容字段与派发语义不变。
+- 最新 targeted 验证：`node --check extension/tool-handlers.js` 通过；
+  `node --test tests/tool-handlers.test.js` 通过 32 项。
+- 最新 full 验证：`git diff --check` 通过；token 残留检查无输出；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，覆盖 102 个 node:test 用例，其中 101 个通过、1 个
+  real-browser smoke 按默认配置跳过；npm package 内容检查通过，包含 42 个文件；
+  extension zip 内容检查通过，包含 13 个文件。
+- `yunti_fill_form` 聚合结果现在会保留单字段结构化失败诊断：批量填表仍保留
+  `filled`、`failed`、`results`、`action: "fill_form"`、`target`、`ok`、`recoverable`
+  和 `nextStepHint` 兼容字段；失败字段的 `results[]` item 会继续携带来自 `yunti_fill`
+  的 `code`、`recoveryHint`、`availableValues` / `availableTexts` 和字段级
+  `nextStepHint`，帮助 agent 对单个失败字段恢复，而不是只看到 `{ ok: false, error }`。
+- 最新 targeted 验证：`node --check extension/tool-handlers.js` 通过；
+  `node --test tests/tool-handlers.test.js` 通过 32 项。
+- 最新 full 验证：`git diff --check` 通过；token 残留检查无输出；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，覆盖 102 个 node:test 用例，其中 101 个通过、1 个
+  real-browser smoke 按默认配置跳过；npm package 内容检查通过，包含 42 个文件；
+  extension zip 内容检查通过，包含 13 个文件。
+- `yunti_fill` 不可编辑目标诊断已补齐：uid fill 会在派发键盘事件前检查目标是否隐藏、
+  disabled、readonly 或不是 input/textarea/select/contenteditable 等可编辑目标；selector
+  fill 的 content-script 路径也会在 `setEditableText` 前检查 hidden/no-size、disabled、
+  readonly 和不可编辑 input type。失败时返回或归类为 `code: "TARGET_NOT_EDITABLE"`，
+  透传 `filled: false`、`ok: false`、`recoverable: true`、`recoveryHint` 和
+  `nextStepHint`，uid 路径还会附带轻量 `element` 诊断元数据。本切片不改变成功 fill、
+  select、contenteditable 或 CDP fallback 兼容字段。
+- 最新 targeted 验证：`node --check extension/tool-handlers.js` 通过；
+  `node --check extension/content.js` 通过；`node --test tests/tool-handlers.test.js`
+  通过 34 项。
+- 最新 full 验证：`git diff --check` 通过；token 残留检查无输出；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，覆盖 104 个 node:test 用例，其中 103 个通过、1 个
+  real-browser smoke 按默认配置跳过；npm package 内容检查通过，包含 42 个文件；
+  extension zip 内容检查通过，包含 13 个文件。
+- `yunti_observe_page` 字段状态提示已补齐：观察元素现在可追加 `editable`、`fillable`、
+  `readOnly`、`fillBlockReason` 和 select `options[]` 摘要，帮助 agent 在调用
+  `yunti_fill` / `yunti_select` 前判断字段是否可填、是否 readonly/disabled/hidden，以及
+  可选项 value/text。该切片只追加观察字段和使用提示，不改变 uid 生命周期、redaction 默认值、
+  click/fill/select/scroll/CDP/截图/network/console 等既有动作能力。
+- 最新 targeted 验证：`node --check extension/dom-observer.js` 通过；
+  `node --test tests/dom-observer.test.js` 通过 5 项；`node --test tests/bridge.test.js`
+  通过 65 项。
+- 最新 full 验证：`git diff --check` 通过；token 残留检查无输出；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，覆盖 105 个 node:test 用例，其中 104 个通过、1 个
+  real-browser smoke 按默认配置跳过；npm package 内容检查通过，包含 42 个文件；
+  extension zip 内容检查通过，包含 13 个文件。
+- `yunti_observe_page` select 当前状态提示已补齐：select 元素现在可追加
+  `selectedIndex`、`selectedValue`、`selectedValueRedacted` 和 `selectedText`，并保留
+  已有 `options[]` 摘要。Agent 可以先读取当前选中项，再决定是否需要调用
+  `yunti_select`，避免重复选择或盲目试错。本切片只追加观察元数据，不改变
+  `yunti_select` 执行路径、uid 生命周期或 redaction 默认值。
+- 最新 targeted 验证：`node --check extension/dom-observer.js` 通过；
+  `node --test tests/dom-observer.test.js` 通过 5 项。
+- `yunti_select` disabled option 诊断已补齐：uid/value、uid/text 和 selector/value
+  路径遇到已禁用 option 时会返回 `selected: false`、`code: "OPTION_DISABLED"`、
+  `disabledValue`、`disabledText` 和结构化 `recoveryHint.decision:
+  "choose-enabled-option-or-unlock-field"`，帮助 agent 选择可用选项、等待字段解锁或询问用户。
+  本切片不改变正常 select 成功路径、uid 生命周期、selector/value 兼容路径或 CDP 能力。
+- 最新 targeted 验证：`node --check extension/tool-handlers.js` 通过；
+  `node --check extension/content.js` 通过；`node --test tests/tool-handlers.test.js`
+  通过 36 项。
+- 最新 full 验证：`git diff --check` 通过；token 残留检查无输出；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，覆盖 107 个 node:test 用例，其中 106 个通过、1 个
+  real-browser smoke 按默认配置跳过；npm package 内容检查通过，包含 42 个文件；
+  extension zip 内容检查通过，包含 13 个文件。
+- `yunti_scroll` 已开始支持 fresh scrollable container uid：`yunti_observe_page` 返回的
+  `scrollableContainers[]` 会进入当前 browserSessionId 最新 uid map；调用 `yunti_scroll`
+  传 `uid` 时会解析容器中心点并复用既有 content-script coordinate/container scroll 路径。
+  本切片保留原 `target` 兼容字段，新增 `uid`、`method: "uid"` 和 `scrollTarget`。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js` 通过 23 项。
+- 最新 full 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 88 项；`npm run release:check` 通过，覆盖 93 个 node:test
+  用例，其中 92 个通过、1 个 real-browser smoke 按默认配置跳过；npm package 内容检查通过，
+  包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；`YUNTI_E2E=1 npm run
+  test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token 残留检查无输出。
+- `yunti_scroll` 已增加无位移诊断：当 content-script 返回的 `before` / `after`
+  scroll position 可比较时，runtime 会追加 `moved`；若位置未变化，则返回
+  `code: "NO_SCROLL_MOVEMENT"`、`ok: false`、`recoverable: true`，并提示 observe、
+  检查边界、尝试最近的 scrollable container uid 或停止重复同一 scroll。本切片不改变
+  原有 scroll 派发路径和 `scrolled`、`target`、`before/after` 兼容字段。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js` 通过 24 项。
+- 最新 full 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 89 项；`npm run release:check` 通过，覆盖 94 个 node:test
+  用例，其中 93 个通过、1 个 real-browser smoke 按默认配置跳过；npm package 内容检查通过，
+  包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；`YUNTI_E2E=1 npm run
+  test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token 残留检查无输出。
+- `yunti_scroll` 无位移诊断已增加方向性 `edgeHint`：在 `moved: false` 且 delta 方向
+  可判断时，返回 `possible-bottom-edge`、`possible-top-edge`、`possible-right-edge` 或
+  `possible-left-edge`，帮助 Agent 判断是否可能到达滚动边界、需要换方向、换容器或停止重复。
+  本切片仍不改变原有 scroll 派发路径和兼容字段。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js` 通过 25 项。
+- 最新 full 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 90 项；`npm run release:check` 通过，覆盖 95 个 node:test
+  用例，其中 94 个通过、1 个 real-browser smoke 按默认配置跳过；npm package 内容检查通过，
+  包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；`YUNTI_E2E=1 npm run
+  test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token 残留检查无输出。
+- `yunti_scroll` 无位移诊断已新增结构化 `recoveryHint`：在
+  `NO_SCROLL_MOVEMENT` 时返回 `reason`、`nextAction`、`recommendedTools`、
+  `currentTarget`、`edgeHint`，若使用 fresh scrollable container uid，还会附带
+  `lastObservedContainer` 的滚动能力与 remaining pixels 摘要。该字段用于帮助 Agent
+  判断 observe、换方向、换容器或停止重复 scroll；本切片不改变 scroll 派发路径和兼容字段。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js` 通过 26 项。
+- 最新 full 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 91 项；`npm run release:check` 通过，覆盖 96 个 node:test
+  用例，其中 95 个通过、1 个 real-browser smoke 按默认配置跳过；npm package 内容检查通过，
+  包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；`YUNTI_E2E=1 npm run
+  test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token 残留检查无输出。
+- `yunti_scroll` 无位移恢复提示已新增 `recoveryHint.suggestedRetry`：当
+  `edgeHint` 能推导出反向方向时，返回一次性反向 `deltaX` / `deltaY`；uid scroll
+  路径会保留同一个 fresh container uid，方便 Agent 尝试一次反向滚动后立即重新 observe。
+  该字段是纯新增诊断信息，不改变 scroll 派发路径、兼容字段、`nextAction` 或既有
+  `recoveryHint` 结构。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js tests/bridge.test.js`
+  通过 91 项。
+- 最新 full 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 91 项；`npm run release:check` 通过，覆盖 96 个 node:test
+  用例，其中 95 个通过、1 个 real-browser smoke 按默认配置跳过；npm package 内容检查通过，
+  包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；`YUNTI_E2E=1 npm run
+  test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token 残留检查无输出。
+- `yunti_scroll` 无位移恢复提示已新增 `recoveryHint.decision`：在
+  `NO_SCROLL_MOVEMENT` 时根据 `edgeHint` 和是否使用 fresh container uid，返回机器可读的
+  恢复决策，例如 `observe-for-scrollable-container`、
+  `observe-for-horizontal-scrollable-container`、
+  `retry-opposite-vertical-on-same-container-once`、
+  `retry-opposite-horizontal-on-same-container-once` 或 `provide-nonzero-delta`。
+  该字段帮助 Agent 在 `nextAction` 和 `suggestedRetry` 之间少做分支判断；本切片仍不改变
+  scroll 派发路径、兼容字段或既有恢复字段。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js tests/bridge.test.js`
+  通过 91 项。
+- 最新 full 验证：`git diff --check` 通过；`node --test tests/tool-handlers.test.js
+  tests/bridge.test.js` 通过 91 项；`npm run release:check` 通过，覆盖 96 个 node:test
+  用例，其中 95 个通过、1 个 real-browser smoke 按默认配置跳过；npm package 内容检查通过，
+  包含 42 个文件；extension zip 内容检查通过，包含 13 个文件；`YUNTI_E2E=1 npm run
+  test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；token 残留检查无输出。
+- `yunti_scroll` coordinate scroll 命中/回退诊断已补齐：当 content script 收到 `x` / `y`
+  时，会返回 `coordinateTarget`、`scrollContainerFound` 和必要时的
+  `coordinateScrollFallback: "document"`，用于区分坐标是否命中嵌套 scroll container，
+  还是回退到 document 滚动。本切片只新增诊断字段，不改变 coordinate/document/uid
+  scroll 派发行为。
+- `yunti_scroll` coordinate document fallback 恢复提示已补齐：当 handler 收到
+  `coordinateScrollFallback: "document"` 时，成功结果保持 `ok: true` /
+  `recoverable: false`，并新增 `coordinateFallbackHint` 与更明确的 `nextStepHint`，
+  引导 Agent 重新 observe 并优先选择 fresh `scrollableContainers[]` uid，避免误判 nested
+  panel 已经被滚动。
+- 最新 targeted 验证：`node --test tests/tool-handlers.test.js tests/bridge.test.js
+  tests/content-scroll.test.js` 通过 107 项。
+- 最新 full 验证：`git diff --check` 通过；token 残留检查无输出；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，覆盖 113 个 node:test 用例，其中 112 个通过、1 个
+  real-browser smoke 按默认配置跳过；npm package 内容检查通过，包含 42 个文件；
+  extension zip 内容检查通过，包含 13 个文件。
+- `yunti_get_tool_usage_hints` wait-observe 恢复指导已补齐：action recovery workflow
+  和 fill/select/scroll 的工具级 recovery 都明确建议，在异步 UI transition、表单校验、
+  option 异步加载或内容继续加载时，使用 `yunti_wait_for` 等待预期 text/selector/state，
+  然后重新 `yunti_observe_page` 并用 fresh uid 继续。本切片只更新 agent guidance
+  和测试，不改变 runtime action 行为。
+- 最新 targeted 验证：`node --test tests/bridge.test.js` 通过 65 项。
+- 最新 full 验证：`git diff --check` 通过；token 残留检查无输出；
+  `YUNTI_E2E=1 npm run test:e2e` 已执行但因本地缺少 Playwright/Chromium 跳过；
+  `npm run release:check` 通过，覆盖 113 个 node:test 用例，其中 112 个通过、1 个
+  real-browser smoke 按默认配置跳过；npm package 内容检查通过，包含 42 个文件；
+  extension zip 内容检查通过，包含 13 个文件。
+
+详细范围、非目标和验收标准见 `docs/NEXT_MAJOR_PLAN.md`。
+
+## P6.3 Agent 工作流契约
+
+状态：已完成
+
+目标：
+
+将 `observe -> act -> verify` 作为默认 Agent 使用范式写入 skill、tool hints 和文档，
+减少盲目重试和坐标操作。
+
+P6.3 的一部分应前置到 P6.1 schema 合并时完成：
+
+- `yunti_get_tool_usage_hints` 必须同步新增 observe-first guidance。
+- `skills/yunti-browser-runtime/SKILL.md` 应加入默认循环：
+  `hints -> list targets -> observe -> act by uid -> wait if needed -> observe -> verify -> recover or continue`。
+- `docs/TOOL_GUIDE.md` 应补点击、填表、滚动找元素、切 tab、等待异步结果五个最小用例。
+- 提供可复制提示词，指导外部 Agent 避免盲目重复失败动作，并在提交、删除、支付、
+  上传敏感文件或修改生产数据前请求用户确认。
+
+详细范围、非目标和验收标准见 `docs/NEXT_MAJOR_PLAN.md`。
+
+## P6.4 DOM 脱敏与页面内容策略
+
+状态：已完成
+
+目标：
+
+把 DOM observation 的敏感内容脱敏提升为一等能力，与现有 network/console redaction
+形成统一安全边界。
+
+P6.1 已前置最小 DOM observation 脱敏基线；P6.4 负责深化：
+
+- `strict` 模式覆盖 email、phone、证件号/银行卡-like、地址-like 和正文中的 credential-like
+  片段。
+- 对齐 DOM、network、console 的敏感词和字段策略。
+- 明确 learning memory、task history、diagnostic artifacts 默认不存 secret，并提供清理路径。
+- 明确截图默认是真实像素，不承诺被 DOM redaction 遮蔽。
+
+P6.4.1 已落地：
+
+- `strict` 模式会在 DOM observation 的 page title、label、name、visible text、
+  placeholder、value preview、select selected value/text、options value/text 和
+  scrollable container name 中遮蔽更广的 PII-like 内容。
+- 新增类别包括 `email`、`phone`、`payment_card` 和 `address`；payment card-like
+  值要求 13-19 位数字且通过 Luhn 校验，减少普通长数字误伤。
+- `balanced` 仍保持默认 credential-like 保护，不因普通业务文本变长而过度遮蔽；
+  `off` 仍只用于显式本地调试。
+- `docs/TOOL_GUIDE.md`、`skills/yunti-browser-runtime/SKILL.md`、`docs/SECURITY.md`
+  和 `yunti_get_tool_usage_hints` 已同步 strict/balanced/off 的使用边界。
+- `tests/dom-observer.test.js` 已覆盖 strict PII 类别、select option text 脱敏、
+  page title 脱敏和 balanced 普通业务文本不误伤。
+
+P6.4.2 已落地：
+
+- `mcp/redaction.js` 统一增强 likely-sensitive text 脱敏，覆盖 Bearer、JWT、
+  private key、长 token-like、email、phone、Luhn-valid payment-card-like 和 address-like。
+- `yunti_remember_learning` 写入 title、detail、tags、source 前统一脱敏，避免 learning
+  memory 成为 secret 或 PII-like 长期存储。
+- `yunti_list_console_messages` / `yunti_get_console_message` 返回的 text、stackTrace 和 args
+  在缓存前统一脱敏。
+- `yunti_get_cdp_events` 保持 raw low-level diagnostics 语义，但文档和 tool hints 已明确
+  这是例外，应在调试后用 `yunti_clear_cdp_events` 清理。
+
+P6.4.3 已落地：
+
+- `yunti_get_tool_usage_hints` 已为 `yunti_get_cdp_events`、`yunti_clear_cdp_events`、
+  `yunti_take_screenshot` 和 `yunti_capture_visible_tab` 增加安全边界和清理 guidance。
+- Raw CDP 诊断明确优先使用 sanitized network/console 工具，必要时按 `method` 和 `limit`
+  缩小范围，用后清理，且不复制 raw params 到聊天、文档或 learning memory。
+- Screenshot 诊断明确是真实可见像素，不受 DOM redaction 保护；优先 viewport 截图，
+  只总结安全视觉结论，不把 raw image data 存入 learning memory。
+
+详细范围、非目标和验收标准见 `docs/NEXT_MAJOR_PLAN.md`。
+
+## P6.5 可选本地运行时控制台
+
+状态：已完成；P6.5.1-P6.5.3 已完成
+
+目标：
+
+提供非必选的本地调试控制台，用于查看 bridge 状态、连接页面、最近工具调用、错误和
+stop/cancel 操作，同时保持 popup 零配置。
+
+P6.5.1 完成范围：
+
+- `yunti-browser-runtime console` 启动 bridge 并打印本地控制台 URL。
+- bridge 提供 `/console` 页面、`/console/state` 脱敏状态 JSON 和
+  `/console/cancel-pending` 取消 runtime pending/queued 请求接口。
+- 控制台展示 connected pages、pending/queued requests、network/console/CDP 诊断数量和
+  最近工具 activity；页面标题、用户信息、URL 和错误摘要统一走脱敏/URL 清洗。
+- 启用 `YUNTI_BROWSER_BRIDGE_TOKEN` 时，`/console/state` 和 cancel 接口仍受 token 保护；
+  页面 shell 只提示需要受保护诊断，不泄露 session 明细。
+- cancel 只清理 runtime 仍在等待或排队的请求，不承诺撤销已经发生的浏览器副作用。
+
+P6.5.2 完成范围：
+
+- 增强空状态和 stale session 的操作指引。
+- 展示 bridge/package 与 extension version mismatch 警告。
+- `HEAD /console` 与 `GET /console` 一样返回 200，便于探活工具检查。
+- `doctor` JSON 和 human summary 中加入 console URL。
+
+P6.5.3 完成范围：
+
+- `YUNTI_E2E=1 npm run test:e2e` 覆盖真实扩展注册后控制台状态。
+- 验证 `HEAD /console`、`GET /console` 和 `/console/state` 都可用。
+- 验证 runtime version、expected extension version 和 session extension version 与
+  package version 一致。
+- 验证真实页面连接后不会出现 `NO_CONNECTED_PAGES` 或
+  `EXTENSION_VERSION_MISMATCH` warning。
+
+P6.6.1 完成范围：
+
+- 审计当前 `extension/manifest.json` 的 permissions / host_permissions。
+- 整理 Chrome Web Store / Edge Add-ons 所需的权限说明、隐私说明和素材清单。
+- 保留 unpacked extension 开发路径，不在第一刀里改变现有权限行为。
+- 新增 `docs/EXTENSION_DISTRIBUTION.md`，并从 README、Security 和 Roadmap 链接。
+
+P6.6.2 完成范围：
+
+- 起草面向 Chrome Web Store / Edge Add-ons 的权限说明和隐私披露文本。
+- 覆盖 `debugger`、`tabs`、`webRequest`、广泛 `http` / `https` host access、
+  localhost bridge、DOM observation、screenshots、network/console diagnostics
+  和 learning memory。
+- 只沉淀文案与决策依据；不在这一刀直接收窄 manifest 权限。
+- 新增 `docs/EXTENSION_STORE_COPY.md`，包含 short/long description、permission
+  rationale、privacy-policy draft、store data disclosure guidance、reviewer notes
+  和 final review checklist。
+
+P6.6.3 完成范围：
+
+- 决定商店版本前的权限策略：继续 broad host access、迁移到 optional host
+  permissions、将 `webRequest` 诊断可选化，或明确 0.2.0 继续只保留 unpacked/npm
+  分发路径。
+- 如果改变行为，需要同步 extension manifest/UX、`mcp/tools.js`、Tool Guide、skill、
+  Security docs 和测试。
+- 新增 `docs/EXTENSION_PERMISSION_STRATEGY.md`，明确当前 npm/unpacked 路径保持完整能力；
+  当前 broad-permission manifest 不建议默认直接提交商店；store-candidate track
+  需要先设计 optional host access、missing-permission recovery 和 optional diagnostics。
+- 本切片不改变 extension manifest 或 runtime 行为。
+
+P6.6.4 后置：
+
+- 设计 store-candidate 权限 UX 和技术原型计划。
+- 明确 popup/doctor/MCP error/tool hints/Tool Guide/skill/tests 在 optional host access
+  和 optional network diagnostics 下如何变化。
+
+详细范围、非目标和验收标准见 `docs/NEXT_MAJOR_PLAN.md`。
+
+## P6.6 浏览器扩展分发准备
+
+状态：0.2.0 npm/unpacked 范围已完成；P6.6.4 后置到 post-0.2 store-candidate track
+
+目标：
+
+准备 Chrome Web Store / Edge Add-ons 上架材料和权限说明，降低最终用户手动加载扩展的
+安装成本，同时保留 unpacked extension 开发路径。
+
+P6.6.1 已完成：
+
+- `docs/EXTENSION_DISTRIBUTION.md` 记录当前 manifest 权限审计、官方策略参考、
+  store submission checklist、隐私披露主题和权限收窄选项。
+- 该审计已接入 README、Security 和 Roadmap，避免后续发布商店版本前丢失上下文。
+- 本切片不改变 extension runtime 行为，也不收窄 manifest 权限。
+
+P6.6.1 最新验证：
+
+- `git diff --check` 通过。
+- token 残留检查无输出。
+- `npm run check` 通过。
+- `npm test` 通过，覆盖 126 个 node:test 用例，其中 125 个通过、1 个默认真实浏览器
+  smoke 按配置跳过。
+- `YUNTI_E2E=1 npm run test:e2e` 在本机 `pytest-playwright` 环境下通过 1 个真实浏览器
+  extension bridge smoke；conda 仅打印 requests 依赖版本 warning，不影响结果。
+- `npm run release:check` 通过，包含 public documentation residue check、15 个公开
+  Markdown 文件链接检查、action result coverage 11 行、npm package 内容 46 个文件和
+  extension zip 内容 13 个文件。
+
+P6.6.2 已完成：
+
+- 将 P6.6.1 的审计结果转成可提交商店时使用的 permission rationale 和 privacy copy 草案。
+- 明确哪些内容可直接用于 store listing，哪些仍需用户/维护者最终确认。
+- `docs/EXTENSION_STORE_COPY.md` 已沉淀 store listing description、permission
+  rationale、privacy policy draft、data disclosure guidance、reviewer notes 和
+  final review checklist。
+- 本切片不改变 extension manifest 或 runtime 行为。
+
+P6.6.2 最新验证：
+
+- `git diff --check` 通过。
+- token 残留检查无输出。
+- `npm run check` 通过。
+- `npm test` 通过，覆盖 126 个 node:test 用例，其中 125 个通过、1 个默认真实浏览器
+  smoke 按配置跳过。
+- `YUNTI_E2E=1 npm run test:e2e` 在本机 `pytest-playwright` 环境下通过 1 个真实浏览器
+  extension bridge smoke；conda 仅打印 requests 依赖版本 warning，不影响结果。
+- `npm run release:check` 通过，包含 public documentation residue check、16 个公开
+  Markdown 文件链接检查、action result coverage 11 行、npm package 内容 47 个文件和
+  extension zip 内容 13 个文件。
+
+P6.6.3 已完成：
+
+- 在不迷失 Yunti local-first / MCP-native 特色的前提下，做商店前权限策略决策。
+- 优先评估 broad host permissions 和 `webRequest` 是否继续保持默认、改为 optional，或
+  延后商店上架。
+- `docs/EXTENSION_PERMISSION_STRATEGY.md` 已明确两轨策略：developer/npm track
+  保持当前 zero-config broad-access 体验；store-candidate track 另行设计可选 host access
+  和可选 network diagnostics。
+- 当前 manifest 和 runtime 行为不变。
+
+P6.6.3 最新验证：
+
+- `git diff --check` 通过。
+- token 残留检查无输出。
+- `npm run check` 通过。
+- `npm test` 通过，覆盖 126 个 node:test 用例，其中 125 个通过、1 个默认真实浏览器
+  smoke 按配置跳过。
+- `YUNTI_E2E=1 npm run test:e2e` 在本机 `pytest-playwright` 环境下通过 1 个真实浏览器
+  extension bridge smoke；conda 仅打印 requests 依赖版本 warning，不影响结果。
+- `npm run release:check` 通过，包含 public documentation residue check、17 个公开
+  Markdown 文件链接检查、action result coverage 11 行、npm package 内容 48 个文件和
+  extension zip 内容 13 个文件。
+
+P6.6.4 后置：
+
+- 做 store-candidate 权限 UX 设计，列清楚用户操作、agent 恢复提示、doctor 检查和测试矩阵。
+- 该设计完成后，再决定是否进入 manifest/extension 代码实现。
+- 该工作不作为 0.2.0 npm/unpacked 发布硬门槛，后续作为 store-candidate track 单独推进。
+
+## P7.1 0.2.0 npm/unpacked 发布收口
+
+状态：已完成
+
+目标：
+
+冻结 0.2.0 范围，发布 npm/unpacked extension 形态；商店候选版权限 UX 后置。
+
+完成范围：
+
+- package 和 extension 版本同步提升到 `0.2.0`。
+- README / Release / status / execution plan 先更新为 0.2.0 发布候选状态，并在发布后
+  更新为已发布状态。
+- 执行 `npm run check:metadata`、`npm run release:prepublish`、真实浏览器 E2E、
+  `npm run release:dry-run`、`npm run release:publish` 和
+  `npm run release:verify-published`。
+
+当前验证：
+
+- `git diff --check` 通过。
+- token 残留检查无输出。
+- `npm run check:metadata` 通过，确认 GitHub repository/homepage/bugs URL 为 200。
+- `npm run release:check` 通过，包含 public documentation residue check、18 个公开
+  Markdown 文件链接检查、version consistency check `0.2.0`、CLI smoke `0.2.0`、
+  action result coverage 11 行、npm package 内容 49 个文件和 extension zip 内容 13 个文件。
+- `YUNTI_E2E=1 npm run test:e2e` 在本机 `pytest-playwright` 环境下通过 1 个真实浏览器
+  extension bridge smoke；conda 仅打印 requests 依赖版本 warning，不影响结果。
+- `npm run release:dry-run` 通过，生成 `yunti-browser-runtime-0.2.0.tgz` dry-run
+  预览，tarball 共 49 个文件。
+- `npm run release:publish` 已发布 `yunti-browser-runtime@0.2.0` 到官方 npm registry。
+- `npm run release:verify-published` 已验证 name、version、repository、homepage、bugs
+  和 tarball URL。
+
+下一步：
+
+- 选择 post-0.2 下一阶段；P6.6.4 store-candidate 权限 UX 仍作为浏览器商店方向后置。
+
+详细范围、非目标和验收标准见 `docs/NEXT_MAJOR_PLAN.md`。
 
 ## 每阶段完成后的固定检查
 
@@ -1383,6 +2741,24 @@ npm test
 npm run test:e2e
 ```
 
+P6.1/P6.2 browser behavior 变更合并前必须执行：
+
+```bash
+YUNTI_E2E=1 npm run test:e2e
+```
+
+最小 fixture 矩阵：
+
+- `observe-basic.fixture.html`
+- `observe-redaction.fixture.html`
+- `observe-scroll.fixture.html`
+- `observe-dynamic.fixture.html`
+- `actions-form.fixture.html`
+- `actions-contenteditable.fixture.html`
+- `actions-scroll-container.fixture.html`
+
+这些 fixture 是本地确定性回归，不是 benchmark 优化目标。
+
 涉及文档/开源化时额外检查：
 
 ```bash
@@ -1391,11 +2767,63 @@ rg "/U[s]ers|C[o]deg|x[y]y|y[b]m100" README.md docs skills package.json
 
 ## 当前下一步
 
-P0.1-P5.3 已完成，`yunti-browser-runtime@0.1.3` 待发布验证。
+P0.1-P7.1 已完成，`yunti-browser-runtime@0.2.0` 已发布到官方 npm registry。
+
+## P7.2 0.2.1 安装后自动注入 / 自动注册页面
+
+状态：实施中，代码与文档已完成，等待完整验证和提交。
+
+目标：
+
+让用户加载扩展后尽量不需要手动刷新页面。扩展后台应主动扫描可访问的 `http` /
+`https` tabs，对没有注册 session 的页面注入 `dom-observer.js`、`content.js` 和
+`content.css`，再触发 `yunti_refresh_registration`，使 Agent 能直接发现和操作已打开页面。
+bridge 重启或 background service worker 恢复后，也应尽量自动恢复注册。
+
+非目标：
+
+- 不绕过 Chrome 对 `chrome://`、扩展页、Web Store、权限不足页面等不可注入页面的限制。
+- 不引入远程服务、不要求用户填写 token、不要求默认打开 popup。
+- 不改变普通 observe-first action 的非 CDP 默认路径。
+
+验收：
+
+- manifest 增加必要的 `scripting` 能力。
+- background/session manager 支持 scan -> ping -> inject -> refresh registration。
+- 安装/startup、tab update/activation、popup refresh、targets inventory/recovery 等路径能触发恢复。
+- README / INSTALL / skill / Tool Guide / usage hints / doctor guidance 不再默认要求用户刷新；
+  只把刷新作为无法注入时的兜底恢复。
+- `git diff --check`、token 残留检查、`npm run release:check` 通过；涉及真实浏览器链路时执行
+  `YUNTI_E2E=1 npm run test:e2e`。
+
+进展：
+
+- manifest 已新增 `scripting` 权限，用于向已打开的受支持页面注入打包内容脚本。
+- session manager 已支持 scan -> ping -> inject -> refresh registration，并带同页短时间去重。
+- background 已接入 install/startup/background start、tab activated、tab updated complete。
+- popup refresh 和 `yunti_list_browser_targets` 已接入自动恢复。
+- README、INSTALL、doctor、console guidance、skill、store/permission docs 已改为自动注册优先，
+  刷新页面只作为浏览器限制下的兜底。
 
-- 发布后验证待执行：`npm run release:verify-published`。
+- 发布后验证已通过：`npm run release:verify-published`。
 - 本地默认使用不再需要 bridge token；需要加固时可显式设置
   `YUNTI_BROWSER_BRIDGE_TOKEN`。
 - 扩展 popup 默认不需要用户保存设置；Bridge URL、页面匹配和 token 已移入高级设置。
-- 后续如要上架浏览器扩展商店，发布前还需重新审查 broad host permissions。
-- 后续版本开发前，先在本文档新增下一阶段目标、范围和验收标准。
+- `0.2.0 Best Browser Automation Runtime` 的大版本计划已沉淀到
+  `docs/NEXT_MAJOR_PLAN.md`。
+- 继续 0.2.0 的小切片推进：P6.4 已完成 DOM strict redaction、learning memory /
+  console diagnostics 存储边界、raw CDP / screenshot 非默认脱敏提示与清理边界。
+  P6.1.4 真实浏览器闭环已补验通过，P6.5.1 可选本地运行时控制台最小闭环已完成，
+  P6.5.2 控制台诊断增强第一刀已完成，P6.5.3 控制台真实浏览器 E2E 验收已完成，
+  P6.6.1 浏览器扩展分发准备已完成，P6.6.2 商店权限与隐私文案草案已完成，
+  P6.6.3 商店前权限策略决策已完成。P6.6.4 Store candidate 权限 UX 设计已后置；
+  P7.1 0.2.0 npm/unpacked 发布收口已完成。
+- 保持兼容：不改变成功 fill、select、scroll、CDP、截图、network/console、file upload 或 tab
+  能力；新增诊断只在失败结果或 observe 元数据里追加更具体的 `code`、`recoveryHint`、
+  `element` / 字段状态摘要和验证提示。
+- 验证重点：继续执行
+  `git diff --check`、token 残留检查、`YUNTI_E2E=1 npm run test:e2e` 和
+  `npm run release:check`。
+- 后续如要上架浏览器扩展商店，按 `docs/EXTENSION_PERMISSION_STRATEGY.md` 单独推进
+  store-candidate 权限 UX 和 broad host permissions 审查。
+- 后续版本开发前，先按 `docs/NEXT_MAJOR_PLAN.md` 拆阶段执行并更新本文档验收记录。