@zentodo/cli 0.1.6 → 0.1.7

package/skills/zentodo/references/tools.md

@@ -317,7 +317,7 @@
 
 ## `zentodo.task.completed-today`
 
-调用 /taskController/getCompletedTasks。过滤条件:syncFlag != D、taskState = 0、taskCompletedTime = today。
+调用 /taskController/getCompletedTasks。服务端根据 usrKey + date 直接过滤,不用在客户端再做一次。
 
 - **后端端点**:`POST /taskController/getCompletedTasks`
 - **所需 scope**:`read`
@@ -325,32 +325,19 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `is_templete` | boolean | 否 | 排除模板。 |
-| `sync_flag` | string | 否 | 同步标记过滤。 |
-| `task_state` | string | 否 | 已完成。 |
-| `task_completed_time` | string | 否 | 完成时间=今日。 |
-| `task_create_time_not_null` | boolean | 否 | 要求 createTime 非空。 |
+| `date` | date | 否 | 指定日期(ISO,可选)。不传则使用服务器今天。 |
 
 ## `zentodo.task.mit-list`
 
-调用 /taskController/getMitTasks。过滤条件与 PC 端 loadMitHeaderDatas() 一致。
+调用 /taskController/getMitTasks。服务端按 usrKey 过滤 isMIT=true + 未完成 + taskCreateTime<=今天。
 
 - **后端端点**:`POST /taskController/getMitTasks`
 - **所需 scope**:`read`
 - **标注**:只读=true,幂等=true,破坏性=false
 
-| 参数 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `sync_flag` | string | 否 | 同步标记过滤。 |
-| `is_templete` | boolean | 否 | 排除模板。 |
-| `task_state` | string | 否 | 未完成。 |
-| `task_create_time_not_null` | boolean | 否 | 要求 createTime 非空。 |
-| `task_create_time` | string | 否 | 到今日为止。 |
-| `is_mit` | boolean | 否 | MIT 过滤。 |
-
 ## `zentodo.task.calendar`
 
-调用 /taskController/getCalendarTaskByDate。过滤与安卓端一致(syncFlag!=D、taskState!=0、isTemplete=false、taskStartItem!=FT、taskStartItem!=垃圾箱)。
+调用 /taskController/getCalendarTaskByDate。服务端已内置过滤(未完成 + 非模板 + 非垃圾箱)。
 
 - **后端端点**:`POST /taskController/getCalendarTaskByDate`
 - **所需 scope**:`read`
@@ -360,11 +347,48 @@
 | --- | --- | --- | --- |
 | `start_date` | date | 是 | 范围起始(ISO 日期)。 |
 | `end_date` | date | 是 | 范围截止(ISO 日期)。 |
-| `sync_flag` | string | 否 | 同步标记过滤。 |
-| `task_state` | string | 否 | 未完成。 |
-| `is_templete` | boolean | 否 | 排除模板。 |
-| `task_start_item_not_1` | string | 否 | 排除 FT 项。 |
-| `task_start_item_not_2` | string | 否 | 排除垃圾箱。 |
+
+## `zentodo.task.overdue`
+
+调用 /taskController/getOverdueTasks。
+
+- **后端端点**:`POST /taskController/getOverdueTasks`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.task.inbox`
+
+调用 /taskController/getInboxTasks。
+
+- **后端端点**:`POST /taskController/getInboxTasks`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.task.search`
+
+调用 /taskController/searchTasks。服务端按 LIKE 匹配并按 latestVersion 倒序返回。
+
+- **后端端点**:`POST /taskController/searchTasks`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `keyword` | string | 是 | 关键字。 |
+| `limit` | integer | 否 | 最多返回多少条(默认 50,最大 500)。 |
+
+## `zentodo.task.stats`
+
+调用 /taskController/getTaskStats。返回 { created, completed, completion_rate, by_project }。
+
+- **后端端点**:`POST /taskController/getTaskStats`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `start_date` | date | 否 | 起始日期(ISO,可选)。不传则今天。 |
+| `end_date` | date | 否 | 截止日期(ISO,可选)。不传则今天。 |
 
 ## `zentodo.task.move`
 
@@ -475,6 +499,47 @@
 - **所需 scope**:`read`
 - **标注**:只读=true,幂等=true,破坏性=false
 
+## `zentodo.project.list-active`
+
+调用 /projectController/getActiveProjects。
+
+- **后端端点**:`POST /projectController/getActiveProjects`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.project.list-archived`
+
+调用 /projectController/getArchivedProjects。projectState in (2,3,4)。
+
+- **后端端点**:`POST /projectController/getArchivedProjects`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.project.search`
+
+调用 /projectController/searchProjects。
+
+- **后端端点**:`POST /projectController/searchProjects`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `keyword` | string | 是 | 关键字。 |
+| `limit` | integer | 否 | 最多返回多少条(默认 50,最大 500)。 |
+
+## `zentodo.project.stats`
+
+调用 /projectController/getProjectStats。返回 { task_count, done_task_count, progress, exec_time_ms, state }。
+
+- **后端端点**:`POST /projectController/getProjectStats`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `project_key` | integer | 是 | 项目 projectKey。 |
+
 ## `zentodo.project.sync-pull`
 
 调用 /projectController/getSyncProjectList。
@@ -842,6 +907,19 @@
 - **所需 scope**:`read`
 - **标注**:只读=true,幂等=true,破坏性=false
 
+## `zentodo.pomo.focus-stats`
+
+调用 /tomatoWorkerController/getFocusStats。返回 { sessions, total_sec, total_hours, by_task }。
+
+- **后端端点**:`POST /tomatoWorkerController/getFocusStats`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `start_time` | datetime | 否 | 起始时间(ISO,可选)。不传则今天 00:00:00。 |
+| `end_time` | datetime | 否 | 截止时间(ISO,可选)。不传则今天 23:59:59。 |
+
 ## `zentodo.pomo.sync-pull-worker`
 
 调用 /tomatoWorkerController/getSyncTomatoWorkerList。