@zentodo/cli 0.1.1 → 0.1.3

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

@@ -0,0 +1,1360 @@
+# ZenTodo MCP 工具参考
+
+> 本文档由清单自动生成。工具命名统一为 `zentodo.<domain>.<action>`。
+
+每个工具返回的外壳结构相同:
+
+```json
+{
+  "ok": true,
+  "data": <业务数据>,
+  "error": null,
+  "meta": { "requestId": "...", "durationMs": 0, "scopeChecked": ["read"] }
+}
+```
+
+## `zentodo.auth.login-password`
+
+调用 /userController/loginXzbb 完成身份校验，返回用户信息与 usrKey。
+
+- **后端端点**:`POST /userController/loginXzbb`
+- **所需 scope**:`read`
+- **标注**:只读=false,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 账号邮箱。 |
+| `password` | string | 是 | 账号密码。 |
+
+## `zentodo.auth.login-email`
+
+调用 /userController/emailLogin，只需邮箱，配合 email-code 命令先发验证码。返回 usrKey（Long）。
+
+- **后端端点**:`POST /userController/emailLogin`
+- **所需 scope**:`read`
+- **标注**:只读=false,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 账号邮箱。 |
+| `invite_code` | string | 否 | 邀请码（可选）。 |
+| `password` | string | 否 | 密码（传空字符串即可）。 |
+
+## `zentodo.auth.email-code`
+
+调用 /userController/sendAuthEmailCode 向指定邮箱发送验证码。
+
+- **后端端点**:`POST /userController/sendAuthEmailCode`
+- **所需 scope**:`read`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 收件邮箱。 |
+
+## `zentodo.auth.register`
+
+调用 /userController/regisiterApp；仅传入邮箱与密码，昵称后续再更新。
+
+- **后端端点**:`POST /userController/regisiterApp`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 账号邮箱。 |
+| `password` | string | 是 | 账号密码。 |
+
+## `zentodo.auth.find-password`
+
+调用 /userController/findPasswordByUsrEmail,服务器将发送找回邮件。
+
+- **后端端点**:`POST /userController/findPasswordByUsrEmail`
+- **所需 scope**:`read`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 账号邮箱。 |
+
+## `zentodo.auth.change-password`
+
+调用 /userController/updateUserWithoutPhoto,携带 usrPwd 与 syncFlag=U。
+
+- **后端端点**:`POST /userController/updateUserWithoutPhoto`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `user_key` | integer | 是 | 目标 usrKey。 |
+| `password` | string | 是 | 新密码。 |
+| `sync_flag` | string | 否 | 同步标记,默认 U。 |
+
+## `zentodo.auth.delete-account`
+
+调用 /userController/deleteUsrByUsrKey。属于破坏性操作,必须携带 --yes。
+
+- **后端端点**:`POST /userController/deleteUsrByUsrKey`
+- **所需 scope**:`destructive, admin`
+- **标注**:只读=false,幂等=false,破坏性=true
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `user_key` | integer | 是 | 目标 usrKey。 |
+
+## `zentodo.auth.email-exists`
+
+调用 /userController/isEmailExist。
+
+- **后端端点**:`POST /userController/isEmailExist`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 待检查的邮箱。 |
+
+## `zentodo.auth.phone-exists`
+
+调用 /userController/isPhoneExist。
+
+- **后端端点**:`POST /userController/isPhoneExist`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `phone` | string | 是 | 待检查的手机号。 |
+
+## `zentodo.user.info`
+
+调用 /userController/getUserInfoByUsrKey。
+
+- **后端端点**:`POST /userController/getUserInfoByUsrKey`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.user.update`
+
+调用 /userController/updateUserWithoutPhoto。只会上传显式传入的字段,未传字段不会覆盖为空。
+
+- **后端端点**:`POST /userController/updateUserWithoutPhoto`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `nickname` | string | 否 | 昵称。 |
+| `phone` | string | 否 | 手机号。 |
+| `gender` | string | 否 | 性别。 |
+| `birthday` | date | 否 | 生日(ISO 日期)。 |
+| `signature` | string | 否 | 个性签名。 |
+
+## `zentodo.user.avatar-get`
+
+调用 /userController/getUserAvatarByUsrKey。
+
+- **后端端点**:`POST /userController/getUserAvatarByUsrKey`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.user.invite-code`
+
+调用 /userController/getInviteCodeByUsrKey。
+
+- **后端端点**:`POST /userController/getInviteCodeByUsrKey`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.user.reward-coin-get`
+
+调用 /userController/getRewardCoinByUsrKey。
+
+- **后端端点**:`POST /userController/getRewardCoinByUsrKey`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.user.reward-coin-set`
+
+调用 /userController/setRewardCoinByUsrKey。
+
+- **后端端点**:`POST /userController/setRewardCoinByUsrKey`
+- **所需 scope**:`write, destructive`
+- **标注**:只读=false,幂等=false,破坏性=true
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `reward_coin` | integer | 是 | 新的余额值。 |
+
+## `zentodo.user.vip-set`
+
+调用 /userController/setVipEndDate。
+
+- **后端端点**:`POST /userController/setVipEndDate`
+- **所需 scope**:`write, admin`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `vip_end_date` | date | 是 | VIP 到期日(ISO 日期)。 |
+
+## `zentodo.user.restore-default-label`
+
+调用 /userController/restoreDefaultLabel。
+
+- **后端端点**:`POST /userController/restoreDefaultLabel`
+- **所需 scope**:`destructive, write`
+- **标注**:只读=false,幂等=false,破坏性=true
+
+## `zentodo.task.add`
+
+调用 /taskController/insertTask,使用 FormData 提交。
+
+- **后端端点**:`POST /taskController/insertTask`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `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。 |
+
+## `zentodo.task.update`
+
+调用 /taskController/updateTask。未传入的字段不会被写入 FormData,避免把现有列置空。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `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 | 否 | 时间四象限。 |
+| `sync_flag` | string | 否 | 同步标记,默认 M。 |
+
+## `zentodo.task.delete`
+
+调用 /taskController/updateTask,自动注入 syncFlag=D。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`destructive, write`
+- **标注**:只读=false,幂等=false,破坏性=true
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+
+## `zentodo.task.complete`
+
+调用 /taskController/updateTask,自动注入 taskState=0 与今日的 taskCompletedTime。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+
+## `zentodo.task.uncomplete`
+
+调用 /taskController/updateTask,把 taskState 还原为 1 并清空完成时间。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `task_state` | integer | 否 | 开放态(一般为 1)。 |
+| `task_completed_time` | string | 否 | 清空完成时间。 |
+
+## `zentodo.task.mit`
+
+调用 /taskController/updateTask,注入 isMIT 与 syncFlag=M。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `is_mit` | boolean | 是 | 是否为 MIT。 |
+
+## `zentodo.task.quadrant`
+
+调用 /taskController/updateTask,注入 task4time 与 syncFlag=M。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `quadrant` | integer | 是 | 象限 0..3。 |
+
+## `zentodo.task.completed-today`
+
+调用 /taskController/getCompletedTasks。过滤条件:syncFlag != D、taskState = 0、taskCompletedTime = today。
+
+- **后端端点**:`POST /taskController/getCompletedTasks`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `is_templete` | boolean | 否 | 排除模板。 |
+| `sync_flag` | string | 否 | 同步标记过滤。 |
+| `task_state` | string | 否 | 已完成。 |
+| `task_completed_time` | string | 否 | 完成时间=今日。 |
+| `task_create_time_not_null` | boolean | 否 | 要求 createTime 非空。 |
+
+## `zentodo.task.mit-list`
+
+调用 /taskController/getMitTasks。过滤条件与 PC 端 loadMitHeaderDatas() 一致。
+
+- **后端端点**:`POST /taskController/getMitTasks`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `sync_flag` | string | 否 | 同步标记过滤。 |
+| `is_templete` | boolean | 否 | 排除模板。 |
+| `task_state` | string | 否 | 未完成。 |
+| `task_create_time_not_null` | boolean | 否 | 要求 createTime 非空。 |
+| `task_create_time` | string | 否 | 到今日为止。 |
+| `is_mit` | boolean | 否 | MIT 过滤。 |
+
+## `zentodo.task.calendar`
+
+调用 /taskController/getCalendarTaskByDate。过滤与安卓端一致(syncFlag!=D、taskState!=0、isTemplete=false、taskStartItem!=FT、taskStartItem!=垃圾箱)。
+
+- **后端端点**:`POST /taskController/getCalendarTaskByDate`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `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.move`
+
+调用 /taskController/updateTaskCreateTime。
+
+- **后端端点**:`POST /taskController/updateTaskCreateTime`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `task_create_time` | datetime | 是 | 新时间(ISO)。 |
+
+## `zentodo.task.sync-pull`
+
+调用 /taskController/getSyncTaskList。
+
+- **后端端点**:`POST /taskController/getSyncTaskList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.task.sync-push`
+
+调用 /taskController/putSyncTask。所有字段通过 FormData 提交,自动剥离 id / rowid。
+
+- **后端端点**:`POST /taskController/putSyncTask`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `record` | object | 否 | 完整记录字段(打平)。 |
+
+## `zentodo.task.list-all`
+
+调用 /taskController/getAllTaskByUserId。
+
+- **后端端点**:`POST /taskController/getAllTaskByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.subtask.sync-push`
+
+调用 /subTaskController/putSyncSubTask。所有字段通过 FormData 提交,自动剥离 id/rowid。
+
+- **后端端点**:`POST /subTaskController/putSyncSubTask`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `sub_task_key` | integer | 否 | 已存在的子任务 key(省略则新建)。 |
+| `task_key` | integer | 是 | 父任务 taskKey。 |
+| `title` | string | 否 | 子任务标题。 |
+| `state` | integer | 否 | 状态(0=完成, 1=未完成)。 |
+| `sync_flag` | string | 否 | M=修改, D=删除, I=新增。 |
+
+## `zentodo.subtask.list-all`
+
+调用 /subTaskController/getAllSubTaskByUserId。
+
+- **后端端点**:`POST /subTaskController/getAllSubTaskByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.subtask.sync-pull`
+
+调用 /subTaskController/getSyncSubTaskList。
+
+- **后端端点**:`POST /subTaskController/getSyncSubTaskList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.project.sync-push`
+
+调用 /projectController/putSyncProject。所有字段通过 FormData 提交,自动剥离 id/rowid。
+
+- **后端端点**:`POST /projectController/putSyncProject`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `project_key` | integer | 否 | 已存在的 projectKey(省略则新建)。 |
+| `name` | string | 否 | 项目名称。 |
+| `color` | string | 否 | 十六进制颜色。 |
+| `icon` | string | 否 | 图标标识。 |
+| `parent_key` | integer | 否 | 父项目 projectKey(用于子项目)。 |
+| `state` | integer | 否 | 0=未开始, 1=进行中, 2=已完成, 3=已暂停, 4=已取消。 |
+| `archived` | boolean | 否 | 归档标记。 |
+| `sync_flag` | string | 否 | M=修改, D=删除, I=新增。 |
+
+## `zentodo.project.list-all`
+
+调用 /projectController/getAllProjectByUserId。
+
+- **后端端点**:`POST /projectController/getAllProjectByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.project.sync-pull`
+
+调用 /projectController/getSyncProjectList。
+
+- **后端端点**:`POST /projectController/getSyncProjectList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.subproject.sync-push`
+
+调用 /subProjectController/putSyncSubProject。
+
+- **后端端点**:`POST /subProjectController/putSyncSubProject`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `sub_project_key` | integer | 否 | 已存在的子项目 key。 |
+| `project_key` | integer | 是 | 父项目 projectKey。 |
+| `name` | string | 否 | 子项目名称。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.subproject.list-all`
+
+调用 /subProjectController/getAllSubProjectByUserId。
+
+- **后端端点**:`POST /subProjectController/getAllSubProjectByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.subproject.sync-pull`
+
+调用 /subProjectController/getSyncSubProjectList。
+
+- **后端端点**:`POST /subProjectController/getSyncSubProjectList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.scene.sync-push`
+
+调用 /sceneController/putSyncScene。
+
+- **后端端点**:`POST /sceneController/putSyncScene`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `scene_key` | integer | 否 | 已存在的场景 key。 |
+| `name` | string | 否 | 场景名称。 |
+| `icon` | string | 否 | 图标标识。 |
+| `desc` | string | 否 | 场景描述。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.scene.list-all`
+
+调用 /sceneController/getAllSceneByUserId。
+
+- **后端端点**:`POST /sceneController/getAllSceneByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.scene.sync-pull`
+
+调用 /sceneController/getSyncSceneList。
+
+- **后端端点**:`POST /sceneController/getSyncSceneList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.target.sync-push`
+
+调用 /targetController/putSyncTarget。
+
+- **后端端点**:`POST /targetController/putSyncTarget`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `target_key` | integer | 否 | 已存在的目标 key。 |
+| `title` | string | 否 | 目标标题。 |
+| `desc` | string | 否 | 目标描述。 |
+| `deadline` | date | 否 | 截止日期(ISO)。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.target.list-all`
+
+调用 /targetController/getAllTargetByUserId。
+
+- **后端端点**:`POST /targetController/getAllTargetByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.target.sync-pull`
+
+调用 /targetController/getSyncTargetList。
+
+- **后端端点**:`POST /targetController/getSyncTargetList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.label.sync-push`
+
+调用 /labelController/putSyncLabel。
+
+- **后端端点**:`POST /labelController/putSyncLabel`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `label_key` | integer | 否 | 已存在的标签 key。 |
+| `name` | string | 否 | 标签名。 |
+| `color` | string | 否 | 十六进制颜色。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.label.list-all`
+
+调用 /labelController/getAllLabelByUserId。
+
+- **后端端点**:`POST /labelController/getAllLabelByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.label.upload-bg`
+
+调用 /labelController/uploadLabelBkFile(multipart/form-data,字段名 file)。
+
+- **后端端点**:`POST /labelController/uploadLabelBkFile`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `label_key` | integer | 是 | 目标标签 key。 |
+| `file` | file | 是 | 图片文件。 |
+
+## `zentodo.toplabel.sync-push`
+
+调用 /topLabelController/putSyncTopLabel。
+
+- **后端端点**:`POST /topLabelController/putSyncTopLabel`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `top_label_key` | integer | 否 | 已存在的顶级标签 key。 |
+| `name` | string | 否 | 名称。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.toplabel.list-all`
+
+调用 /topLabelController/getAllTopLabelByUserId。
+
+- **后端端点**:`POST /topLabelController/getAllTopLabelByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.toplabel.sync-pull`
+
+调用 /topLabelController/getSyncTopLabelList。
+
+- **后端端点**:`POST /topLabelController/getSyncTopLabelList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.quadrant.sync-push`
+
+调用 /quadrantController/putSyncQuadrant。
+
+- **后端端点**:`POST /quadrantController/putSyncQuadrant`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `quadrant_key` | integer | 否 | 已存在的 quadrantKey。 |
+| `title` | string | 否 | 象限标题。 |
+| `index` | integer | 否 | 象限索引 0..3。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.quadrant.list-all`
+
+调用 /quadrantController/getAllQuadrantByUserId。
+
+- **后端端点**:`POST /quadrantController/getAllQuadrantByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.quadrant.sync-pull`
+
+调用 /quadrantController/getSyncQuadrantList。
+
+- **后端端点**:`POST /quadrantController/getSyncQuadrantList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.timeline.sync-push`
+
+调用 /timeLineController/putSyncTimeLine。
+
+- **后端端点**:`POST /timeLineController/putSyncTimeLine`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `time_line_key` | integer | 否 | 已存在的 timeLineKey。 |
+| `title` | string | 否 | 标题。 |
+| `content` | string | 否 | 正文。 |
+| `time` | datetime | 否 | 时间戳(ISO)。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.timeline.list-all`
+
+调用 /timeLineController/getAllTimeLineByUserId。
+
+- **后端端点**:`POST /timeLineController/getAllTimeLineByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.timeline.sync-pull`
+
+调用 /timeLineController/getSyncTimeLineList。
+
+- **后端端点**:`POST /timeLineController/getSyncTimeLineList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.attach.upload-task`
+
+调用 /attachmentController/uploadTaskAttachmentFile(multipart,字段 file)。
+
+- **后端端点**:`POST /attachmentController/uploadTaskAttachmentFile`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 目标任务 taskKey。 |
+| `file` | file | 是 | 附件文件。 |
+
+## `zentodo.attach.upload-thinkmap`
+
+调用 /attachmentController/uploadThinkMapAttachmentFile。
+
+- **后端端点**:`POST /attachmentController/uploadThinkMapAttachmentFile`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `gd_meta_key` | integer | 是 | 目标 GDMeta key。 |
+| `file` | file | 是 | 附件文件。 |
+
+## `zentodo.attach.upload-rewardstore`
+
+调用 /attachmentController/uploadRewardStoreFile。
+
+- **后端端点**:`POST /attachmentController/uploadRewardStoreFile`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `reward_id` | integer | 是 | 目标 reward id。 |
+| `file` | file | 是 | 文件。 |
+
+## `zentodo.attach.list-all`
+
+调用 /attachmentController/getAllAttachmentByUserId。
+
+- **后端端点**:`POST /attachmentController/getAllAttachmentByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.attach.sync-pull`
+
+调用 /attachmentController/getSyncAttachmentList。
+
+- **后端端点**:`POST /attachmentController/getSyncAttachmentList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.attach.sync-push`
+
+调用 /attachmentController/putSyncAttchment。
+
+- **后端端点**:`POST /attachmentController/putSyncAttchment`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `attachment_key` | integer | 否 | 已存在的 attachmentKey。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.pomo.start`
+
+调用 /timerController/startPomodoro。
+
+- **后端端点**:`POST /timerController/startPomodoro`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 要专注的任务 taskKey。 |
+| `duration_sec` | integer | 否 | 专注秒数(默认 25 分钟)。 |
+| `break_sec` | integer | 否 | 短休秒数。 |
+| `long_break_sec` | integer | 否 | 长休秒数。 |
+
+## `zentodo.pomo.stop`
+
+调用 /timerController/stopTimer。
+
+- **后端端点**:`POST /timerController/stopTimer`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `timer_key` | string | 是 | 计时器 key。 |
+
+## `zentodo.pomo.history`
+
+调用 /tomatoWorkerController/getAllTomatoByUserId。
+
+- **后端端点**:`POST /tomatoWorkerController/getAllTomatoByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.pomo.sync-pull-worker`
+
+调用 /tomatoWorkerController/getSyncTomatoWorkerList。
+
+- **后端端点**:`POST /tomatoWorkerController/getSyncTomatoWorkerList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.pomo.sync-push-worker`
+
+调用 /tomatoWorkerController/putSyncTomatoWorker。
+
+- **后端端点**:`POST /tomatoWorkerController/putSyncTomatoWorker`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `tomato_key` | integer | 否 | 已存在的 tomatoKey。 |
+| `task_key` | integer | 否 | 任务 taskKey。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.pomo.config-get`
+
+调用 /tomatoConfigController/getAllTomatoConfigByUserId。
+
+- **后端端点**:`POST /tomatoConfigController/getAllTomatoConfigByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.pomo.config-set`
+
+调用 /tomatoConfigController/putSyncTomatoConfig。
+
+- **后端端点**:`POST /tomatoConfigController/putSyncTomatoConfig`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `config_key` | integer | 否 | 已存在的 configKey。 |
+| `focus_duration_sec` | integer | 否 | 专注秒数。 |
+| `break_duration_sec` | integer | 否 | 短休秒数。 |
+| `long_break_duration_sec` | integer | 否 | 长休秒数。 |
+| `long_break_every` | integer | 否 | 每多少轮后长休。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.pomo.sync-pull-config`
+
+调用 /tomatoConfigController/getSyncTomatoConfigList。
+
+- **后端端点**:`POST /tomatoConfigController/getSyncTomatoConfigList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.timer.start-task`
+
+调用 /timerController/startTaskTimer。
+
+- **后端端点**:`POST /timerController/startTaskTimer`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+
+## `zentodo.workstate.start`
+
+调用 /workStateController/saveWorkState。
+
+- **后端端点**:`POST /workStateController/saveWorkState`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 否 | 关联任务 taskKey。 |
+| `scene_key` | integer | 否 | 关联场景 sceneKey。 |
+| `title` | string | 否 | 本次会话标题。 |
+
+## `zentodo.workstate.stop`
+
+调用 /workStateController/stopWorkState。
+
+- **后端端点**:`POST /workStateController/stopWorkState`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `work_state_key` | string | 是 | 工作状态 key。 |
+
+## `zentodo.workstate.current`
+
+调用 /workStateController/getCurrentWorkState。
+
+- **后端端点**:`POST /workStateController/getCurrentWorkState`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.workstate.update`
+
+调用 /workStateController/updateWorkState。
+
+- **后端端点**:`POST /workStateController/updateWorkState`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `work_state_key` | string | 是 | 工作状态 key。 |
+| `title` | string | 否 | 新标题。 |
+| `note` | string | 否 | 备注。 |
+
+## `zentodo.workstate.list-all`
+
+调用 /workStateController/getAllWorkStateByUserId。
+
+- **后端端点**:`POST /workStateController/getAllWorkStateByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.workstate.sync-pull`
+
+调用 /workStateController/getSyncWorkStateList。
+
+- **后端端点**:`POST /workStateController/getSyncWorkStateList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.workstate.sync-push`
+
+调用 /workStateController/putSyncWorkState。
+
+- **后端端点**:`POST /workStateController/putSyncWorkState`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `work_state_key` | string | 否 | 已存在的 key。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.diary.title-list`
+
+调用 /mdTitleController/getAllMDTitleByUserId。
+
+- **后端端点**:`POST /mdTitleController/getAllMDTitleByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.diary.title-sync-pull`
+
+调用 /mdTitleController/getSyncMDTitleList。
+
+- **后端端点**:`POST /mdTitleController/getSyncMDTitleList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.diary.title-sync-push`
+
+调用 /mdTitleController/putSyncMDTitle。
+
+- **后端端点**:`POST /mdTitleController/putSyncMDTitle`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `md_title_key` | integer | 否 | 已存在的 mdTitleKey。 |
+| `title` | string | 否 | 标题。 |
+| `date` | date | 否 | 日期(ISO)。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.diary.content-list`
+
+调用 /mdContentController/getAllMdContentByUserId。
+
+- **后端端点**:`POST /mdContentController/getAllMdContentByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.diary.content-sync-pull`
+
+调用 /mdContentController/getSyncMdContentList。
+
+- **后端端点**:`POST /mdContentController/getSyncMdContentList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.diary.content-sync-push`
+
+调用 /mdContentController/putSyncMdContent。
+
+- **后端端点**:`POST /mdContentController/putSyncMdContent`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `md_content_key` | integer | 否 | 已存在的 mdContentKey。 |
+| `md_title_key` | integer | 否 | 父标题 mdTitleKey。 |
+| `content` | string | 否 | 正文。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.mindmap.sync-push`
+
+调用 /gdMetaController/putSyncGDMeta。
+
+- **后端端点**:`POST /gdMetaController/putSyncGDMeta`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `gd_meta_key` | integer | 否 | 已存在的 gdMetaKey。 |
+| `parent_key` | integer | 否 | 父节点 key。 |
+| `content` | string | 否 | 节点内容。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.mindmap.list-all`
+
+调用 /gdMetaController/getAllGDMetaByUserId。
+
+- **后端端点**:`POST /gdMetaController/getAllGDMetaByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.mindmap.sync-pull`
+
+调用 /gdMetaController/getSyncGDMetaList。
+
+- **后端端点**:`POST /gdMetaController/getSyncGDMetaList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.reward.store-sync-push`
+
+调用 /rewardStoreController/putSyncRewardStore。
+
+- **后端端点**:`POST /rewardStoreController/putSyncRewardStore`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `reward_key` | integer | 否 | 已存在的 rewardKey。 |
+| `name` | string | 否 | 奖励名称。 |
+| `cost` | integer | 否 | 兑换所需奖励币。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.reward.store-list`
+
+调用 /rewardStoreController/getAllRewardStoreByUserId。
+
+- **后端端点**:`POST /rewardStoreController/getAllRewardStoreByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.reward.store-sync-pull`
+
+调用 /rewardStoreController/getSyncRewardStoreList。
+
+- **后端端点**:`POST /rewardStoreController/getSyncRewardStoreList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.reward.store-update-file`
+
+调用 /rewardStoreController/updateRewardStoreFile。
+
+- **后端端点**:`POST /rewardStoreController/updateRewardStoreFile`
+- **所需 scope**:`write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `reward_id` | integer | 是 | 奖励 id。 |
+| `file` | file | 是 | 文件。 |
+
+## `zentodo.reward.record-sync-push`
+
+调用 /rewardRecordController/putSyncRewardRecord。
+
+- **后端端点**:`POST /rewardRecordController/putSyncRewardRecord`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `record_key` | integer | 否 | 已存在的记录 key。 |
+| `reward_key` | integer | 否 | 关联的奖励 key。 |
+| `cost` | integer | 否 | 消耗的奖励币。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.reward.record-list`
+
+调用 /rewardRecordController/getAllRewardRecordByUserId。
+
+- **后端端点**:`POST /rewardRecordController/getAllRewardRecordByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.reward.record-sync-pull`
+
+调用 /rewardRecordController/getSyncRewardRecordList。
+
+- **后端端点**:`POST /rewardRecordController/getSyncRewardRecordList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.fasttime.sync-push`
+
+调用 /fastTimeRecordController/putSyncFastTimeRecord。
+
+- **后端端点**:`POST /fastTimeRecordController/putSyncFastTimeRecord`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `record_key` | integer | 否 | 已存在的记录 key。 |
+| `title` | string | 否 | 标题。 |
+| `duration_sec` | integer | 否 | 时长(秒)。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.fasttime.list-all`
+
+调用 /fastTimeRecordController/getAllFastTimeByUserId。
+
+- **后端端点**:`POST /fastTimeRecordController/getAllFastTimeByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.fasttime.sync-pull`
+
+调用 /fastTimeRecordController/getSyncFastTimeRecordList。
+
+- **后端端点**:`POST /fastTimeRecordController/getSyncFastTimeRecordList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.wheel.sync-push`
+
+调用 /wheelViewController/putSyncWheelView。
+
+- **后端端点**:`POST /wheelViewController/putSyncWheelView`
+- **所需 scope**:`sync, write`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `wheel_key` | integer | 否 | 已存在的 key。 |
+| `title` | string | 否 | 标题。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo.wheel.list-all`
+
+调用 /wheelViewController/getAllWheelByUserId。
+
+- **后端端点**:`POST /wheelViewController/getAllWheelByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.wheel.sync-pull`
+
+调用 /wheelViewController/getSyncWheelViewList。
+
+- **后端端点**:`POST /wheelViewController/getSyncWheelViewList`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo.invite.list-all`
+
+调用 /inviteController/getAllInviteByUserId。
+
+- **后端端点**:`POST /inviteController/getAllInviteByUserId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.app.latest-version`
+
+调用 /appUpdateController/getLastestVersionCode。
+
+- **后端端点**:`POST /appUpdateController/getLastestVersionCode`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.app.update-info`
+
+调用 /appUpdateController/getLastestAppUpdateItem。
+
+- **后端端点**:`POST /appUpdateController/getLastestAppUpdateItem`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `version_code` | integer | 是 | 当前 versionCode。 |
+
+## `zentodo.app.service-time`
+
+调用 /serviceController/getServiceTime。
+
+- **后端端点**:`POST /serviceController/getServiceTime`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+## `zentodo.pay.price`
+
+调用 /xzbbPriceController/getXzbbPrice。
+
+- **后端端点**:`POST /xzbbPriceController/getXzbbPrice`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `id` | integer | 否 | 价格 id 过滤。 |
+
+## `zentodo.pay.wechat-order`
+
+调用 /payController/getWechatOrderInfo。需要 scope "pay"。
+
+- **后端端点**:`POST /payController/getWechatOrderInfo`
+- **所需 scope**:`pay`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `product_id` | integer | 是 | 商品 id。 |
+
+## `zentodo.pay.alipay-order`
+
+调用 /payController/getAlipayOrderInfo。需要 scope "pay"。
+
+- **后端端点**:`POST /payController/getAlipayOrderInfo`
+- **所需 scope**:`pay`
+- **标注**:只读=false,幂等=false,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `product_id` | integer | 是 | 商品 id。 |
+
+## `zentodo.pay.coupon`
+
+调用 /couponController/getCouponByCouponId。
+
+- **后端端点**:`POST /couponController/getCouponByCouponId`
+- **所需 scope**:`read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `coupon_id` | string | 是 | 优惠券 id。 |
+
+## `zentodo.sync.server-version`
+
+调用 /tableRecorderController/getTableRecordLatestVersion。
+
+- **后端端点**:`POST /tableRecorderController/getTableRecordLatestVersion`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=true,破坏性=false
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `table_name` | string | 是 | 表名(如 task、project)。 |
+
+## `zentodo.sync.recorder-list`
+
+调用 /tableRecorderController/getAllTableRecorderByUserId。
+
+- **后端端点**:`POST /tableRecorderController/getAllTableRecorderByUserId`
+- **所需 scope**:`sync, read`
+- **标注**:只读=true,幂等=true,破坏性=false