Skip to content

docs(skill): clarify observation and overlay recovery - #564

Open
Wang-Zephyr wants to merge 1 commit into
Tencent:mainfrom
Wang-Zephyr:docs/observation-overlay-recovery
Open

Wang-Zephyr wants to merge 1 commit into
Tencent:mainfrom
Wang-Zephyr:docs/observation-overlay-recovery

Conversation

@Wang-Zephyr

Copy link
Copy Markdown

Summary

Adds recovery guidance for the sync/retry loop and extension-overlay obstruction reported in #551, in both the universal CLI skill and the DSH plugin skill.

  • Successful target-policy syncs issue a fresh top-level receipt even with kind: "unchanged". After a failed/refused untargeted attempt, synchronize and reconsider the returned evidence.
  • A plugin schema that cannot forward observationId needs an upgrade and skill reload; repeating sync cannot repair it.
  • For Could not clear the extension overlay from the click point, explain the temporary Control hints workaround, reinspection of the intended target, and the distinction from site masks reported by VOM.

This documents recovery; it does not fix the overlay hit-testing defect or close #551. The original issue's baseline-only receipt rule is not reproduced by the current implementation.

Validation

  • node scripts/check-skill-bundles.mjs
  • node --test scripts/check-skill-bundles.test.mjs — 6 passed
  • node scripts/check-crate-skill.mjs
  • git diff --check
  • Existing source-behavior tests: pnpm --filter @browser-skill/extension exec vitest run src/cooperation/target-policy.test.ts src/content/__tests__/overlay-controller.test.ts src/tools/vom/__tests__/capture.test.ts --maxWorkers=2 — 107 passed

Documentation only: 14 lines added across four references. No production code changes or live-browser reproduction claimed.

@Wang-Zephyr
Wang-Zephyr marked this pull request as ready for review November 3, 2026 15:40
@Wang-Zephyr
Wang-Zephyr force-pushed the docs/observation-overlay-recovery branch from c2a6475 to 5ed9eb9 Compare November 17, 2026 08:17

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: 补充 strict observation 的发放条件与扩展悬浮层遮挡的排查说明

1 participant