القائمة
通过 Playwright 多浏览器并行巡检 AiOS 全站页面。每次运行前自动扫描 Vue Router 文件获取最新路由表，无需手工维护。截图、控制台与网络错误检测、白屏与模拟数据识别、安全交互探索，生成 JSON 报告供 AI agent 消费。当用户提到"全站巡检""检查所有页面""系统体检""全面检查""巡检报告"时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
从 AI 回复中提取和解析 JSON 数据，处理 thinking 标签、Markdown 代码块、混合文本。当解析 AI 返回的 JSON 失败或需要从 LLM 回复中提取结构化数据时使用。
统一 AI 调用服务，三服务商策略（4sapi+sodao+OpenRouter），支持文本对话、图片理解、PDF/音视频分析、图像生成、流式输出、智能降级。当需要接入大语言模型或实现多模态 AI 功能时使用。
FastAPI 项目通用基础设施（shared_backend），包含 CORS、全局异常处理、请求日志、统一响应格式。当新建 FastAPI 后端模块或需要统一中间件时使用。
| name | site-inspector |
| description | 通过 Playwright 多浏览器并行巡检 AiOS 全站页面。每次运行前自动扫描 Vue Router 文件获取最新路由表，无需手工维护。截图、控制台与网络错误检测、白屏与模拟数据识别、安全交互探索，生成 JSON 报告供 AI agent 消费。当用户提到"全站巡检""检查所有页面""系统体检""全面检查""巡检报告"时使用。 |
用 Playwright 无头浏览器并行检查 AiOS 所有前端页面（含侧边栏），生成 JSON 报告供 AI agent 消费。
路由表在每次运行前自动从各前端模块的 router/index.js|ts 扫描生成，新增或删除页面无需手工维护。
cd ~/.cursor/skills/全站巡检/scripts
# 全站检查（自动扫描路由）
PYTHONUNBUFFERED=1 python3 run.py
# 只查指定模块
python3 run.py -m 门户系统 -m 联系人
# 调整并行数（默认 4）
python3 run.py -w 6
# 列出自动扫描到的所有模块和页面数
python3 run.py --list-modules
报告输出到 reports/ 子目录，每次运行自动清理旧报告只保留最新一份。
route_scanner.py 在每次巡检前解析 /root/瑞小美AiOS/*/前端*/src/router/index.{js,ts}：
createWebHistory(base) 作为 URL 前缀children 嵌套路由，自动拼接父路径:id) / 创建编辑页 / 登录 OAuth / 404 通配route_scanner.py 中静态配置新增前端模块时，在 route_scanner.py 的 MODULE_SOURCES 中加一行映射即可。
| 检查项 | 级别 | 说明 |
|---|---|---|
| 白屏 | P0 | 页面无内容或极少可见元素 |
| 控制台 JS 错误 | P0 | 过滤了 Permissions-Policy、ResizeObserver 等环境噪音 |
| API 请求失败 | P0 | /api/ 路径的 4xx/5xx 响应 |
| 模拟数据残留 | P0 | 检测张三/李四/13800138000/placeholder/mock 等 |
| 空数据 + API 失败 | P0 | 空状态组件 + 后端返回错误 = 大概率 bug |
| 页面加载超时 | P0 | 超过 30s |
| 慢 API 请求 | P1 | API 响应超过 3s |
| 空数据（待确认） | P2 | 有表格但数据为空，非已知合理空页面 |
| 静态资源加载失败 | P2 | 非 API 的 4xx/5xx |
自动对每个页面执行安全交互，暴露更多子视图：
绝不点击：删除、禁用、确认、提交、审批、开关。
生成两类 JWT Token 覆盖全站：
is_super 超管权限，注入 scrm_token + scrm_usertype: sidebar_user 格式，注入 scrm_sidebar_token + scrm_userid + scrm_username两类 Token 同时注入所有域名的 localStorage，无需按模块区分。
全站巡检/
├── SKILL.md # 本文件
├── scripts/
│ ├── run.py # CLI 入口
│ ├── route_scanner.py # 路由自动扫描（解析 Vue Router 文件）
│ ├── config.py # 运行时常量（并行数、超时、选择器）
│ ├── auth.py # 生成管理后台 + 侧边栏两种 JWT
│ ├── engine.py # asyncio + 多 BrowserContext 并行
│ ├── checker.py # 单页面检查逻辑
│ ├── reporter.py # JSON 报告生成
│ └── requirements.txt # playwright
└── reports/ # 只保留最新一份
└── inspection_YYYYMMDD_HHMMSS/
├── report.json # 仅含有问题的页面，按 P0→P2 排序
└── screenshots/ # 截图 PNG
portal-backend 容器正在运行（生成 JWT 需要）首次安装：
pip3 install playwright
playwright install chromium
dnf install -y atk at-spi2-atk cups-libs libdrm mesa-libgbm libxkbcommon pango alsa-lib nss nspr libXcomposite libXdamage libXrandr libXtst libXfixes libXcursor libXScrnSaver libXi gtk3
:id）和写入页面（create/edit）自动跳过route_scanner.py 的 MODULE_SOURCES 加一行