普贤教程 › 包参考

captcha 包

数字验证码（ASCII 渲染）

项	值
包名	`captcha`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`captcha.px`
分类	`认证与安全`
文件数 / 行数	`1 / 169`

安装与引入

bash

pxpkg init          # 首次
pxpkg add captcha@0.2.0
pxpkg install

import captcha

所属分类教程：认证与安全

公开接口

函数	参数
`cp_generate`	`len_v=4, opts={}`
`cp_verify`	`answer, guess`
`cp_valid`	`s`

其余 6 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`cp_glyph`	`d`
`cp_digit`	`c`
`cp_generate_alpha`	`len_v=4, opts={}`
`cp_render`	`answer, opts={}`
`cp_compare`	`answer, guess`
`cp_generate_hex`	`len_v=4, opts={}`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/captcha —— 数字验证码（ASCII 渲染）
------------------------------------------------------------
纯函数库（无 IO、无状态；随机源 = 原生 random），编译/解释双模式一致。
cp_generate(len=4, opts={}) → Ok({answer, image}) | Err
answer：len 位随机数字；image：5 行 ASCII 渲染（3×5 七段字体）
opts: {noise: bool(默认 false，' ' 替换为 '.' 加噪), font?}
cp_verify(answer, guess) → bool（精确匹配）
cp_valid(s) → bool（是否纯数字且 1..10 位）
3×5 字体（经典七段）：0-9 各 3 列 5 行；字间以空格分隔。
============================================================