综述

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 路由器、契约生成器和契约测试入口

最小调用：

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，前端不得使用真实文件路径。