- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id,且由用户负责生成 - 修改合并模式逻辑,merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活(状态改回 pending 或 in_progress) - 禁止 in_progress 状态退回到 pending,必须标记为 completed 或 cancelled - 优化状态转换校验,允许特定状态间合法切换 - 简化任务变更消息,移除详细的新增/更新/移除统计 - 更新文档和示例,明确 id 必须由用户生成和使用 - 修复和补充测试,增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑,统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式,提升稳定性和易用性
2.2 KiB
2.2 KiB
markdown +overwrite
前置条件: 先阅读
../lark-shared/SKILL.md了解认证、全局参数和安全规则。
覆盖更新 Drive 中已有的原生 Markdown 文件,并返回覆盖后的新版本号。
命令
# 用行内内容覆盖
lark-cli markdown +overwrite \
--file-token boxcnxxxx \
--content '# Updated'
# 用本地 .md 文件覆盖
lark-cli markdown +overwrite \
--file-token boxcnxxxx \
--file ./README.md
# 覆盖内容时顺便显式指定新文件名
lark-cli markdown +overwrite \
--file-token boxcnxxxx \
--name NEW-README.md \
--content '# Updated'
# 用 --content 从本地文件读取
lark-cli markdown +overwrite \
--file-token boxcnxxxx \
--content @./README.md
# 用 stdin 覆盖
printf '# Updated\n' | \
lark-cli markdown +overwrite \
--file-token boxcnxxxx \
--content -
# 预览底层请求
lark-cli markdown +overwrite \
--file-token boxcnxxxx \
--content '# Updated' \
--dry-run
参数
| 参数 | 必填 | 说明 |
|---|---|---|
--file-token |
是 | 目标 Markdown 文件 token |
--name |
否 | 显式指定覆盖后的文件名;必须带 .md 后缀。传入时优先使用它 |
--content |
条件必填 | 新 Markdown 内容;与 --file 互斥;支持直接传字符串、@file、-(stdin) |
--file |
条件必填 | 本地 .md 文件路径;与 --content 互斥 |
关键约束
--content与--file必须二选一- 如果传了
--name,直接使用它作为覆盖后的文件名 - 如果没传
--name且使用--content,默认保留远端原文件名 - 如果没传
--name且使用--file,默认使用本地文件名 --file指向的本地文件名必须带.md后缀- 覆盖成功后 必须 返回
version
返回值
{
"ok": true,
"identity": "user",
"data": {
"file_token": "boxcnxxxx",
"file_name": "README.md",
"version": "7633658129540910621",
"size_bytes": 2048
}
}
其中:
version是覆盖写入后的新版本号size_bytes是本次覆盖后的内容大小
参考
- lark-markdown — Markdown 域总览
- lark-shared — 认证和全局参数