Lark Todo

bash "<SKILL_DIR>/scripts/bootstrap.sh"

lark-cli --version 2>/dev/null \
  || { echo "[lark-todo] 未找到 lark-cli。请执行：npm install -g @larksuite/cli（需 Node.js >= 18）" >&2; exit 1; }

Step A: 读取 ~/.lark-cli/config.json，检查 apps 数组
         │
         ├─ apps 数组非空 → 提取所有 appId，构建 PROFILES 列表，进入 Step B
         └─ apps 数组为空 或文件不存在 → 需要首次配置，执行 Step A1
                                           │
                                           ▼
                   Step A1: lark-cli config init --new（background 执行）
                            → 启动后立即读取输出，提取配置链接发给用户
                            → 等待 background 任务完成通知（不要让用户手动确认）
                            → 收到完成通知后重新读取 config.json 构建 PROFILES 列表
                            → 进入 Step B

Step B: 对 PROFILES 列表中的每个 profile 检查授权状态
         │
         对每个 <PROFILE>：lark-cli auth status --profile <PROFILE>
         │
         ├─ identity=user → 该 profile 就绪，记录 userName 作为企业标签
         └─ identity=bot（"No user logged in"）→ 需要用户授权，执行 Step B1
                                                   │
                                                   ▼
                   Step B1: lark-cli auth login --profile <PROFILE> --domain im,vc,drive,docs,task,approval,calendar,mail,contact,minutes,wiki
                            （background 执行）
                            → 启动后立即读取输出，提取授权链接发给用户
                            → 等待 background 任务完成通知（不要让用户手动确认）
                            → 收到完成通知后继续检查下一个 profile
         │
         所有 profile 检查完成后，构建最终扫描列表 ACTIVE_PROFILES：
         [
           { profile: "<appId>", userName: "张三", brand: "feishu" },
           { profile: "<appId>", userName: "李四", brand: "feishu" },
           ...
         ]
         │
         ├─ ACTIVE_PROFILES 为空 → 所有 profile 授权均失败，终止并告知用户
         ├─ ACTIVE_PROFILES 仅 1 个 → 单账号模式（行为与旧版一致，输出不带企业标签）
         └─ ACTIVE_PROFILES >= 2 个 → 多账号模式（输出带企业标签）
         │
         进入 Step B2

Step B2: 权限预检与降级标记
         │
         对每个就绪的 profile，执行：
         │
         lark-cli auth status --verify --profile <PROFILE> --format json
         │
         从返回 JSON 中提取 `scope` 字段（空格分隔的已授权 scope 列表），构建 PERMISSION_MAP。
         所需 scope 与数据源映射如下：
         │
         | 数据源 | 关键 scope |
         |--------|-----------|
         | IM 消息 | `search:message` |
         | 会议纪要 | `vc:meeting.search:read` |
         | 日程 | `calendar:calendar.event:read` |
         | 文档评论 | `search:docs:read` + `docs:document.comment:read` |
         | 待办审批 | `approval:task:read` |
         | 我发起的审批 | `approval:task:read` |
         | 任务 | `task:task:read` |
         | 邮件 | `mail:user_mailbox.message:readonly` |
         │
         只要关键 scope 中**任意一个**存在于 `scope` 列表中，即标记该数据源为可用（`true`）。
         缺失则标记为不可用（`false`），扫描时直接跳过，不发起无效调用。
         │
         此步骤目的：避免扫描阶段因权限不足反复报错，减少无效 API 调用，提升扫描速度。
         权限缺失的数据源在最终报告中统一标注为「[数据源名] 权限未开通」，并附带授权命令供用户参考。
         │
         进入 Step C

Step C: 白名单预检（仅在当前 Agent 支持 shell 命令白名单时执行）
         │
         本 skill 会在一次扫描里调用数十次 lark-cli，如果每次都弹确认框，用户体验很差。
         如果当前 Agent 允许把 shell 命令加入白名单（例如 Claude Code 有
         ~/.claude/settings.json 的 permissions.allow 机制），尝试检查并添加；
         不支持白名单机制的 Agent 直接跳过此步。
         │
         对 Claude Code：读取 ~/.claude/settings.json，检查 permissions.allow 是否已包含
         "Bash(lark-cli *)"；未包含则询问用户："本技能会频繁调用 lark-cli，建议加入白名单
         避免反复弹确认。是否允许我添加？"——用户同意后追加即可。
         │
         对其他 Agent：如果不确定白名单机制，直接跳过进入采集阶段。skill 能跑，只是每条
         命令可能要点一次确认——这是能接受的降级体验。

# 探测是否可用加速模式（任一步失败都降级到纯 SKILL.md 流程）
python3 --version 2>/dev/null || python --version 2>/dev/null
test -f "<SKILL_DIR>/scripts/scan.py"

python "<SKILL_DIR>/scripts/scan.py" \
  --profiles-json '[{"profile":"cli_xxx","open_id":"ou_xxx","name":"张三"},{"profile":"cli_yyy","open_id":"ou_yyy","name":"Sam Zhang"}]' \
  --mode full

# 增量扫描：
python "<SKILL_DIR>/scripts/scan.py" \
  --profiles-json '...' --mode incremental --since "2026-04-21T12:00:00+08:00"

# 并发调优（可选，默认 10）：profile 数多或本机资源紧张时下调，
# 资源充裕且 lark-cli 未触发限流时可上调
python "<SKILL_DIR>/scripts/scan.py" \
  --profiles-json '...' --mode full --concurrency 6

{
  "mode": "full",
  "scan_start": "2026-04-21T00:00:00+08:00",
  "scan_end":   "2026-04-21T23:59:59+08:00",
  "today":      "2026-04-21",
  "profiles": [
    {
      "profile": "cli_xxx",
      "user_name": "张三",
      "open_id": "ou_xxx",
      "sources": {
        "im":                 { "ok": true, "data": { ... } },
        "vc_search":          { "ok": true, "data": { ... } },
        "calendar":           { "ok": true, "data": { ... } },
        "docs_mine":          { "ok": true, "data": { ... } },
        "docs_at_me":         { "ok": true, "data": { ... } },
        "approval_pending":   { "ok": true, "data": { ... } },
        "approval_initiated": { "ok": true, "data": { ... } },
        "tasks":              { "ok": true, "data": { ... } },
        "mail":               { "ok": false, "error": "timeout" }
      }
    }
  ]
}

# 创建新的命名 profile（background 执行）
lark-cli config init --new --name <用户指定的名称或自动用appId>

lark-cli auth login --profile <新PROFILE> --domain im,vc,drive,docs,task,approval,calendar,mail,contact,minutes,wiki

# 读取 config.json 列出所有 apps
# 对每个 appId 执行 auth status --profile <appId> 获取 userName 和 tokenStatus
lark-cli auth list

已配置 2 个企业账号：
1. 张三 (cli_a901...dcd5) — 已授权，token 有效
2. Sam Zhang (cli_b702...ece6) — 已授权，token 需刷新（自动刷新）

lark-cli config remove --profile <PROFILE>

lark-cli auth login --profile <PROFILE> --scope "<missing_scope>"

阶段一：采集                    阶段二：研判             阶段三：行动
┌─────────────────────┐     ┌───────────────┐     ┌──────────────┐
│ 每个 profile 各跑    │     │ 企业内去重+    │     │ 路由到对应    │
│ 8 个数据源并行扫描   │ ──► │ 优先级+日程关联 │ ──► │ profile 执行  │
│ （多 profile 也并行） │     │ 跨企业标注来源  │     │ 直接处理或建任务│
└─────────────────────┘     └───────────────┘     └──────────────┘

# 获取当前日期（后续所有 <TODAY> 占位符用此值替换）
date +%Y-%m-%d

# 获取每个 profile 的用户信息（多账号时对每个 PROFILE 分别执行）
lark-cli contact +get-user --profile <PROFILE> --format json

Profile A: [IM] [会议] [日程] [文档] [待办审批] [我发起的审批] [任务] [邮件]  ← 8 个并行
Profile B: [IM] [会议] [日程] [文档] [待办审批] [我发起的审批] [任务] [邮件]  ← 8 个并行
↑ 两个 profile 之间也并行