# GolangCC **Repository Path**: codelint/golang-cc ## Basic Information - **Project Name**: GolangCC - **Description**: OpenCC 的纯 Go 移植:零依赖、单二进制、兼容官方词典与配置,覆盖简繁/港台地区/日文全部标准转换链。 - **Primary Language**: Go - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-19 - **Last Updated**: 2026-11-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # gocc —— 中文简繁转换工具 零依赖、单文件便携的中文简繁与地区变体转换工具,覆盖简繁、台湾/香港地区、日文新字体、篆书等全部标准转换链。 ## 特性 - **零第三方依赖**:仅使用 Go 标准库,无 CGO,`go.mod` 无任何 `require` - **单文件便携**:全部 19 个转换配置与 26 份词典通过 `go:embed` 内嵌,二进制拷贝到任意目录/同平台任意机器即可运行,不依赖外部文件 - **完整转换链**:normalization 归一化、mmseg 最大匹配分词、多级词典转换链、地区变体与反向映射语义齐备 - **等价命令行**:stdin/stdout 逐行转换、`-c` 配置、`-i/-o` 文件模式、`--version` ## 快速开始 ```bash # 构建(产物约 4.7 MB) go build -o gocc ./cmd/gocc # 管道转换 echo "台湾的新泽西,信道很好" | ./gocc -c s2twp # → 臺灣的紐澤西,通道很好 # 文件转换 ./gocc -c t2s -i input.txt -o output.txt # 查看版本 ./gocc --version ``` `-c` 接受裸名(`s2t`)或带后缀(`s2t.json`),默认 `s2t.json`,仅支持内置配置。 ## 内置转换配置(19 个) | 类别 | 配置 | |------|------| | 简 ↔ 繁 | `s2t` `t2s` | | 简 ↔ 台湾 | `s2tw` `tw2s` `s2twp` `tw2sp` | | 简 ↔ 香港 | `s2hk` `hk2s` `s2hkp` `hk2sp` | | 繁 ↔ 地区 | `t2tw` `t2hk` `tw2t` `hk2t` | | 繁 ↔ 日文新字体 | `t2jp` `jp2t` | | 篆书 | `s2seal` `t2seal` `seal2t` | ## 项目结构 ``` cmd/gocc/ 命令行入口 cmd/gogen/ 派生词典生成器(构建期运行) internal/dict/ 词典解析与最长前缀匹配(short_circuit / union) internal/ids/ 表意文字描述序列(IDS)长度解析 internal/convert/ 转换阶段与转换链 internal/segment/ mmseg 最大匹配分词 internal/config/ JSON 配置解析与管线装配 internal/generator/ reverse / tofu-risk / 地区词投影生成规则 data/config/ 19 个转换配置 data/dictionary/ 26 份词典 txt(19 源 + 7 派生生成) testdata/ 测试用例与 golden 语料 ``` 转换管线语义与模块设计详见 [docs/architecture.md](docs/architecture.md)。 ## 派生词典 词典集合中有 7 份属于派生数据(5 个反向词典、TSCharactersExt、STPhrases_GeneratedFromRegionalPhrases),由 `cmd/gogen` 在构建期生成、提交入库后再内嵌,最终二进制无需任何生成步骤。生成规则详见 [docs/derived-dictionaries.md](docs/derived-dictionaries.md)。 ```bash go run ./cmd/gogen # 重新生成派生词典到 data/dictionary/ ``` ## 测试与验收 ```bash go vet ./... # 无告警 go test ./... # 281 条用例(611 项检查)+ golden 5 配置全文逐字节一致 ``` 行为约定与对拍口径见 [docs/compatibility.md](docs/compatibility.md),测试说明见 [docs/testing.md](docs/testing.md)。 ## 不实现的部分 二进制词典格式、jieba 分词插件、外部自定义配置文件、以及 `--segmentation`/`--inspect`/`--ambiguities` 等调试模式均不在本工具范围内。