# 纯后端脚本
my-script/
├── main.py          # 主脚本（必须）
├── readme.md        # 使用说明（推荐）
└── data.csv         # 附带的数据文件（可选）

# HTTP 服务脚本
my-web-app/
├── main.py          # 后端逻辑（必须）
├── index.html       # 前端页面（必须）
└── readme.md        # 使用说明（推荐）

import os, json

# ✅ 读取脚本附带的文件（CWD = 脚本目录）
with open('data.csv', encoding='utf-8') as f:
    data = f.read()

# ✅ 将输出写到运行目录
run_dir = os.environ['KUAI_RUN_DIR']
with open(os.path.join(run_dir, 'result.json'), 'w', encoding='utf-8') as f:
    json.dump(result, f, ensure_ascii=False)

# ❌ 不要假设系统编码（Windows 可能是 GBK）
# ❌ 不要使用 Flask/FastAPI（用内置 SDK）
# ❌ 不要将 HTML 内嵌到 Python 字符串中

from kuai import *


class MyScript(Script):
    name = "图片批量压缩"
    icon = "🖼️"
    description = "批量压缩指定目录下的所有图片"
    packages = ["Pillow", "requests"]
    os = ["Windows", "macOS"]
    python_version = ["3.11.0"]
    run_as_admin = True
    input_description = "包含图片的目录"
    output_description = "压缩后的图片"

class MyParams(Params):
    input_dir = SingleDirectoryPicker(
        label="输入目录",
        description="选择包含图片的文件夹。",
    )

    quality = Slider(
        label="压缩质量",
        default=80,
        min=1,
        max=100,
        unit="%",
        description="图片压缩质量，数值越高质量越好。",
    )

    output_format = Radio(
        label="输出格式",
        default="JPEG",
        options=["JPEG", "PNG", "WebP"],
        description="选择输出格式。",
    )

class MyParams(Params):
    mode = Radio(
        label="模式",
        options=["压缩", "裁剪"],
    )

    # 仅当 mode == "压缩" 时显示
    quality = Slider(
        label="压缩质量",
        default=80, min=1, max=100,
        visible_if=J("mode") == "压缩",
    )

    # 支持 AND / OR 组合
    advanced = ToggleSwitch(label="高级选项")
    threads = IntInput(
        label="线程数",
        default=4,
        visible_if=(J("mode") == "压缩") & (J("advanced") == True),
    )

params = MyParams()


def main():
    print(f"输入目录: {params.input_dir}")
    print(f"压缩质量: {params.quality}")
    print(f"输出格式: {params.output_format}")
    # 你的业务逻辑...
    print("✅ 处理完成！")


if __name__ == "__main__":
    kuai.run(main)

    output_format = Radio(
        label="输出格式",
        default="JPEG",
        options=["JPEG", "PNG", "WebP"],
        description="选择输出图片格式。",
    )

    language = Dropdown(
        label="语言",
        default="中文",
        options=["中文", "English", "日本語"],
    )

    features = Checkbox(
        label="功能选择",
        default=["压缩"],
        options=["压缩", "裁剪", "水印", "格式转换"],
        min_select=1,
        max_select=3,
    )

    overwrite = ToggleSwitch(
        label="覆盖原文件",
        default=False,
        description="是否覆盖原文件，关闭则输出到新目录。",
    )

    threads = IntInput(
        label="线程数",
        default=4,
        min=1,
        max=16,
        unit="个",
        description="并发线程数量。",
    )

    threshold = FloatInput(
        label="匹配阈值",
        default=0.85,
        min=0.0,
        max=1.0,
        precision=2,
    )

    quality = Slider(
        label="压缩质量",
        default=80,
        min=1,
        max=100,
        unit="%",
        precision=0,
        description="图片压缩质量，数值越高质量越好。",
    )

    keyword = SingleLineTextInput(
        label="搜索关键词",
        default="",
        max_length=100,
        description="输入搜索关键词。",
    )

    prompt = MultiLineTextInput(
        label="提示内容",
        default="",
        max_length=2000,
    )

    api_key = PasswordInput(
        label="API 密钥",
        validation="^[A-Za-z0-9]{32,}$",
        validation_message="密钥至少32个字符",
    )

    email = EmailInput(
        label="邮箱地址",
        description="用于接收通知。",
    )

    source = SingleFilePicker(
        label="源文件",
        file_types=["jpg", "png", "webp"],
        description="选择要处理的图片。",
    )

    excel_files = MultiFilePicker(
        label="Excel 文件",
        file_types=["xlsx", "csv"],
        min_files=1,
        max_files=10,
    )

    output_dir = SingleDirectoryPicker(
        label="输出目录",
        description="选择输出文件保存位置。",
    )

    start_date = DatePicker(
        label="开始日期",
        default="2024-01-01",
        format="yyyy-MM-dd",
    )

    schedule_time = TimePicker(
        label="提醒时间",
        default="09:00",
        format="HH:mm",
    )

    watermark_color = ColorPicker(
        label="水印颜色",
        default="#FF0000",
    )

from kuai import *


class WebApp(Script):
    name = "Web 应用示例"
    icon = "🌐"
    description = "带网页界面的示例脚本"


class MyParams(HttpParams):
    # HttpParams 自动包含 server_port 和 auto_open_browser
    # 只需定义你的自定义参数
    theme = Radio(
        label="主题",
        default="深色",
        options=["深色", "浅色"],
    )


params = MyParams()


class Handler(kuai.KuaiHandler):
    def do_GET(self):
        if self.path == '/':
            self.serve_index()
        elif self.path == '/api/data':
            self.json_response({"message": "Hello"})
        else:
            self.send_error(404)

    def do_POST(self):
        if self.path == '/api/submit':
            body = self.read_json()
            self.json_response({"received": body})
        else:
            self.send_error(404)


if __name__ == "__main__":
    kuai.run(lambda: kuai.serve(params, Handler))

<kuai-moniter/>   <!-- 必须：放在最前面 -->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>Web 应用示例</title>
</head>
<body>
    <h1>Hello KuaiScript</h1>
    <div id="result"></div>
    <script>
        fetch('/api/data')
            .then(r => r.json())
            .then(data => {
                document.getElementById('result')
                    .textContent = data.message;
            });
    </script>
</body>
</html>