@zentodo/cli 0.1.6 → 0.1.8

package/dist/bin.cjs

@@ -4061,6 +4061,24 @@ var pomoCapabilities = [
     cli: { group: "pomo", command: "history" },
     tool: { readOnlyHint: true, idempotentHint: true }
   },
+  {
+    id: "pomo.focus-stats",
+    domain: "pomo",
+    action: "focus-stats",
+    summary: "\u4E13\u6CE8\u65F6\u957F\u7EDF\u8BA1(\u65F6\u95F4\u7A97)\u3002",
+    description: "\u8C03\u7528 /tomatoWorkerController/getFocusStats\u3002\u8FD4\u56DE { sessions, total_sec, total_hours, by_task }\u3002",
+    http: { method: "POST", path: "/tomatoWorkerController/getFocusStats" },
+    params: [
+      { name: "start_time", backendName: "startTime", type: "datetime", transform: "isoToBackendDateTime", description: "\u8D77\u59CB\u65F6\u95F4(ISO,\u53EF\u9009)\u3002\u4E0D\u4F20\u5219\u4ECA\u5929 00:00:00\u3002" },
+      { name: "end_time", backendName: "endTime", type: "datetime", transform: "isoToBackendDateTime", description: "\u622A\u6B62\u65F6\u95F4(ISO,\u53EF\u9009)\u3002\u4E0D\u4F20\u5219\u4ECA\u5929 23:59:59\u3002" }
+    ],
+    output: { shape: "object" },
+    scopes: ["read"],
+    readOnly: true,
+    idempotent: true,
+    cli: { group: "pomo", command: "focus-stats" },
+    tool: { readOnlyHint: true, idempotentHint: true }
+  },
   {
     id: "pomo.sync-pull-worker",
     domain: "pomo",
@@ -4200,6 +4218,71 @@ var projectCapabilities = [
     cli: { group: "project", command: "list" },
     tool: { readOnlyHint: true, idempotentHint: true }
   },
+  {
+    id: "project.list-active",
+    domain: "project",
+    action: "list-active",
+    summary: "\u5217\u51FA\u6D3B\u8DC3\u9879\u76EE(\u672A\u5B8C\u6210\u3001\u672A\u53D6\u6D88\u3001\u672A\u6A21\u677F)\u3002",
+    description: "\u8C03\u7528 /projectController/getActiveProjects\u3002",
+    http: { method: "POST", path: "/projectController/getActiveProjects" },
+    params: [],
+    output: { shape: "array" },
+    scopes: ["read"],
+    readOnly: true,
+    idempotent: true,
+    cli: { group: "project", command: "list-active" },
+    tool: { readOnlyHint: true, idempotentHint: true }
+  },
+  {
+    id: "project.list-archived",
+    domain: "project",
+    action: "list-archived",
+    summary: "\u5217\u51FA\u5DF2\u5F52\u6863/\u5DF2\u5B8C\u6210/\u5DF2\u53D6\u6D88\u7684\u9879\u76EE\u3002",
+    description: "\u8C03\u7528 /projectController/getArchivedProjects\u3002projectState in (2,3,4)\u3002",
+    http: { method: "POST", path: "/projectController/getArchivedProjects" },
+    params: [],
+    output: { shape: "array" },
+    scopes: ["read"],
+    readOnly: true,
+    idempotent: true,
+    cli: { group: "project", command: "list-archived" },
+    tool: { readOnlyHint: true, idempotentHint: true }
+  },
+  {
+    id: "project.search",
+    domain: "project",
+    action: "search",
+    summary: "\u6309\u5173\u952E\u5B57\u641C\u7D22\u9879\u76EE(projectName / projectDesc)\u3002",
+    description: "\u8C03\u7528 /projectController/searchProjects\u3002",
+    http: { method: "POST", path: "/projectController/searchProjects" },
+    params: [
+      { name: "keyword", backendName: "keyword", type: "string", required: true, description: "\u5173\u952E\u5B57\u3002" },
+      { name: "limit", backendName: "limit", type: "integer", default: 50, description: "\u6700\u591A\u8FD4\u56DE\u591A\u5C11\u6761(\u9ED8\u8BA4 50,\u6700\u5927 500)\u3002" }
+    ],
+    output: { shape: "array" },
+    scopes: ["read"],
+    readOnly: true,
+    idempotent: true,
+    cli: { group: "project", command: "search" },
+    tool: { readOnlyHint: true, idempotentHint: true }
+  },
+  {
+    id: "project.stats",
+    domain: "project",
+    action: "stats",
+    summary: "\u5355\u4E2A\u9879\u76EE\u7684\u7EDF\u8BA1\u6570\u636E\u3002",
+    description: "\u8C03\u7528 /projectController/getProjectStats\u3002\u8FD4\u56DE { task_count, done_task_count, progress, exec_time_ms, state }\u3002",
+    http: { method: "POST", path: "/projectController/getProjectStats" },
+    params: [
+      { name: "project_key", backendName: "projectKey", type: "integer", required: true, description: "\u9879\u76EE projectKey\u3002" }
+    ],
+    output: { shape: "object" },
+    scopes: ["read"],
+    readOnly: true,
+    idempotent: true,
+    cli: { group: "project", command: "stats" },
+    tool: { readOnlyHint: true, idempotentHint: true }
+  },
   {
     id: "project.sync-pull",
     domain: "project",
@@ -4741,15 +4824,11 @@ var taskCapabilities = [
     id: "task.completed-today",
     domain: "task",
     action: "completed-today",
-    summary: "\u5217\u51FA\u4ECA\u65E5\u5B8C\u6210\u7684\u4EFB\u52A1\u3002",
-    description: "\u8C03\u7528 /taskController/getCompletedTasks\u3002\u8FC7\u6EE4\u6761\u4EF6:syncFlag != D\u3001taskState = 0\u3001taskCompletedTime = today\u3002",
+    summary: "\u5217\u51FA\u4ECA\u65E5\uFF08\u6216\u6307\u5B9A\u65E5\u671F\uFF09\u5B8C\u6210\u7684\u4EFB\u52A1\u3002",
+    description: "\u8C03\u7528 /taskController/getCompletedTasks\u3002\u670D\u52A1\u7AEF\u6839\u636E usrKey + date \u76F4\u63A5\u8FC7\u6EE4,\u4E0D\u7528\u5728\u5BA2\u6237\u7AEF\u518D\u505A\u4E00\u6B21\u3002",
     http: { method: "POST", path: "/taskController/getCompletedTasks" },
     params: [
-      { name: "is_templete", backendName: "isTemplete", type: "boolean", default: false, transform: "booleanToString", description: "\u6392\u9664\u6A21\u677F\u3002" },
-      { name: "sync_flag", backendName: "syncFlag", type: "string", default: "!=D", description: "\u540C\u6B65\u6807\u8BB0\u8FC7\u6EE4\u3002" },
-      { name: "task_state", backendName: "taskState", type: "string", default: "=0", description: "\u5DF2\u5B8C\u6210\u3002" },
-      { name: "task_completed_time", backendName: "taskCompletedTime", type: "string", default: "=today", description: "\u5B8C\u6210\u65F6\u95F4=\u4ECA\u65E5\u3002" },
-      { name: "task_create_time_not_null", backendName: "taskCreateTimeNotNull", type: "boolean", default: true, transform: "booleanToString", description: "\u8981\u6C42 createTime \u975E\u7A7A\u3002" }
+      { name: "date", backendName: "date", type: "date", transform: "isoToBackendDate", description: "\u6307\u5B9A\u65E5\u671F(ISO,\u53EF\u9009)\u3002\u4E0D\u4F20\u5219\u4F7F\u7528\u670D\u52A1\u5668\u4ECA\u5929\u3002" }
     ],
     output: { shape: "array" },
     scopes: ["read"],
@@ -4763,16 +4842,9 @@ var taskCapabilities = [
     domain: "task",
     action: "mit-list",
     summary: "\u5217\u51FA\u4ECA\u65E5 MIT(\u6700\u91CD\u8981)\u4EFB\u52A1\u3002",
-    description: "\u8C03\u7528 /taskController/getMitTasks\u3002\u8FC7\u6EE4\u6761\u4EF6\u4E0E PC \u7AEF loadMitHeaderDatas() \u4E00\u81F4\u3002",
+    description: "\u8C03\u7528 /taskController/getMitTasks\u3002\u670D\u52A1\u7AEF\u6309 usrKey \u8FC7\u6EE4 isMIT=true + \u672A\u5B8C\u6210 + taskCreateTime<=\u4ECA\u5929\u3002",
     http: { method: "POST", path: "/taskController/getMitTasks" },
-    params: [
-      { name: "sync_flag", backendName: "syncFlag", type: "string", default: "!=D", description: "\u540C\u6B65\u6807\u8BB0\u8FC7\u6EE4\u3002" },
-      { name: "is_templete", backendName: "isTemplete", type: "boolean", default: false, transform: "booleanToString", description: "\u6392\u9664\u6A21\u677F\u3002" },
-      { name: "task_state", backendName: "taskState", type: "string", default: "!=0", description: "\u672A\u5B8C\u6210\u3002" },
-      { name: "task_create_time_not_null", backendName: "taskCreateTimeNotNull", type: "boolean", default: true, transform: "booleanToString", description: "\u8981\u6C42 createTime \u975E\u7A7A\u3002" },
-      { name: "task_create_time", backendName: "taskCreateTime", type: "string", default: "<=today", description: "\u5230\u4ECA\u65E5\u4E3A\u6B62\u3002" },
-      { name: "is_mit", backendName: "isMIT", type: "boolean", default: true, transform: "booleanToString", description: "MIT \u8FC7\u6EE4\u3002" }
-    ],
+    params: [],
     output: { shape: "array" },
     scopes: ["read"],
     readOnly: true,
@@ -4785,16 +4857,11 @@ var taskCapabilities = [
     domain: "task",
     action: "calendar",
     summary: "\u6309\u65E5\u671F\u8303\u56F4\u5217\u51FA\u65E5\u5386\u89C6\u56FE\u4EFB\u52A1\u3002",
-    description: "\u8C03\u7528 /taskController/getCalendarTaskByDate\u3002\u8FC7\u6EE4\u4E0E\u5B89\u5353\u7AEF\u4E00\u81F4(syncFlag!=D\u3001taskState!=0\u3001isTemplete=false\u3001taskStartItem!=FT\u3001taskStartItem!=\u5783\u573E\u7BB1)\u3002",
+    description: "\u8C03\u7528 /taskController/getCalendarTaskByDate\u3002\u670D\u52A1\u7AEF\u5DF2\u5185\u7F6E\u8FC7\u6EE4(\u672A\u5B8C\u6210 + \u975E\u6A21\u677F + \u975E\u5783\u573E\u7BB1)\u3002",
     http: { method: "POST", path: "/taskController/getCalendarTaskByDate" },
     params: [
       { name: "start_date", backendName: "startDate", type: "date", transform: "isoToBackendDate", required: true, description: "\u8303\u56F4\u8D77\u59CB(ISO \u65E5\u671F)\u3002" },
-      { name: "end_date", backendName: "endDate", type: "date", transform: "isoToBackendDate", required: true, description: "\u8303\u56F4\u622A\u6B62(ISO \u65E5\u671F)\u3002" },
-      { name: "sync_flag", backendName: "syncFlag", type: "string", default: "!=D", description: "\u540C\u6B65\u6807\u8BB0\u8FC7\u6EE4\u3002" },
-      { name: "task_state", backendName: "taskState", type: "string", default: "!=0", description: "\u672A\u5B8C\u6210\u3002" },
-      { name: "is_templete", backendName: "isTemplete", type: "boolean", default: false, transform: "booleanToString", description: "\u6392\u9664\u6A21\u677F\u3002" },
-      { name: "task_start_item_not_1", backendName: "taskStartItemNot1", type: "string", default: "FT", description: "\u6392\u9664 FT \u9879\u3002" },
-      { name: "task_start_item_not_2", backendName: "taskStartItemNot2", type: "string", default: "\u5783\u573E\u7BB1", description: "\u6392\u9664\u5783\u573E\u7BB1\u3002" }
+      { name: "end_date", backendName: "endDate", type: "date", transform: "isoToBackendDate", required: true, description: "\u8303\u56F4\u622A\u6B62(ISO \u65E5\u671F)\u3002" }
     ],
     output: { shape: "array" },
     scopes: ["read"],
@@ -4803,6 +4870,72 @@ var taskCapabilities = [
     cli: { group: "task", command: "calendar" },
     tool: { readOnlyHint: true, idempotentHint: true }
   },
+  {
+    id: "task.overdue",
+    domain: "task",
+    action: "overdue",
+    summary: "\u5217\u51FA\u5DF2\u8FC7\u671F\u672A\u5B8C\u6210\u7684\u4EFB\u52A1(taskCreateTime < \u4ECA\u5929)\u3002",
+    description: "\u8C03\u7528 /taskController/getOverdueTasks\u3002",
+    http: { method: "POST", path: "/taskController/getOverdueTasks" },
+    params: [],
+    output: { shape: "array" },
+    scopes: ["read"],
+    readOnly: true,
+    idempotent: true,
+    cli: { group: "task", command: "overdue" },
+    tool: { readOnlyHint: true, idempotentHint: true }
+  },
+  {
+    id: "task.inbox",
+    domain: "task",
+    action: "inbox",
+    summary: "\u5217\u51FA\u6536\u96C6\u7BB1\u4EFB\u52A1(\u672A\u5B89\u6392\u65F6\u95F4\u7684\u672A\u5B8C\u6210\u4EFB\u52A1)\u3002",
+    description: "\u8C03\u7528 /taskController/getInboxTasks\u3002",
+    http: { method: "POST", path: "/taskController/getInboxTasks" },
+    params: [],
+    output: { shape: "array" },
+    scopes: ["read"],
+    readOnly: true,
+    idempotent: true,
+    cli: { group: "task", command: "inbox" },
+    tool: { readOnlyHint: true, idempotentHint: true }
+  },
+  {
+    id: "task.search",
+    domain: "task",
+    action: "search",
+    summary: "\u6309\u5173\u952E\u5B57\u641C\u7D22\u4EFB\u52A1(taskName / taskDesc)\u3002",
+    description: "\u8C03\u7528 /taskController/searchTasks\u3002\u670D\u52A1\u7AEF\u6309 LIKE \u5339\u914D\u5E76\u6309 latestVersion \u5012\u5E8F\u8FD4\u56DE\u3002",
+    http: { method: "POST", path: "/taskController/searchTasks" },
+    params: [
+      { name: "keyword", backendName: "keyword", type: "string", required: true, description: "\u5173\u952E\u5B57\u3002" },
+      { name: "limit", backendName: "limit", type: "integer", default: 50, description: "\u6700\u591A\u8FD4\u56DE\u591A\u5C11\u6761(\u9ED8\u8BA4 50,\u6700\u5927 500)\u3002" }
+    ],
+    output: { shape: "array" },
+    scopes: ["read"],
+    readOnly: true,
+    idempotent: true,
+    cli: { group: "task", command: "search" },
+    tool: { readOnlyHint: true, idempotentHint: true }
+  },
+  {
+    id: "task.stats",
+    domain: "task",
+    action: "stats",
+    summary: "\u4EFB\u52A1\u5B8C\u6210\u60C5\u51B5\u7EDF\u8BA1(\u6307\u5B9A\u65F6\u95F4\u7A97)\u3002",
+    description: "\u8C03\u7528 /taskController/getTaskStats\u3002\u8FD4\u56DE { created, completed, completion_rate, by_project }\u3002",
+    http: { method: "POST", path: "/taskController/getTaskStats" },
+    params: [
+      { name: "start_date", backendName: "startDate", type: "date", transform: "isoToBackendDate", description: "\u8D77\u59CB\u65E5\u671F(ISO,\u53EF\u9009)\u3002\u4E0D\u4F20\u5219\u4ECA\u5929\u3002" },
+      { name: "end_date", backendName: "endDate", type: "date", transform: "isoToBackendDate", description: "\u622A\u6B62\u65E5\u671F(ISO,\u53EF\u9009)\u3002\u4E0D\u4F20\u5219\u4ECA\u5929\u3002" }
+    ],
+    output: { shape: "object" },
+    scopes: ["read"],
+    readOnly: true,
+    idempotent: true,
+    cli: { group: "task", command: "stats" },
+    tool: { readOnlyHint: true, idempotentHint: true }
+  },
   {
     id: "task.move",
     domain: "task",
@@ -8010,7 +8143,7 @@ function describeGroup(name) {
 }
 
 // src/program.ts
-var CLI_VERSION = true ? "0.1.6" : "0.0.0";
+var CLI_VERSION = true ? "0.1.8" : "0.0.0";
 function buildProgram() {
   const program3 = new Command();
   program3.name("zentodo").description("ZenTodo \u547D\u4EE4\u884C\u5DE5\u5177 \u2014 \u57FA\u4E8E\u6E05\u5355\u9A71\u52A8,\u8FDE\u63A5 ZenTodo \u540E\u7AEF\u3002\u6240\u6709\u8BF7\u6C42\u4F7F\u7528 FormData\u3002").version(CLI_VERSION, "-V, --version", "\u6253\u5370 CLI \u7248\u672C").helpOption("-h, --help", "\u663E\u793A\u5E2E\u52A9\u4FE1\u606F").addHelpCommand("help [command]", "\u67E5\u770B\u547D\u4EE4\u5E2E\u52A9").option("--profile <name>", "\u4F7F\u7528\u6307\u5B9A Profile(\u9ED8\u8BA4\u4F7F\u7528 current_profile)").option("--server <url>", "\u8986\u76D6\u540E\u7AEF\u5730\u5740").option("--token <token>", "\u8986\u76D6\u672C\u5730 Token").option("--log-level <level>", "\u65E5\u5FD7\u7EA7\u522B:trace|debug|info|warn|error", "info").option("--log-file <path>", "\u8FFD\u52A0\u65E5\u5FD7\u5230\u6307\u5B9A\u6587\u4EF6").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").option("--no-color", "\u5173\u95ED\u5F69\u8272\u8F93\u51FA").option("--dry-run", "\u53EA\u6253\u5370\u5C06\u53D1\u9001\u7684\u8BF7\u6C42,\u4E0D\u771F\u6B63\u8C03\u7528\u540E\u7AEF").option("--yes", "\u8DF3\u8FC7\u7834\u574F\u6027\u64CD\u4F5C\u7684\u786E\u8BA4\u63D0\u793A").option("--local", "\u4F18\u5148\u4F7F\u7528\u672C\u5730 SQLite(\u82E5\u53EF\u7528)").option("--remote", "\u5F3A\u5236\u4F7F\u7528\u8FDC\u7A0B HTTP \u6A21\u5F0F").option("--json", "JSON \u8F93\u51FA").option("--ndjson", "\u6309\u884C\u8F93\u51FA JSON(\u9002\u5408\u6D41\u5F0F\u5904\u7406)").option("--yaml", "YAML \u8F93\u51FA").option("--quiet", "\u9690\u85CF\u975E\u5FC5\u8981\u8F93\u51FA");

package/dist/skills/zentodo/SKILL.md

@@ -93,6 +93,16 @@ curl -X POST http://ztdfwq.qmlist.net:8082/zentodoserver/projectController/getAl
 
 如果 `zentodo` 命令不可用，先按"前置条件"安装，不要绕过 CLI 直接调接口。
 
+**关于 "Session 过期 / 302 重定向"的常见误解：**
+
+ZenTodo 后端使用 Spring Security + Session Cookie 认证。CLI 是无状态 HTTP 调用，不带 Cookie。
+大部分接口（以 `usrKey` 参数形式设计）对 CLI 完全可用；**极少数旧接口依赖 Session，CLI 调它们会被 302 重定向到 `/login`**。
+
+遇到这种情况：
+- **不要**提示用户"session 过期，请重新登录"——CLI 本来就不走 session
+- 应该选用替代接口（几乎每种查询都有 `usrKey` 版本）
+- 或者让用户反馈，由后端把该接口改造成 FormData 传 `usrKey` 模式
+
 ---
 
 

package/dist/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/dist/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 |