---
title: "permission"
description: "请求宿主校验运行时权限，并返回当前是否可用。"
---


> 请求宿主校验运行时权限，并返回当前是否可用。

## 模块边界

`permission` 只处理主机运行时授权，不替代协议层的命令权限校验。即使前端没有主动
请求，宿主仍会在执行命令前检查权限。

实现入口是 `frontend/src/api/permission.ts`。

## 方法索引

|方法 |平台差异 |
| --- | --- |
| [request](/docs/kasumi/api/permission/request) | Windows 直接授予已注册权限；Android 按系统能力请求 |

## 已注册权限

|权限 |关联能力 |
| --- | --- |
| `fs.read` | `fs.readText`、`fs.exists` |
| `fs.write` | `fs.writeText` |
| `fs.remove` | `fs.remove` |
| `dialog` | `dialog.*` |
| `clipboard.read` | `clipboard.readText` |
| `clipboard.write` | `clipboard.writeText` |
| `notification.show` | `notification.show` |
| `window.control` | `window.*`、`app.exit` |

未知权限名返回 `INVALID_ARGS`。前端能力缓存不会在权限变化后自动失效。

Android 宿主等待运行时授权的上限是 60 秒，但前端请求默认 10 秒超时。用户停留时间
超过 10 秒时，Promise 先以 `TIMEOUT`拒绝；系统权限对话框可能仍在显示，宿主会抑制
迟到结果。

## 相关

- [capabilities](/docs/kasumi/api/core/capabilities)
- [errors](/docs/kasumi/api/errors)