Skip to main content

Crate marspeak

Crate marspeak 

Source
Expand description

中文火星文转换库:可逆的单字符字形替换。

一个字符进、一个字符出,不依赖上下文,因此 decode(encode(s)) == s 恒成立。 可逆性不靠记录操作历史,而是靠映射表本身的三条规则(见 Table): 候选不等于原字、候选全局唯一、候选不能同时是别人的原字。

use marspeak::Builder;

let m = Builder::new().seed(42).intensity(0.6).build().unwrap();
let encoded = m.encode("我爱你");
assert_eq!(m.decode(&encoded), "我爱你");

§两个容易踩的语义

  • intensity 是概率,不是“前 N 个字“。它表示约有百分之多少的「有映射字符」 被替换,具体哪些由哈希决定。表里没有的字符(ASCII、emoji、空白)永远原样通过。
  • decode 是无条件的。它会还原输入里所有能反查的字符,跟 encode 时用了 多少 intensity 无关。所以 decode 一段别人写的火星文同样会生效——这是有意 的设计后果,不是 bug。

§确定性

同一组 (seed, intensity, table) 永远得到同一份输出。哈希是手写的 FNV-1a, 不依赖任何外部状态或平台特性。

Structs§

Builder
Marspeak 的构造器。默认 seed = 0、intensity = 1.0、用内置表。
Marspeak
一个配置好的转换器。由 Builder 产出,可重复使用。
Table
一张字符映射表。

Enums§

MarspeakError
构造 Marspeak 时的参数错误。
TableError
映射表解析失败的原因。每条都对应 Table::parse 的一条校验规则, 并且都带上出错的行号,方便直接定位到 TSV 的那一行。