Agent Skills
返回列表
Base64 编解码工具

Base64 编解码工具

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-cn-base64-tool。

技能介绍

要解决什么问题

在联调接口、处理附件元数据或排查日志时，你经常要在「可读文本」和 Base64 字符串之间来回转换；若还要对本地文件做同样操作，手写脚本容易重复造轮子，或误用编码（例如把二进制当 UTF-8 读）。本技能面向这类本地、离线的编解码需求，不依赖在线 API 或额外包。

技能如何工作

实现完全基于 Python 标准库中的 base64 与 argparse，通过 Agent 按你的意图调用相应能力：

  • 编码：将 UTF-8 字符串或指定文件内容转为 Base64 文本
  • 解码：将 Base64 字符串还原为原始字节/文本，并可写回文件
  • 文件路径：支持对磁盘上的文件进行编码或解码，避免在对话里粘贴大段二进制

流程上通常是：明确输入是字符串还是文件、是否需要保存到路径，再执行编码或解码；字符侧默认按 UTF-8 处理，与常见 Web/JSON 场景一致。

适用边界与注意点

  • 仅做 Base64 变换，不提供 URL-safe 变体、MIME 分块等高级格式的专门说明时，需自行确认是否与对端约定一致（标准库可支持多种 alphabet，以技能实际调用为准）。
  • 大文件会占用上下文或执行时间，更适合中小体积文件或片段；敏感内容在 Agent 环境中处理时注意日志与留存策略。
  • 无外部依赖也意味着无云存储、批量队列等企业级能力，适合开发调试与个人数据处理。

使用场景

  • 联调 REST 或 GraphQL 接口时，将响应 JSON 中的 Base64 字段解码为本地文件，核对图片或附件是否与预期一致。
  • 构造接口 mock 或 Postman 用例前，把小型样例文件编码为 Base64 字符串填入请求体或 fixture。
  • 排查生产日志里出现的 Base64 片段，解码后确认是否为 UTF-8 明文或错误堆栈内容。
  • 把本地配置文件或密钥材料编码为 Base64，便于写入环境变量或 CI 密文占位后再人工核对。

适合人员

  • 对接 OAuth、JWT 或 Basic 认证的后端工程师，需要在本地反复对凭证或 payload 做 Base64 编解码验证。
  • 编写自动化测试的 QA，要把工单或日志里导出的 Base64 附件还原成可打开文件再写回归步骤。
  • 维护数据管道或 ETL 脚本的开发，偶尔要把 CSV/小二进制块转成 Base64 嵌入消息队列测试消息。
  • 做小程序或 H5 上传联调的前端，需要把选中的本地图片编码后对照服务端解码结果排查格式问题。