# AgentRun Desktop SDK

Desktop SDK for AgentRun sandbox —提供鼠标/键盘/截图/文件/命令自动化功能。

## 安装

```bash
pip install agentrun-desktop-sdk
```

## 功能

-鼠标控制（移动、点击、滚动、拖拽）
- 键盘控制（按键、输入文本、快捷键）
- 截图功能
- 文件操作
- 命令执行
- 应用程序控制

## 使用示例

```python
from desktop_sdk import DesktopSandbox

# 创建沙箱实例
sandbox = DesktopSandbox()

# 鼠标操作
sandbox.mouse_move(100, 200)
sandbox.mouse_left_click()

# 键盘操作
sandbox.keyboard_write("Hello World")
sandbox.keyboard_press("enter")

# 截图
screenshot = sandbox.screenshot()
```

## 开发

### 安装开发依赖

```bash
make dev
# 或
pip install -e ".[dev]"
```

### 构建分发包

```bash
make build
# 或
python -m build
```

### 发布到 PyPI

```bash
make publish
# 或
twine upload dist/*
```

>注意：发布前需要配置 PyPI 凭据，可以通过环境变量 `TWINE_USERNAME` 和 `TWINE_PASSWORD` 或 `~/.pypirc` 文件配置。

### 清理构建文件

```bash
make clean
```

### 可用命令

| 命令 | 说明 |
|------|------|
| `make help` | 显示帮助信息 |
| `make install` | 安装依赖 |
| `make dev` | 以开发模式安装 |
| `make build` | 构建分发包 |
| `make publish` | 发布到 PyPI |
| `make test` | 运行测试 |
| `make clean` | 清理构建文件 |

## 依赖

- Python >= 3.10
- httpx >= 0.24.0
- agentrun-sdk >= 0.0.9

## 许可证

MIT License
