# new()

新建一个空项目。和 File > New 一样。

场景里有未保存的工作时，没有 `discard=True` 就会被拒绝。不会弹出保存询问。

### 签名
```python
api.new(discard=False) -> result
```

| 字段 | 含义 |
|---|---|
| `ok` | 成功时为 True。 |
| `error` | 失败代码。成功时为空。不含路径。 |
| `dirty` | 还有没保存的工作。 |

### 示例
```python
result = api.new(discard=True)
print(result.ok, result.error)
``