ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
# task +search
|
|
|
|
> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
|
|
>
|
|
> **⚠️ Note:** This API must be called with a user identity. **Do NOT use an app identity, otherwise the call will fail.**
|
|
|
|
Search tasks by keyword and optional filters.
|
|
|
|
## Recommended Commands
|
|
|
|
```bash
|
|
# Search by keyword
|
|
lark-cli task +search --query "test"
|
|
|
|
# Search incomplete tasks assigned to specific users
|
|
lark-cli task +search --assignee "ou_xxx,ou_yyy" --completed=false
|
|
|
|
# Search by due time range
|
|
lark-cli task +search --query "release" --due "-1d,+7d"
|
|
```
|
|
|
|
## Parameters
|
|
|
|
| Parameter | Required | Description |
|
|
|-----------|----------|-------------|
|
|
| `--query <string>` | No | Search keyword. If omitted, at least one filter must be provided. |
|
|
| `--creator <ids>` | No | Creator open_ids, comma-separated. |
|
|
| `--assignee <ids>` | No | Assignee open_ids, comma-separated. |
|
|
| `--follower <ids>` | No | Follower open_ids, comma-separated. |
|
|
| `--completed=<bool>` | No | Filter by completion state. |
|
|
| `--due <range>` | No | Due time range in `start,end` form. Each side supports ISO/date/relative/ms input. |
|
|
| `--page-token <string>` | No | Page token for pagination. |
|
|
| `--page-all` | No | Automatically paginate through all pages (max 40). |
|
|
| `--page-limit <int>` | No | Max page limit (default 20). |
|
|
|
|
## Workflow
|
|
|
|
1. Build the keyword and filters from the user's request.
|
|
2. Execute `lark-cli task +search ...`
|
|
3. Report the matched tasks and include the next `page_token` if more results exist.
|
|
|