Back to Details

fanfuaji

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Fanfuaji - Chinese Terminology Converter

Fanfuaji - 中文术语转换工具

Overview

概述

Convert Chinese terminology between simplified/traditional, regional variants (China/Taiwan/Hong Kong), and phonetic forms (Pinyin/Bopomofo) using the Fanhuaji API.
This skill includes 
scripts/fanfuaji.py
- a ready-to-use Python wrapper that handles all API complexity.
通过Fanhuaji API实现中文术语在繁简体、区域变体（大陆/台湾/香港）以及拼音/注音之间的转换。
本技能包含
scripts/fanfuaji.py
——一个开箱即用的Python封装脚本，可处理所有API相关的复杂操作。

When to Use

使用场景

Use this skill when:
  • User requests output in Traditional Chinese, Taiwan terminology, etc.
  • Converting between simplified ↔ traditional Chinese
  • Applying regional terminology (China, Taiwan, Hong Kong)
  • Converting to Pinyin or Bopomofo (Zhuyin)
  • Need custom replacement rules or term protection
在以下场景中使用本技能：
  • 用户要求输出繁体中文、台湾用语等内容
  • 进行简体↔繁体中文转换
  • 应用区域术语规范（大陆、台湾、香港）
  • 转换为拼音或注音
  • 需要自定义替换规则或术语保护

Important: Converter Selection

重要提示：转换工具选择

If user does NOT explicitly specify the conversion target (Taiwan/Hong Kong/China/Traditional/Simplified), you MUST ask first.
Use the 
question
tool to present single-choice options:
Which converter would you like to use?
Common options:
Select appropriate converters based on context. See "Quick Reference: Available Converters" below for the complete list and order.
Most frequently used:
  • 台灣化 (Taiwan) - Traditional Chinese with Taiwan terminology
  • 繁體化 (Traditional) - Traditional Chinese only
  • 简体化 (Simplified) - Simplified Chinese only
  • 中国化 (China) - Simplified Chinese with China terminology
  • 香港化 (Hongkong) - Traditional Chinese with Hong Kong terminology
Additional options (if relevant to context):
  • 注音化 (Bopomofo) - Convert to Bopomofo (Zhuyin)
  • 拼音化 (Pinyin) - Convert to Pinyin romanization
  • See complete list in "Quick Reference" section below
Examples of ambiguous requests:
  • ❌ "轉換成繁體" → Ask: Traditional or Taiwan? Hong Kong?
  • ❌ "使用繁體中文" → Ask: Which region?
  • ❌ "確保都是繁體" → Ask: Traditional only or Taiwan/Hong Kong variant?
  • ✅ "使用台灣用語" → Clear: Use Taiwan converter
  • ✅ "轉成香港繁體" → Clear: Use Hongkong converter
如果用户未明确指定转换目标（台湾/香港/大陆/繁体/简体），必须先询问用户。
使用
question
工具提供单选选项：
请问您需要使用哪种转换工具？
常见选项：
根据上下文选择合适的转换工具，完整列表及优先级见下方“快速参考：可用转换工具”。
最常用的工具：
  • 台灣化 (Taiwan) - 繁体中文+台湾用语
  • 繁體化 (Traditional) - 仅转换为繁体中文
  • 简体化 (Simplified) - 仅转换为简体中文
  • 中国化 (China) - 简体中文+大陆用语
  • 香港化 (Hongkong) - 繁体中文+香港用语
其他可选工具（根据上下文相关时使用）：
  • 注音化 (Bopomofo) - 转换为注音（台湾音标）
  • 拼音化 (Pinyin) - 转换为拼音
  • 详见下方“快速参考”部分的完整列表
模糊请求示例：
  • ❌ “转换成繁体” → 询问：是仅繁体还是台湾/香港变体？
  • ❌ “使用繁体中文” → 询问：需要哪个区域的变体？
  • ❌ “确保都是繁体” → 询问：是仅繁体还是台湾/香港变体？
  • ✅ “使用台湾用语” → 明确：使用台湾化转换工具
  • ✅ “转成香港繁体” → 明确：使用香港化转换工具

Important: File Operations

重要提示：文件操作

If output file already exists, you MUST ask user before overwriting.
Use the 
question
tool to present options:
Output file already exists. What would you like to do?
Options to provide:
  • Overwrite existing file
  • Save to new file (suggest filename with timestamp or _new suffix)
  • Cancel operation
Example suggested filenames:
  • output_2024-02-10.txt
    (with date)
  • output_converted.txt
    (with suffix)
  • output_new.txt
    (simple suffix)
Implementation: Before executing conversion with 
--output
, check if file exists. If exists, ask first.
如果输出文件已存在，必须先询问用户是否覆盖。
使用
question
工具提供选项：
输出文件已存在，请问您希望如何操作？
可选操作：
  • 覆盖现有文件
  • 保存到新文件（建议带时间戳或_new后缀的文件名）
  • 取消操作
示例建议文件名：
  • output_2024-02-10.txt
    （带日期）
  • output_converted.txt
    （带转换后缀）
  • output_new.txt
    （简单后缀）
实现方式： 在使用
--output
参数执行转换前，检查文件是否存在。若已存在，先询问用户。

Quick Reference: Available Converters

快速参考：可用转换工具

Ordered by priority (Taiwan-related first, then others):
ConverterAPI NameDescription
台灣化
Taiwan
Traditional + Taiwan terminology
繁體化
Traditional
Convert to traditional Chinese
注音化
Bopomofo
Convert to Bopomofo (Zhuyin) - Taiwan phonetic
中国化
China
Simplified + China terminology
香港化
Hongkong
Traditional + Hong Kong terminology
简体化
Simplified
Convert to simplified Chinese
拼音化
Pinyin
Convert to Pinyin romanization
火星化
Mars
Convert to Mars text (internet slang)
維基繁體化
WikiTraditional
Traditional (Wikipedia dict only)
维基简体化
WikiSimplified
Simplified (Wikipedia dict only)
按优先级排序（台湾相关工具优先，其余在后）：
转换工具API名称描述
台灣化
Taiwan
繁体中文+台湾用语
繁體化
Traditional
转换为繁体中文
注音化
Bopomofo
转换为注音（台湾音标）
中国化
China
简体中文+大陆用语
香港化
Hongkong
繁体中文+香港用语
简体化
Simplified
转换为简体中文
拼音化
Pinyin
转换为拼音
火星化
Mars
转换为火星文（网络俚语）
維基繁體化
WikiTraditional
仅使用维基词典转换为繁体中文
维基简体化
WikiSimplified
仅使用维基词典转换为简体中文

Using the Script

使用脚本

Basic Usage

基础用法

bash
undefined
bash
undefined

Convert text

转换文本

python scripts/fanfuaji.py "软件开发" --converter Taiwan
python scripts/fanfuaji.py "软件开发" --converter Taiwan

Output: 軟體開發

输出：軟體開發

Convert file

转换文件

python scripts/fanfuaji.py --file input.txt --converter Taiwan
python scripts/fanfuaji.py --file input.txt --converter Taiwan

File to file (supports file:// URI)

文件到文件转换（支持file:// URI）

python scripts/fanfuaji.py -f input.txt -o output.txt -c Taiwan python scripts/fanfuaji.py -f file:///in.txt -o file:///out.txt -c Taiwan
undefined
python scripts/fanfuaji.py -f input.txt -o output.txt -c Taiwan python scripts/fanfuaji.py -f file:///in.txt -o file:///out.txt -c Taiwan
undefined

Advanced Options

进阶选项

bash
undefined
bash
undefined

Protect specific terms from conversion

保护特定术语不被转换

python scripts/fanfuaji.py "软件" --converter Taiwan --protect "软件"
python scripts/fanfuaji.py "软件" --converter Taiwan --protect "软件"

Post-conversion replacement

转换后替换

python scripts/fanfuaji.py "哦" --converter Taiwan --post-replace "哦=喔,啰=囉"
python scripts/fanfuaji.py "哦" --converter Taiwan --post-replace "哦=喔,啰=囉"

Disable specific modules

禁用特定模块

python scripts/fanfuaji.py "内存" --converter Taiwan --modules '{"GanToZuo": 0}'
python scripts/fanfuaji.py "内存" --converter Taiwan --modules '{"GanToZuo": 0}'

Different file encodings

不同文件编码

python scripts/fanfuaji.py --file big5_file.txt --encoding big5 --converter Taiwan python scripts/fanfuaji.py --file gbk_file.txt --encoding gbk --converter Traditional
python scripts/fanfuaji.py --file big5_file.txt --encoding big5 --converter Taiwan python scripts/fanfuaji.py --file gbk_file.txt --encoding gbk --converter Traditional

Verbose output

详细输出

python scripts/fanfuaji.py "软件" --converter Taiwan --verbose
undefined
python scripts/fanfuaji.py "软件" --converter Taiwan --verbose
undefined

As Python Library

作为Python库使用

python
import sys
sys.path.insert(0, 'scripts')
from fanfuaji import convert_text, FanfuajiAPI, Converter
python
import sys
sys.path.insert(0, 'scripts')
from fanfuaji import convert_text, FanfuajiAPI, Converter

Simple conversion

简单转换

result = convert_text("软件开发", Converter.TAIWAN) print(result) # Output: 軟體開發
result = convert_text("软件开发", Converter.TAIWAN) print(result) # 输出：軟體開發

Advanced usage

进阶用法

with FanfuajiAPI() as api: result = api.convert( text="内存和硬盘", converter=Converter.TAIWAN, modules={"GanToZuo": 0}, user_post_replace={"哦": "喔"}, user_protect_replace=["內存"] ) print(result.text) print(f"Used modules: {result.used_modules}")
undefined
with FanfuajiAPI() as api: result = api.convert( text="内存和硬盘", converter=Converter.TAIWAN, modules={"GanToZuo": 0}, user_post_replace={"哦": "喔"}, user_protect_replace=["內存"] ) print(result.text) print(f"使用的模块: {result.used_modules}")
undefined

Common Use Cases

常见使用场景

Working with Different File Encodings

处理不同文件编码

The script supports various character encodings for input files. Use the 
--encoding
flag to specify the encoding:
bash
undefined
脚本支持多种输入文件字符编码，使用
--encoding
参数指定编码：
bash
undefined

Big5 encoded files (common in Taiwan legacy systems)

Big5编码文件（台湾旧系统常用）

python scripts/fanfuaji.py --file legacy_big5.txt --encoding big5 --converter Taiwan
python scripts/fanfuaji.py --file legacy_big5.txt --encoding big5 --converter Taiwan

GBK encoded files (common in China)

GBK编码文件（大陆常用）

python scripts/fanfuaji.py --file chinese_gbk.txt --encoding gbk --converter Traditional
python scripts/fanfuaji.py --file chinese_gbk.txt --encoding gbk --converter Traditional

GB2312 encoded files (older China standard)

GB2312编码文件（大陆旧标准）

python scripts/fanfuaji.py --file old_gb2312.txt --encoding gb2312 --converter Taiwan
python scripts/fanfuaji.py --file old_gb2312.txt --encoding gb2312 --converter Taiwan

UTF-8 (default, no need to specify)

UTF-8（默认，无需指定）

python scripts/fanfuaji.py --file utf8_file.txt --converter Taiwan

**Common encodings:**
- `utf-8` (default) - Universal encoding
- `big5` - Traditional Chinese (Taiwan, Hong Kong)
- `gbk` - Simplified Chinese (China)
- `gb2312` - Simplified Chinese (older standard)

**Note:** Output is always in UTF-8 encoding, regardless of input encoding.
python scripts/fanfuaji.py --file utf8_file.txt --converter Taiwan

**常见编码：**
- `utf-8`（默认）- 通用编码
- `big5` - 繁体中文（台湾、香港）
- `gbk` - 简体中文（大陆）
- `gb2312` - 简体中文（旧标准）

**注意：**无论输入编码是什么，输出始终为UTF-8编码。

User Asks for Taiwan Terminology

用户要求台湾用语

bash
undefined
bash
undefined

User: "使用台灣用語輸出"

用户："使用台灣用語輸出"

python scripts/fanfuaji.py "软件和内存" --converter Taiwan
python scripts/fanfuaji.py "软件和内存" --converter Taiwan

Output: 軟體和記憶體

输出：軟體和記憶體

undefined
undefined

Convert File Content

转换文件内容

bash
undefined
bash
undefined

Read simplified Chinese file, output traditional

读取简体中文文件，输出繁体版本

python scripts/fanfuaji.py --file document.txt --converter Taiwan --output output.txt
undefined
python scripts/fanfuaji.py --file document.txt --converter Taiwan --output output.txt
undefined

Batch Processing with Custom Rules

带自定义规则的批量处理

bash
undefined
bash
undefined

Convert with term protection and replacement

转换时保护术语并执行替换

python scripts/fanfuaji.py
--file input.txt
--converter Taiwan
--protect "API,GitHub"
--post-replace "哦=喔,啰=囉"
--output converted.txt
undefined
python scripts/fanfuaji.py \ --file input.txt \ --converter Taiwan \ --protect "API,GitHub" \ --post-replace "哦=喔,啰=囉" \ --output converted.txt
undefined

Script Features

脚本特性

  • ✅ Zero dependencies (uses stdlib 
    urllib
    )
  • ✅ File I/O support (text, file paths, file:// URIs)
  • ✅ Multiple encodings (UTF-8, Big5, GBK, GB2312, Shift_JIS, etc.)
  • ✅ Error handling (network, API errors, file errors)
  • ✅ Flexible output (stdout or file)
  • ✅ Full API access (modules, replacements, protection)
  • ✅ 零依赖（使用标准库
    urllib
    ）
  • ✅ 文件I/O支持（文本、文件路径、file:// URI）
  • ✅ 多编码支持（UTF-8、Big5、GBK、GB2312、Shift_JIS等）
  • ✅ 错误处理（网络、API、文件错误）
  • ✅ 灵活输出（标准输出或文件）
  • ✅ 完整API访问（模块、替换、保护）

Related Resources

相关资源

Notes

注意事项

  • Free tier available without API key
  • Commercial use requires paid API key (details)
  • Rate limits apply - check official docs
  • Script handles all API parameter formatting automatically
  • 免费额度：无需API密钥即可使用
  • 商业使用：需要付费API密钥（详情）
  • 速率限制：请查看官方文档
  • 脚本会自动处理所有API参数格式",