---
title: "综述"
description: "Windows 与 Android 共用一套 Web 前端、分别运行在原生 WebView 宿主中的应用框架。"
---

Kasumi 用统一协议连接前端和原生能力。协议定义在 `protocol/`，前端通过 `KSM` 根入口调用，Windows 使用 C++/WebView2，Android 使用 Kotlin/WebView。

当前已具备：

- `ping`、`capabilities.query`、`app.getInfo`
- 虚拟路径下的 `fs.readText`、`fs.writeText`、`fs.exists`、`fs.remove`
- 前端 `KSM` 初始化、请求超时、取消、事件订阅和 WebView 重载恢复
- Windows / Android 路由器、契约生成器和契约测试入口

最小调用：

```ts
import { KSM, KSMWebMessageTransport, fs } from '@kasumi/bridge';

KSM.initialize(new KSMWebMessageTransport());
await KSM.ping();
await fs.writeText({ path: 'app://data/hello.txt', content: 'hello' });
```

新增命令时先更新 `protocol/commands.json` 和权限契约，再运行 `tools/codegen.py`，然后实现双端处理器、前端封装和契约测试。Android 禁止使用 `addJavascriptInterface`，前端不得使用真实文件路径。