核心用法
minio-share 是一款面向文件分享场景的技能工具，允许用户将本地文件或网络资源上传至自托管的 MinIO S3 兼容对象存储，并自动生成带有 Markdown 格式化的分享链接。该技能特别适合需要向他人分发大文件、视频或图片的场景，无需依赖第三方云盘服务。
显著优点
1. 自托管可控：基于开源 MinIO 部署，数据主权完全由用户掌控，避免商业云服务的隐私审查和流量限制。
2. 富媒体输出：自动识别图片和视频文件，在 Markdown 中嵌入内联预览（图片直接显示、视频带播放器），提升接收端体验。
3. 灵活的命名策略：支持通过 --title 参数使用语义化标题作为文件名，自动清理特殊字符并保留中文，解决原始文件名混乱的问题。
4. 多格式输出：默认提供结构化的 Markdown 报告，也可通过 --json 获取结构化数据或纯文本 URL，便于自动化集成。
5. 时效可控：预签名链接默认可配置有效期（默认 7 天），兼顾分享便利性与访问安全。
潜在缺点与局限性
- 环境依赖严格：必须预先配置 5 项 MinIO 连接参数（URL、密钥、桶名），且要求目标桶已存在，新手部署门槛较高。
- 网络可达性要求：分享链接的有效性依赖于 MinIO 服务端的公网可访问性，内网部署需额外配置反向代理或内网穿透。
- 单点故障风险：自托管架构下，若 MinIO 服务或存储后端出现异常，所有分享链接将同时失效。
- 无文件去重机制：重复上传相同文件会产生多个对象，缺乏基于哈希的自动去重或秒传功能。
- CLI 交互限制：当前仅支持命令行调用，无图形界面，对非技术用户不够友好。
适合人群
- 开发者和技术团队，需要将构建产物、日志或文档快速分享给同事
- 内容创作者，定期分发视频、设计稿等大体积素材给合作方
- 注重数据隐私的组织，希望替代百度网盘、WeTransfer 等第三方服务
- 已有 MinIO 或 AWS S3 基础设施的 DevOps 工程师
常规风险
- 密钥泄露风险：MinIO 访问密钥以明文形式存储在环境变量中，若运行环境被入侵，攻击者可获得完整的存储桶读写权限。
- URL 有效期管理：预签名链接一旦生成即不可撤销（除非轮换密钥），误发给无关人员后只能等待过期或手动删除对象。
- 存储成本失控：缺乏上传配额限制，恶意或误操作可能导致存储桶被填满产生费用。
- 传输安全：默认依赖 HTTPS，但若配置
--insecure或 API URL 使用 HTTP，存在中间人窃听风险。