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

3.6 KiB

Raw Blame History

drive +create-folder（创建云空间/云盘/云存储文件夹）

前置条件： 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

在飞书云空间（云盘/云存储）中创建一个新文件夹。该 shortcut 对原生 drive files create_folder 做了一层更适合日常使用的封装：--folder-token 可省略，此时会在调用者根目录创建；如果使用 --as bot，创建成功后 CLI 会尝试把新文件夹的可管理权限自动授予当前 CLI 用户。

命令

# 在根目录创建文件夹
lark-cli drive +create-folder \
  --name "周报归档"

# 在指定父文件夹下创建子文件夹
lark-cli drive +create-folder \
  --folder-token <PARENT_FOLDER_TOKEN> \
  --name "2026-W16"

# 预览底层调用
lark-cli drive +create-folder \
  --folder-token <PARENT_FOLDER_TOKEN> \
  --name "分析资料" \
  --dry-run

返回值

成功后会返回一个 JSON 对象，常见字段包括：

folder_token：新建文件夹 token，可直接用于后续 drive +move、drive +upload 等命令
url：新建文件夹链接（如果接口返回）
name：文件夹名称
parent_folder_token：父文件夹 token；为空字符串表示创建在根目录
permission_grant（可选）：仅 --as bot 时返回，说明是否已自动为当前 CLI 用户授予可管理权限

Important

如果文件夹是以应用身份（bot）创建的，如 lark-cli drive +create-folder --as bot，在创建成功后 CLI 会尝试为当前 CLI 用户自动授予该文件夹的 full_access（可管理权限）。

以应用身份创建时，结果里会额外返回 permission_grant 字段，明确说明授权结果：

status = granted：当前 CLI 用户已获得该文件夹的可管理权限

status = skipped：本地没有可用的当前用户 open_id，因此不会自动授权；可提示用户先完成 lark-cli auth login，再让 AI / agent 继续使用应用身份（bot）授予当前用户权限

status = failed：文件夹已创建成功，但自动授权用户失败；会带上失败原因，并提示稍后重试或继续使用 bot 身份处理该文件夹

permission_grant.perm = full_access 表示该资源已授予“可管理权限”。

不要擅自执行 owner 转移。 如果用户需要把 owner 转给自己，必须单独确认。

参数

参数	必填	说明
`--name`	是	文件夹名称，不能为空，最长 256 字节
`--folder-token`	否	父文件夹 token；省略时表示在调用者根目录创建

行为说明

根目录创建：不传 --folder-token 时，shortcut 会向 API 显式传空字符串 folder_token=""，让后端按“根目录”语义创建
bot 自动授权：只有在 --as bot 时，结果才会额外带上 permission_grant
原生 API 仍可用：如果用户明确要求按底层 API 字段调用，仍可继续使用 lark-cli drive files create_folder

参考

lark-drive -- 云空间（云盘/云存储）全部命令
lark-shared -- 认证和全局参数

3.6 KiB Raw Blame History Unescape Escape

drive +create-folder（创建云空间/云盘/云存储文件夹）

命令

返回值

参数

行为说明

推荐场景

参考

3.6 KiB

Raw Blame History