@zentodo/cli 0.1.6 → 0.1.7

package/skills/zentodo/references/commands.md

@@ -531,6 +531,19 @@ zentodo auth login-email --email a@b.com
 - **所需 scope**:`read`
 - **对应 Skill 工具**:`zentodo.pomo.history`
 
+### `zentodo pomo focus-stats` _(只读 / 幂等)_
+
+专注时长统计(时间窗)。
+
+- **后端端点**:`POST /tomatoWorkerController/getFocusStats`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.pomo.focus-stats`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `start_time` | datetime | 否 | 起始时间(ISO,可选)。不传则今天 00:00:00。 |
+| `end_time` | datetime | 否 | 截止时间(ISO,可选)。不传则今天 23:59:59。 |
+
 ### `zentodo pomo sync-pull-worker` _(只读)_
 
 按 clientVersion 拉取番茄钟记录增量。
@@ -623,6 +636,47 @@ zentodo auth login-email --email a@b.com
 - **所需 scope**:`read`
 - **对应 Skill 工具**:`zentodo.project.list-all`
 
+### `zentodo project list-active` _(只读 / 幂等)_
+
+列出活跃项目(未完成、未取消、未模板)。
+
+- **后端端点**:`POST /projectController/getActiveProjects`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.project.list-active`
+
+### `zentodo project list-archived` _(只读 / 幂等)_
+
+列出已归档/已完成/已取消的项目。
+
+- **后端端点**:`POST /projectController/getArchivedProjects`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.project.list-archived`
+
+### `zentodo project search` _(只读 / 幂等)_
+
+按关键字搜索项目(projectName / projectDesc)。
+
+- **后端端点**:`POST /projectController/searchProjects`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.project.search`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `keyword` | string | 是 | 关键字。 |
+| `limit` | integer | 否 | 最多返回多少条(默认 50,最大 500)。 |
+
+### `zentodo project stats` _(只读 / 幂等)_
+
+单个项目的统计数据。
+
+- **后端端点**:`POST /projectController/getProjectStats`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.project.stats`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `project_key` | integer | 是 | 项目 projectKey。 |
+
 ### `zentodo project sync-pull` _(只读)_
 
 按 clientVersion 拉取项目增量。
@@ -1048,7 +1102,7 @@ zentodo task add --title "写周报" --due 2025-09-05T14:00 --priority 3
 
 ### `zentodo task completed-today` _(只读 / 幂等)_
 
-列出今日完成的任务。
+列出今日（或指定日期）完成的任务。
 
 - **后端端点**:`POST /taskController/getCompletedTasks`
 - **所需 scope**:`read`
@@ -1056,11 +1110,7 @@ zentodo task add --title "写周报" --due 2025-09-05T14:00 --priority 3
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
 
@@ -1070,15 +1120,6 @@ zentodo task add --title "写周报" --due 2025-09-05T14:00 --priority 3
 - **所需 scope**:`read`
 - **对应 Skill 工具**:`zentodo.task.mit-list`
 
-| 参数 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
 
 按日期范围列出日历视图任务。
@@ -1091,11 +1132,48 @@ zentodo task add --title "写周报" --due 2025-09-05T14:00 --priority 3
 | --- | --- | --- | --- |
 | `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` _(只读 / 幂等)_
+
+列出已过期未完成的任务(taskCreateTime < 今天)。
+
+- **后端端点**:`POST /taskController/getOverdueTasks`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.task.overdue`
+
+### `zentodo task inbox` _(只读 / 幂等)_
+
+列出收集箱任务(未安排时间的未完成任务)。
+
+- **后端端点**:`POST /taskController/getInboxTasks`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.task.inbox`
+
+### `zentodo task search` _(只读 / 幂等)_
+
+按关键字搜索任务(taskName / taskDesc)。
+
+- **后端端点**:`POST /taskController/searchTasks`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.task.search`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `keyword` | string | 是 | 关键字。 |
+| `limit` | integer | 否 | 最多返回多少条(默认 50,最大 500)。 |
+
+### `zentodo task stats` _(只读 / 幂等)_
+
+任务完成情况统计(指定时间窗)。
+
+- **后端端点**:`POST /taskController/getTaskStats`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.task.stats`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `start_date` | date | 否 | 起始日期(ISO,可选)。不传则今天。 |
+| `end_date` | date | 否 | 截止日期(ISO,可选)。不传则今天。 |
 
 ### `zentodo task move`
 

package/skills/zentodo/references/mapping.md

@@ -29,6 +29,10 @@
 | task | `zentodo task completed-today` | `zentodo.task.completed-today` | `POST /taskController/getCompletedTasks` | read |
 | task | `zentodo task mit-list` | `zentodo.task.mit-list` | `POST /taskController/getMitTasks` | read |
 | task | `zentodo task calendar` | `zentodo.task.calendar` | `POST /taskController/getCalendarTaskByDate` | read |
+| task | `zentodo task overdue` | `zentodo.task.overdue` | `POST /taskController/getOverdueTasks` | read |
+| task | `zentodo task inbox` | `zentodo.task.inbox` | `POST /taskController/getInboxTasks` | read |
+| task | `zentodo task search` | `zentodo.task.search` | `POST /taskController/searchTasks` | read |
+| task | `zentodo task stats` | `zentodo.task.stats` | `POST /taskController/getTaskStats` | read |
 | task | `zentodo task move` | `zentodo.task.move` | `POST /taskController/updateTaskCreateTime` | write |
 | task | `zentodo task sync-pull` | `zentodo.task.sync-pull` | `POST /taskController/getSyncTaskList` | sync, read |
 | task | `zentodo task sync-push` | `zentodo.task.sync-push` | `POST /taskController/putSyncTask` | sync, write |
@@ -38,6 +42,10 @@
 | subtask | `zentodo subtask sync-pull` | `zentodo.subtask.sync-pull` | `POST /subTaskController/getSyncSubTaskList` | sync, read |
 | project | `zentodo project upsert` | `zentodo.project.sync-push` | `POST /projectController/putSyncProject` | sync, write |
 | project | `zentodo project list` | `zentodo.project.list-all` | `POST /projectController/getAllProjectByUserId` | read |
+| project | `zentodo project list-active` | `zentodo.project.list-active` | `POST /projectController/getActiveProjects` | read |
+| project | `zentodo project list-archived` | `zentodo.project.list-archived` | `POST /projectController/getArchivedProjects` | read |
+| project | `zentodo project search` | `zentodo.project.search` | `POST /projectController/searchProjects` | read |
+| project | `zentodo project stats` | `zentodo.project.stats` | `POST /projectController/getProjectStats` | read |
 | project | `zentodo project sync-pull` | `zentodo.project.sync-pull` | `POST /projectController/getSyncProjectList` | sync, read |
 | subproject | `zentodo subproject upsert` | `zentodo.subproject.sync-push` | `POST /subProjectController/putSyncSubProject` | sync, write |
 | subproject | `zentodo subproject list` | `zentodo.subproject.list-all` | `POST /subProjectController/getAllSubProjectByUserId` | read |
@@ -69,6 +77,7 @@
 | pomo | `zentodo pomo start` | `zentodo.pomo.start` | `POST /timerController/startPomodoro` | write |
 | pomo | `zentodo pomo stop` | `zentodo.pomo.stop` | `POST /timerController/stopTimer` | write |
 | pomo | `zentodo pomo history` | `zentodo.pomo.history` | `POST /tomatoWorkerController/getAllTomatoByUserId` | read |
+| pomo | `zentodo pomo focus-stats` | `zentodo.pomo.focus-stats` | `POST /tomatoWorkerController/getFocusStats` | read |
 | pomo | `zentodo pomo sync-pull-worker` | `zentodo.pomo.sync-pull-worker` | `POST /tomatoWorkerController/getSyncTomatoWorkerList` | sync, read |
 | pomo | `zentodo pomo sync-push-worker` | `zentodo.pomo.sync-push-worker` | `POST /tomatoWorkerController/putSyncTomatoWorker` | sync, write |
 | pomo | `zentodo pomo config-get` | `zentodo.pomo.config-get` | `POST /tomatoConfigController/getAllTomatoConfigByUserId` | read |

package/skills/zentodo/references/tools.json

@@ -927,7 +927,7 @@
     "name": "zentodo.task.completed-today",
     "domain": "task",
     "action": "completed-today",
-    "description": "调用 /taskController/getCompletedTasks。过滤条件:syncFlag != D、taskState = 0、taskCompletedTime = today。",
+    "description": "调用 /taskController/getCompletedTasks。服务端根据 usrKey + date 直接过滤,不用在客户端再做一次。",
     "http": {
       "method": "POST",
       "path": "/taskController/getCompletedTasks"
@@ -942,41 +942,11 @@
     },
     "params": [
       {
-        "name": "is_templete",
-        "backendName": "isTemplete",
-        "type": "boolean",
-        "default": false,
-        "transform": "booleanToString",
-        "description": "排除模板。"
-      },
-      {
-        "name": "sync_flag",
-        "backendName": "syncFlag",
-        "type": "string",
-        "default": "!=D",
-        "description": "同步标记过滤。"
-      },
-      {
-        "name": "task_state",
-        "backendName": "taskState",
-        "type": "string",
-        "default": "=0",
-        "description": "已完成。"
-      },
-      {
-        "name": "task_completed_time",
-        "backendName": "taskCompletedTime",
-        "type": "string",
-        "default": "=today",
-        "description": "完成时间=今日。"
-      },
-      {
-        "name": "task_create_time_not_null",
-        "backendName": "taskCreateTimeNotNull",
-        "type": "boolean",
-        "default": true,
-        "transform": "booleanToString",
-        "description": "要求 createTime 非空。"
+        "name": "date",
+        "backendName": "date",
+        "type": "date",
+        "transform": "isoToBackendDate",
+        "description": "指定日期(ISO,可选)。不传则使用服务器今天。"
       }
     ],
     "output": {
@@ -987,7 +957,7 @@
     "name": "zentodo.task.mit-list",
     "domain": "task",
     "action": "mit-list",
-    "description": "调用 /taskController/getMitTasks。过滤条件与 PC 端 loadMitHeaderDatas() 一致。",
+    "description": "调用 /taskController/getMitTasks。服务端按 usrKey 过滤 isMIT=true + 未完成 + taskCreateTime<=今天。",
     "http": {
       "method": "POST",
       "path": "/taskController/getMitTasks"
@@ -1000,53 +970,7 @@
       "idempotent": true,
       "destructive": false
     },
-    "params": [
-      {
-        "name": "sync_flag",
-        "backendName": "syncFlag",
-        "type": "string",
-        "default": "!=D",
-        "description": "同步标记过滤。"
-      },
-      {
-        "name": "is_templete",
-        "backendName": "isTemplete",
-        "type": "boolean",
-        "default": false,
-        "transform": "booleanToString",
-        "description": "排除模板。"
-      },
-      {
-        "name": "task_state",
-        "backendName": "taskState",
-        "type": "string",
-        "default": "!=0",
-        "description": "未完成。"
-      },
-      {
-        "name": "task_create_time_not_null",
-        "backendName": "taskCreateTimeNotNull",
-        "type": "boolean",
-        "default": true,
-        "transform": "booleanToString",
-        "description": "要求 createTime 非空。"
-      },
-      {
-        "name": "task_create_time",
-        "backendName": "taskCreateTime",
-        "type": "string",
-        "default": "<=today",
-        "description": "到今日为止。"
-      },
-      {
-        "name": "is_mit",
-        "backendName": "isMIT",
-        "type": "boolean",
-        "default": true,
-        "transform": "booleanToString",
-        "description": "MIT 过滤。"
-      }
-    ],
+    "params": [],
     "output": {
       "shape": "array"
     }
@@ -1055,7 +979,7 @@
     "name": "zentodo.task.calendar",
     "domain": "task",
     "action": "calendar",
-    "description": "调用 /taskController/getCalendarTaskByDate。过滤与安卓端一致(syncFlag!=D、taskState!=0、isTemplete=false、taskStartItem!=FT、taskStartItem!=垃圾箱)。",
+    "description": "调用 /taskController/getCalendarTaskByDate。服务端已内置过滤(未完成 + 非模板 + 非垃圾箱)。",
     "http": {
       "method": "POST",
       "path": "/taskController/getCalendarTaskByDate"
@@ -1084,46 +1008,128 @@
         "transform": "isoToBackendDate",
         "required": true,
         "description": "范围截止(ISO 日期)。"
-      },
-      {
-        "name": "sync_flag",
-        "backendName": "syncFlag",
-        "type": "string",
-        "default": "!=D",
-        "description": "同步标记过滤。"
-      },
+      }
+    ],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.task.overdue",
+    "domain": "task",
+    "action": "overdue",
+    "description": "调用 /taskController/getOverdueTasks。",
+    "http": {
+      "method": "POST",
+      "path": "/taskController/getOverdueTasks"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.task.inbox",
+    "domain": "task",
+    "action": "inbox",
+    "description": "调用 /taskController/getInboxTasks。",
+    "http": {
+      "method": "POST",
+      "path": "/taskController/getInboxTasks"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.task.search",
+    "domain": "task",
+    "action": "search",
+    "description": "调用 /taskController/searchTasks。服务端按 LIKE 匹配并按 latestVersion 倒序返回。",
+    "http": {
+      "method": "POST",
+      "path": "/taskController/searchTasks"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
       {
-        "name": "task_state",
-        "backendName": "taskState",
+        "name": "keyword",
+        "backendName": "keyword",
         "type": "string",
-        "default": "!=0",
-        "description": "未完成。"
+        "required": true,
+        "description": "关键字。"
       },
       {
-        "name": "is_templete",
-        "backendName": "isTemplete",
-        "type": "boolean",
-        "default": false,
-        "transform": "booleanToString",
-        "description": "排除模板。"
-      },
+        "name": "limit",
+        "backendName": "limit",
+        "type": "integer",
+        "default": 50,
+        "description": "最多返回多少条(默认 50,最大 500)。"
+      }
+    ],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.task.stats",
+    "domain": "task",
+    "action": "stats",
+    "description": "调用 /taskController/getTaskStats。返回 { created, completed, completion_rate, by_project }。",
+    "http": {
+      "method": "POST",
+      "path": "/taskController/getTaskStats"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
       {
-        "name": "task_start_item_not_1",
-        "backendName": "taskStartItemNot1",
-        "type": "string",
-        "default": "FT",
-        "description": "排除 FT 项。"
+        "name": "start_date",
+        "backendName": "startDate",
+        "type": "date",
+        "transform": "isoToBackendDate",
+        "description": "起始日期(ISO,可选)。不传则今天。"
       },
       {
-        "name": "task_start_item_not_2",
-        "backendName": "taskStartItemNot2",
-        "type": "string",
-        "default": "垃圾箱",
-        "description": "排除垃圾箱。"
+        "name": "end_date",
+        "backendName": "endDate",
+        "type": "date",
+        "transform": "isoToBackendDate",
+        "description": "截止日期(ISO,可选)。不传则今天。"
       }
     ],
     "output": {
-      "shape": "array"
+      "shape": "object"
     }
   },
   {
@@ -1467,6 +1473,117 @@
       "shape": "array"
     }
   },
+  {
+    "name": "zentodo.project.list-active",
+    "domain": "project",
+    "action": "list-active",
+    "description": "调用 /projectController/getActiveProjects。",
+    "http": {
+      "method": "POST",
+      "path": "/projectController/getActiveProjects"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.project.list-archived",
+    "domain": "project",
+    "action": "list-archived",
+    "description": "调用 /projectController/getArchivedProjects。projectState in (2,3,4)。",
+    "http": {
+      "method": "POST",
+      "path": "/projectController/getArchivedProjects"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.project.search",
+    "domain": "project",
+    "action": "search",
+    "description": "调用 /projectController/searchProjects。",
+    "http": {
+      "method": "POST",
+      "path": "/projectController/searchProjects"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
+      {
+        "name": "keyword",
+        "backendName": "keyword",
+        "type": "string",
+        "required": true,
+        "description": "关键字。"
+      },
+      {
+        "name": "limit",
+        "backendName": "limit",
+        "type": "integer",
+        "default": 50,
+        "description": "最多返回多少条(默认 50,最大 500)。"
+      }
+    ],
+    "output": {
+      "shape": "array"
+    }
+  },
+  {
+    "name": "zentodo.project.stats",
+    "domain": "project",
+    "action": "stats",
+    "description": "调用 /projectController/getProjectStats。返回 { task_count, done_task_count, progress, exec_time_ms, state }。",
+    "http": {
+      "method": "POST",
+      "path": "/projectController/getProjectStats"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
+      {
+        "name": "project_key",
+        "backendName": "projectKey",
+        "type": "integer",
+        "required": true,
+        "description": "项目 projectKey。"
+      }
+    ],
+    "output": {
+      "shape": "object"
+    }
+  },
   {
     "name": "zentodo.project.sync-pull",
     "domain": "project",
@@ -2561,6 +2678,43 @@
       "shape": "array"
     }
   },
+  {
+    "name": "zentodo.pomo.focus-stats",
+    "domain": "pomo",
+    "action": "focus-stats",
+    "description": "调用 /tomatoWorkerController/getFocusStats。返回 { sessions, total_sec, total_hours, by_task }。",
+    "http": {
+      "method": "POST",
+      "path": "/tomatoWorkerController/getFocusStats"
+    },
+    "scopes": [
+      "read"
+    ],
+    "annotations": {
+      "readOnly": true,
+      "idempotent": true,
+      "destructive": false
+    },
+    "params": [
+      {
+        "name": "start_time",
+        "backendName": "startTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "起始时间(ISO,可选)。不传则今天 00:00:00。"
+      },
+      {
+        "name": "end_time",
+        "backendName": "endTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "截止时间(ISO,可选)。不传则今天 23:59:59。"
+      }
+    ],
+    "output": {
+      "shape": "object"
+    }
+  },
   {
     "name": "zentodo.pomo.sync-pull-worker",
     "domain": "pomo",