ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
43 lines
2.0 KiB
Markdown
43 lines
2.0 KiB
Markdown
# Wiki token routing
|
||
|
||
Wiki URL 中的 `/wiki/<token>` 是节点 token，不一定是底层文档、表格、Base、文件或幻灯片的对象 token。需要对底层对象做读取、评论、导出、下载、表内操作等动作时，先解包，再按底层类型路由。
|
||
|
||
## 推荐方式
|
||
|
||
优先使用 `lark-drive` 的 `drive +inspect`：
|
||
|
||
```bash
|
||
lark-cli drive +inspect --url 'https://xxx.feishu.cn/wiki/<wiki_token>'
|
||
```
|
||
|
||
输出中的 `type` 是底层对象类型，`token` 是后续命令应使用的 canonical token。`wiki_node` 字段保留节点侧信息，如 `space_id`、`node_token`、`obj_token`、`obj_type`。
|
||
|
||
## 手动方式
|
||
|
||
如果不能使用 shortcut，再调用 Wiki 节点接口：
|
||
|
||
```bash
|
||
lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}'
|
||
```
|
||
|
||
从返回值中读取：
|
||
|
||
| 字段 | 含义 |
|
||
|------|------|
|
||
| `node.obj_type` | 底层对象类型，如 `docx`、`doc`、`sheet`、`bitable`、`slides`、`file`、`mindnote` |
|
||
| `node.obj_token` | 底层对象 token，用于对应业务 skill 或原生 API |
|
||
| `node.node_token` / `token` | Wiki 节点 token，用于 Wiki 节点层级操作 |
|
||
| `node.space_id` | 所属知识空间 |
|
||
|
||
## 路由
|
||
|
||
| `obj_type` | 后续操作 |
|
||
|------------|----------|
|
||
| `docx` / `doc` | 文档内容走 `lark-doc`；评论、权限、导出等云空间能力走 `lark-drive` |
|
||
| `sheet` | 表内数据走 `lark-sheets`；评论、权限、导出等云空间能力走 `lark-drive` |
|
||
| `bitable` | 表内数据走 `lark-base`；评论、权限、导出等云空间能力走 `lark-drive` |
|
||
| `slides` | 幻灯片内容编辑走 `lark-slides`；评论、权限、导出等云空间能力走 `lark-drive` |
|
||
| `file` | 普通文件上传、下载、评论、权限等走 `lark-drive` |
|
||
| `mindnote` | 思维笔记的移动、删除、快捷方式、权限、安全标签等云空间能力走 `lark-drive`；知识库节点层级操作走 `lark-wiki` |
|
||
| wiki 节点层级 / 空间成员 | 走 `lark-wiki`，不要把底层对象 token 当节点 token |
|