UUID 多格式生成器

要解决什么问题

在接口设计、日志关联、测试数据造数或分布式 ID 占位时，你往往需要 可复现或随机 的唯一标识符。手写 uuid.uuid4() 很快够用，但一旦要 v1（时间序）、v5（命名空间哈希） 或 更短的 Base62 形态，还要 一次生成多条，就得在脚本里反复拼参数、查文档，容易版本混用或格式不统一。

技能如何工作

本技能围绕 Python 内置 uuid 模块做 纯本地生成，不调用外部 API，也不引入第三方包。核心能力包括：

• UUID v4：随机 UUID，适合大多数「只要唯一」的场景
• UUID v1：基于时间戳与节点信息，便于按时间粗排序（需注意隐私与节点字段语义）
• UUID v5：在固定命名空间与名称上生成确定性 UUID，适合「同一输入永远同一 ID」
• 短 UUID：在需要更短、URL 友好字符串时，走 Base62 编码形态
• 批量：通过 count 一次产出多条，减少重复操作

调用侧主要关心三个参数：count（数量，默认 1）、version（1 / 4 / 5，默认 4）、short（是否短 UUID，默认 false）。Agent 按你的自然语言意图映射到这些参数并返回结果即可。

适用边界与注意点

• 运行环境需 Python 3.6+；逻辑依赖标准库，不能替代 数据库自增、Snowflake、ULID 等带业务语义的 ID 方案。
• v5 需要明确的命名空间与名称约定，否则「确定性」无法在你团队内对齐。
• v1 可能暴露 MAC/节点相关信息的历史行为，对外公开 ID 时要评估是否改用 v4。
• 短 UUID 是展示层压缩，碰撞概率与长度权衡 需按你的系统容量自行评估；高安全场景仍应以完整 UUID 或专门 ID 服务为准。