# snap灵犀输入法

**Repository Path**: gzcloud/snap

## Basic Information

- **Project Name**: snap灵犀输入法
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-07
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Snap (秒回) 输入法

一款基于 Rust 核心、支持 AI 自动回复和上下文感知的跨平台输入法。

## 特性

- ✨ **AI 自动回复**: 基于上下文智能生成回复建议
- 🚀 **极致性能**: Rust 核心保证毫秒级响应
- 🔒 **隐私保护**: 本地脱敏处理，可选云端 AI
- 📱 **跨平台**: Android、iOS、Windows (规划中)

## 架构

```
Snap 输入法
├── Core (Rust)          # 核心逻辑层
│   ├── 输入引擎         # 拼音处理、候选词生成
│   ├── AI 引擎          # LLM 调用、流式输出
│   ├── 上下文分析       # 场景识别、智能建议
│   └── 隐私脱敏         # PII 检测与移除
│
├── Android (Kotlin)     # Android 客户端
│   ├── InputMethodService
│   ├── AccessibilityService
│   └── Jetpack Compose UI
│
└── iOS (Swift)          # iOS 客户端
    ├── UIInputViewController
    └── SwiftUI
```

## 快速开始

### 环境要求

- Rust 1.75+
- Android Studio (Android 开发)
- Xcode 15+ (iOS 开发)
- Android NDK 26+

### 构建 Rust Core

```bash
# 运行单元测试
cd core
cargo test

# 构建库
cargo build --release
```

### CLI 调试工具

```bash
# 运行命令行模拟器
cd cli_debug
cargo run

# 示例交互
> nihao
当前输入: nihao
候选词: [你好 (ni hao)]
> <space>
✓ 上屏: 你好
```

### Android 构建

```bash
cd android
./gradlew assembleDebug
```

### iOS 构建

```bash
cd ios
xcodebuild -project SnapKeyboard.xcodeproj -scheme SnapKeyboard
```

## 开发指南

### 核心原则

1. **逻辑中心化**: 所有业务逻辑必须在 Rust Core 实现
2. **UI 哑终端**: 客户端仅负责渲染和事件转发
3. **性能优先**: 主线程无阻塞，内存精细管理
4. **安全第一**: FFI 边界严格错误处理，禁止 panic

### 调试策略

1. **Level 1**: Rust 单元测试 (`cargo test`)
2. **Level 2**: CLI 模拟器 (`cargo run --bin snap-cli`)
3. **Level 3**: 真机日志 (Android Logcat / iOS Console)
4. **Level 4**: 崩溃捕获 (Panic catching)

### 目录结构

```
/snap
├── /core                # Rust 核心库
│   ├── /src
│   │   ├── lib.rs      # 库入口
│   │   ├── api.udl     # UniFFI 接口定义
│   │   ├── engine.rs   # 输入引擎
│   │   └── error.rs    # 错误定义
│   ├── Cargo.toml
│   └── build.rs
│
├── /cli_debug           # CLI 调试工具
│   └── /src/main.rs
│
├── /android             # Android 项目
├── /ios                 # iOS 项目
└── /docs                # 文档
```

## 技术栈

- **Core**: Rust + UniFFI + Tokio + Reqwest
- **Android**: Kotlin + Jetpack Compose
- **iOS**: Swift + SwiftUI

## 文档

- [框架选型](docs/框架选型.md)
- [项目规划](docs/项目规划.md)
- [开发规则](.windsurf/rules/rule.md)

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！