火星文转换器 v2.1
将正常汉字随机转换为火星文风格文本。611 个汉字映射，1020 条映射关系。
使用方法
python3 {baseDir}/scripts/mars_text.py "要转换的文本"
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
--all |
全部转换（同默认行为，所有有映射的字都转） | 默认即全量 |
--prob 0.7 |
转换概率 0.0-1.0，调低可保留部分原字 | 1.0 |
--seed N |
随机种子，用于复现结果 | 随机 |
--map 字 |
查看某个字的所有替代写法 | — |
--json |
JSON格式输出 | 否 |
示例
# 全量转换（默认）
python3 scripts/mars_text.py "我爱你中国"
# 输出：莪嫒伱忠囯
# 查看映射
python3 scripts/mars_text.py --map 我
# 输出：「我」→ 莪 / 涐
# 保留部分原字（50%概率）
python3 scripts/mars_text.py "今天天气很好" --prob 0.5
# 可复现
python3 scripts/mars_text.py "测试" --seed 42
转换规则
- 全量转换：默认每个能转的字都转（probability=1.0）
- 多对多随机替换：同一个字有多个替代写法，随机选取
- 不转换：标点、数字、英文字母、emoji 不变
- 可辨认优先：所有替代字必须能被读者辨认出原字（见下方质量规则）
映射质量规则（永久遵守）
替代字必须满足以下至少一条才可入选：
| 规则 | 说明 | 示例 |
|---|---|---|
| ✅ 同音字 | 拼音相同（忽略声调）的常用字 | 很→狠, 今→衿, 因→洇 |
| ✅ 繁体字 | 对应的繁体/异体写法 | 国→國, 听→聽, 梦→夢 |
| ✅ 经典火星文 | 文化上公认的火星文（即使拼音不同） | 我→莪/涐, 在→茬, 天→兲 |
| ✅ 形近变体 | 视觉结构与原字明显相关 | 伱(你), 旳(的), 眞(真) |
| ✅ 符号替代 | 非CJK字符（圈数字等） | 一→①, 七→⑦ |
禁止入选的字：
| 禁止类型 | 说明 | 反面示例 |
|---|---|---|
| ❌ 生僻无关字 | 读者完全无法辨认的字 | |
| ❌ 仅声母相同 | 只是首字母碰巧一样 | |
| ❌ 古音/罕见读音匹配 | 靠古汉语冷僻读音凑出的匹配 |
核心判断标准：一个普通中文读者看到替代字，能否在3秒内猜出原字？不能则不合格。
数据规模
- 611 个汉字映射，1020 条映射关系
- 每个字 1-4 个替代写法
- 覆盖：人称代词、动词、名词、形容词、副词、助词、连词、数词、量词、方向、时间、身体部位、食物、自然、科技、交通、动物、衣物、建筑、天气、情感等 30+ 分类
扩展映射
在 scripts/mars_text.py 的 MARS_MAP 列表中添加新映射：
("字", ["替代1", "替代2", "替代3"]),
添加前必须验证：新增的每个替代字都必须满足上述质量规则。宁可少一个映射，也不要加入让人看不懂的字。
版本历史
- v2.1: 清理生僻字映射，移除 204 条不可辨认的替代字（17%），恢复经典火星文（莪、涐、茬等），新增聽、壞等繁体映射
- v2.0: 初始版本，640+ 汉字映射