# tzpy

**Repository Path**: wapuboy/tzpy

## Basic Information

- **Project Name**: tzpy
- **Description**: 制作田字拼音格的rust项目，可根据输入的文本自动补充拼音，并可按照行隐藏拼音或汉字，还可以自定义汉字拼音。
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-13
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 汉字拼音格矩阵 (pinyingrid)

一个基于 Rust 语言开发的汉字拼音格矩阵生成器 Web 服务。

## 功能特性

- 支持汉字转拼音，包含多音字处理
- 基于 jieba-rs 分词和 CC-CEDICT 词典，提供准确的词组拼音
- 提供 RESTful API 接口
- 内置 Web 界面，方便直接使用
- 高性能，低延迟

## 构建步骤

### 前置条件

- Rust 1.60+（推荐使用最新稳定版）
- Cargo 包管理器

### 构建命令

1. 克隆项目

```bash
git clone https://gitee.com/wapuboy/tzpy.git
cd tzpy
```

2. 构建项目

```bash
# 开发环境构建
cargo build

# 生产环境构建（优化）
cargo build --release
```

## 使用方法

### 启动服务

```bash
# 开发环境运行
cargo run

# 生产环境运行
./target/release/pinyingrid

# 自定义监听地址和端口
cargo run -- --host 0.0.0.0 --port 8080
```

### API 接口

#### GET /hz2py

将汉字转换为拼音。

**参数：**
- `text`：要转换的汉字文本

**返回：**
- JSON 格式的拼音数据，包含每个汉字及其对应的拼音

**示例：**

```bash
curl "http://localhost:5555/hz2py?text=你好"
```

**响应：**

```json
[
  {"char": "你", "pinyin": "nǐ"},
  {"char": "好", "pinyin": "hǎo"}
]
```

### Web 界面

启动服务后，访问 `http://localhost:5555` 即可使用内置的 Web 界面。

## 项目结构

```
tzpy/
├── src/             # 源代码目录
│   ├── main.rs      # 主入口文件
│   └── phrase_data.rs # 词组数据
├── templates/       # 模板文件
│   └── index.html   # Web 界面
├── dict/            # 词典文件
│   └── cedict_ts.u8 # CC-CEDICT 词典
├── Cargo.toml       # 项目配置和依赖
├── Cargo.lock       # 依赖版本锁定
└── README.md        # 项目说明
```

## 依赖项

- `axum`：Web 框架
- `tokio`：异步运行时
- `serde`：序列化/反序列化
- `pinyin`：逐字拼音（兜底回退）
- `jieba-rs`：分词库（用于词组上下文）
- `clap`：命令行参数解析

## 性能特点

- 启动时预热词典，避免首次请求延迟
- 异步处理，支持并发请求
- 内存高效，词典数据结构优化

## 许可证

MIT License