Struct ZeroingConfirmToken 

pub struct ZeroingConfirmToken(/* private fields */);

关节归零确认令牌（Zero-token 类型模式）

安全机制：此类型只能通过三种方式创建：

1. 从环境变量读取（confirm_from_env()）
2. unsafe 创建（new_unchecked()）
3. 测试创建（confirm_for_test()，仅测试可用）

这确保了用户明确确认了归零操作的 danger。

设计说明

这是一个 Zero-cost 类型安全 模式：

• 类型大小：0 字节（ZST，零大小类型）
• 运行时开销：0
• 编译期检查：✅

示例

// 从环境变量读取（推荐）
let token = ZeroingConfirmToken::confirm_from_env()?;

// 或使用 unsafe（仅用于 GUI）
let token = unsafe { ZeroingConfirmToken::new_unchecked() };

Implementations

impl ZeroingConfirmToken

pub fn confirm_from_env() -> Result<Self, ZeroingTokenError>

从环境变量确认（推荐用于 CLI 应用）

环境变量：PIPPER_ZEROING_CONFIRM 期望值：I_CONFIRM_ZEROING_IS_DANGEROUS

错误

• 环境变量未设置
• 环境变量值不匹配

示例

// 用户需要在命令行明确确认：
// export PIPER_ZEROING_CONFIRM=I_CONFIRM_ZEROING_IS_DANGEROUS
let token = ZeroingConfirmToken::confirm_from_env()?;

pub unsafe fn new_unchecked() -> Self

不安全创建（供 GUI 应用使用）

⚠️ 安全契约：

调用此方法前，必须确保：

1. 用户已在 UI 中明确确认归零操作的 danger
2. 显示了清晰的警告信息
3. 用户主动点击了“确认“按钮（或其他明确的确认动作）

Safety

调用者必须保证用户已经明确确认了归零操作的 danger。 此函数绕过了环境变量检查，因此调用者有责任确保用户同意。

示例

// 显示确认对话框
if show_confirmation_dialog() {
    // ⚠️ 用户已确认，使用 unsafe 跳过检查
    let token = unsafe { ZeroingConfirmToken::new_unchecked() };
} else {
    return Err(Box::new(io::Error::new(
        io::ErrorKind::Other,
        "User cancelled"
    )) as Box<dyn std::error::Error>);
}

Trait Implementations

impl Clone for ZeroingConfirmToken

fn clone(&self) -> ZeroingConfirmToken

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ZeroingConfirmToken

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Copy for ZeroingConfirmToken