PicoBot/skills/lark-shared/references/lark-wiki-token-routing.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

2.0 KiB
Raw Blame History

Wiki token routing

Wiki URL 中的 /wiki/<token> 是节点 token不一定是底层文档、表格、Base、文件或幻灯片的对象 token。需要对底层对象做读取、评论、导出、下载、表内操作等动作时先解包再按底层类型路由。

推荐方式

优先使用 lark-drivedrive +inspect

lark-cli drive +inspect --url 'https://xxx.feishu.cn/wiki/<wiki_token>'

输出中的 type 是底层对象类型,token 是后续命令应使用的 canonical token。wiki_node 字段保留节点侧信息,如 space_idnode_tokenobj_tokenobj_type

手动方式

如果不能使用 shortcut再调用 Wiki 节点接口:

lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}'

从返回值中读取:

字段 含义
node.obj_type 底层对象类型,如 docxdocsheetbitableslidesfilemindnote
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