【soar-w5学习和使用】

一.docker部署

1.下载w5代码,地址https://github.com/w5teams/w5

2.进入w5目录下面,执行

复制代码
cp -r apps docker && cp config.ini docker && docker-compose up -d

3.初始化成功

访问地址:http://ip:8888/ 账号:admin 密码:12345678

二.app开发

app整体概括

python 复制代码
├── helloworld       # APP 目录名
│   ├── app.json    # APP 配置文件
│   ├── icon.png    # APP 图标
│   ├── main       # APP 代码
|   |   └── run.py  # APP 入口文件
│   └── readme.md   # APP 说明文件

1.配置文件

  • app.json配置文件在https://w5.io/help/dev/dev2.html

  • 需要注意函数名字需要一致,参数顺序一致,当修改完函数不成效时,注意强制刷新或者重启w5

  • app配置文件,action里面放相应动作绑定的函数,可以多个动作,每个动作对应一个函数

python 复制代码
{
  "identification": "w5soar",               // w5soar 签名,无需更改,必须存在
  "is_public": true,                        // 是否为公开 APP,设置 false 为私有 APP
  "name": "Hello World",                     // APP 名称
  "version": "0.1",                         // APP 版本
  "description": "W5 SOAR - Hello World",    // APP 描述
  "type": "基本应用",                        // APP 分类
  "action": [                               // APP 动作列表
    {
      "name": "HelloWorld",                  // APP 动作名称
      "func": "hello_world"                  // 动作对应的函数名
    },
    {
      "name": "test",                      // APP 动作名称
      "func": "app_test"                   // 动作对应的函数名
    }
  ],
  "args": {                                 // 动作参数
    "hello_world": [                         // 动作对应的函数名
      {
        "key": "name",                      // 动作参数名
        "type": "text",                     // 动作参数类型
        "required": true                    // 是否是必填项
      }
    ],
    "app_test": [                           // 动作对应的函数名
      {
        "key": "name",                      // 动作参数名
        "type": "text",                     // 动作参数类型
        "required": true                    // 是否是必填项
      },
      {
        "key": "sex",                       // 动作参数名
        "type": "text",                     // 动作参数类型
        "required": true                    // 是否是必填项
      }
    ],
  }
}

参数支持5种类型

复制代码
类型      说明
text    文本输入框
password        密码输入框
textarea        多行文本输入框
number  数字输入框
select  下拉选择框

参数支持默认,是否必填

python 复制代码
"args": {                                 // 动作参数
    "app_demo": [                           // 动作对应的函数名
      {
        "key": "name",                      // 动作参数名
        "type": "text",                     // 动作参数类型
        "default": "W5",                    // 参数默认值,不写默认为空
        "required": true                    // 是否是必填项
      },
      {
        "key": "age",                       // 动作参数名
        "type": "number",                   // 动作参数类型
        "default": 18,                      // 参数默认值,不写默认为空
        "required": true                    // 是否是必填项
      },
      {
        "key": "desc",                      // 动作参数名
        "type": "textarea",                 // 动作参数类型
        "required": true                    // 是否是必填项
      },
      {
        "key": "type",                      // 动作参数名
        "type": "select",                   // 动作参数类型
        "default": "test",                  // 参数默认值,不写默认不选择
        "data": [                           // 下拉列表
          "test",
          "test2",
          "test3",
          "test4"
        ],
        "required": true                    // 是否是必填项
      }
    ]
}

2.app图标

图标名称 icon.png 不可改变

图标大小 200 x 200

3.app代码run.py

  • run.py主要写函数逻辑,注意传入参数必须和配置文件里面的参数一致
python 复制代码
#!/usr/bin/env python
 encoding:utf-8
import json
from loguru import logger

async def hello_world(name):
    logger.info("[Hello World] APP 执行参数为: {name}", name=name)
    try:
        a = json.loads(name)
    except Exception as e:
        a = name
    return {"status": 0, "result":a }

async def app_test(name,sex):
    logger.info("[Hello World] APP 执行参数为: {name},{sex}", name=name,sex=sex)

    return {"status": 0, "result":name+sex}

4.readme.md说明文件

按照参数和类型写就好

5.w5的开发规范 请看https://w5.io/help/dev/dev5.html

三.使用app

  • 每个app都会有个uuid
  • 不同的动作对应配置文件设置的函数
  • result是获取每个app结果的参数

1. 获取上一个app的结果@(对应app的uuid.result)

  1. 获取上一个app的参数结果@(对应app的参数字段名.result)

3.获取app结果是json数据,json数据里面某个键的内容@(对应app的uuid.result!>键字段)

一些其他json的使用方法https://w5.io/help/use/use7.html

四.for 的使用

for介绍https://w5.io/help/use/use9.html

1.类型可选字典,数组,次数
循环数据放需要循环的内容,注意格式需要和类型一致

2.下个app使用方法

数组变量:@(uuid.value)

字典变量:@(uuid.key) @(uuid.value)

数字变量:@(uuid.value)

五.if 的使用

if的介绍https://w5.io/help/use/use2.html

没学会,有学会的可以教教我

相关推荐
Python×CATIA工业智造10 分钟前
Frida RPC高级应用:动态模拟执行Android so文件实战指南
开发语言·python·pycharm
onceco40 分钟前
领域LLM九讲——第5讲 为什么选择OpenManus而不是QwenAgent(附LLM免费api邀请码)
人工智能·python·深度学习·语言模型·自然语言处理·自动化
狐凄1 小时前
Python实例题:基于 Python 的简单聊天机器人
开发语言·python
悦悦子a啊2 小时前
Python之--基本知识
开发语言·前端·python
笑稀了的野生俊4 小时前
在服务器中下载 HuggingFace 模型:终极指南
linux·服务器·python·bash·gpu算力
Naiva4 小时前
【小技巧】Python+PyCharm IDE 配置解释器出错,环境配置不完整或不兼容。(小智AI、MCP、聚合数据、实时新闻查询、NBA赛事查询)
ide·python·pycharm
路来了5 小时前
Python小工具之PDF合并
开发语言·windows·python
蓝婷儿5 小时前
Python 机器学习核心入门与实战进阶 Day 3 - 决策树 & 随机森林模型实战
人工智能·python·机器学习
AntBlack5 小时前
拖了五个月 ,不当韭菜体验版算是正式发布了
前端·后端·python
.30-06Springfield5 小时前
决策树(Decision tree)算法详解(ID3、C4.5、CART)
人工智能·python·算法·决策树·机器学习