base on Conversion between Traditional and Simplified Chinese # Open Chinese Convert 開放中文轉換 [](https://github.com/BYVoid/OpenCC/actions/workflows/cmake.yml) [](https://github.com/BYVoid/OpenCC/actions/workflows/bazel.yml) [](https://github.com/BYVoid/OpenCC/actions/workflows/msvc.yml) [](https://github.com/BYVoid/OpenCC/actions/workflows/nodejs.yml) [](https://github.com/BYVoid/OpenCC/actions/workflows/python.yml) [](https://ci.appveyor.com/project/Carbo/OpenCC) ## Introduction 介紹  Open Chinese Convert (OpenCC, 開放中文轉換) is an opensource project for conversions between Traditional Chinese, Simplified Chinese and Japanese Kanji (Shinjitai). It supports character-level and phrase-level conversion, character variant conversion and regional idioms among Mainland China, Taiwan and Hong Kong. This is not translation tool between Mandarin and Cantonese, etc. 中文簡繁轉換開源項目，支持詞彙級別的轉換、異體字轉換和地區習慣用詞轉換（中國大陸、臺灣、香港、日本新字體）。不提供普通話與粵語的轉換。 Discussion (Telegram): https://t.me/open_chinese_convert ### Features 特點 * 嚴格區分「一簡對多繁」和「一簡對多異」。 * 完全兼容異體字，可以實現動態替換。 * 嚴格審校一簡對多繁詞條，原則爲「能分則不合」。 * 支持中國大陸、臺灣、香港異體字和地區習慣用詞轉換，如「裏」「裡」、「鼠標」「滑鼠」。 * 詞庫和函數庫完全分離，可以自由修改、導入、擴展。 ## Installation 安裝 ### Package Managers 包管理器 * [Debian](https://tracker.debian.org/pkg/opencc) * [Ubuntu](https://launchpad.net/ubuntu/+source/opencc) * [Fedora](https://packages.fedoraproject.org/pkgs/opencc/opencc/) * [Arch Linux](https://archlinux.org/packages/extra/x86_64/opencc/) * [Mac](https://formulae.brew.sh/formula/opencc) * [Bazel](https://registry.bazel.build/modules/opencc) * [Node.js](https://npmjs.org/package/opencc) * [Python](https://pypi.org/project/OpenCC/) ### Prebuilt 預編譯 * Windows (x86_64): [Latest build](https://ci.appveyor.com/api/projects/Carbo/opencc/artifacts/OpenCC.zip?branch=master&job=Environment:%20nodejs_version=none;%20Platform:%20x64) * Windows (x86): [Latest build](https://ci.appveyor.com/api/projects/Carbo/opencc/artifacts/OpenCC.zip?branch=master&job=Environment:%20nodejs_version=none;%20Platform:%20x86) ## Usage 使用 ### Online demo 線上轉換展示 Warning: **This is NOT an API.** You will be banned if you make calls programmatically. https://opencc.byvoid.com/ ### Node.js [npm](https://www.npmjs.com/opencc) `npm install opencc` #### JavaScript ```js const OpenCC = require('opencc'); const converter = new OpenCC('s2t.json'); converter.convertPromise("汉字").then(converted => { console.log(converted); // 漢字 }); ``` #### TypeScript ```ts import { OpenCC } from 'opencc'; async function main() { const converter: OpenCC = new OpenCC('s2t.json'); const result: string = await converter.convertPromise('汉字'); console.log(result); } ``` See [demo.js](https://github.com/BYVoid/OpenCC/blob/master/node/demo.js) and [ts-demo.ts](https://github.com/BYVoid/OpenCC/blob/master/node/ts-demo.ts). ### Python `pip install opencc` (Windows, Linux, Mac) ```python import opencc converter = opencc.OpenCC('s2t.json') converter.convert('汉字') # 漢字 ``` ### C++ ```c++ #include "opencc.h" int main() { const opencc::SimpleConverter converter("s2t.json"); converter.Convert("汉字"); // 漢字 return 0; } ``` [Full example with Bazel](https://github.com/BYVoid/opencc-bazel-example) ### C ```c #include "opencc.h" int main() { opencc_t opencc = opencc_open("s2t.json"); const char* input = "汉字"; char* converted = opencc_convert_utf8(opencc, input, strlen(input)); // 漢字 opencc_convert_utf8_free(converted); opencc_close(opencc); return 0; } ``` Document 文檔: https://byvoid.github.io/OpenCC/ ### Command Line * `opencc --help` * `opencc_dict --help` * `opencc_phrase_extract --help` ### Others (Unofficial) * Swift (iOS): [SwiftyOpenCC](https://github.com/XQS6LB3A/SwiftyOpenCC) * iOSOpenCC (pod): [iOSOpenCC](https://github.com/swiftdo/OpenCC) * Java: [opencc4j](https://github.com/houbb/opencc4j) * Android: [android-opencc](https://github.com/qichuan/android-opencc) * PHP: [opencc4php](https://github.com/nauxliu/opencc4php) * Pure JavaScript: [opencc-js](https://github.com/nk2028/opencc-js) * WebAssembly: [wasm-opencc](https://github.com/oyyd/wasm-opencc) * Browser Extension: [opencc-extension](https://github.com/tnychn/opencc-extension) * Go (Pure): [OpenCC for Go](https://github.com/longbridgeapp/opencc) * Dart (native-assets): [opencc-dart](https://github.com/lindeer/opencc-dart) ### Configurations 配置文件 #### 預設配置文件 * `s2t.json` Simplified Chinese to Traditional Chinese 簡體到繁體 * `t2s.json` Traditional Chinese to Simplified Chinese 繁體到簡體 * `s2tw.json` Simplified Chinese to Traditional Chinese (Taiwan Standard) 簡體到臺灣正體 * `tw2s.json` Traditional Chinese (Taiwan Standard) to Simplified Chinese 臺灣正體到簡體 * `s2hk.json` Simplified Chinese to Traditional Chinese (Hong Kong variant) 簡體到香港繁體 * `hk2s.json` Traditional Chinese (Hong Kong variant) to Simplified Chinese 香港繁體到簡體 * `s2twp.json` Simplified Chinese to Traditional Chinese (Taiwan Standard) with Taiwanese idiom 簡體到繁體（臺灣正體標準）並轉換爲臺灣常用詞彙 * `tw2sp.json` Traditional Chinese (Taiwan Standard) to Simplified Chinese with Mainland Chinese idiom 繁體（臺灣正體標準）到簡體並轉換爲中國大陸常用詞彙 * `t2tw.json` Traditional Chinese (OpenCC Standard) to Taiwan Standard 繁體（OpenCC 標準）到臺灣正體 * `hk2t.json` Traditional Chinese (Hong Kong variant) to Traditional Chinese 香港繁體到繁體（OpenCC 標準） * `t2hk.json` Traditional Chinese (OpenCC Standard) to Hong Kong variant 繁體（OpenCC 標準）到香港繁體 * `t2jp.json` Traditional Chinese Characters (Kyūjitai) to New Japanese Kanji (Shinjitai) 繁體（OpenCC 標準，舊字體）到日文新字體 * `jp2t.json` New Japanese Kanji (Shinjitai) to Traditional Chinese Characters (Kyūjitai) 日文新字體到繁體（OpenCC 標準，舊字體） * `tw2t.json` Traditional Chinese (Taiwan standard) to Traditional Chinese 臺灣正體到繁體（OpenCC 標準） ## Build 編譯 ### Build with CMake #### Linux & Mac OS X g++ 4.6+ or clang 3.2+ is required. ```bash make ``` #### Windows Visual Studio: ```bash build.cmd ``` ### Build with Bazel ```bash bazel build //:opencc bazel test --test_output=all //src/... //data/... //test/... ``` ### Test 測試 #### Linux & Mac OS X ``` make test ``` #### Windows Visual Studio: ```bash test.cmd ``` ### Benchmark 基準測試 ``` make benchmark ``` Example results (from Github CI): ``` 1: ------------------------------------------------------------------ 1: Benchmark Time CPU Iterations 1: ------------------------------------------------------------------ 1: BM_Initialization/hk2s 1.56 ms 1.56 ms 442 1: BM_Initialization/hk2t 0.144 ms 0.144 ms 4878 1: BM_Initialization/jp2t 0.260 ms 0.260 ms 2604 1: BM_Initialization/s2hk 23.8 ms 23.8 ms 29 1: BM_Initialization/s2t 25.6 ms 25.6 ms 28 1: BM_Initialization/s2tw 24.0 ms 23.9 ms 30 1: BM_Initialization/s2twp 24.6 ms 24.6 ms 28 1: BM_Initialization/t2hk 0.052 ms 0.052 ms 12897 1: BM_Initialization/t2jp 0.141 ms 0.141 ms 5012 1: BM_Initialization/t2s 1.30 ms 1.30 ms 540 1: BM_Initialization/tw2s 1.39 ms 1.39 ms 529 1: BM_Initialization/tw2sp 1.69 ms 1.69 ms 426 1: BM_Initialization/tw2t 0.089 ms 0.089 ms 7707 1: BM_Convert2M 582 ms 582 ms 1 1: BM_Convert/100 1.07 ms 1.07 ms 636 1: BM_Convert/1000 11.0 ms 11.0 ms 67 1: BM_Convert/10000 113 ms 113 ms 6 1: BM_Convert/100000 1176 ms 1176 ms 1 ``` ## Projects using OpenCC 使用 OpenCC 的項目 Please update if your project is using OpenCC. * [ibus-pinyin](https://github.com/ibus/ibus-pinyin) * [fcitx](https://github.com/fcitx/fcitx) * [rimeime](https://rime.im/) * [libgooglepinyin](http://code.google.com/p/libgooglepinyin/) * [ibus-libpinyin](https://github.com/libpinyin/ibus-libpinyin) * [alfred-chinese-converter](https://github.com/amowu/alfred-chinese-converter) * [GoldenDict](https://github.com/goldendict/goldendict) ## License 許可協議 Apache License 2.0 ## Third Party Library 第三方庫 * [darts-clone](https://github.com/s-yata/darts-clone) BSD License * [marisa-trie](https://github.com/s-yata/marisa-trie) BSD License * [tclap](http://tclap.sourceforge.net/) MIT License * [rapidjson](https://github.com/Tencent/rapidjson) MIT License * [Google Test](https://github.com/google/googletest) BSD License All these libraries are statically linked by default. ## Change History 版本歷史 * [NEWS](https://github.com/BYVoid/OpenCC/blob/master/NEWS.md) ### Links 相關鏈接 * Introduction 詳細介紹 https://github.com/BYVoid/OpenCC/wiki/%E7%B7%A3%E7%94%B1 * 現代漢語常用簡繁一對多字義辨析表 http://ytenx.org/byohlyuk/KienxPyan ## Contributors 貢獻者 * [BYVoid](http://www.byvoid.com/) * [佛振](https://github.com/lotem) * [Peng Huang](https://github.com/phuang) * [LI Daobing](https://github.com/lidaobing) * [Kefu Chai](https://github.com/tchaikov) * [Kan-Ru Chen](http://kanru.info/) * [Ma Xiaojun](https://twitter.com/damage3025) * [Jiang Jiang](http://jjgod.org/) * [Ruey-Cheng Chen](https://github.com/rueycheng) * [Paul Meng](http://home.mno2.org/) * [Lawrence Lau](https://github.com/ktslwy) * [瑾昀](https://github.com/kunki) * [內木一郎](https://github.com/SyaoranHinata) * [Marguerite Su](https://www.marguerite.su/) * [Brian White](http://mscdex.net) * [Qijiang Fan](https://fqj.me/) * [LEOYoon-Tsaw](https://github.com/LEOYoon-Tsaw) * [Steven Yao](https://github.com/stevenyao) * [Pellaeon Lin](https://github.com/pellaeon) * [stony](https://github.com/stony-shixz) * [steelywing](https://github.com/steelywing) * [吕旭东](https://github.com/lvxudong) * [Weng Xuetian](https://github.com/wengxt) * [Ma Tao](https://github.com/iwater) * [Heinz Wiesinger](https://github.com/pprkut) * [J.W](https://github.com/jakwings) * [Amo Wu](https://github.com/amowu) * [Mark Tsai](https://github.com/mxgit1090) * [Zhe Wang](https://github.com/0x1997) * [sgqy](https://github.com/sgqy) * [Qichuan (Sean) ZHANG](https://github.com/qichuan) * [Flandre Scarlet](https://github.com/XadillaX) * [宋辰文](https://github.com/songchenwen) * [iwater](https://github.com/iwater) * [Xpol Wan](https://github.com/xpol) * [Weihang Lo](https://github.com/weihanglo) * [Cychih](https://github.com/pi314) * [kyleskimo](https://github.com/kyleskimo) * [Ryuan Choi](https://github.com/bunhere) * [Prcuvu](https://github.com/Prcuvu) * [Tony Able](https://github.com/TonyAble) * [Xiao Liang](https://github.com/yxliang01) Please feel free to update this list if you have contributed OpenCC. ", Assign "at most 3 tags" to the expected json: {"id":"9965","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"