[yzhg1983]

Why

Run script defaults to Ask, but Chrome's "Allow User Scripts" switch is off on every new install. Until now pi quietly dropped run_script in that case, and neither the user nor the model knew why. The only hint was a line in Settings > Tools. This PR treats scripts as a core feature and makes the gap visible (design 6.23).

What changes

Setup step

• The card appears once the provider has a key and site access, while Run script is Ask or On and the switch is off:

  Let pi run scripts on pages
  Scripts let pi pull data out of pages, fill in pages and change them. Turn on "Allow User Scripts" on pi's Chrome details page (scroll down), then come back.
  With Run script on Ask, you review each script before it runs. (only while Ask)
  [Open pi's Chrome details page] [Skip]

• It does not block the message box.
• Chrome has no event for the switch, so the panel reads it on focus, when it becomes visible, and every second while the card shows.
• When the switch turns on, the card closes. "Scripts enabled in Chrome" then shows outside it for 6 s and is announced to screen readers. The next message offers run_script; nothing retries automatically.
• Skip only ends onboarding. Run script, Settings > Tools and the model hint are unchanged.
• Only settings.scriptsOnboarded is stored, never the switch. If the switch is already on, the step is marked done without showing. The step never comes back, even if the switch is turned off later.

Model hint

• run_script stays unoffered while the switch is off.
• While only the switch blocks it, the instructions add a short note (SCRIPTS_BLOCKED) that names no tool: say so, and where to enable it, only when the task materially needs a script. Nothing changes when Run script is Off.

Settings > Tools

• The "off" line now says to scroll down on the details page.

Docs

• docs/page-tools.md: the hint word for word, plus a new "Setup: Allow User Scripts" section.
• docs/guide.md, both READMEs (Quick start step 4) and PRIVACY.md.

Tests

• npm test: 615 passed. New unit tests cover the setting's default and that Skip changes nothing else, and that the hint appears only while the switch alone is blocking (not when Run script is Off, not when the switch is on).
• test:page-tools (61 checks), with new checks for:
  • the hint sent to the model;
  • the card shown, then the switch turned on from the details page, the confirmation appearing and the step saved as done;
  • the card staying closed after the switch is turned off again.
• test:localization (268 checks), with new checks for the card in English, Skip, and the card staying closed after a restart in Chinese.
• test:screenshots, test:slash, test:edit, test:attachments and test:selection still pass.

---

Generated by Claude Code