qwenpaw-skills
109 lines
3.1 KiB
Markdown
109 lines
3.1 KiB
Markdown
# DataEase V2 全能技能
|
|
|
|
一站式 DataEase 自动化解决方案，融合图表部署与资源管理能力。
|
|
|
|
## 🎯 功能特性
|
|
|
|
| 功能 | 命令 | 说明 |
|
|
|------|------|------|
|
|
| 📊 数据探索 | `inspect_data.py` | 查询数据集、字段信息 |
|
|
| 📈 图表部署 | `deploy.py` | 创建图表并自动截图 |
|
|
| 📋 多图看板 | `multi_deploy.py` | 创建多图表仪表板 |
|
|
| 🏢 组织管理 | `capture_dashboard.py` | 查询/切换组织 |
|
|
| 📑 资源列表 | `capture_dashboard.py` | 列出仪表板/大屏 |
|
|
| 📸 截图导出 | `capture_dashboard.py` | 导出截图或PDF |
|
|
|
|
## 🚀 快速开始
|
|
|
|
### 1. 安装依赖
|
|
|
|
```bash
|
|
npm install
|
|
npx playwright install chromium
|
|
```
|
|
|
|
### 2. 配置环境
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
编辑 `.env` 文件：
|
|
|
|
```bash
|
|
DATAEASE_BASE_URL=https://your-dataease.example.com
|
|
DATAEASE_API_PREFIX=/de2api
|
|
DATAEASE_ACCESS_KEY=your_access_key
|
|
DATAEASE_SECRET_KEY=your_secret_key
|
|
DATAEASE_USERNAME=admin
|
|
DATAEASE_PASSWORD=your_password
|
|
DATAEASE_LOGIN_ORIGIN=0
|
|
```
|
|
|
|
**认证方式（二选一）：**
|
|
- AK/SK：配置 `ACCESS_KEY` + `SECRET_KEY`
|
|
- 密码登录：配置 `USERNAME` + `PASSWORD`
|
|
|
|
### 3. 使用示例
|
|
|
|
```bash
|
|
# 查询数据集
|
|
python3 scripts/inspect_data.py --list-datasets
|
|
|
|
# 查询字段
|
|
python3 scripts/inspect_data.py --dataset "销售数据"
|
|
|
|
# 创建图表（自动截图）
|
|
python3 scripts/deploy.py bar '各产品销售额' '销售数据' '产品' '实际销售'
|
|
|
|
# 创建多图表看板
|
|
python3 scripts/multi_deploy.py '销售分析' '[{"type":"bar","title":"销售","dataset_name":"销售数据","x_axis":["产品"],"y_axis":["销售额"]}]'
|
|
|
|
# 查询组织
|
|
python3 scripts/capture_dashboard.py list-orgs
|
|
|
|
# 导出截图
|
|
python3 scripts/capture_dashboard.py capture --resource-id <ID> --busi-type dashboard --output-dir ./output
|
|
|
|
# 导出 PDF
|
|
python3 scripts/capture_dashboard.py capture --resource-id <ID> --busi-type dashboard --result-format 1 --output-dir ./output
|
|
```
|
|
|
|
## 📁 目录结构
|
|
|
|
```
|
|
dataease-v2-chart-skill/
|
|
├── SKILL.md # 技能文档（Agent 读取）
|
|
├── README.md # 本文档
|
|
├── .env.example # 环境变量模板
|
|
├── package.json # Node 依赖
|
|
├── scripts/
|
|
│ ├── inspect_data.py # 数据探索
|
|
│ ├── deploy.py # 图表部署
|
|
│ ├── multi_deploy.py # 多图表部署
|
|
│ ├── engine.py # 图表引擎
|
|
│ ├── client.py # API 客户端
|
|
│ ├── capture_dashboard.py # 截图/资源管理
|
|
│ └── browser_capture.mjs # 浏览器截图
|
|
├── templates/ # 图表模板
|
|
├── references/ # API 参考
|
|
└── agents/ # Agent 配置
|
|
```
|
|
|
|
## 📊 支持的图表类型
|
|
|
|
- `bar` - 柱状图
|
|
- `line` - 折线图
|
|
- `pie` - 饼图
|
|
- `table_info` - 明细表
|
|
|
|
## 📸 截图参数
|
|
|
|
- `--pixel`: 分辨率，默认 `1920*1080`，可设 `2560*1440`
|
|
- `--ext-wait-time`: 额外等待秒数
|
|
- `--result-format`: `0`=JPEG, `1`=PDF
|
|
|
|
## 📝 许可证
|
|
|
|
MIT
|