# selfTyping

**Repository Path**: masaikk/self-typing

## Basic Information

- **Project Name**: selfTyping
- **Description**: 口袋打字软件及其后端
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-02-27
- **Last Updated**: 2025-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 莫斯码输入工具

这是一个功能丰富的莫斯码输入工具，允许用户通过莫斯码（点和杠）输入文本，并将其上传到服务器。

## 功能特性

- **莫斯码转换**：将莫斯码序列转换为英文字母和符号
- **实时监听**：支持键盘实时输入莫斯码
- **自动转换**：输入后等待1秒自动将莫斯码转换为字符
- **特殊命令**：
  - 使用六个连续杠 `------` 上传当前内容到服务器
- **日语支持**：可选启用日语平假名转换功能
- **服务器交互**：将输入的文本上传到服务器并获取统计信息

## 安装

1. 克隆此仓库：
   ```
   git clone https://github.com/yourusername/morse-input-tool.git
   cd morse-input-tool
   ```

2. 安装依赖：
   ```
   pip install -r requirements.txt
   ```

## 使用方法

### 启动服务器

在一个终端中启动服务器：

```
python server/index.py
```

服务器默认运行在 http://localhost:8000

### 基本使用示例

运行基本示例：

```
python client/morse_example.py
```

### 实时输入模式

运行实时莫斯码输入模式：

```
python client/realtime_morse.py
```

在实时模式中：
- 按 `.` 输入点
- 按 `-` 输入杠
- 按 `空格键` 输入空格
- 输入 `------` (六个杠) 上传当前内容
- 按 `q` 退出程序

## 配置选项

在创建 `TypingTracker` 实例时可以自定义多个参数：

```python
tracker = TypingTracker(
    service=my_service,  # 自定义服务实例
    dot=".",             # 自定义点符号
    dash="-",            # 自定义杠符号
    upload_key="------", # 自定义上传键
    is_japanese=False    # 是否启用日语模式
)
```

## 日语模式

启用日语模式可以将英文字母组合转换为日语平假名：

```python
tracker = TypingTracker(is_japanese=True)
```

日语模式支持以下功能：
- 基本假名转换：如 "KA" → "か", "NN" → "ん"
- 促音(双辅音)支持：如 "KKA" → "っか", "TTA" → "った"
- 小假名支持：如 "LA"/"XA" → "ぁ", "LTSU"/"XTSU" → "っ" 

## 莫斯码参考

莫斯码参考表可通过以下方式获取：

```python
reference = tracker.get_morse_reference()
print(reference)
```

## 统计信息

获取当前服务器上的文本统计信息：

```python
stats = service.get_formatted_statistics()
print(stats)
```

## 注意事项

- 确保服务器在使用客户端前已启动
- 输入莫斯码后等待1秒将自动转换为对应字符
- 使用上传键后会清空当前缓冲区

## 高级用法

详见 `client/selftyping.py` 文件中的 `TypingTracker` 类，可以根据需要扩展更多功能。