# Ziniao Page

> Use when a request concerns a webpage running inside an already-opened 紫鸟/ZClaw store browser, including navigation, inspection, interaction, extraction, or screenshots. If the task starts by identifying or opening a store, use ziniao-store first.

- Skill: `ziniao-open/ziniao-page` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds add ziniao-open/ziniao-page`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ziniao-open/ziniao-page/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: ziniao-open (https://skillmd.com/u/ziniao-open)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/ziniao-open/ziniao-page

---


# 紫鸟页面能力

本技能负责已打开紫鸟店铺浏览器中的通用网页资源操作，不负责店铺生命周期，也不定义用户的业务流程。

## 负责范围

- 对当前店铺浏览器中的网页进行通用操作或读取。
- 在页面操作中复用已确认的 `store-id`，必要时指定 `target-id`。
- 根据页面状态选择 CLI 已提供的页面命令；参数以 `ziniao-cli page <command> --help` 为准。
- 页面操作需要复杂编排时，按需读取 automation reference。

## 路由边界

- 已有店铺浏览器并且目标是网页资源：直接使用本技能。
- 任务尚未确定或打开店铺：转到 `ziniao-store`，不要自行猜测店铺 ID。
- 不要把用户的业务目标或任务参数写入技能；这些是用户任务，由模型组合通用页面能力完成。
- 配置、认证、Bridge、客户端或网络异常：按需读取 `ziniao-shared` 的诊断规则，不在本技能重复维护环境修复流程。

## 最小执行规则

1. 确认店铺已打开，并取得有效 `store-id`；页面命令通常都需要它。
2. 先确认当前页面状态，再执行必要的页面操作；页面变化后不要复用失效的目标或定位信息。
3. 对导航、等待、读取、交互、提取和截图等能力，直接使用 CLI 的对应命令；不确定参数时先看 `--help`。
4. 涉及附件或图片上传时，在下载、路径转换或上传调用前，必须完整读取 [page upload 安全规则](references/ziniao-page-upload.md)；未读取不得执行上传。
5. 只在当前任务需要时读取 reference，不要默认读取全部页面文档。
6. 报错时区分页面/目标定位问题和环境问题；环境问题再转 `ziniao-shared`/`doctor`。

## 页面读取与定位顺序

1. 页面状态、`target-id` 和稳定 CSS selector 已知时，直接复用并执行必要操作；不要为每一步重复读取页面。
2. 需要理解页面或验证导航、搜索、提交结果时，优先使用 `page content --content-format structured`；只需 URL/title 时也可使用 `page exec`。
3. selector 未知时，先使用 `page content`、`page query` 或 `page exec` 分析 DOM，再使用 `page input` / `page click --selector`。
4. 只有上传控件、自定义或图标控件、多个相似控件存在歧义，或上述 DOM 方法仍无法唯一定位时，才使用 `page snapshot` 和当前页面 ref。

`page snapshot` 不是通用页面状态检查命令。不得为了验证店铺窗口、读取 URL/title/`target-id`、操作已知 selector、普通搜索或结果验证而调用 snapshot；页面未变化时也不得重复创建 snapshot/ref。snapshot ref 只属于当前店铺、tab 和页面，页面导航或刷新后不得复用。

输入后提交只能选择一种方式：使用 `page input --submit` 后等待并验证结果，或不传 `--submit` 再执行提交按钮的 `page click --wait-nav`；不得重复提交。

## 按需参考

- [page visit](references/ziniao-page-visit.md)：需要导航时读取。
- [page screenshot](references/ziniao-page-screenshot.md)：需要截图时读取。
- [page upload 安全规则](references/ziniao-page-upload.md)：涉及附件、图片、文件输入框或 `page upload` 时必须读取。
- [automation run](references/ziniao-page-automation.md)：需要多步骤自动化时读取。
- `ziniao-store`：需要确定或打开店铺时使用。
- `ziniao-shared`：仅在环境、配置、认证或 Bridge 诊断时读取。