ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
51 lines
1.8 KiB
Markdown
51 lines
1.8 KiB
Markdown
|
||
# drive +inspect（文档 URL 检视：类型、标题、Token 解析）
|
||
|
||
> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
|
||
|
||
给定一个飞书文档 URL 或 bare token，返回其类型、标题和 canonical token。对 wiki URL 自动解包到底层文档。
|
||
|
||
## 命令
|
||
|
||
```bash
|
||
# 检视一个 docx URL
|
||
lark-cli drive +inspect --url 'https://xxx.feishu.cn/docx/doxcnXXX'
|
||
|
||
# 检视一个 wiki URL（自动解包到底层文档）
|
||
lark-cli drive +inspect --url 'https://xxx.feishu.cn/wiki/wikcnXXX'
|
||
|
||
# bare token 需要指定 --type
|
||
lark-cli drive +inspect --url doxcnXXX --type docx
|
||
|
||
# 格式化输出
|
||
lark-cli drive +inspect --url 'https://xxx.feishu.cn/base/bascnXXX' --format pretty
|
||
```
|
||
|
||
## 输出
|
||
|
||
JSON 输出包含以下字段：
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `input_url` | 原始输入 URL |
|
||
| `type` | 文档类型（docx, doc, sheet, bitable, wiki, file, folder, mindnote, slides） |
|
||
| `title` | 文档标题 |
|
||
| `token` | canonical file token |
|
||
| `url` | 重建的 canonical URL |
|
||
| `wiki_node` | 仅 wiki URL：包含 `space_id`, `node_token`, `obj_token`, `obj_type` |
|
||
|
||
## 典型场景
|
||
|
||
| 场景 | 命令 |
|
||
|------|------|
|
||
| 用户给了一个 URL，想知道它是什么类型的文档 | `lark-cli drive +inspect --url '<url>'` |
|
||
| wiki 链接需要拿到底层文档的 token 来做后续操作 | `lark-cli drive +inspect --url '<wiki_url>'`，取输出中的 `token` |
|
||
| 只有 token 没有 URL | `lark-cli drive +inspect --url <token> --type <type>` |
|
||
|
||
## 注意事项
|
||
|
||
- `--url` 为必填参数
|
||
- 当 `--url` 是 bare token（非完整 URL）时，`--type` 也是必填的
|
||
- wiki URL 会自动调用 `get_node` API 解包，输出中 `type` 和 `token` 是底层文档的类型和 token
|
||
- 支持 `--dry-run` 查看将调用的 API 步骤
|