FST ITN-ZH保姆级教程：生产环境部署指南

FST ITN-ZH保姆级教程：生产环境部署指南

1. 简介与背景

中文逆文本标准化（Inverse Text Normalization, ITN）是语音识别、自然语言处理和智能对话系统中的关键预处理环节。其核心任务是将口语化或非标准表达的中文文本转换为规范化的书面格式，例如将“一百二十三”转为“123”，或将“早上八点半”转为“8:30a.m.”。

FST ITN-ZH 是基于有限状态转导器（Finite State Transducer, FST）架构实现的高性能中文ITN工具，具备高准确率、低延迟和可扩展性强等优势。本文介绍的是由开发者“科哥”进行WebUI二次开发后的FST ITN-ZH 生产环境部署方案，适用于企业级服务集成、自动化文本处理流水线等实际应用场景。

本教程将从环境准备、服务启动、功能验证到运维建议，提供一套完整可落地的部署实践路径。

2. 部署前准备

2.1 硬件与系统要求

注意：该服务对计算资源需求较低，适合在边缘设备或轻量云服务器上运行。

2.2 软件依赖

• Docker（推荐方式）或 Python 3.8+
• Git
• bash shell 环境
• curl/wget工具（用于测试）

若使用容器化部署，建议提前安装 Docker 和 Docker Compose：

sudo apt update && sudo apt install -y docker.io docker-compose sudo systemctl enable docker --now

3. 部署流程详解

3.1 获取项目代码

通过 Git 克隆包含 WebUI 的二次开发版本：

git clone https://github.com/kege/fst-itn-zh-webui.git cd fst-itn-zh-webui

注：该项目为社区维护版本，原始 FST ITN-ZH 核心逻辑保持不变，仅增加可视化界面和批量处理能力。

3.2 启动服务（Docker 方式）

项目根目录下已提供docker-compose.yml文件，一键启动服务：

docker-compose up -d

构建完成后，服务将在后台运行，并映射端口7860。

查看容器状态

docker ps | grep itn

预期输出：

CONTAINER ID IMAGE COMMAND PORTS NAMES abc123def456 itn-webui "python app.py" 0.0.0.0:7860->7860/tcp fst-itn-zh-webui

3.3 手动启动脚本说明

如未使用 Docker，可通过内置脚本直接运行：

/bin/bash /root/run.sh

该脚本通常包含以下操作：

#!/bin/bash cd /root/fst-itn-zh-webui source venv/bin/activate python app.py --host 0.0.0.0 --port 7860

确保 Python 虚拟环境已正确配置并安装所需依赖（见requirements.txt）。

4. 功能模块解析与使用

4.1 WebUI 界面概览

访问http://<服务器IP>:7860即可进入主界面，整体布局如下：

┌─────────────────────────────────────────┐ │ [紫蓝渐变] 中文逆文本标准化 (ITN) │ │ webUI二次开发 by 科哥 │ ├─────────────────────────────────────────┤ │ [📝 文本转换] [📦 批量转换] │ │ │ │ ┌───────────┐ ┌───────────┐ │ │ │ 输入框 │ → │ 输出框 │ │ │ │ │ │ │ │ │ └───────────┘ └───────────┘ │ │ │ │ [开始转换] [清空] [复制] [保存] │ ├─────────────────────────────────────────┤ │ 🎯 快速示例 │ │ [日期] [时间] [数字] [货币] ... │ └─────────────────────────────────────────┘

4.2 功能一：单条文本转换

使用步骤

1. 访问http://<IP>:7860
2. 切换至「📝 文本转换」标签页
3. 在输入框中填写待转换文本
4. 点击「开始转换」按钮
5. 查看输出结果

示例演示

输入: 二零零八年八月八日早上八点半 输出: 2008年08月08日 8:30a.m.

支持多种语义类型的联合识别与转换，无需手动指定类别。

4.3 功能二：批量文件转换

对于大批量数据处理场景（如日志清洗、ASR后处理），推荐使用「📦 批量转换」功能。

操作流程

1. 准备.txt文件，每行一条原始文本二零零八年八月八日 一百二十三 早上八点半 一点二五元
2. 点击「上传文件」选择文件
3. 点击「批量转换」触发处理
4. 完成后点击「下载结果」获取标准化文本

输出文件命名规则

生成文件名为itn_output_YYYYMMDD_HHMMSS.txt，带时间戳便于归档管理。

4.4 高级参数配置

点击「高级设置」可调整以下三个关键开关：

这些选项可根据业务需求灵活调节，避免过度标准化导致语义失真。

5. 支持的标准化类型一览

5.1 基础类型支持

5.2 特殊字符兼容性

• 支持简体数字：一、二、三
• 支持大写数字：壹、贰、叁
• 支持口语变体：幺（一）、两（二）

例如：

输入: 贰万两千零贰拾元整 输出: ¥22020

6. 实际应用技巧与最佳实践

6.1 长文本多类型混合处理

系统支持在同一段文本中识别并转换多个实体类型：

输入: 这件事发生在二零一九年九月十二日的晚上，大概八点半左右，涉及金额为一万二千元。 输出: 这件事发生在2019年09月12日的晚上，大概8:30左右，涉及金额为12000元。

此特性特别适用于 ASR 输出纠错、客服对话记录结构化等场景。

6.2 批量处理性能优化建议

当处理超过 10,000 行文本时，建议采取以下措施提升效率：

1. 分片上传：每次上传不超过 5000 行，防止内存溢出
2. 异步调用 API（进阶）：bash curl -X POST http://localhost:7860/api/itn \ -H "Content-Type: application/json" \ -d '{"text": "二零二四年一月一日"}'
3. 定时任务整合：结合cron实现每日自动处理新数据

6.3 结果持久化与审计

点击「保存到文件」后，结果会存储在服务器本地路径（默认/data/output/），命名格式为：

itn_output_20250405_142310.txt

可用于后续审计、比对或导入数据库。

7. 常见问题与解决方案

7.1 Q&A 整理

7.2 日志排查方法

查看容器日志定位异常：

docker logs fst-itn-zh-webui

常见错误包括： - 端口冲突（Address already in use）→ 更换端口或终止占用进程 - 缺失依赖 → 运行pip install -r requirements.txt- 权限不足 → 使用sudo或调整目录权限

8. 总结

FST ITN-ZH 结合科哥开发的 WebUI 界面，显著降低了中文逆文本标准化技术的使用门槛，尤其适合非技术人员快速上手。本文详细介绍了其在生产环境中的部署流程、核心功能使用、高级配置及运维建议。

通过 Docker 化部署 + 批量处理能力 + 多类型联合识别，该方案已在多个语音识别、智能客服和文档自动化项目中成功落地，展现出良好的稳定性与实用性。

未来可进一步拓展方向包括： - 集成 RESTful API 接口供其他系统调用 - 支持更多方言表达（如粤语数字） - 提供模型热更新机制以动态升级规则库

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。