ooodc/PicoBot
1
0
Fork 0
Code Pull Requests Activity
PicoBot/.agents/skills/lark-drive/references/lark-drive-preview.md
ooodc a7883dbed9 refactor(todo): 重构待办事项管理逻辑及更新状态规则 
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id，且由用户负责生成
- 修改合并模式逻辑，merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress）
- 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled
- 优化状态转换校验，允许特定状态间合法切换
- 简化任务变更消息，移除详细的新增/更新/移除统计
- 更新文档和示例，明确 id 必须由用户生成和使用
- 修复和补充测试，增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑，统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
2026-06-13 09:22:33 +08:00

2.4 KiB
Raw Blame History

drive +preview

前置条件： 先阅读 ../lark-shared/SKILL.md 了解认证、权限处理和安全规则。

列出或下载 Drive 文件可用的预览产物。这个 shortcut 不猜测默认类型：

  • 只想看候选项时，用 --list-only
  • 想下载时，必须显式传 --type 和 --output
  • 如果某个候选项还在生成中，会返回结构化错误并提示先重新 --list-only

命令

# 列出可用预览候选项
lark-cli drive +preview \
  --file-token "<FILE_TOKEN>" \
  --list-only

# 下载 PDF 预览
lark-cli drive +preview \
  --file-token "<FILE_TOKEN>" \
  --type pdf \
  --output ./artifacts/report

# 下载文本预览，并在目标已存在时自动改名
lark-cli drive +preview \
  --file-token "<FILE_TOKEN>" \
  --type text \
  --output ./artifacts/report \
  --if-exists rename

# 指定版本号查询/下载
lark-cli drive +preview \
  --file-token "<FILE_TOKEN>" \
  --version "12" \
  --type html \
  --output ./artifacts/report.html

参数

参数 必填 说明
--file-token 是 Drive 文件 token
--type 条件必填 预览类型；优先使用 --list-only 返回的 type，如 pdf / html / text / png / jpg / source_file
--version 否 文件版本号
--list-only 否 仅返回候选项，不下载
--output 条件必填 下载到本地的输出路径
--if-exists 否 输出冲突策略：error（默认）/ overwrite / rename

输出约定

  • 查询态返回：
    • mode=list
    • file_token
    • candidates[]
    • next_action
  • 下载态返回：
    • mode=download
    • file_token
    • selected_type
    • output_path
    • status

候选项字段

candidates[] 中每个对象包含：

  • type
  • type_code
  • label
  • status
  • status_code
  • downloadable
  • reason（可选）

关键约束

  • 不传 --list-only 时，必须显式传 --type 和 --output
  • 不会隐式选择“第一个候选项”作为默认下载目标
  • 候选项状态来自后端 preview_status 枚举，例如 READY / PROCESSING / FAILED / NO_SUPPORT
  • 本地文件名在未显式带扩展名时，会结合响应头自动补扩展名

参考