@zentodo/cli 0.1.12 → 0.1.14

package/skills/zentodo/references/tools.md

@@ -209,7 +209,7 @@
 
 ## `zentodo.task.add`
 
-调用 /taskController/insertTask,使用 FormData 提交。
+调用 /taskController/insertTask,使用 JSON 请求体(后端 @RequestBody Tasks)。
 
 - **后端端点**:`POST /taskController/insertTask`
 - **所需 scope**:`write`
@@ -217,21 +217,21 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `title` | string | 是 | 任务标题。 |
-| `desc` | string | 否 | 任务描述。 |
-| `due` | datetime | 否 | 计划时间 / 截止时间(ISO)。 |
-| `priority` | integer | 否 | 优先级 0-4。 |
-| `project_key` | integer | 否 | 所属项目 projectKey。 |
-| `scene_key` | integer | 否 | 所属场景 sceneKey。 |
-| `labels` | array | 否 | 标签(自动拼接为 CSV)。 |
-| `mit` | boolean | 否 | 是否标记为 MIT(今日最重要)。 |
-| `reminder` | datetime | 否 | 提醒时间(ISO)。 |
-| `sub_of` | integer | 否 | 父任务 taskKey(子任务用)。 |
-| `quadrant` | integer | 否 | 时间四象限 0-3。 |
+| `title` | string | 是 | 任务标题(映射到 Tasks.taskName)。 |
+| `desc` | string | 否 | 任务描述(映射到 Tasks.taskDesc)。 |
+| `due` | datetime | 否 | 计划时间 / 截止时间(ISO,映射到 Tasks.taskCreateTime)。 |
+| `priority` | string | 否 | 优先级 0-4(Tasks.taskPriority 存为字符串)。 |
+| `project_key` | integer | 否 | 所属项目 projectKey(映射到 Tasks.projectKey)。 |
+| `scene_key` | integer | 否 | 所属场景 sceneKey(映射到 Tasks.sceneKey)。 |
+| `labels` | array | 否 | 标签 CSV(Tasks 实体只存单个 labelKey,此参数当前为 no-op,供前端兼容)。 |
+| `mit` | boolean | 否 | 是否标记为 MIT(今日最重要,映射到 Tasks.isMIT)。 |
+| `reminder` | datetime | 否 | 提醒时间(ISO,映射到 Tasks.taskReminderDate)。 |
+| `sub_of` | integer | 否 | Tasks 实体无 taskParentKey 字段,此参数为 no-op;子任务请使用 subtask.sync-push。 |
+| `quadrant` | integer | 否 | 时间四象限 0-3(映射到 Tasks.task4time)。 |
 
 ## `zentodo.task.update`
 
-调用 /taskController/updateTask。未传入的字段不会被写入 FormData,避免把现有列置空。
+调用 /taskController/updateTask(后端 @RequestBody Tasks)。未传入的字段不会被写入 JSON payload,避免把现有列置空。
 
 - **后端端点**:`POST /taskController/updateTask`
 - **所需 scope**:`write`
@@ -240,15 +240,15 @@
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `task_key` | integer | 是 | 任务 taskKey。 |
-| `title` | string | 否 | 新标题。 |
-| `desc` | string | 否 | 新描述。 |
-| `due` | datetime | 否 | 新计划时间(ISO)。 |
-| `priority` | integer | 否 | 新优先级。 |
-| `project_key` | integer | 否 | 迁移到的 projectKey。 |
-| `scene_key` | integer | 否 | 迁移到的 sceneKey。 |
-| `labels` | array | 否 | 标签(CSV)。 |
-| `reminder` | datetime | 否 | 新提醒时间(ISO)。 |
-| `quadrant` | integer | 否 | 时间四象限。 |
+| `title` | string | 否 | 新标题(映射到 Tasks.taskName)。 |
+| `desc` | string | 否 | 新描述(映射到 Tasks.taskDesc)。 |
+| `due` | datetime | 否 | 新计划时间(ISO,映射到 Tasks.taskCreateTime)。 |
+| `priority` | string | 否 | 新优先级(Tasks.taskPriority 存为字符串)。 |
+| `project_key` | integer | 否 | 迁移到的 projectKey(映射到 Tasks.projectKey)。 |
+| `scene_key` | integer | 否 | 迁移到的 sceneKey(映射到 Tasks.sceneKey)。 |
+| `labels` | array | 否 | 标签 CSV(Tasks 实体只存单个 labelKey,此参数当前为 no-op)。 |
+| `reminder` | datetime | 否 | 新提醒时间(ISO,映射到 Tasks.taskReminderDate)。 |
+| `quadrant` | integer | 否 | 时间四象限(映射到 Tasks.task4time)。 |
 | `sync_flag` | string | 否 | 同步标记,默认 M。 |
 
 ## `zentodo.task.delete`
@@ -277,7 +277,7 @@
 
 ## `zentodo.task.uncomplete`
 
-调用 /taskController/updateTask,把 taskState 还原为 1 并清空完成时间。
+调用 /taskController/updateTask(@RequestBody),把 taskState 还原为 1 并清空完成时间。
 
 - **后端端点**:`POST /taskController/updateTask`
 - **所需 scope**:`write`
@@ -417,7 +417,7 @@
 
 ## `zentodo.task.sync-push`
 
-调用 /taskController/putSyncTask。所有字段通过 FormData 提交,自动剥离 id / rowid。
+调用 /taskController/putSyncTask(@RequestBody Tasks),完整字段提交,自动剥离 id / rowid。
 
 - **后端端点**:`POST /taskController/putSyncTask`
 - **所需 scope**:`sync, write`
@@ -438,7 +438,7 @@
 
 ## `zentodo.subtask.sync-push`
 
-调用 /subTaskController/putSyncSubTask。所有字段通过 FormData 提交,自动剥离 id/rowid。
+调用 /subTaskController/putSyncSubTask(后端 @RequestBody SubTask)。JSON 体,自动剥离 id/rowid。
 
 - **后端端点**:`POST /subTaskController/putSyncSubTask`
 - **所需 scope**:`sync, write`
@@ -448,8 +448,8 @@
 | --- | --- | --- | --- |
 | `sub_task_key` | integer | 否 | 已存在的子任务 key(省略则新建)。 |
 | `task_key` | integer | 是 | 父任务 taskKey。 |
-| `title` | string | 否 | 子任务标题。 |
-| `state` | integer | 否 | 状态(0=完成, 1=未完成)。 |
+| `title` | string | 否 | 子任务标题(映射到 SubTask.subTaskName)。 |
+| `state` | boolean | 否 | 状态(SubTask.subTaskState 为 Boolean;true=完成)。 |
 | `sync_flag` | string | 否 | M=修改, D=删除, I=新增。 |
 
 ## `zentodo.subtask.list-all`
@@ -474,7 +474,7 @@
 
 ## `zentodo.project.sync-push`
 
-调用 /projectController/putSyncProject。所有字段通过 FormData 提交,自动剥离 id/rowid。
+调用 /projectController/putSyncProject(后端 @RequestBody Project)。所有字段以 JSON 体提交,自动剥离 id/rowid。
 
 - **后端端点**:`POST /projectController/putSyncProject`
 - **所需 scope**:`sync, write`
@@ -483,12 +483,16 @@
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `project_key` | integer | 否 | 已存在的 projectKey(省略则新建)。 |
-| `name` | string | 否 | 项目名称。 |
-| `color` | string | 否 | 十六进制颜色。 |
-| `icon` | string | 否 | 图标标识。 |
-| `parent_key` | integer | 否 | 父项目 projectKey(用于子项目)。 |
-| `state` | integer | 否 | 0=未开始, 1=进行中, 2=已完成, 3=已暂停, 4=已取消。 |
-| `archived` | boolean | 否 | 归档标记。 |
+| `name` | string | 否 | 项目名称(映射到 Project.projectName)。 |
+| `desc` | string | 否 | 项目描述(映射到 Project.projectDesc)。 |
+| `bk_url` | string | 否 | 项目背景图 URL(映射到 Project.projectBKUrl)。 |
+| `header_url` | string | 否 | 项目头图 URL(映射到 Project.projectHeaderUrl)。 |
+| `label_key` | integer | 否 | 关联标签 labelKey(映射到 Project.labelKey)。 |
+| `target_key` | integer | 否 | 关联目标 targetKey(映射到 Project.targetKey)。 |
+| `state` | integer | 否 | 项目状态(映射到 Project.projectState)。 |
+| `star` | boolean | 否 | 是否标星(映射到 Project.isStar)。 |
+| `is_templete` | boolean | 否 | 是否模板(映射到 Project.isTemplete)。 |
+| `end_time` | datetime | 否 | 项目结束时间(ISO,映射到 Project.endTime)。 |
 | `sync_flag` | string | 否 | M=修改, D=删除, I=新增。 |
 
 ## `zentodo.project.list-all`
@@ -554,7 +558,7 @@
 
 ## `zentodo.subproject.sync-push`
 
-调用 /subProjectController/putSyncSubProject。
+调用 /subProjectController/putSyncSubProject(后端 @RequestBody SubProject)。JSON 体。
 
 - **后端端点**:`POST /subProjectController/putSyncSubProject`
 - **所需 scope**:`sync, write`
@@ -562,9 +566,12 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `sub_project_key` | integer | 否 | 已存在的子项目 key。 |
+| `sub_project_key` | integer | 否 | 已存在的子项目 key(映射到 SubProject.spKey)。 |
 | `project_key` | integer | 是 | 父项目 projectKey。 |
-| `name` | string | 否 | 子项目名称。 |
+| `name` | string | 否 | 子项目名称(映射到 SubProject.spName)。 |
+| `desc` | string | 否 | 子项目描述(映射到 SubProject.spDesc)。 |
+| `bk_url` | string | 否 | 子项目背景图(映射到 SubProject.spBKUrl)。 |
+| `state` | integer | 否 | 子项目状态(映射到 SubProject.spState)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.subproject.list-all`
@@ -589,7 +596,7 @@
 
 ## `zentodo.scene.sync-push`
 
-调用 /sceneController/putSyncScene。
+调用 /sceneController/putSyncScene(后端 @RequestBody Scene)。JSON 体。Scene 实体仅含 sceneName / sceneState / sceneKey,没有 icon / desc 字段。
 
 - **后端端点**:`POST /sceneController/putSyncScene`
 - **所需 scope**:`sync, write`
@@ -598,9 +605,8 @@
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `scene_key` | integer | 否 | 已存在的场景 key。 |
-| `name` | string | 否 | 场景名称。 |
-| `icon` | string | 否 | 图标标识。 |
-| `desc` | string | 否 | 场景描述。 |
+| `name` | string | 否 | 场景名称(映射到 Scene.sceneName)。 |
+| `state` | boolean | 否 | 场景启用状态(Scene.sceneState 为 Boolean)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.scene.list-all`
@@ -625,7 +631,7 @@
 
 ## `zentodo.target.sync-push`
 
-调用 /targetController/putSyncTarget。
+调用 /targetController/putSyncTarget(后端 @RequestBody Target)。JSON 体。Target 实体用 ttName/ttDesc/ttState 系列字段,不是 targetTitle。
 
 - **后端端点**:`POST /targetController/putSyncTarget`
 - **所需 scope**:`sync, write`
@@ -634,9 +640,15 @@
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `target_key` | integer | 否 | 已存在的目标 key。 |
-| `title` | string | 否 | 目标标题。 |
-| `desc` | string | 否 | 目标描述。 |
-| `deadline` | date | 否 | 截止日期(ISO)。 |
+| `title` | string | 否 | 目标标题(映射到 Target.ttName)。 |
+| `desc` | string | 否 | 目标描述(映射到 Target.ttDesc)。 |
+| `bk_url` | string | 否 | 背景图(映射到 Target.bkUrl)。 |
+| `state` | integer | 否 | 状态(映射到 Target.ttState)。 |
+| `label_key` | integer | 否 | 关联标签 labelKey。 |
+| `label_name` | string | 否 | 标签名快照(映射到 Target.labelName)。 |
+| `deadline` | datetime | 否 | 截止日期(ISO,映射到 Target.endTime)。 |
+| `start_time` | datetime | 否 | 开始日期(ISO,映射到 Target.startTime)。 |
+| `reward_value` | integer | 否 | 完成奖励(映射到 Target.rewardValue)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.target.list-all`
@@ -661,7 +673,7 @@
 
 ## `zentodo.label.sync-push`
 
-调用 /labelController/putSyncLabel。
+调用 /labelController/putSyncLabel(后端 @RequestBody Label)。JSON 体。Label 实体颜色字段是 iconColor,不是 labelColor;另有 labelDesc/labelBKUrl/iconIndex/labelType。
 
 - **后端端点**:`POST /labelController/putSyncLabel`
 - **所需 scope**:`sync, write`
@@ -670,8 +682,12 @@
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `label_key` | integer | 否 | 已存在的标签 key。 |
-| `name` | string | 否 | 标签名。 |
-| `color` | string | 否 | 十六进制颜色。 |
+| `name` | string | 否 | 标签名(映射到 Label.labelName)。 |
+| `desc` | string | 否 | 标签描述(映射到 Label.labelDesc)。 |
+| `color` | string | 否 | 图标/标签颜色十六进制(映射到 Label.iconColor)。 |
+| `icon_index` | integer | 否 | 图标索引(映射到 Label.iconIndex)。 |
+| `label_type` | integer | 否 | 标签类型:0 子任务 / 1 任务 / 2 项目 / 3 目标(映射到 Label.labelType)。 |
+| `bk_url` | string | 否 | 背景图 URL(映射到 Label.labelBKUrl)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.label.list-all`
@@ -697,7 +713,7 @@
 
 ## `zentodo.toplabel.sync-push`
 
-调用 /topLabelController/putSyncTopLabel。
+调用 /topLabelController/putSyncTopLabel。注意:后端暂未提供 TopLabel 实体/控制器,此 capability 为占位。
 
 - **后端端点**:`POST /topLabelController/putSyncTopLabel`
 - **所需 scope**:`sync, write`
@@ -731,7 +747,7 @@
 
 ## `zentodo.quadrant.sync-push`
 
-调用 /quadrantController/putSyncQuadrant。
+调用 /quadrantController/putSyncQuadrant(后端 @RequestBody Quadrant)。JSON 体。Quadrant 实体用 meKey 作主键,字段为 time1..4/color1..4/rules。
 
 - **后端端点**:`POST /quadrantController/putSyncQuadrant`
 - **所需 scope**:`sync, write`
@@ -739,9 +755,16 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `quadrant_key` | integer | 否 | 已存在的 quadrantKey。 |
-| `title` | string | 否 | 象限标题。 |
-| `index` | integer | 否 | 象限索引 0..3。 |
+| `me_key` | integer | 否 | 已存在的 meKey(映射到 Quadrant.meKey,四象限配置以 meKey 唯一识别)。 |
+| `time1` | string | 否 | 第 1 象限时间值(映射到 Quadrant.time1)。 |
+| `time2` | string | 否 | 第 2 象限时间值。 |
+| `time3` | string | 否 | 第 3 象限时间值。 |
+| `time4` | string | 否 | 第 4 象限时间值。 |
+| `color1` | string | 否 | 第 1 象限颜色。 |
+| `color2` | string | 否 | 第 2 象限颜色。 |
+| `color3` | string | 否 | 第 3 象限颜色。 |
+| `color4` | string | 否 | 第 4 象限颜色。 |
+| `rules` | string | 否 | 象限规则配置(JSON 字符串)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.quadrant.list-all`
@@ -766,7 +789,7 @@
 
 ## `zentodo.timeline.sync-push`
 
-调用 /timeLineController/putSyncTimeLine。
+调用 /timeLineController/putSyncTimeLine(后端 @RequestBody TimeLine)。JSON 体。TimeLine 实体字段为 tlKey/tlName/tlDesc/tlType/tlImageUrl/startTime/endTime,无 timeLineTitle/Content/Time 字段。
 
 - **后端端点**:`POST /timeLineController/putSyncTimeLine`
 - **所需 scope**:`sync, write`
@@ -774,10 +797,17 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `time_line_key` | integer | 否 | 已存在的 timeLineKey。 |
-| `title` | string | 否 | 标题。 |
-| `content` | string | 否 | 正文。 |
-| `time` | datetime | 否 | 时间戳(ISO)。 |
+| `time_line_key` | integer | 否 | 已存在的 tlKey(映射到 TimeLine.tlKey)。 |
+| `title` | string | 否 | 标题(映射到 TimeLine.tlName)。 |
+| `content` | string | 否 | 正文/描述(映射到 TimeLine.tlDesc)。 |
+| `type` | string | 否 | 类型(映射到 TimeLine.tlType)。 |
+| `image_url` | string | 否 | 配图(映射到 TimeLine.tlImageUrl)。 |
+| `start_time` | datetime | 否 | 开始时间(ISO,映射到 TimeLine.startTime)。 |
+| `end_time` | datetime | 否 | 结束时间(ISO,映射到 TimeLine.endTime)。 |
+| `match_key` | integer | 否 | 关联对象 key(task/project/target,根据 tlType 解释)。 |
+| `target_key` | integer | 否 | 关联目标 targetKey。 |
+| `project_key` | integer | 否 | 关联项目 projectKey。 |
+| `label_name` | string | 否 | 标签名快照(映射到 TimeLine.labelName)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.timeline.list-all`
@@ -861,7 +891,7 @@
 
 ## `zentodo.attach.sync-push`
 
-调用 /attachmentController/putSyncAttchment。
+调用 /attachmentController/putSyncAttchment(后端 @RequestBody Attachment)。JSON 体,仅元数据,不包含文件二进制。Attachment 实体以 athKey 为主键,通过 matchKey 关联任务/导图节点。
 
 - **后端端点**:`POST /attachmentController/putSyncAttchment`
 - **所需 scope**:`sync, write`
@@ -869,7 +899,13 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `attachment_key` | integer | 否 | 已存在的 attachmentKey。 |
+| `attachment_key` | integer | 否 | 已存在的 athKey(映射到 Attachment.athKey)。 |
+| `match_key` | integer | 否 | 关联对象 key(映射到 Attachment.matchKey)。 |
+| `file_url` | string | 否 | 客户端本地文件 URL(映射到 Attachment.fileUrl)。 |
+| `service_file_url` | string | 否 | 服务端文件 URL(映射到 Attachment.serviceFileUrl)。 |
+| `file_type` | string | 否 | 文件类型(映射到 Attachment.fileType)。 |
+| `file_desc` | string | 否 | 文件描述(映射到 Attachment.fileDesc)。 |
+| `remark` | string | 否 | 备注(映射到 Attachment.remark)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.pomo.start`
@@ -934,7 +970,7 @@
 
 ## `zentodo.pomo.sync-push-worker`
 
-调用 /tomatoWorkerController/putSyncTomatoWorker。
+调用 /tomatoWorkerController/putSyncTomatoWorker(后端 @RequestBody TomatoWorker)。JSON 体。TomatoWorker 实体以 twKey 为主键,通过 matchKey 关联任务。
 
 - **后端端点**:`POST /tomatoWorkerController/putSyncTomatoWorker`
 - **所需 scope**:`sync, write`
@@ -942,8 +978,11 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `tomato_key` | integer | 否 | 已存在的 tomatoKey。 |
-| `task_key` | integer | 否 | 任务 taskKey。 |
+| `tomato_key` | integer | 否 | 已存在的 twKey(映射到 TomatoWorker.twKey)。 |
+| `task_key` | integer | 否 | 关联任务的 taskKey(TomatoWorker 用 matchKey 关联)。 |
+| `is_tomato` | boolean | 否 | 是否番茄钟记录(映射到 TomatoWorker.isTomato)。 |
+| `start_time` | datetime | 否 | 开始时间(映射到 TomatoWorker.tomatoStartTime)。 |
+| `execute_time` | string | 否 | 实际执行时长(映射到 TomatoWorker.tomatoExecuteTime)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.pomo.config-get`
@@ -956,7 +995,7 @@
 
 ## `zentodo.pomo.config-set`
 
-调用 /tomatoConfigController/putSyncTomatoConfig。
+调用 /tomatoConfigController/putSyncTomatoConfig(后端 @RequestBody TomatoConfig)。JSON 体。TomatoConfig 实体字段为 tcKey/workTime/shortRestTime/longRestTime/tomatoCircle/wirelessMode。
 
 - **后端端点**:`POST /tomatoConfigController/putSyncTomatoConfig`
 - **所需 scope**:`sync, write`
@@ -964,11 +1003,12 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `config_key` | integer | 否 | 已存在的 configKey。 |
-| `focus_duration_sec` | integer | 否 | 专注秒数。 |
-| `break_duration_sec` | integer | 否 | 短休秒数。 |
-| `long_break_duration_sec` | integer | 否 | 长休秒数。 |
-| `long_break_every` | integer | 否 | 每多少轮后长休。 |
+| `config_key` | integer | 否 | 已存在的 tcKey(映射到 TomatoConfig.tcKey)。 |
+| `focus_duration_sec` | integer | 否 | 专注秒数(映射到 TomatoConfig.workTime)。 |
+| `break_duration_sec` | integer | 否 | 短休秒数(映射到 TomatoConfig.shortRestTime)。 |
+| `long_break_duration_sec` | integer | 否 | 长休秒数(映射到 TomatoConfig.longRestTime)。 |
+| `long_break_every` | integer | 否 | 每多少轮后长休(映射到 TomatoConfig.tomatoCircle)。 |
+| `wireless_mode` | boolean | 否 | 是否无线模式(映射到 TomatoConfig.wirelessMode)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.pomo.sync-pull-config`
@@ -1031,7 +1071,7 @@
 
 ## `zentodo.workstate.update`
 
-调用 /workStateController/updateWorkState。
+调用 /workStateController/updateWorkState(后端 @RequestBody WorkState)。JSON 体。WorkState 实体以 wsKey 为主键,字段为 startTime/matchKey/workType/tomatoState/tomatoRound(无 title/note 字段)。
 
 - **后端端点**:`POST /workStateController/updateWorkState`
 - **所需 scope**:`write`
@@ -1039,9 +1079,12 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `work_state_key` | string | 是 | 工作状态 key。 |
-| `title` | string | 否 | 新标题。 |
-| `note` | string | 否 | 备注。 |
+| `work_state_key` | integer | 是 | 工作状态 key(映射到 WorkState.wsKey)。 |
+| `start_time` | datetime | 否 | 开始时间(映射到 WorkState.startTime)。 |
+| `match_key` | integer | 否 | 关联对象 key(映射到 WorkState.matchKey)。 |
+| `work_type` | integer | 否 | 工作类型(映射到 WorkState.workType)。 |
+| `tomato_state` | integer | 否 | 番茄钟状态(映射到 WorkState.tomatoState)。 |
+| `tomato_round` | integer | 否 | 番茄钟轮次(映射到 WorkState.tomatoRound)。 |
 
 ## `zentodo.workstate.list-all`
 
@@ -1065,7 +1108,7 @@
 
 ## `zentodo.workstate.sync-push`
 
-调用 /workStateController/putSyncWorkState。
+调用 /workStateController/putSyncWorkState(后端 @RequestBody WorkState)。JSON 体。WorkState 实体以 wsKey 为主键。
 
 - **后端端点**:`POST /workStateController/putSyncWorkState`
 - **所需 scope**:`sync, write`
@@ -1073,7 +1116,10 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `work_state_key` | string | 否 | 已存在的 key。 |
+| `work_state_key` | integer | 否 | 已存在的 wsKey(映射到 WorkState.wsKey)。 |
+| `start_time` | datetime | 否 | 开始时间(映射到 WorkState.startTime)。 |
+| `match_key` | integer | 否 | 关联对象 key(映射到 WorkState.matchKey)。 |
+| `work_type` | integer | 否 | 工作类型(映射到 WorkState.workType)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.diary.title-list`
@@ -1148,7 +1194,7 @@
 
 ## `zentodo.mindmap.sync-push`
 
-调用 /gdMetaController/putSyncGDMeta。
+调用 /gdMetaController/putSyncGDMeta(后端 @RequestBody GDMeta)。JSON 体。GDMeta 实体以 meKey 为主键,字段为 title/metaDesc/content/iconUrl/bkUrl/templeteName/matchKey 等。
 
 - **后端端点**:`POST /gdMetaController/putSyncGDMeta`
 - **所需 scope**:`sync, write`
@@ -1156,9 +1202,17 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `gd_meta_key` | integer | 否 | 已存在的 gdMetaKey。 |
-| `parent_key` | integer | 否 | 父节点 key。 |
-| `content` | string | 否 | 节点内容。 |
+| `gd_meta_key` | integer | 否 | 已存在的 meKey(映射到 GDMeta.meKey)。 |
+| `parent_key` | integer | 否 | 父/关联节点 key(映射到 GDMeta.matchKey)。 |
+| `title` | string | 否 | 节点标题(映射到 GDMeta.title)。 |
+| `content` | string | 否 | 节点内容(映射到 GDMeta.content)。 |
+| `desc` | string | 否 | 节点描述(映射到 GDMeta.metaDesc)。 |
+| `icon_url` | string | 否 | 图标 URL(映射到 GDMeta.iconUrl)。 |
+| `bk_url` | string | 否 | 背景图(映射到 GDMeta.bkUrl)。 |
+| `templete_name` | string | 否 | 模板名称(映射到 GDMeta.templeteName)。 |
+| `is_templete` | integer | 否 | 是否模板(映射到 GDMeta.isTemplete)。 |
+| `templete_key` | integer | 否 | 模板 key(映射到 GDMeta.templeteKey)。 |
+| `state` | integer | 否 | 状态(映射到 GDMeta.state)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.mindmap.list-all`
@@ -1183,7 +1237,7 @@
 
 ## `zentodo.reward.store-sync-push`
 
-调用 /rewardStoreController/putSyncRewardStore。
+调用 /rewardStoreController/putSyncRewardStore(后端 @RequestBody RewardStore)。JSON 体。RewardStore 实体用 rsKey/rsName/rsPrice/rsDesc 系列字段。
 
 - **后端端点**:`POST /rewardStoreController/putSyncRewardStore`
 - **所需 scope**:`sync, write`
@@ -1191,9 +1245,13 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `reward_key` | integer | 否 | 已存在的 rewardKey。 |
-| `name` | string | 否 | 奖励名称。 |
-| `cost` | integer | 否 | 兑换所需奖励币。 |
+| `reward_key` | integer | 否 | 已存在的 rsKey(映射到 RewardStore.rsKey)。 |
+| `name` | string | 否 | 奖励名称(映射到 RewardStore.rsName)。 |
+| `cost` | integer | 否 | 兑换所需奖励币(映射到 RewardStore.rsPrice)。 |
+| `desc` | string | 否 | 奖励描述(映射到 RewardStore.rsDesc)。 |
+| `image_url` | string | 否 | 奖励图片 URL(映射到 RewardStore.rsImageUrl)。 |
+| `state` | integer | 否 | 奖励状态(映射到 RewardStore.rsState)。 |
+| `repeat_limit` | string | 否 | 兑换次数限制(映射到 RewardStore.repeatLimit)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.reward.store-list`
@@ -1231,7 +1289,7 @@
 
 ## `zentodo.reward.record-sync-push`
 
-调用 /rewardRecordController/putSyncRewardRecord。
+调用 /rewardRecordController/putSyncRewardRecord(后端 @RequestBody RewardRecord)。JSON 体。RewardRecord 以 rsKey 标识记录对应的奖励,字段为 rrName/rrPrice/rrDesc/rrImageUrl。
 
 - **后端端点**:`POST /rewardRecordController/putSyncRewardRecord`
 - **所需 scope**:`sync, write`
@@ -1239,9 +1297,12 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `record_key` | integer | 否 | 已存在的记录 key。 |
-| `reward_key` | integer | 否 | 关联的奖励 key。 |
-| `cost` | integer | 否 | 消耗的奖励币。 |
+| `reward_key` | integer | 是 | 关联的奖励 rsKey(RewardRecord 通过 rsKey 识别对应商品)。 |
+| `name` | string | 否 | 奖励名称快照(映射到 RewardRecord.rrName)。 |
+| `cost` | integer | 否 | 消耗的奖励币(映射到 RewardRecord.rrPrice)。 |
+| `desc` | string | 否 | 备注(映射到 RewardRecord.rrDesc)。 |
+| `image_url` | string | 否 | 图片(映射到 RewardRecord.rrImageUrl)。 |
+| `record_time` | datetime | 否 | 兑换时间(映射到 RewardRecord.recordTime)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.reward.record-list`
@@ -1266,7 +1327,7 @@
 
 ## `zentodo.fasttime.sync-push`
 
-调用 /fastTimeRecordController/putSyncFastTimeRecord。
+调用 /fastTimeRecordController/putSyncFastTimeRecord(后端 @RequestBody FastTimeRecord)。JSON 体。FastTimeRecord 实体以 ftKey 为主键,字段为 qtEvent/qtDescription/qtTimeValue/qtTimePriority。
 
 - **后端端点**:`POST /fastTimeRecordController/putSyncFastTimeRecord`
 - **所需 scope**:`sync, write`
@@ -1274,9 +1335,16 @@
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `record_key` | integer | 否 | 已存在的记录 key。 |
-| `title` | string | 否 | 标题。 |
-| `duration_sec` | integer | 否 | 时长(秒)。 |
+| `record_key` | integer | 否 | 已存在的 ftKey(映射到 FastTimeRecord.ftKey)。 |
+| `title` | string | 否 | 事件名称(映射到 FastTimeRecord.qtEvent)。 |
+| `description` | string | 否 | 描述(映射到 FastTimeRecord.qtDescription)。 |
+| `duration_sec` | string | 否 | 时长字符串(映射到 FastTimeRecord.qtTimeValue)。 |
+| `time_priority` | integer | 否 | 时间优先级(映射到 FastTimeRecord.qtTimePriority)。 |
+| `top_label` | integer | 否 | 顶级标签 key(映射到 FastTimeRecord.topLabel)。 |
+| `second_label` | integer | 否 | 二级标签 key(映射到 FastTimeRecord.secondLabel)。 |
+| `project_key` | integer | 否 | 关联项目 projectKey。 |
+| `scene_key` | integer | 否 | 关联场景 sceneKey。 |
+| `delete_able` | boolean | 否 | 是否可删除(映射到 FastTimeRecord.deleteAble)。 |
 | `sync_flag` | string | 否 | 同步标记。 |
 
 ## `zentodo.fasttime.list-all`
@@ -1301,7 +1369,7 @@
 
 ## `zentodo.wheel.sync-push`
 
-调用 /wheelViewController/putSyncWheelView。
+调用 /wheelViewController/putSyncWheelView。注意:后端暂未提供 WheelView 实体/控制器,此 capability 为占位。
 
 - **后端端点**:`POST /wheelViewController/putSyncWheelView`
 - **所需 scope**:`sync, write`