@zentodo/cli 0.1.12 → 0.1.14

package/dist/skills/zentodo/references/tools.json

@@ -547,10 +547,11 @@
     "name": "zentodo.task.add",
     "domain": "task",
     "action": "add",
-    "description": "调用 /taskController/insertTask,使用 FormData 提交。",
+    "description": "调用 /taskController/insertTask,使用 JSON 请求体(后端 @RequestBody Tasks)。",
     "http": {
       "method": "POST",
-      "path": "/taskController/insertTask"
+      "path": "/taskController/insertTask",
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -563,41 +564,41 @@
     "params": [
       {
         "name": "title",
-        "backendName": "taskTitle",
+        "backendName": "taskName",
         "type": "string",
         "required": true,
-        "description": "任务标题。"
+        "description": "任务标题(映射到 Tasks.taskName)。"
       },
       {
         "name": "desc",
-        "backendName": "taskDescription",
+        "backendName": "taskDesc",
         "type": "string",
-        "description": "任务描述。"
+        "description": "任务描述(映射到 Tasks.taskDesc)。"
       },
       {
         "name": "due",
         "backendName": "taskCreateTime",
         "type": "datetime",
         "transform": "isoToBackendDateTime",
-        "description": "计划时间 / 截止时间(ISO)。"
+        "description": "计划时间 / 截止时间(ISO,映射到 Tasks.taskCreateTime)。"
       },
       {
         "name": "priority",
         "backendName": "taskPriority",
-        "type": "integer",
-        "description": "优先级 0-4。"
+        "type": "string",
+        "description": "优先级 0-4(Tasks.taskPriority 存为字符串)。"
       },
       {
         "name": "project_key",
-        "backendName": "taskProjectKey",
+        "backendName": "projectKey",
         "type": "integer",
-        "description": "所属项目 projectKey。"
+        "description": "所属项目 projectKey(映射到 Tasks.projectKey)。"
       },
       {
         "name": "scene_key",
-        "backendName": "taskSceneKey",
+        "backendName": "sceneKey",
         "type": "integer",
-        "description": "所属场景 sceneKey。"
+        "description": "所属场景 sceneKey(映射到 Tasks.sceneKey)。"
       },
       {
         "name": "labels",
@@ -605,33 +606,33 @@
         "type": "array",
         "itemType": "string",
         "transform": "arrayToCsv",
-        "description": "标签(自动拼接为 CSV)。"
+        "description": "标签 CSV(Tasks 实体只存单个 labelKey,此参数当前为 no-op,供前端兼容)。"
       },
       {
         "name": "mit",
         "backendName": "isMIT",
         "type": "boolean",
         "transform": "booleanToString",
-        "description": "是否标记为 MIT(今日最重要)。"
+        "description": "是否标记为 MIT(今日最重要,映射到 Tasks.isMIT)。"
       },
       {
         "name": "reminder",
-        "backendName": "taskReminderTime",
+        "backendName": "taskReminderDate",
         "type": "datetime",
         "transform": "isoToBackendDateTime",
-        "description": "提醒时间(ISO)。"
+        "description": "提醒时间(ISO,映射到 Tasks.taskReminderDate)。"
       },
       {
         "name": "sub_of",
         "backendName": "taskParentKey",
         "type": "integer",
-        "description": "父任务 taskKey(子任务用)。"
+        "description": "Tasks 实体无 taskParentKey 字段,此参数为 no-op;子任务请使用 subtask.sync-push。"
       },
       {
         "name": "quadrant",
         "backendName": "task4time",
         "type": "integer",
-        "description": "时间四象限 0-3。"
+        "description": "时间四象限 0-3(映射到 Tasks.task4time)。"
       }
     ],
     "output": {
@@ -642,10 +643,11 @@
     "name": "zentodo.task.update",
     "domain": "task",
     "action": "update",
-    "description": "调用 /taskController/updateTask。未传入的字段不会被写入 FormData,避免把现有列置空。",
+    "description": "调用 /taskController/updateTask(后端 @RequestBody Tasks)。未传入的字段不会被写入 JSON payload,避免把现有列置空。",
     "http": {
       "method": "POST",
-      "path": "/taskController/updateTask"
+      "path": "/taskController/updateTask",
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -665,40 +667,40 @@
       },
       {
         "name": "title",
-        "backendName": "taskTitle",
+        "backendName": "taskName",
         "type": "string",
-        "description": "新标题。"
+        "description": "新标题(映射到 Tasks.taskName)。"
       },
       {
         "name": "desc",
-        "backendName": "taskDescription",
+        "backendName": "taskDesc",
         "type": "string",
-        "description": "新描述。"
+        "description": "新描述(映射到 Tasks.taskDesc)。"
       },
       {
         "name": "due",
         "backendName": "taskCreateTime",
         "type": "datetime",
         "transform": "isoToBackendDateTime",
-        "description": "新计划时间(ISO)。"
+        "description": "新计划时间(ISO,映射到 Tasks.taskCreateTime)。"
       },
       {
         "name": "priority",
         "backendName": "taskPriority",
-        "type": "integer",
-        "description": "新优先级。"
+        "type": "string",
+        "description": "新优先级(Tasks.taskPriority 存为字符串)。"
       },
       {
         "name": "project_key",
-        "backendName": "taskProjectKey",
+        "backendName": "projectKey",
         "type": "integer",
-        "description": "迁移到的 projectKey。"
+        "description": "迁移到的 projectKey(映射到 Tasks.projectKey)。"
       },
       {
         "name": "scene_key",
-        "backendName": "taskSceneKey",
+        "backendName": "sceneKey",
         "type": "integer",
-        "description": "迁移到的 sceneKey。"
+        "description": "迁移到的 sceneKey(映射到 Tasks.sceneKey)。"
       },
       {
         "name": "labels",
@@ -706,20 +708,20 @@
         "type": "array",
         "itemType": "string",
         "transform": "arrayToCsv",
-        "description": "标签(CSV)。"
+        "description": "标签 CSV(Tasks 实体只存单个 labelKey,此参数当前为 no-op)。"
       },
       {
         "name": "reminder",
-        "backendName": "taskReminderTime",
+        "backendName": "taskReminderDate",
         "type": "datetime",
         "transform": "isoToBackendDateTime",
-        "description": "新提醒时间(ISO)。"
+        "description": "新提醒时间(ISO,映射到 Tasks.taskReminderDate)。"
       },
       {
         "name": "quadrant",
         "backendName": "task4time",
         "type": "integer",
-        "description": "时间四象限。"
+        "description": "时间四象限(映射到 Tasks.task4time)。"
       },
       {
         "name": "sync_flag",
@@ -743,7 +745,8 @@
       "path": "/taskController/updateTask",
       "pragmas": [
         "softDelete"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "destructive",
@@ -777,7 +780,8 @@
       "path": "/taskController/updateTask",
       "pragmas": [
         "completeTask"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -804,10 +808,11 @@
     "name": "zentodo.task.uncomplete",
     "domain": "task",
     "action": "uncomplete",
-    "description": "调用 /taskController/updateTask,把 taskState 还原为 1 并清空完成时间。",
+    "description": "调用 /taskController/updateTask(@RequestBody),把 taskState 还原为 1 并清空完成时间。",
     "http": {
       "method": "POST",
-      "path": "/taskController/updateTask"
+      "path": "/taskController/updateTask",
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -855,7 +860,8 @@
       "path": "/taskController/updateTask",
       "pragmas": [
         "setMit"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -894,7 +900,8 @@
       "path": "/taskController/updateTask",
       "pragmas": [
         "setQuadrant"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -1205,13 +1212,14 @@
     "name": "zentodo.task.sync-push",
     "domain": "task",
     "action": "sync-push",
-    "description": "调用 /taskController/putSyncTask。所有字段通过 FormData 提交,自动剥离 id / rowid。",
+    "description": "调用 /taskController/putSyncTask(@RequestBody Tasks),完整字段提交,自动剥离 id / rowid。",
     "http": {
       "method": "POST",
       "path": "/taskController/putSyncTask",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1266,13 +1274,14 @@
     "name": "zentodo.subtask.sync-push",
     "domain": "subtask",
     "action": "sync-push",
-    "description": "调用 /subTaskController/putSyncSubTask。所有字段通过 FormData 提交,自动剥离 id/rowid。",
+    "description": "调用 /subTaskController/putSyncSubTask(后端 @RequestBody SubTask)。JSON 体,自动剥离 id/rowid。",
     "http": {
       "method": "POST",
       "path": "/subTaskController/putSyncSubTask",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1299,15 +1308,15 @@
       },
       {
         "name": "title",
-        "backendName": "subTaskTitle",
+        "backendName": "subTaskName",
         "type": "string",
-        "description": "子任务标题。"
+        "description": "子任务标题(映射到 SubTask.subTaskName)。"
       },
       {
         "name": "state",
         "backendName": "subTaskState",
-        "type": "integer",
-        "description": "状态(0=完成, 1=未完成)。"
+        "type": "boolean",
+        "description": "状态(SubTask.subTaskState 为 Boolean;true=完成)。"
       },
       {
         "name": "sync_flag",
@@ -1378,13 +1387,14 @@
     "name": "zentodo.project.sync-push",
     "domain": "project",
     "action": "sync-push",
-    "description": "调用 /projectController/putSyncProject。所有字段通过 FormData 提交,自动剥离 id/rowid。",
+    "description": "调用 /projectController/putSyncProject(后端 @RequestBody Project)。所有字段以 JSON 体提交,自动剥离 id/rowid。",
     "http": {
       "method": "POST",
       "path": "/projectController/putSyncProject",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1406,38 +1416,62 @@
         "name": "name",
         "backendName": "projectName",
         "type": "string",
-        "description": "项目名称。"
+        "description": "项目名称(映射到 Project.projectName)。"
       },
       {
-        "name": "color",
-        "backendName": "projectColor",
+        "name": "desc",
+        "backendName": "projectDesc",
         "type": "string",
-        "description": "十六进制颜色。"
+        "description": "项目描述(映射到 Project.projectDesc)。"
       },
       {
-        "name": "icon",
-        "backendName": "projectIcon",
+        "name": "bk_url",
+        "backendName": "projectBKUrl",
         "type": "string",
-        "description": "图标标识。"
+        "description": "项目背景图 URL(映射到 Project.projectBKUrl)。"
       },
       {
-        "name": "parent_key",
-        "backendName": "projectParentKey",
+        "name": "header_url",
+        "backendName": "projectHeaderUrl",
+        "type": "string",
+        "description": "项目头图 URL(映射到 Project.projectHeaderUrl)。"
+      },
+      {
+        "name": "label_key",
+        "backendName": "labelKey",
         "type": "integer",
-        "description": "父项目 projectKey(用于子项目)。"
+        "description": "关联标签 labelKey(映射到 Project.labelKey)。"
+      },
+      {
+        "name": "target_key",
+        "backendName": "targetKey",
+        "type": "integer",
+        "description": "关联目标 targetKey(映射到 Project.targetKey)。"
       },
       {
         "name": "state",
         "backendName": "projectState",
         "type": "integer",
-        "description": "0=未开始, 1=进行中, 2=已完成, 3=已暂停, 4=已取消。"
+        "description": "项目状态(映射到 Project.projectState)。"
       },
       {
-        "name": "archived",
-        "backendName": "isArchived",
+        "name": "star",
+        "backendName": "isStar",
         "type": "boolean",
-        "transform": "booleanToString",
-        "description": "归档标记。"
+        "description": "是否标星(映射到 Project.isStar)。"
+      },
+      {
+        "name": "is_templete",
+        "backendName": "isTemplete",
+        "type": "boolean",
+        "description": "是否模板(映射到 Project.isTemplete)。"
+      },
+      {
+        "name": "end_time",
+        "backendName": "endTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "项目结束时间(ISO,映射到 Project.endTime)。"
       },
       {
         "name": "sync_flag",
@@ -1619,13 +1653,14 @@
     "name": "zentodo.subproject.sync-push",
     "domain": "subproject",
     "action": "sync-push",
-    "description": "调用 /subProjectController/putSyncSubProject。",
+    "description": "调用 /subProjectController/putSyncSubProject(后端 @RequestBody SubProject)。JSON 体。",
     "http": {
       "method": "POST",
       "path": "/subProjectController/putSyncSubProject",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1639,9 +1674,9 @@
     "params": [
       {
         "name": "sub_project_key",
-        "backendName": "subProjectKey",
+        "backendName": "spKey",
         "type": "integer",
-        "description": "已存在的子项目 key。"
+        "description": "已存在的子项目 key(映射到 SubProject.spKey)。"
       },
       {
         "name": "project_key",
@@ -1652,9 +1687,27 @@
       },
       {
         "name": "name",
-        "backendName": "subProjectName",
+        "backendName": "spName",
         "type": "string",
-        "description": "子项目名称。"
+        "description": "子项目名称(映射到 SubProject.spName)。"
+      },
+      {
+        "name": "desc",
+        "backendName": "spDesc",
+        "type": "string",
+        "description": "子项目描述(映射到 SubProject.spDesc)。"
+      },
+      {
+        "name": "bk_url",
+        "backendName": "spBKUrl",
+        "type": "string",
+        "description": "子项目背景图(映射到 SubProject.spBKUrl)。"
+      },
+      {
+        "name": "state",
+        "backendName": "spState",
+        "type": "integer",
+        "description": "子项目状态(映射到 SubProject.spState)。"
       },
       {
         "name": "sync_flag",
@@ -1725,13 +1778,14 @@
     "name": "zentodo.scene.sync-push",
     "domain": "scene",
     "action": "sync-push",
-    "description": "调用 /sceneController/putSyncScene。",
+    "description": "调用 /sceneController/putSyncScene(后端 @RequestBody Scene)。JSON 体。Scene 实体仅含 sceneName / sceneState / sceneKey,没有 icon / desc 字段。",
     "http": {
       "method": "POST",
       "path": "/sceneController/putSyncScene",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1753,19 +1807,13 @@
         "name": "name",
         "backendName": "sceneName",
         "type": "string",
-        "description": "场景名称。"
+        "description": "场景名称(映射到 Scene.sceneName)。"
       },
       {
-        "name": "icon",
-        "backendName": "sceneIcon",
-        "type": "string",
-        "description": "图标标识。"
-      },
-      {
-        "name": "desc",
-        "backendName": "sceneDescription",
-        "type": "string",
-        "description": "场景描述。"
+        "name": "state",
+        "backendName": "sceneState",
+        "type": "boolean",
+        "description": "场景启用状态(Scene.sceneState 为 Boolean)。"
       },
       {
         "name": "sync_flag",
@@ -1836,13 +1884,14 @@
     "name": "zentodo.target.sync-push",
     "domain": "target",
     "action": "sync-push",
-    "description": "调用 /targetController/putSyncTarget。",
+    "description": "调用 /targetController/putSyncTarget(后端 @RequestBody Target)。JSON 体。Target 实体用 ttName/ttDesc/ttState 系列字段,不是 targetTitle。",
     "http": {
       "method": "POST",
       "path": "/targetController/putSyncTarget",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1862,22 +1911,59 @@
       },
       {
         "name": "title",
-        "backendName": "targetTitle",
+        "backendName": "ttName",
         "type": "string",
-        "description": "目标标题。"
+        "description": "目标标题(映射到 Target.ttName)。"
       },
       {
         "name": "desc",
-        "backendName": "targetDescription",
+        "backendName": "ttDesc",
+        "type": "string",
+        "description": "目标描述(映射到 Target.ttDesc)。"
+      },
+      {
+        "name": "bk_url",
+        "backendName": "bkUrl",
         "type": "string",
-        "description": "目标描述。"
+        "description": "背景图(映射到 Target.bkUrl)。"
+      },
+      {
+        "name": "state",
+        "backendName": "ttState",
+        "type": "integer",
+        "description": "状态(映射到 Target.ttState)。"
+      },
+      {
+        "name": "label_key",
+        "backendName": "labelKey",
+        "type": "integer",
+        "description": "关联标签 labelKey。"
+      },
+      {
+        "name": "label_name",
+        "backendName": "labelName",
+        "type": "string",
+        "description": "标签名快照(映射到 Target.labelName)。"
       },
       {
         "name": "deadline",
-        "backendName": "targetDeadline",
-        "type": "date",
-        "transform": "isoToBackendDate",
-        "description": "截止日期(ISO)。"
+        "backendName": "endTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "截止日期(ISO,映射到 Target.endTime)。"
+      },
+      {
+        "name": "start_time",
+        "backendName": "startTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "开始日期(ISO,映射到 Target.startTime)。"
+      },
+      {
+        "name": "reward_value",
+        "backendName": "rewardValue",
+        "type": "integer",
+        "description": "完成奖励(映射到 Target.rewardValue)。"
       },
       {
         "name": "sync_flag",
@@ -1948,13 +2034,14 @@
     "name": "zentodo.label.sync-push",
     "domain": "label",
     "action": "sync-push",
-    "description": "调用 /labelController/putSyncLabel。",
+    "description": "调用 /labelController/putSyncLabel(后端 @RequestBody Label)。JSON 体。Label 实体颜色字段是 iconColor,不是 labelColor;另有 labelDesc/labelBKUrl/iconIndex/labelType。",
     "http": {
       "method": "POST",
       "path": "/labelController/putSyncLabel",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -1976,13 +2063,37 @@
         "name": "name",
         "backendName": "labelName",
         "type": "string",
-        "description": "标签名。"
+        "description": "标签名(映射到 Label.labelName)。"
+      },
+      {
+        "name": "desc",
+        "backendName": "labelDesc",
+        "type": "string",
+        "description": "标签描述(映射到 Label.labelDesc)。"
       },
       {
         "name": "color",
-        "backendName": "labelColor",
+        "backendName": "iconColor",
+        "type": "string",
+        "description": "图标/标签颜色十六进制(映射到 Label.iconColor)。"
+      },
+      {
+        "name": "icon_index",
+        "backendName": "iconIndex",
+        "type": "integer",
+        "description": "图标索引(映射到 Label.iconIndex)。"
+      },
+      {
+        "name": "label_type",
+        "backendName": "labelType",
+        "type": "integer",
+        "description": "标签类型:0 子任务 / 1 任务 / 2 项目 / 3 目标(映射到 Label.labelType)。"
+      },
+      {
+        "name": "bk_url",
+        "backendName": "labelBKUrl",
         "type": "string",
-        "description": "十六进制颜色。"
+        "description": "背景图 URL(映射到 Label.labelBKUrl)。"
       },
       {
         "name": "sync_flag",
@@ -2059,7 +2170,7 @@
     "name": "zentodo.toplabel.sync-push",
     "domain": "toplabel",
     "action": "sync-push",
-    "description": "调用 /topLabelController/putSyncTopLabel。",
+    "description": "调用 /topLabelController/putSyncTopLabel。注意:后端暂未提供 TopLabel 实体/控制器,此 capability 为占位。",
     "http": {
       "method": "POST",
       "path": "/topLabelController/putSyncTopLabel",
@@ -2158,13 +2269,14 @@
     "name": "zentodo.quadrant.sync-push",
     "domain": "quadrant",
     "action": "sync-push",
-    "description": "调用 /quadrantController/putSyncQuadrant。",
+    "description": "调用 /quadrantController/putSyncQuadrant(后端 @RequestBody Quadrant)。JSON 体。Quadrant 实体用 meKey 作主键,字段为 time1..4/color1..4/rules。",
     "http": {
       "method": "POST",
       "path": "/quadrantController/putSyncQuadrant",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2177,22 +2289,64 @@
     },
     "params": [
       {
-        "name": "quadrant_key",
-        "backendName": "quadrantKey",
+        "name": "me_key",
+        "backendName": "meKey",
         "type": "integer",
-        "description": "已存在的 quadrantKey。"
+        "description": "已存在的 meKey(映射到 Quadrant.meKey,四象限配置以 meKey 唯一识别)。"
       },
       {
-        "name": "title",
-        "backendName": "quadrantTitle",
+        "name": "time1",
+        "backendName": "time1",
         "type": "string",
-        "description": "象限标题。"
+        "description": "第 1 象限时间值(映射到 Quadrant.time1)。"
       },
       {
-        "name": "index",
-        "backendName": "quadrantIndex",
-        "type": "integer",
-        "description": "象限索引 0..3。"
+        "name": "time2",
+        "backendName": "time2",
+        "type": "string",
+        "description": "第 2 象限时间值。"
+      },
+      {
+        "name": "time3",
+        "backendName": "time3",
+        "type": "string",
+        "description": "第 3 象限时间值。"
+      },
+      {
+        "name": "time4",
+        "backendName": "time4",
+        "type": "string",
+        "description": "第 4 象限时间值。"
+      },
+      {
+        "name": "color1",
+        "backendName": "color1",
+        "type": "string",
+        "description": "第 1 象限颜色。"
+      },
+      {
+        "name": "color2",
+        "backendName": "color2",
+        "type": "string",
+        "description": "第 2 象限颜色。"
+      },
+      {
+        "name": "color3",
+        "backendName": "color3",
+        "type": "string",
+        "description": "第 3 象限颜色。"
+      },
+      {
+        "name": "color4",
+        "backendName": "color4",
+        "type": "string",
+        "description": "第 4 象限颜色。"
+      },
+      {
+        "name": "rules",
+        "backendName": "rules",
+        "type": "string",
+        "description": "象限规则配置(JSON 字符串)。"
       },
       {
         "name": "sync_flag",
@@ -2263,13 +2417,14 @@
     "name": "zentodo.timeline.sync-push",
     "domain": "timeline",
     "action": "sync-push",
-    "description": "调用 /timeLineController/putSyncTimeLine。",
+    "description": "调用 /timeLineController/putSyncTimeLine(后端 @RequestBody TimeLine)。JSON 体。TimeLine 实体字段为 tlKey/tlName/tlDesc/tlType/tlImageUrl/startTime/endTime,无 timeLineTitle/Content/Time 字段。",
     "http": {
       "method": "POST",
       "path": "/timeLineController/putSyncTimeLine",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2283,28 +2438,71 @@
     "params": [
       {
         "name": "time_line_key",
-        "backendName": "timeLineKey",
+        "backendName": "tlKey",
         "type": "integer",
-        "description": "已存在的 timeLineKey。"
+        "description": "已存在的 tlKey(映射到 TimeLine.tlKey)。"
       },
       {
         "name": "title",
-        "backendName": "timeLineTitle",
+        "backendName": "tlName",
         "type": "string",
-        "description": "标题。"
+        "description": "标题(映射到 TimeLine.tlName)。"
       },
       {
         "name": "content",
-        "backendName": "timeLineContent",
+        "backendName": "tlDesc",
         "type": "string",
-        "description": "正文。"
+        "description": "正文/描述(映射到 TimeLine.tlDesc)。"
       },
       {
-        "name": "time",
-        "backendName": "timeLineTime",
+        "name": "type",
+        "backendName": "tlType",
+        "type": "string",
+        "description": "类型(映射到 TimeLine.tlType)。"
+      },
+      {
+        "name": "image_url",
+        "backendName": "tlImageUrl",
+        "type": "string",
+        "description": "配图(映射到 TimeLine.tlImageUrl)。"
+      },
+      {
+        "name": "start_time",
+        "backendName": "startTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "开始时间(ISO,映射到 TimeLine.startTime)。"
+      },
+      {
+        "name": "end_time",
+        "backendName": "endTime",
         "type": "datetime",
         "transform": "isoToBackendDateTime",
-        "description": "时间戳(ISO)。"
+        "description": "结束时间(ISO,映射到 TimeLine.endTime)。"
+      },
+      {
+        "name": "match_key",
+        "backendName": "matchKey",
+        "type": "integer",
+        "description": "关联对象 key(task/project/target,根据 tlType 解释)。"
+      },
+      {
+        "name": "target_key",
+        "backendName": "targetKey",
+        "type": "integer",
+        "description": "关联目标 targetKey。"
+      },
+      {
+        "name": "project_key",
+        "backendName": "projectKey",
+        "type": "integer",
+        "description": "关联项目 projectKey。"
+      },
+      {
+        "name": "label_name",
+        "backendName": "labelName",
+        "type": "string",
+        "description": "标签名快照(映射到 TimeLine.labelName)。"
       },
       {
         "name": "sync_flag",
@@ -2539,13 +2737,14 @@
     "name": "zentodo.attach.sync-push",
     "domain": "attach",
     "action": "sync-push",
-    "description": "调用 /attachmentController/putSyncAttchment。",
+    "description": "调用 /attachmentController/putSyncAttchment(后端 @RequestBody Attachment)。JSON 体,仅元数据,不包含文件二进制。Attachment 实体以 athKey 为主键,通过 matchKey 关联任务/导图节点。",
     "http": {
       "method": "POST",
       "path": "/attachmentController/putSyncAttchment",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2559,9 +2758,45 @@
     "params": [
       {
         "name": "attachment_key",
-        "backendName": "attachmentKey",
+        "backendName": "athKey",
+        "type": "integer",
+        "description": "已存在的 athKey(映射到 Attachment.athKey)。"
+      },
+      {
+        "name": "match_key",
+        "backendName": "matchKey",
         "type": "integer",
-        "description": "已存在的 attachmentKey。"
+        "description": "关联对象 key(映射到 Attachment.matchKey)。"
+      },
+      {
+        "name": "file_url",
+        "backendName": "fileUrl",
+        "type": "string",
+        "description": "客户端本地文件 URL(映射到 Attachment.fileUrl)。"
+      },
+      {
+        "name": "service_file_url",
+        "backendName": "serviceFileUrl",
+        "type": "string",
+        "description": "服务端文件 URL(映射到 Attachment.serviceFileUrl)。"
+      },
+      {
+        "name": "file_type",
+        "backendName": "fileType",
+        "type": "string",
+        "description": "文件类型(映射到 Attachment.fileType)。"
+      },
+      {
+        "name": "file_desc",
+        "backendName": "fileDesc",
+        "type": "string",
+        "description": "文件描述(映射到 Attachment.fileDesc)。"
+      },
+      {
+        "name": "remark",
+        "backendName": "remark",
+        "type": "string",
+        "description": "备注(映射到 Attachment.remark)。"
       },
       {
         "name": "sync_flag",
@@ -2750,13 +2985,14 @@
     "name": "zentodo.pomo.sync-push-worker",
     "domain": "pomo",
     "action": "sync-push-worker",
-    "description": "调用 /tomatoWorkerController/putSyncTomatoWorker。",
+    "description": "调用 /tomatoWorkerController/putSyncTomatoWorker(后端 @RequestBody TomatoWorker)。JSON 体。TomatoWorker 实体以 twKey 为主键,通过 matchKey 关联任务。",
     "http": {
       "method": "POST",
       "path": "/tomatoWorkerController/putSyncTomatoWorker",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2770,15 +3006,34 @@
     "params": [
       {
         "name": "tomato_key",
-        "backendName": "tomatoKey",
+        "backendName": "twKey",
         "type": "integer",
-        "description": "已存在的 tomatoKey。"
+        "description": "已存在的 twKey(映射到 TomatoWorker.twKey)。"
       },
       {
         "name": "task_key",
-        "backendName": "taskKey",
+        "backendName": "matchKey",
         "type": "integer",
-        "description": "任务 taskKey。"
+        "description": "关联任务的 taskKey(TomatoWorker 用 matchKey 关联)。"
+      },
+      {
+        "name": "is_tomato",
+        "backendName": "isTomato",
+        "type": "boolean",
+        "description": "是否番茄钟记录(映射到 TomatoWorker.isTomato)。"
+      },
+      {
+        "name": "start_time",
+        "backendName": "tomatoStartTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "开始时间(映射到 TomatoWorker.tomatoStartTime)。"
+      },
+      {
+        "name": "execute_time",
+        "backendName": "tomatoExecuteTime",
+        "type": "string",
+        "description": "实际执行时长(映射到 TomatoWorker.tomatoExecuteTime)。"
       },
       {
         "name": "sync_flag",
@@ -2818,13 +3073,14 @@
     "name": "zentodo.pomo.config-set",
     "domain": "pomo",
     "action": "config-set",
-    "description": "调用 /tomatoConfigController/putSyncTomatoConfig。",
+    "description": "调用 /tomatoConfigController/putSyncTomatoConfig(后端 @RequestBody TomatoConfig)。JSON 体。TomatoConfig 实体字段为 tcKey/workTime/shortRestTime/longRestTime/tomatoCircle/wirelessMode。",
     "http": {
       "method": "POST",
       "path": "/tomatoConfigController/putSyncTomatoConfig",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -2838,33 +3094,39 @@
     "params": [
       {
         "name": "config_key",
-        "backendName": "configKey",
+        "backendName": "tcKey",
         "type": "integer",
-        "description": "已存在的 configKey。"
+        "description": "已存在的 tcKey(映射到 TomatoConfig.tcKey)。"
       },
       {
         "name": "focus_duration_sec",
-        "backendName": "focusDuration",
+        "backendName": "workTime",
         "type": "integer",
-        "description": "专注秒数。"
+        "description": "专注秒数(映射到 TomatoConfig.workTime)。"
       },
       {
         "name": "break_duration_sec",
-        "backendName": "breakDuration",
+        "backendName": "shortRestTime",
         "type": "integer",
-        "description": "短休秒数。"
+        "description": "短休秒数(映射到 TomatoConfig.shortRestTime)。"
       },
       {
         "name": "long_break_duration_sec",
-        "backendName": "longBreakDuration",
+        "backendName": "longRestTime",
         "type": "integer",
-        "description": "长休秒数。"
+        "description": "长休秒数(映射到 TomatoConfig.longRestTime)。"
       },
       {
         "name": "long_break_every",
-        "backendName": "longBreakEvery",
+        "backendName": "tomatoCircle",
         "type": "integer",
-        "description": "每多少轮后长休。"
+        "description": "每多少轮后长休(映射到 TomatoConfig.tomatoCircle)。"
+      },
+      {
+        "name": "wireless_mode",
+        "backendName": "wirelessMode",
+        "type": "boolean",
+        "description": "是否无线模式(映射到 TomatoConfig.wirelessMode)。"
       },
       {
         "name": "sync_flag",
@@ -3036,10 +3298,11 @@
     "name": "zentodo.workstate.update",
     "domain": "workstate",
     "action": "update",
-    "description": "调用 /workStateController/updateWorkState。",
+    "description": "调用 /workStateController/updateWorkState(后端 @RequestBody WorkState)。JSON 体。WorkState 实体以 wsKey 为主键,字段为 startTime/matchKey/workType/tomatoState/tomatoRound(无 title/note 字段)。",
     "http": {
       "method": "POST",
-      "path": "/workStateController/updateWorkState"
+      "path": "/workStateController/updateWorkState",
+      "bodyFormat": "json"
     },
     "scopes": [
       "write"
@@ -3052,22 +3315,41 @@
     "params": [
       {
         "name": "work_state_key",
-        "backendName": "workStateKey",
-        "type": "string",
+        "backendName": "wsKey",
+        "type": "integer",
         "required": true,
-        "description": "工作状态 key。"
+        "description": "工作状态 key(映射到 WorkState.wsKey)。"
       },
       {
-        "name": "title",
-        "backendName": "title",
-        "type": "string",
-        "description": "新标题。"
+        "name": "start_time",
+        "backendName": "startTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "开始时间(映射到 WorkState.startTime)。"
       },
       {
-        "name": "note",
-        "backendName": "note",
-        "type": "string",
-        "description": "备注。"
+        "name": "match_key",
+        "backendName": "matchKey",
+        "type": "integer",
+        "description": "关联对象 key(映射到 WorkState.matchKey)。"
+      },
+      {
+        "name": "work_type",
+        "backendName": "workType",
+        "type": "integer",
+        "description": "工作类型(映射到 WorkState.workType)。"
+      },
+      {
+        "name": "tomato_state",
+        "backendName": "tomatoState",
+        "type": "integer",
+        "description": "番茄钟状态(映射到 WorkState.tomatoState)。"
+      },
+      {
+        "name": "tomato_round",
+        "backendName": "tomatoRound",
+        "type": "integer",
+        "description": "番茄钟轮次(映射到 WorkState.tomatoRound)。"
       }
     ],
     "output": {
@@ -3131,13 +3413,14 @@
     "name": "zentodo.workstate.sync-push",
     "domain": "workstate",
     "action": "sync-push",
-    "description": "调用 /workStateController/putSyncWorkState。",
+    "description": "调用 /workStateController/putSyncWorkState(后端 @RequestBody WorkState)。JSON 体。WorkState 实体以 wsKey 为主键。",
     "http": {
       "method": "POST",
       "path": "/workStateController/putSyncWorkState",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3151,9 +3434,28 @@
     "params": [
       {
         "name": "work_state_key",
-        "backendName": "workStateKey",
-        "type": "string",
-        "description": "已存在的 key。"
+        "backendName": "wsKey",
+        "type": "integer",
+        "description": "已存在的 wsKey(映射到 WorkState.wsKey)。"
+      },
+      {
+        "name": "start_time",
+        "backendName": "startTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "开始时间(映射到 WorkState.startTime)。"
+      },
+      {
+        "name": "match_key",
+        "backendName": "matchKey",
+        "type": "integer",
+        "description": "关联对象 key(映射到 WorkState.matchKey)。"
+      },
+      {
+        "name": "work_type",
+        "backendName": "workType",
+        "type": "integer",
+        "description": "工作类型(映射到 WorkState.workType)。"
       },
       {
         "name": "sync_flag",
@@ -3382,13 +3684,14 @@
     "name": "zentodo.mindmap.sync-push",
     "domain": "mindmap",
     "action": "sync-push",
-    "description": "调用 /gdMetaController/putSyncGDMeta。",
+    "description": "调用 /gdMetaController/putSyncGDMeta(后端 @RequestBody GDMeta)。JSON 体。GDMeta 实体以 meKey 为主键,字段为 title/metaDesc/content/iconUrl/bkUrl/templeteName/matchKey 等。",
     "http": {
       "method": "POST",
       "path": "/gdMetaController/putSyncGDMeta",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3402,21 +3705,69 @@
     "params": [
       {
         "name": "gd_meta_key",
-        "backendName": "gdMetaKey",
+        "backendName": "meKey",
         "type": "integer",
-        "description": "已存在的 gdMetaKey。"
+        "description": "已存在的 meKey(映射到 GDMeta.meKey)。"
       },
       {
         "name": "parent_key",
-        "backendName": "parentKey",
+        "backendName": "matchKey",
         "type": "integer",
-        "description": "父节点 key。"
+        "description": "父/关联节点 key(映射到 GDMeta.matchKey)。"
+      },
+      {
+        "name": "title",
+        "backendName": "title",
+        "type": "string",
+        "description": "节点标题(映射到 GDMeta.title)。"
       },
       {
         "name": "content",
         "backendName": "content",
         "type": "string",
-        "description": "节点内容。"
+        "description": "节点内容(映射到 GDMeta.content)。"
+      },
+      {
+        "name": "desc",
+        "backendName": "metaDesc",
+        "type": "string",
+        "description": "节点描述(映射到 GDMeta.metaDesc)。"
+      },
+      {
+        "name": "icon_url",
+        "backendName": "iconUrl",
+        "type": "string",
+        "description": "图标 URL(映射到 GDMeta.iconUrl)。"
+      },
+      {
+        "name": "bk_url",
+        "backendName": "bkUrl",
+        "type": "string",
+        "description": "背景图(映射到 GDMeta.bkUrl)。"
+      },
+      {
+        "name": "templete_name",
+        "backendName": "templeteName",
+        "type": "string",
+        "description": "模板名称(映射到 GDMeta.templeteName)。"
+      },
+      {
+        "name": "is_templete",
+        "backendName": "isTemplete",
+        "type": "integer",
+        "description": "是否模板(映射到 GDMeta.isTemplete)。"
+      },
+      {
+        "name": "templete_key",
+        "backendName": "templeteKey",
+        "type": "integer",
+        "description": "模板 key(映射到 GDMeta.templeteKey)。"
+      },
+      {
+        "name": "state",
+        "backendName": "state",
+        "type": "integer",
+        "description": "状态(映射到 GDMeta.state)。"
       },
       {
         "name": "sync_flag",
@@ -3487,13 +3838,14 @@
     "name": "zentodo.reward.store-sync-push",
     "domain": "reward",
     "action": "store-sync-push",
-    "description": "调用 /rewardStoreController/putSyncRewardStore。",
+    "description": "调用 /rewardStoreController/putSyncRewardStore(后端 @RequestBody RewardStore)。JSON 体。RewardStore 实体用 rsKey/rsName/rsPrice/rsDesc 系列字段。",
     "http": {
       "method": "POST",
       "path": "/rewardStoreController/putSyncRewardStore",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3507,21 +3859,45 @@
     "params": [
       {
         "name": "reward_key",
-        "backendName": "rewardKey",
+        "backendName": "rsKey",
         "type": "integer",
-        "description": "已存在的 rewardKey。"
+        "description": "已存在的 rsKey(映射到 RewardStore.rsKey)。"
       },
       {
         "name": "name",
-        "backendName": "rewardName",
+        "backendName": "rsName",
         "type": "string",
-        "description": "奖励名称。"
+        "description": "奖励名称(映射到 RewardStore.rsName)。"
       },
       {
         "name": "cost",
-        "backendName": "rewardCost",
+        "backendName": "rsPrice",
         "type": "integer",
-        "description": "兑换所需奖励币。"
+        "description": "兑换所需奖励币(映射到 RewardStore.rsPrice)。"
+      },
+      {
+        "name": "desc",
+        "backendName": "rsDesc",
+        "type": "string",
+        "description": "奖励描述(映射到 RewardStore.rsDesc)。"
+      },
+      {
+        "name": "image_url",
+        "backendName": "rsImageUrl",
+        "type": "string",
+        "description": "奖励图片 URL(映射到 RewardStore.rsImageUrl)。"
+      },
+      {
+        "name": "state",
+        "backendName": "rsState",
+        "type": "integer",
+        "description": "奖励状态(映射到 RewardStore.rsState)。"
+      },
+      {
+        "name": "repeat_limit",
+        "backendName": "repeatLimit",
+        "type": "string",
+        "description": "兑换次数限制(映射到 RewardStore.repeatLimit)。"
       },
       {
         "name": "sync_flag",
@@ -3629,13 +4005,14 @@
     "name": "zentodo.reward.record-sync-push",
     "domain": "reward",
     "action": "record-sync-push",
-    "description": "调用 /rewardRecordController/putSyncRewardRecord。",
+    "description": "调用 /rewardRecordController/putSyncRewardRecord(后端 @RequestBody RewardRecord)。JSON 体。RewardRecord 以 rsKey 标识记录对应的奖励,字段为 rrName/rrPrice/rrDesc/rrImageUrl。",
     "http": {
       "method": "POST",
       "path": "/rewardRecordController/putSyncRewardRecord",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3648,22 +4025,42 @@
     },
     "params": [
       {
-        "name": "record_key",
-        "backendName": "recordKey",
+        "name": "reward_key",
+        "backendName": "rsKey",
         "type": "integer",
-        "description": "已存在的记录 key。"
+        "required": true,
+        "description": "关联的奖励 rsKey(RewardRecord 通过 rsKey 识别对应商品)。"
       },
       {
-        "name": "reward_key",
-        "backendName": "rewardKey",
-        "type": "integer",
-        "description": "关联的奖励 key。"
+        "name": "name",
+        "backendName": "rrName",
+        "type": "string",
+        "description": "奖励名称快照(映射到 RewardRecord.rrName)。"
       },
       {
         "name": "cost",
-        "backendName": "cost",
+        "backendName": "rrPrice",
         "type": "integer",
-        "description": "消耗的奖励币。"
+        "description": "消耗的奖励币(映射到 RewardRecord.rrPrice)。"
+      },
+      {
+        "name": "desc",
+        "backendName": "rrDesc",
+        "type": "string",
+        "description": "备注(映射到 RewardRecord.rrDesc)。"
+      },
+      {
+        "name": "image_url",
+        "backendName": "rrImageUrl",
+        "type": "string",
+        "description": "图片(映射到 RewardRecord.rrImageUrl)。"
+      },
+      {
+        "name": "record_time",
+        "backendName": "recordTime",
+        "type": "datetime",
+        "transform": "isoToBackendDateTime",
+        "description": "兑换时间(映射到 RewardRecord.recordTime)。"
       },
       {
         "name": "sync_flag",
@@ -3734,13 +4131,14 @@
     "name": "zentodo.fasttime.sync-push",
     "domain": "fasttime",
     "action": "sync-push",
-    "description": "调用 /fastTimeRecordController/putSyncFastTimeRecord。",
+    "description": "调用 /fastTimeRecordController/putSyncFastTimeRecord(后端 @RequestBody FastTimeRecord)。JSON 体。FastTimeRecord 实体以 ftKey 为主键,字段为 qtEvent/qtDescription/qtTimeValue/qtTimePriority。",
     "http": {
       "method": "POST",
       "path": "/fastTimeRecordController/putSyncFastTimeRecord",
       "pragmas": [
         "stripAutoKeys"
-      ]
+      ],
+      "bodyFormat": "json"
     },
     "scopes": [
       "sync",
@@ -3754,21 +4152,63 @@
     "params": [
       {
         "name": "record_key",
-        "backendName": "recordKey",
+        "backendName": "ftKey",
         "type": "integer",
-        "description": "已存在的记录 key。"
+        "description": "已存在的 ftKey(映射到 FastTimeRecord.ftKey)。"
       },
       {
         "name": "title",
-        "backendName": "title",
+        "backendName": "qtEvent",
         "type": "string",
-        "description": "标题。"
+        "description": "事件名称(映射到 FastTimeRecord.qtEvent)。"
+      },
+      {
+        "name": "description",
+        "backendName": "qtDescription",
+        "type": "string",
+        "description": "描述(映射到 FastTimeRecord.qtDescription)。"
       },
       {
         "name": "duration_sec",
-        "backendName": "duration",
+        "backendName": "qtTimeValue",
+        "type": "string",
+        "description": "时长字符串(映射到 FastTimeRecord.qtTimeValue)。"
+      },
+      {
+        "name": "time_priority",
+        "backendName": "qtTimePriority",
+        "type": "integer",
+        "description": "时间优先级(映射到 FastTimeRecord.qtTimePriority)。"
+      },
+      {
+        "name": "top_label",
+        "backendName": "topLabel",
         "type": "integer",
-        "description": "时长(秒)。"
+        "description": "顶级标签 key(映射到 FastTimeRecord.topLabel)。"
+      },
+      {
+        "name": "second_label",
+        "backendName": "secondLabel",
+        "type": "integer",
+        "description": "二级标签 key(映射到 FastTimeRecord.secondLabel)。"
+      },
+      {
+        "name": "project_key",
+        "backendName": "projectKey",
+        "type": "integer",
+        "description": "关联项目 projectKey。"
+      },
+      {
+        "name": "scene_key",
+        "backendName": "sceneKey",
+        "type": "integer",
+        "description": "关联场景 sceneKey。"
+      },
+      {
+        "name": "delete_able",
+        "backendName": "deleteAble",
+        "type": "boolean",
+        "description": "是否可删除(映射到 FastTimeRecord.deleteAble)。"
       },
       {
         "name": "sync_flag",
@@ -3839,7 +4279,7 @@
     "name": "zentodo.wheel.sync-push",
     "domain": "wheel",
     "action": "sync-push",
-    "description": "调用 /wheelViewController/putSyncWheelView。",
+    "description": "调用 /wheelViewController/putSyncWheelView。注意:后端暂未提供 WheelView 实体/控制器,此 capability 为占位。",
     "http": {
       "method": "POST",
       "path": "/wheelViewController/putSyncWheelView",