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.5 KiB

Raw Blame History

lark-wiki +node-get

Get a wiki node's details by node_token, obj_token, or a Lark URL. Use this as the "what am I about to touch?" step before +move / +node-copy / +node-delete.

Usage

lark-cli wiki +node-get \
  --node-token <node_token | obj_token | Lark URL> \
  [--obj-type <doc|docx|sheet|bitable|mindnote|slides|file>] \
  [--space-id <space_id>] \
  [--format json|pretty|table|csv|ndjson] \
  [--as user|bot]

Flags

Flag	Type	Required	Default	Description
`--node-token`	string	Yes	—	`node_token`, cloud-doc `obj_token`, or a Lark URL embedding one (e.g. `https://feishu.cn/wiki/<token>` or `https://feishu.cn/docx/<token>`). Matches the `--node-token` naming used by sibling `+node-delete` / `+node-copy` / `+move`.
`--token`	string	— (deprecated)	—	Deprecated original name; still accepted for backward compatibility but emits a `Flag --token has been deprecated, use --node-token instead` warning on stderr. New scripts should use `--node-token`.
`--obj-type`	enum	No	—	Needed when `--node-token` is a raw `obj_token`; auto-inferred from the URL path. Not allowed when the token looks like a `node_token` (`wik...`)
`--space-id`	string	No	—	Optional cross-check: fail if the resolved node does not live in this space
`--format`	enum	No	`json`	`json` / `pretty` / `table` / `csv` / `ndjson`
`--as`	enum	No	`auto`	Identity `user`/`bot`; wiki is user-centric → pass `--as user`

Output

{
  "space_id": "7160145948494381236",
  "node_token": "wikcnEXAMPLE",
  "obj_token": "docxEXAMPLE",
  "obj_type": "docx",
  "node_type": "origin",
  "parent_node_token": "wikcnPARENT",
  "origin_node_token": "",
  "title": "Design Spec",
  "has_child": true,
  "creator": "ou_xxx",
  "owner": "ou_yyy",
  "obj_edit_time": "1700000000",
  "obj_create_time": "1690000000",
  "node_create_time": "1690000001",
  "updated_at": "2023-11-14T22:13:20Z"
}

Notes

The underlying API is GET /open-apis/wiki/v2/spaces/get_node. For a node_token no obj_type is sent; for an obj_token the obj_type (explicit or URL-inferred) is required.
creator falls back to creator when node_creator is absent. updated_at is obj_edit_time formatted as RFC3339.
No url is returned: get_node does not provide one and a synthesized www.feishu.cn/wiki/<node_token> link is non-canonical/misleading for a read command. Use node_token / obj_token as the identifiers.

Required Scope

wiki:node:retrieve

2.5 KiB Raw Blame History