核心用法
pmctl 是一款基于 Python 的命令行工具，通过 Postman API 实现终端环境下的 API 资源管理。主要功能涵盖四大模块：
1. Profiles 配置管理：支持多账户配置，通过 pmctl profile add 添加 Postman API Key，设置默认 workspace，实现个人/工作账户隔离。
2. Collections 浏览：pmctl collections list 列出工作空间集合，collections show <UID> 以树形结构展示请求层级，支持 --all 跨工作空间查询。
3. Requests 深度查询：pmctl requests list 提供表格化端点概览，支持模糊搜索（如 getCmp 匹配 get Campaign）；requests show 输出完整请求详情，包括方法、URL、Headers、Body、Query 参数等。支持 --json 管道化输出配合 jq 处理。
4. Environments 变量解析：environments show 查看环境变量，支持 --full 显示完整值（避免截断），可结合请求中的 {{variable}} 占位符解析真实 URL。
典型工作流
- API 发现：
requests list --search模糊搜索快速定位端点 - curl 构建：提取
--json输出中的 method/url/headers/body，拼接环境变量生成可执行命令 - 自动化脚本：利用
--json与jq组合实现 CI/CD 集成
显著优点
- 零 GUI 依赖：终端操作响应快，适合远程服务器、容器环境
- 模糊搜索友好：
--search支持字符顺序匹配，大幅降低记忆成本 - 多账户隔离：Profile 机制便于管理个人/企业/客户多 Postman 账户
- 管道友好：全链路 JSON 输出，与
jq/shell 脚本无缝集成 - 开源透明：GitHub 源码可审计，社区驱动迭代
潜在局限
- Postman API Key 依赖：需手动获取并配置 API Key，新用户有学习成本
- 仅读操作：当前版本不支持创建/修改集合，纯浏览与查询工具
- 变量解析需手动：
{{variable}}不会自动替换，需二次查询 environments 并拼接 - Python 环境依赖：需
pip install，非系统原生工具
适合人群
- 后端/全栈开发者日常 API 探索与调试
- DevOps 工程师构建 CI/CD 流水线中的 API 测试脚本
- 需要批量处理 Postman 集合数据的自动化场景
- 偏好终端效率、反感 GUI 切换的重度 CLI 用户
常规风险
- API Key 泄露风险：
~/.pmctl/profiles.yaml存储明文 API Key，需确保文件权限 600 - 生产环境误操作：虽为只读工具，但解析出的敏感变量（如
api-secret）可能暴露于终端历史 - 第三方 API 依赖：Postman API 服务可用性影响工具功能，无离线模式
- Rate Limiting：高频调用可能触发 Postman API 限流