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

3.1 KiB

Raw Blame History

lark-wiki +node-list

List wiki nodes in a space or under a specific parent node. Default fetches a single page (large knowledge bases can have thousands of nodes — opt into --page-all explicitly with an eye on --page-limit).

Usage

# Default: single page of root nodes
lark-cli wiki +node-list --space-id <SPACE_ID>

# Drill into a sub-directory (still single page by default)
lark-cli wiki +node-list --space-id <SPACE_ID> --parent-node-token <NODE_TOKEN>

# Personal document library (user identity only)
lark-cli wiki +node-list --space-id my_library --as user

# Walk every page (capped by --page-limit, default 10)
lark-cli wiki +node-list --space-id <SPACE_ID> --page-all

# Walk every page with a higher cap
lark-cli wiki +node-list --space-id <SPACE_ID> --page-all --page-limit 30

# Resume from a cursor
lark-cli wiki +node-list --space-id <SPACE_ID> --page-token <TOKEN>

# Pretty / table output
lark-cli wiki +node-list --space-id <SPACE_ID> --format pretty

Flags

Flag	Type	Required	Default	Description
`--space-id`	string	Yes	—	Wiki space ID. Use `my_library` for personal document library (user only)
`--parent-node-token`	string	No	—	Parent node token; omit to list the space root
`--page-size`	int	No	50	Page size, 1-50
`--page-token`	string	No	—	Page cursor; implies single-page fetch (no auto-pagination)
`--page-all`	bool	No	`false`	Automatically paginate through all pages (capped by `--page-limit`)
`--page-limit`	int	No	10	Max pages with `--page-all` (0 = unlimited)
`--format`	enum	No	`json`	`json` / `pretty` / `table` / `csv` / `ndjson`
`--as`	enum	No	`auto`	Identity `user`/`bot`; wiki is user-centric → pass `--as user` (`my_library` requires `--as user`)

Output

{
  "ok": true,
  "data": {
    "nodes": [
      {
        "space_id": "6946843325487912356",
        "node_token": "wikcn_EXAMPLE_TOKEN",
        "obj_token": "doccn_EXAMPLE_TOKEN",
        "obj_type": "docx",
        "parent_node_token": "",
        "node_type": "origin",
        "title": "Getting Started",
        "has_child": true
      }
    ],
    "has_more": false,
    "page_token": ""
  },
  "meta": { "count": 1 }
}

When the default single-page fetch (or --page-all capped by --page-limit) does not exhaust the upstream cursor, has_more=true and page_token=<cursor> so the caller can resume via --page-token or by increasing --page-limit.

Traverse the wiki tree

To list all content recursively, call +node-list again with each node's node_token as --parent-node-token when has_child is true.

# Step 1: list root nodes
lark-cli wiki +node-list --space-id 6946843325487912356

# Step 2: drill into a node that has children
lark-cli wiki +node-list --space-id 6946843325487912356 --parent-node-token wikcn_EXAMPLE_TOKEN

Notes

--space-id my_library is a per-user alias and only valid with --as user. The shortcut will refuse --as bot with my_library upfront.

Required Scope

wiki:node:retrieve

3.1 KiB Raw Blame History