PicoBot/.qoder/skills/lark-drive/references/lark-drive-secure-label.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

1.9 KiB
Raw Blame History

drive +secure-label-list / +secure-label-update云文档密级标签

何时使用

  • drive +secure-label-list:查询当前用户可用的密级标签,先拿到目标 id
  • drive +secure-label-update:把目标云文档调整为指定密级标签。

这两个 shortcut 都使用用户身份(--as user)。修改密级前,通常先执行 +secure-label-list 确认可用标签 ID。

查询可用密级标签

lark-cli drive +secure-label-list --page-size 10 --lang zh

可选参数:

参数 说明
--page-size 分页大小,范围 1..10,默认 10
--page-token 上一页响应里的 page_token
--lang 标签语言:zhenja

底层接口:GET /open-apis/drive/v2/my_secure_labels

修改文档密级

lark-cli drive +secure-label-update \
  --token "https://example.feishu.cn/docx/doxcnxxxx" \
  --label-id "7217780879644737539"

参数:

参数 说明
--token 目标文档 URL 或 bare tokenURL 可自动推断 --type
--type bare token 必填URL 输入时可省略。可选:docdocxsheetfilebitablemindnoteslides
--label-id 要设置的密级标签 ID

底层接口:PATCH /open-apis/drive/v2/files/:file_token/secure_labelquery 参数 type,请求体 { "id": "<label-id>" }

错误处理

CLI 不会在 shortcut 中为密级错误码追加专用 hintagent 必须根据返回的 error.code 做以下引导。

错误码 含义 引导
1063013 密级降级需要审批 提示用户打开目标文档,在文档界面完成密级降级审批后重试;如果用户传入的是文档 URL必须把该 URL 一并给用户作为操作入口

遇到 1063013 时,不要继续重试 API也不要提示补 scope这是文档侧审批流程要求需要用户到文档里操作。