# Qingteng Use

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

- Skill: `agentflocks/qingteng-use` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add agentflocks/qingteng-use`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentflocks/qingteng-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/qingteng-use

---


# Qingteng Use

## First

操作模式 API V.S Browser

### 何时使用API
- 默认模式，默认使用API
- !!! important: 如果已经进入了浏览器模式，就不要走 API 了
- 查询类和任务类动作要严格区分；用户没有明确要求执行任务时，默认只使用只读查询能力

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

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

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

## API 模式使用指南

- 时间字段硬规则：凡是本次 API 调用涉及 `time_range` / `begin_time` / `end_time` / `logTime` / `loginTime` / `createTime` / `time` 等时间字段，必须先在 bash 中执行 `uv run python` 动态计算，再调用对应 tool；禁止手动估算、禁止硬编码、禁止把“今天”“最近 7 天”等自然语言时间直接脑补成参数。
- 青藤查询类时间字段要按对应 schema 要求传值；`DateRange` 类型必须先用 `uv run python` 生成 `yyyy-MM-dd HH:mm:ss - yyyy-MM-dd HH:mm:ss` 格式字符串后再传入，不能手写。
- 用户说“主机资产”“进程”“账号”“端口”“网站”“数据库”“安装包”时，优先走 `qingteng_assets`
- 用户说“可疑操作”“暴力破解”“异常登录”“WebShell”“后门”“蜜罐”时，优先走 `qingteng_detect`
- 用户说“补丁”“风险”“弱密码”“风险文件”“漏洞扫描”“作业管理”时，优先走 `qingteng_risk`
- 用户说“合规基线”“基线检查”“授权”“基线任务”时，优先走 `qingteng_baseline`
- 用户说“系统审计”“谁改了配置”“谁执行了操作”时，优先走 `qingteng_system_audit`
- 用户只是想快速做风险体检时，可优先考虑 `qingteng_vul_check`

高风险写操作要特别谨慎，例如：
- 资产刷新、主机删除、业务组调整
- 暴力破解封停、规则增删改、扫描任务下发
- 漏洞/弱密码/风险扫描、作业管理、文件下载任务创建
- 基线任务创建、更新、执行、授权管理

必须阅读：
API使用说明见 [references/api-reference.md](references/api-reference.md)。

### 时间字段处理规范

- 青藤 API 返回结果里，凡是字段名包含 `time` / `Time`，且接口文档把该字段标注为 `Integer` / `int(10)` 并说明“时间戳，精确到秒”的，默认按 **Unix 秒级时间戳** 处理，例如 `logTime`、`loginTime`、`modifyTime`、`createTime`、`time`、`eventTime`。
- **不要**把这类数值直接当成自然语言时间去脑补转换；没有经过代码或工具校验时，默认保留原始整数值输出。
- 如果用户需要可读时间，必须通过代码或工具实际转换后再输出；输出时同时保留原始时间戳，并显式标注时区。若用户未指定时区，默认使用 `Asia/Shanghai (UTC+08:00)`。

## 浏览器模式使用指南

- ⚠️ 如果青藤访问地址不清楚，请先询问用户，不要擅自填写域名。
- ⚠️ 用 --headed 打开浏览器，人工完成登录或页面确认。

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

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