# Skyeye Use

> 用于处理 SkyEye/天眼/网神分析平台相关任务，支持通过API或者结合浏览器进行操作。只要用户提到 SkyEye、天眼、网神分析平台的相关操作时，必须先加载本 skill。本 skill 是 天眼 平台操作的唯一决策入口：在未阅读本 skill 并完成模式判断前，不要直接调用任何 `skyeye_*` tool。

- Skill: `agentflocks/skyeye-use` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add agentflocks/skyeye-use`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentflocks/skyeye-use/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: agentflocks (https://skillmd.com/u/agentflocks)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/agentflocks/skyeye-use

---


# SkyEye Use

## First

操作模式 API V.S Browser

### 何时使用API
- 默认模式，默认使用API
- !!! important: 如果已经进入了浏览器模式，就不要走 API 了

### 何时使用浏览器
- 现有 API 没有覆盖目标能力
- 未检测到对应 API 工具
- API 当前不可用，例如未配置、未开通、无权限、认证失败或服务不可达
- 任务必须查看页面级详情、导出、下载或使用复杂交互
- 页面需要人工登录、验证码、多因子认证或页面级确认
- 用户要求使用浏览器，或者已经在浏览器操作过程中

### 请求确认
除非是用户要求使用浏览器，否则提示用户API不可用，请检查API配置或直接使用浏览器模式。

当确定操作模式后：
- API模式：请阅读API模式使用指南
- 浏览器模式：请阅读浏览器模式使用指南

## API模式使用指南

- 时间字段硬规则：凡是本次 API 调用涉及 `start_time` / `end_time` 等时间字段，必须先在 bash 中执行 `uv run python` 动态计算，再调用对应 tool；禁止手动估算、禁止硬编码、禁止把“今天”“最近 7 天”“告警当天”这类自然语言时间直接脑补成数字。
- SkyEye 的时间入参默认按 Unix 毫秒级时间戳处理；即使只是下载报告、PCAP 或样本，也必须先用 `uv run python` 算出准确的毫秒级时间窗口后再传参。
- 用户说“告警列表”“最近告警”“按威胁级别筛选告警”时，优先走 `skyeye_alarm_list`
- 用户说“告警字段有哪些”“攻击阶段有哪些”“需要枚举值”时，优先走 `skyeye_alarm_params`
- 用户说“看板”“概览”“趋势”“整体视图”“系统状态”时，优先走 `skyeye_dashboard_view`
- 用户说“导出告警报告”“下载 PDF/DOCX 报告”时，优先走 `skyeye_download_alarm_report`
- 用户说“下载 PCAP”时，优先走 `skyeye_download_pcap`
- 用户说“下载样本”“下载上传文件”“取告警关联文件”时，优先走 `skyeye_download_uploadfile`

必须阅读：
API 参数和适用场景见 [references/api-reference.md](references/api-reference.md)。

## 浏览器模式使用指南

- ⚠️ 如果 SkyEye 域名不清楚，请先询问用户，不要擅自填写域名。
- 打开 SkyEye 页面或执行 CLI 前，先按登录态流程处理，不要一开始就要求用户提供账密。
- 如果用户给的是完整登录页 URL，自动登录时保留其中的路径，例如 `/skyeye/home/login`，不要退回默认 `/login`。
- SkyEye 自动登录使用图片验证码，脚本会优先从登录页验证码图片元素动态获取图片并用 OCR 库识别。
- 当没有可用登录态时，引导用户选择：提供账密自动登录并保存，或不提供账密走手动登录；不再提供临时账密选项。

只要进入浏览器模式，就请阅读并按照 browser-workflow 操作。

请严格按照以下文档执行：
- [references/browser-workflow.md](references/browser-workflow.md)