核心用法
porteden drive 是 Google Drive 的安全化管理工具，通过命令行实现完整的文件生命周期管理。核心设计强调 `-jc` 标志（--json --compact），专为 AI 代理优化，减少 token 消耗并结构化输出。
主要功能模块
| 场景 | 命令示例 |
|------|---------|
| 浏览与搜索 | `porteden drive files -jc`（列表）、`-q "关键词"`（搜索）、`--mime-type`（过滤） |
| 内容读取 | `porteden drive content google:FILEID` —— 智能识别文件类型，文本直接返回、二进制返回预览链接 |
| 创建与上传 | `create`（内联文本 ≤10MB）、`upload`（二进制文件）、`mkdir`（文件夹） |
| 组织管理 | `rename`、`move`、`copy`（支持 Google Workspace 文档复制） |
| 权限共享 | `share` 支持用户/域名/公开三种粒度，角色涵盖 reader/commenter/writer |
认证架构
采用系统密钥环存储（macOS Keychain/Windows Credential/Linux Secret Service），浏览器登录一次后凭证持久化。可选 PE_API_KEY 环境变量覆盖，适配 CI/CD 场景。
显著优点
1. AI 原生设计：-jc 输出相比标准 Google Drive API 减少 60%+ token，字段裁剪精准
2. 安全凭证管理：不暴露 token 到 shell history 或环境变量（除非显式设置）
3. 统一文件 ID 格式：强制 google: 前缀，避免跨云（未来支持 SharePoint/OneDrive 时）混淆
4. 智能内容路由：content 命令自动识别 Google Sheets/Slides 并引导至专用命令，避免格式错乱
潜在缺点与局限
| 问题 | 说明 |
|------|------|
| 生态依赖 | 必须安装 `porteden` CLI（Homebrew 或 Go install），非纯 API 方案 |
| 二进制限制 | 内联 `create` 仅支持 UTF-8 文本，大文件必须用 `upload` |
| 文件夹复制受限 | 返回 `PROVIDER_ERROR`，需手动递归实现 |
| SharePoint 未支持 | `copy` 等命令对 SharePoint 文件返回 `NOT_SUPPORTED` |
| 分页安全上限 | `--all` 自动分页硬编码 50 页上限，超大数据集需手动处理 |
适合人群
- AI 开发与自动化：需要结构化、低噪音的 Drive 数据接入 LLM 工作流
- DevOps/SRE：基础设施即代码场景下的 Drive 资源管理
- 安全敏感企业：要求凭证不落盘、不泄露到进程列表的团队
常规风险
- 权限扩散：
share --type anyone易产生公开链接，需二次确认 - 删除不可逆性：
delete进入回收站（可恢复），但-y标志跳过确认需警惕 - Token 范围泄露：
accessInfo字段需监控，确保copy_file等敏感权限按需分配