PicoBot/.agents/skills/lark-wiki/references/lark-wiki-space-list.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.2 KiB

lark-wiki +space-list

List wiki spaces accessible to the caller. Default fetches a single page (matches the rest of the CLI's list shortcuts); pass --page-all to walk every page.

Usage

# Default: single page (first up to --page-size items)
lark-cli wiki +space-list

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

# Walk every page, no cap (use with care if you have many spaces)
lark-cli wiki +space-list --page-all --page-limit 0

# Resume from a specific cursor (single-page fetch regardless of --page-all)
lark-cli wiki +space-list --page-token <TOKEN>

# Pretty / table / csv / ndjson output
lark-cli wiki +space-list --format pretty
lark-cli wiki +space-list --format table

Flags

Flag Type Default Description
--page-size int 50 Page size, 1-50
--page-token string Page cursor; implies single-page fetch (no auto-pagination)
--page-all bool false Automatically paginate through all pages (capped by --page-limit)
--page-limit int 10 Max pages with --page-all (0 = unlimited)
--format enum json json / pretty / table / csv / ndjson
--as enum auto Identity user/bot; wiki is user-centric → pass --as user

Output

{
  "ok": true,
  "data": {
    "spaces": [
      {
        "space_id": "6946843325487912356",
        "name": "Engineering Wiki",
        "description": "...",
        "space_type": "team",
        "visibility": "private",
        "open_sharing": "closed"
      }
    ],
    "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.

Notes

  • The underlying API never returns the my_library personal library; resolve it via lark-cli wiki spaces get --params '{"space_id":"my_library"}'.
  • Use space_id from the output as --space-id for +node-list or +node-copy.

Required Scope

wiki:space:retrieve