porteden

使用 porteden 管理多个账户的日历和邮件。请使用 -jc 参数 获取 AI 优化的输出结果。

若尚未安装 porteden：运行 brew install porteden/tap/porteden（或 go install github.com/porteden/cli/cmd/porteden@latest）。

初始化配置（仅需一次）

• 浏览器登录（推荐）： porteden auth login — 自动打开浏览器，凭据将安全存储于系统密钥环中
• 直接传入令牌： porteden auth login --token — 令牌将存储于系统密钥环中
• 验证登录状态： porteden auth status
• 若环境变量中已设置 PE_API_KEY，CLI 将自动使用该密钥（无需额外登录）。

日历命令

• 列出所有日历：porteden calendar calendars -jc
• 查看今日事件（支持 --tomorrow、--week）：porteden calendar events --today -jc
• 自定义时间范围查询事件：porteden calendar events --from 2026-02-01 --to 2026-02-07 -jc
• 获取一周内全部事件（自动分页）：porteden calendar events --week --all -jc
• 搜索事件：porteden calendar events -q "meeting" --today -jc
• 按联系人查询事件：porteden calendar by-contact "user@example.com" -jc（也可使用 --name "John Smith"）
• 获取单个事件详情：porteden calendar event -jc
• 创建新事件：porteden calendar create --calendar --summary "Meeting" --from "..." --to "..." --location "Room A" --attendees "a@b.com,c@d.com"
• 更新事件：porteden calendar update --summary "New Title"（还可指定 --from、--to、--location）
• 更新与会者：porteden calendar update --add-attendees "new@example.com"（也可使用 --remove-attendees；添加 --notify 可向与会者发送通知）
• 删除事件：porteden calendar delete （添加 --no-notify 可跳过向与会者发送通知）
• 响应邀请：porteden calendar respond accepted（可选值：declined、tentative）

事件状态值说明

• confirmed — 已接受/已安排
• tentative — 待定（可能参加）
• needsAction — 需用户响应
• cancelled — 事件已取消

时间格式说明

• 所有时间均采用 RFC3339 UTC 格式：2026-02-01T10:00:00Z
• 全天事件请使用午夜至午夜的时间范围，并配合 --all-day 参数
• JSON 输出中包含 startUtc、endUtc 和 durationMinutes 字段

邮件命令

使用 porteden email（别名：porteden mail）管理邮件。

• 列出邮件（支持 --today、--yesterday、--week、--days N）：porteden email messages -jc
• 按发件人筛选邮件：porteden email messages --from sender@example.com -jc（还支持 --to、--subject、--label、--unread、--has-attachment）
• 搜索邮件：porteden email messages -q "keyword" --today -jc
• 自定义日期范围：porteden email messages --after 2026-02-01 --before 2026-02-07 -jc
• 获取一周内全部邮件（自动分页）：porteden email messages --week --all -jc
• 获取单封邮件：porteden email message -jc
• 获取整封邮件线程：porteden email thread -jc
• 发送邮件：porteden email send --to user@example.com --subject "Hi" --body "Hello"（还支持 --cc、--bcc、--body-file、--body-type text、--importance high）
• 使用具名收件人发送邮件：porteden email send --to "John Doe " --subject "Hi" --body "Hello"
• 回复邮件：porteden email reply --body "Thanks"（添加 --reply-all 可全部回复）
• 转发邮件：porteden email forward --to colleague@example.com（可选参数：--body "FYI"、--cc）
• 修改邮件状态：porteden email modify --mark-read（还支持 --mark-unread、--add-labels IMPORTANT、--remove-labels INBOX）
• 删除邮件：porteden email delete

注意事项

• 登录后，凭据将持久化保存在系统密钥环中，后续无需重复认证。
• 设置环境变量 PE_PROFILE=work 后，可避免重复指定 --profile 参数。
• -jc 是 --json --compact 的简写：用于过滤冗余信息、截断字段内容、减少 token 消耗。
• 使用 --all 可自动获取全部分页数据；可通过 JSON 输出中的 hasMore/nextPageToken（邮件）或 meta.hasMore/meta.totalCount（日历）判断是否还有更多数据。
• 日历手动分页方式：--limit 100 --offset 0，随后为 --offset 100，依此类推。
• by-contact 支持模糊匹配：例如使用 "@acme.com" 匹配邮箱域名，或使用 --name "Smith" 匹配姓名。
• 邮件 ID 带有提供商前缀（如 google:abc123、m365:xyz789），请原样传入。
• 对 messages 命令使用 --include-body 可获取完整正文（默认仅返回预览）；而单条 message 查询默认即包含正文。
• --body 与 --body-file 互斥；使用 --body-type text 可指定纯文本格式（默认为 HTML）。
• 发送、回复、转发或删除邮件前，系统将要求确认。
• 创建、更新或删除事件前，系统将要求确认。
• 若提示 “invalid calendar ID”，请先通过 porteden calendar calendars -jc 获取有效日历 ID。
• 支持的环境变量：PE_API_KEY、PE_PROFILE、PE_TIMEZONE、PE_FORMAT、PE_COLOR、PE_VERBOSE。