cua-s1-forms

cua-s1-forms

为 GUI 表单的每个元素给出可能动作的评分，例如填写、勾选、点击或跳过，并返回每个选项的概率。这是一个很小的模型，适合开发表单填写智能体的开发者。

由 cua-ai 在 Hugging Face 上制作。这些说明是 Mindket 根据它的模型页面和模型卡写的，模型自己的文件和许可证在 Hugging Face 上。

简介

它是什么：cua-s1-forms 是一个极小的模型，只有 706,048 个参数，用来填写屏幕上的表单。它不生成文字。你把一个表单元素和可选的选项交给它，它同时给出每个选项的可能性。它属于 cua-ai 的 Cua-S1 研究系列。

适合谁：适合开发根据文档填写表单的智能体的开发者，以及研究小型模型如何选择界面动作的研究者。

Industry | Who uses it | How they use it | Example
软件开发 | 构建电脑操作智能体的开发者 | 给表单上的每个字段评分，选出对应的动作 | 判断电话字段应该填写、跳过还是点击
研究 | 研究小型动作模型的研究者 | 研究一个很小的模型如何给表单字段的选项排序 | 用 706,048 个参数的模型测试表单检查
后台自动化 | 把文档数据录入表单的团队 | 把模型和负责填写、提交的代码配合使用 | 根据一份扫描文档填写登记表

如果你需要能写作或聊天的模型，可以跳过它，因为它只给选项打分。

用在哪里：它通过 cua-s1 包在 Python 里运行，文件可以在 Windows、macOS 或 Linux 上下载。

• Python：加载检查点的地方
• cua-s1 包：提供加载器和设备辅助函数
• Cua Driver 会话：规划循环发送动作的地方

Use case | Who | What they get back
表单字段评分 | 智能体开发者 | 每个选项对应一个概率
动作选择 | 自动化开发者 | 得分最高、待执行的选项
小模型研究 | 研究者 | 一个紧凑、可检查和测试的检查点

如何设置：你需要 Python、cua-s1 包和两个 safetensors 文件。只加载这一对 safetensors 文件。旧的 pickle 检查点已被删除，模型卡警告说，反序列化 pickle 检查点可能运行任意代码。

• 带 pip 的 Python
• 从 Cua 项目的代码副本安装的 cua-s1 包
• 两个文件，一个 safetensors 文件和一个 json 文件

1. 安装 huggingface_hub。
2. 获取 Cua 项目的代码，并从中安装 cua-s1。
3. 只下载这两个文件，不要下载任何 pickle 副本。
4. 用 cua-s1 的加载器加载检查点。

pip install -U huggingface_hub
hf download cua-ai/cua-s1-forms

模型卡在代码副本里这样安装这个包：

uv sync --project libs/cua-s1/python

如何使用：下载这两个文件，再用加载器加载。加载器会在返回模型之前检查格式、版本和签名。

from pathlib import Path
from huggingface_hub import snapshot_download
from cua_s1.model import load_checkpoint, select_device

root = Path(snapshot_download(
    "cua-ai/cua-s1-forms",
    allow_patterns=["cua-s1-forms.safetensors", "cua-s1-forms.json"],
))
model, collator, config = load_checkpoint(root / "cua-s1-forms.safetensors", select_device("auto"))

使用命令行时，如果你固定了较旧的版本，请排除 pickle 文件：

hf download cua-ai/cua-s1-forms --exclude "*.pt" --local-dir ./cua-s1-forms

Tool | What it does
snapshot_download | 只下载模型需要的两个文件
load_checkpoint | 检查格式和签名后加载模型
select_device | 选择运行所用的设备
hf download | 从命令行下载，并排除 pickle 文件

示例：对于登记表上的电话号码字段，你传入表单上下文和这些选项：用文档里的电话号码填写、勾选、点击、跳过。模型为每个选项返回一个概率，执行器取最高的那个。

新手与专家：如果你刚接触这类模型，可以把它看作一个排序器。它看到一个表单字段和一小串选择，并说出每个选择的可能性。先下载这两个文件，再用 Python 代码片段加载。

如果你熟悉这个领域，它是一个字节级模型，带 2 层 Transformer 编码器，宽度 128，4 个头。每个选项通过注意力头去查询上下文，然后 softmax 在仍有效的选项之间分配概率。模型卡说它在 10,000 个合成回合上训练，动作的顺序由模型之外的代码决定。

表单上下文和选项输入
模型给每个选项打分
执行器选出得分最高的
Cua Driver 设置值或点击

注意事项：模型卡说这个检查点不是 cua-s1-form-v0 研究配置的正式对应版本。jev-use 选择器不会加载它。

• License: MIT
• Cost to run: 未提及
• Data it reaches: 你传入的表单元素和文档，使用规划循环时还包括实时的 Cua Driver 会话
• Not for: 生成文字，或加载模型的 pickle 副本，模型卡说要避免这样做

Hugging Face 上的数据（2026年11月13日）

• 任务：other
• 框架：cua-s1
• Formats: Safetensors
• 最近 30 天下载：0
• 点赞：119
• 许可证：mit
• 语言：en
• Quantized versions: 2
• 标签：cua-s1, computer-use, form-filling, option-attention, system-one, safetensors, other

链接

• 模型：https://huggingface.co/cua-ai/cua-s1-forms
• 文件：https://huggingface.co/cua-ai/cua-s1-forms/tree/main

获取模型

用 Hugging Face 的命令行下载它的文件：

pip install -U huggingface_hub
hf download cua-ai/cua-s1-forms

然后按它的模型卡使用它。这个工具包里没有会自己运行的东西。