---
title: "window"
description: "控制当前窗口的标题、最小化、最大化和关闭状态。"
---


> 控制当前窗口的标题、最小化、最大化和关闭状态。

## 模块边界

`window` 只操作当前应用窗口，不创建新窗口，也不提供尺寸、位置或置顶控制。
实现入口是 `frontend/src/api/window.ts`。

## 方法索引

|方法 | Windows | Android |
| --- | --- | --- |
| [setTitle](/docs/kasumi/api/window/set-title) |支持 |不支持，`NOT_SUPPORTED` |
| [minimize](/docs/kasumi/api/window/minimize) |支持 |不支持，`NOT_SUPPORTED` |
| [maximize](/docs/kasumi/api/window/maximize) |支持 |不支持，`NOT_SUPPORTED` |
| [close](/docs/kasumi/api/window/close) |支持 |支持 |

`KSM.app.exit()` 也能结束应用，但语义是退出应用；`KSM.window.close()` 语义是关闭窗口。
桌面端实现可能使用相同的窗口关闭消息，调用侧仍应按业务语义选择。

## 平台检测

不要在业务代码中写 `if (platform === 'windows')` 后再决定是否调用。优先检查能力：

```ts
const { commands } = await KSM.capabilities();

if (commands.includes('window.minimize')) {
  await KSM.window.minimize();
}
```

Android 能力列表不包含标题、最小化和最大化命令。

## 相关

- [app](/docs/kasumi/api/app)
- [errors](/docs/kasumi/api/errors)