PicoBot/.agents/skills/lark-markdown/references/lark-markdown-fetch.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

80 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# markdown +fetch
> **前置条件:** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
读取 Drive 中原生 Markdown 文件的内容;也支持把内容保存到本地。
## 命令
```bash
# 直接返回 Markdown 文本
lark-cli markdown +fetch --file-token boxcnxxxx
# 保存到本地
lark-cli markdown +fetch \
--file-token boxcnxxxx \
--output ./README.md
# 传目录时,使用远端文件名保存到该目录下
lark-cli markdown +fetch \
--file-token boxcnxxxx \
--output ./downloads/
# 覆盖已存在文件
lark-cli markdown +fetch \
--file-token boxcnxxxx \
--output ./README.md \
--overwrite
# 预览底层请求
lark-cli markdown +fetch \
--file-token boxcnxxxx \
--output ./README.md \
--dry-run
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--file-token` | 是 | 目标 Markdown 文件 token |
| `--output` | 否 | 本地保存路径;既可传具体文件名,也可传目录路径。传目录时使用远端文件名保存;省略时直接返回 Markdown 内容 |
| `--overwrite` | 否 | 覆盖已存在的本地输出文件;仅在传入 `--output` 时生效 |
## 返回值
不传 `--output`
```json
{
"ok": true,
"identity": "user",
"data": {
"file_token": "boxcnxxxx",
"file_name": "README.md",
"content": "# Hello\n",
"size_bytes": 8
}
}
```
传入 `--output`
```json
{
"ok": true,
"identity": "user",
"data": {
"file_token": "boxcnxxxx",
"file_name": "README.md",
"saved_path": "/abs/path/README.md",
"size_bytes": 8
}
}
```
## 参考
- [lark-markdown](../SKILL.md) — Markdown 域总览
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数