📁 在Claude AI中设置快脚本项目

# coding=utf-8
"""
kuai: 1.0
python_version:
    - 3.11.0
os:
    - Windows 11
packages:
    - Pillow
name: 脚本名称
description: 功能描述
input_description: 输入和加载的数据描述
output_description: 输出数据的描述
"""
import argparse
import json
from urllib.parse import quote, unquote
from PIL import Image


class Params:
    """
    说明: 启动参数（实例属性）
    """

    def __init__(self):
        """
        label: 单选示例
        input_method: Radio
        options:
            - 选项1
        description: 选择一个选项。。
        """
        self.radio_option: str = "选项1"

        """
        label: 开关示例
        input_method: ToggleSwitch
        description: 是否开启某项功能。
        """
        self.toggle_switch: bool = False

        """
        label: 多选示例
        input_method: Checkbox
        options:
            - 选项1
        min_select: 1
        max_select: 1
        description: 选择多个选项。
        """
        self.checkbox: [str] = []

        """
        label: 整数输入示例
        input_method: IntInput
        unit: 个
        max: 10
        min: -10
        description: 输入一个数字。
        """
        self.int_input: int = 0

        """
        label: 浮点数输入示例
        input_method: FloatInput
        unit: 摄氏度
        max: -10.00
        min: -100.00
        precision: 2
        说明: 输入一个数字。
        """
        self.float_input: float = 0.00

        """
        label: 单行文本输入示例
        input_method: SingleLineTextInput
        max_length: 100
        min_length: 10
        required: true
        validation: ^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+$
        validation_message: 请输入有效的电子邮件地址
        description: 输入电子邮件地址。
        """
        self.single_line_text_input: str = ""

        """
        label: 多行文本输入示例
        input_method: MultiLineTextInput
        max_length: 100
        min_length: 10
        required: true
        description: 输入文本。
        """
        self.multi_line_text_input: str = ""

        """
        label: 单文件选择示例
        input_method: SingleFilePicker
        file_types:
            - jpg
        description: 上传多个文件。
        """
        self.single_file_picker: str = ""

        """
        label: 多文件选择示例
        input_method: MultiFilePicker
        file_types:
            - jpg
        min_files: 1
        max_files: 5
        description: 上传多个文件。
        """
        self.multi_file_picker: [str] = []

        """
        label: 单目录选择示例
        input_method: SingleDirectoryPicker
        description: 选择一个目录。
        """
        self.single_directory_picker: str = ""

        """
        label: 下拉选示例
        input_method: Dropdown
        options:
            - 选项1
        description: 选择一个选项。
        """
        self.dropdown: str = "选项1"

        """
        label: 日期选择示例
        input_method: DatePicker
        format: yyyy-MM-dd
        min: 2020-04-05
        max: 2024-04-05
        description: 选择一个日期。
        """
        self.date_picker: str = "2021-01-01"

        """
        label: 时间选择示例
        input_method: TimePicker
        format: HH:mm
        min: 01:00
        max: 23:00
        description: 选择一个特定的时间。
        """
        self.time_picker: str = "12:00"

        """
        label: 滑块选择示例
        input_method: Slider
        unit: 摄氏度
        max: 100
        min: -100
        precision: 0
        divisions: 200
        description: 滑块选择一个值。
        """
        self.range_slider: float = 0.0

        """
        label: 密码输入示例
        input_method: PasswordInput
        validation: ^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d]{8,}$
        validation_message: 密码至少8字符，包含字母和数字
        description: 输入密码。
        """
        self.password_input: str = ""

    def load(self, _params):
        for key, value in _params.items():
            if hasattr(self, key):
                setattr(self, key, value)


# 全局参数实例
params = Params()

def param():
    parser = argparse.ArgumentParser()
    parser.add_argument('json_string', type=str)
    args = parser.parse_args()
    if args.json_string is not None:
        decoded_json_string = unquote(args.json_string)
        params.load(json.loads(decoded_json_string))

if __name__ == "__main__":
    param()

这上面是kuai格式的python脚本的例子，遵循kuai格式的脚本能被kuai客户端解析，会解析成用户友好的启动界面。
所有文本注释都是yaml格式。
启动界面参数必须定义为__init__方法中的实例属性，不能定义为class属性，否则不解析。
启动界面参数必须严格从下面的列举的9中启动参数中选择，不能写其他类型，否则会解析失败。
用户会通过解析后的界面来启动脚本，所以启动参数要合理，友好。
packages是需要安装的第三方库名。
label尽可能的简单和明确，且所有的label长度尽量保持相同。

启动参数可选类型：
Radio
ToggleSwitch
Checkbox
IntInput
FloatInput
SingleLineTextInput
MultiLineTextInput
SingleFilePicker
MultiFilePicker
SingleDirectoryPicker
Dropdown
DatePicker
TimePicker
Slider
PasswordInput