@zentodo/cli 0.1.1 → 0.1.2

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

@@ -0,0 +1,1413 @@
+# ZenTodo CLI · 命令参考
+
+> 本文档由 **清单自动生成**,请勿手动编辑。
+>
+> 所有对 `zentodoserver` 的请求统一使用 `multipart/form-data`。
+
+## 全局参数
+
+| 选项 | 说明 |
+| --- | --- |
+| `--profile <name>` | 使用指定 Profile |
+| `--server <url>` | 覆盖后端地址 |
+| `--token <token>` | 覆盖本地 Token |
+| `--json / --ndjson / --yaml` | 结构化输出(三选一) |
+| `--dry-run` | 只打印将发送的内容,不调用后端 |
+| `--yes` | 跳过破坏性操作确认 |
+| `--local / --remote` | 本地 SQLite 或强制远程 |
+| `--no-retry / --no-color / --quiet` | 关闭重试 / 彩色 / 非必要输出 |
+| `--log-level <level>` / `--log-file <path>` | 日志控制 |
+
+## `zentodo app`
+
+### `zentodo app latest-version` _(只读 / 幂等)_
+
+获取 App 最新 versionCode。
+
+- **后端端点**:`POST /appUpdateController/getLastestVersionCode`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.app.latest-version`
+
+### `zentodo app update-info` _(只读 / 幂等)_
+
+根据当前 versionCode 获取最新更新信息。
+
+- **后端端点**:`POST /appUpdateController/getLastestAppUpdateItem`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.app.update-info`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `version_code` | integer | 是 | 当前 versionCode。 |
+
+### `zentodo app service-time` _(只读 / 幂等)_
+
+获取服务器时间(用于时钟偏差检测)。
+
+- **后端端点**:`POST /serviceController/getServiceTime`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.app.service-time`
+
+## `zentodo attach`
+
+### `zentodo attach upload-task`
+
+为任务上传附件。
+
+- **后端端点**:`POST /attachmentController/uploadTaskAttachmentFile`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.attach.upload-task`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 目标任务 taskKey。 |
+| `file` | file | 是 | 附件文件。 |
+
+### `zentodo attach upload-thinkmap`
+
+为思维导图节点上传附件。
+
+- **后端端点**:`POST /attachmentController/uploadThinkMapAttachmentFile`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.attach.upload-thinkmap`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `gd_meta_key` | integer | 是 | 目标 GDMeta key。 |
+| `file` | file | 是 | 附件文件。 |
+
+### `zentodo attach upload-rewardstore`
+
+为奖励商店上传文件。
+
+- **后端端点**:`POST /attachmentController/uploadRewardStoreFile`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.attach.upload-rewardstore`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `reward_id` | integer | 是 | 目标 reward id。 |
+| `file` | file | 是 | 文件。 |
+
+### `zentodo attach list` _(只读 / 幂等)_
+
+列出所有附件。
+
+- **后端端点**:`POST /attachmentController/getAllAttachmentByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.attach.list-all`
+
+### `zentodo attach sync-pull` _(只读)_
+
+按 clientVersion 拉取附件元数据增量。
+
+- **后端端点**:`POST /attachmentController/getSyncAttachmentList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.attach.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+### `zentodo attach sync-push`
+
+推送附件元数据记录。
+
+- **后端端点**:`POST /attachmentController/putSyncAttchment`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.attach.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `attachment_key` | integer | 否 | 已存在的 attachmentKey。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo auth`
+
+### `zentodo auth login-password` _(幂等)_
+
+邮箱 + 密码登录。
+
+- **后端端点**:`POST /userController/loginXzbb`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.auth.login-password`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 账号邮箱。 |
+| `password` | string | 是 | 账号密码。 |
+
+**示例:**
+
+```
+zentodo auth login-password --email a@b.com --password ****
+```
+
+### `zentodo auth email-code`
+
+发送邮箱登录验证码。
+
+- **后端端点**:`POST /userController/sendAuthEmailCode`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.auth.email-code`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 收件邮箱。 |
+
+### `zentodo auth register`
+
+注册新账号。
+
+- **后端端点**:`POST /userController/regisiterApp`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.auth.register`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 账号邮箱。 |
+| `password` | string | 是 | 账号密码。 |
+
+### `zentodo auth find-password`
+
+发起找回密码流程。
+
+- **后端端点**:`POST /userController/findPasswordByUsrEmail`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.auth.find-password`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 账号邮箱。 |
+
+### `zentodo auth change-password`
+
+修改当前用户密码。
+
+- **后端端点**:`POST /userController/updateUserWithoutPhoto`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.auth.change-password`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `user_key` | integer | 是 | 目标 usrKey。 |
+| `password` | string | 是 | 新密码。 |
+| `sync_flag` | string | 否 | 同步标记,默认 U。 |
+
+### `zentodo auth delete-account` _(破坏性)_
+
+在服务器上删除当前账号(不可恢复)。
+
+- **后端端点**:`POST /userController/deleteUsrByUsrKey`
+- **所需 scope**:`destructive, admin`
+- **对应 Skill 工具**:`zentodo.auth.delete-account`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `user_key` | integer | 是 | 目标 usrKey。 |
+
+### `zentodo auth email-exists` _(只读 / 幂等)_
+
+检查邮箱是否已注册。
+
+- **后端端点**:`POST /userController/isEmailExist`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.auth.email-exists`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `email` | string | 是 | 待检查的邮箱。 |
+
+### `zentodo auth phone-exists` _(只读 / 幂等)_
+
+检查手机号是否已注册。
+
+- **后端端点**:`POST /userController/isPhoneExist`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.auth.phone-exists`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `phone` | string | 是 | 待检查的手机号。 |
+
+## `zentodo diary`
+
+### `zentodo diary title-list` _(只读 / 幂等)_
+
+列出晨间日记标题。
+
+- **后端端点**:`POST /mdTitleController/getAllMDTitleByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.diary.title-list`
+
+### `zentodo diary title-sync-pull` _(只读)_
+
+按 clientVersion 拉取日记标题增量。
+
+- **后端端点**:`POST /mdTitleController/getSyncMDTitleList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.diary.title-sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+### `zentodo diary title-upsert`
+
+新建/更新/删除晨间日记标题。
+
+- **后端端点**:`POST /mdTitleController/putSyncMDTitle`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.diary.title-sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `md_title_key` | integer | 否 | 已存在的 mdTitleKey。 |
+| `title` | string | 否 | 标题。 |
+| `date` | date | 否 | 日期(ISO)。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo diary content-list` _(只读 / 幂等)_
+
+列出晨间日记内容。
+
+- **后端端点**:`POST /mdContentController/getAllMdContentByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.diary.content-list`
+
+### `zentodo diary content-sync-pull` _(只读)_
+
+按 clientVersion 拉取日记内容增量。
+
+- **后端端点**:`POST /mdContentController/getSyncMdContentList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.diary.content-sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+### `zentodo diary content-upsert`
+
+新建/更新/删除晨间日记内容。
+
+- **后端端点**:`POST /mdContentController/putSyncMdContent`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.diary.content-sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `md_content_key` | integer | 否 | 已存在的 mdContentKey。 |
+| `md_title_key` | integer | 否 | 父标题 mdTitleKey。 |
+| `content` | string | 否 | 正文。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+## `zentodo fasttime`
+
+### `zentodo fasttime upsert`
+
+新建/更新/删除快速时间记录。
+
+- **后端端点**:`POST /fastTimeRecordController/putSyncFastTimeRecord`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.fasttime.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `record_key` | integer | 否 | 已存在的记录 key。 |
+| `title` | string | 否 | 标题。 |
+| `duration_sec` | integer | 否 | 时长(秒)。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo fasttime list` _(只读 / 幂等)_
+
+列出快速时间记录。
+
+- **后端端点**:`POST /fastTimeRecordController/getAllFastTimeByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.fasttime.list-all`
+
+### `zentodo fasttime sync-pull` _(只读)_
+
+按 clientVersion 拉取快速时间记录增量。
+
+- **后端端点**:`POST /fastTimeRecordController/getSyncFastTimeRecordList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.fasttime.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo invite`
+
+### `zentodo invite list` _(只读 / 幂等)_
+
+列出当前用户发出的邀请。
+
+- **后端端点**:`POST /inviteController/getAllInviteByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.invite.list-all`
+
+## `zentodo label`
+
+### `zentodo label upsert`
+
+新建/更新/删除标签。
+
+- **后端端点**:`POST /labelController/putSyncLabel`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.label.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `label_key` | integer | 否 | 已存在的标签 key。 |
+| `name` | string | 否 | 标签名。 |
+| `color` | string | 否 | 十六进制颜色。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo label list` _(只读 / 幂等)_
+
+列出所有标签。
+
+- **后端端点**:`POST /labelController/getAllLabelByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.label.list-all`
+
+### `zentodo label upload-bg`
+
+为标签上传背景图。
+
+- **后端端点**:`POST /labelController/uploadLabelBkFile`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.label.upload-bg`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `label_key` | integer | 是 | 目标标签 key。 |
+| `file` | file | 是 | 图片文件。 |
+
+## `zentodo mindmap`
+
+### `zentodo mindmap upsert`
+
+新建/更新/删除思维导图节点元数据。
+
+- **后端端点**:`POST /gdMetaController/putSyncGDMeta`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.mindmap.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `gd_meta_key` | integer | 否 | 已存在的 gdMetaKey。 |
+| `parent_key` | integer | 否 | 父节点 key。 |
+| `content` | string | 否 | 节点内容。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo mindmap list` _(只读 / 幂等)_
+
+列出所有思维导图元数据。
+
+- **后端端点**:`POST /gdMetaController/getAllGDMetaByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.mindmap.list-all`
+
+### `zentodo mindmap sync-pull` _(只读)_
+
+按 clientVersion 拉取思维导图元数据增量。
+
+- **后端端点**:`POST /gdMetaController/getSyncGDMetaList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.mindmap.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo pay`
+
+### `zentodo pay price` _(只读 / 幂等)_
+
+查询 XZBB 商品价格(只读)。
+
+- **后端端点**:`POST /xzbbPriceController/getXzbbPrice`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.pay.price`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `id` | integer | 否 | 价格 id 过滤。 |
+
+### `zentodo pay wechat-order`
+
+创建微信支付订单(仅返回订单信息,不代扣)。
+
+- **后端端点**:`POST /payController/getWechatOrderInfo`
+- **所需 scope**:`pay`
+- **对应 Skill 工具**:`zentodo.pay.wechat-order`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `product_id` | integer | 是 | 商品 id。 |
+
+### `zentodo pay alipay-order`
+
+创建支付宝订单(仅返回订单串,不代扣)。
+
+- **后端端点**:`POST /payController/getAlipayOrderInfo`
+- **所需 scope**:`pay`
+- **对应 Skill 工具**:`zentodo.pay.alipay-order`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `product_id` | integer | 是 | 商品 id。 |
+
+### `zentodo pay coupon` _(只读 / 幂等)_
+
+按 couponId 查询优惠券。
+
+- **后端端点**:`POST /couponController/getCouponByCouponId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.pay.coupon`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `coupon_id` | string | 是 | 优惠券 id。 |
+
+## `zentodo pomo`
+
+### `zentodo pomo start`
+
+在任务上开启一次番茄钟。
+
+- **后端端点**:`POST /timerController/startPomodoro`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.pomo.start`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 要专注的任务 taskKey。 |
+| `duration_sec` | integer | 否 | 专注秒数(默认 25 分钟)。 |
+| `break_sec` | integer | 否 | 短休秒数。 |
+| `long_break_sec` | integer | 否 | 长休秒数。 |
+
+### `zentodo pomo stop`
+
+停止正在进行的番茄钟/计时。
+
+- **后端端点**:`POST /timerController/stopTimer`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.pomo.stop`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `timer_key` | string | 是 | 计时器 key。 |
+
+### `zentodo pomo history` _(只读 / 幂等)_
+
+列出番茄钟历史记录。
+
+- **后端端点**:`POST /tomatoWorkerController/getAllTomatoByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.pomo.history`
+
+### `zentodo pomo sync-pull-worker` _(只读)_
+
+按 clientVersion 拉取番茄钟记录增量。
+
+- **后端端点**:`POST /tomatoWorkerController/getSyncTomatoWorkerList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.pomo.sync-pull-worker`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+### `zentodo pomo sync-push-worker`
+
+推送一条番茄钟记录。
+
+- **后端端点**:`POST /tomatoWorkerController/putSyncTomatoWorker`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.pomo.sync-push-worker`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `tomato_key` | integer | 否 | 已存在的 tomatoKey。 |
+| `task_key` | integer | 否 | 任务 taskKey。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo pomo config-get` _(只读 / 幂等)_
+
+获取番茄钟配置。
+
+- **后端端点**:`POST /tomatoConfigController/getAllTomatoConfigByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.pomo.config-get`
+
+### `zentodo pomo config-set`
+
+新建/更新番茄钟配置。
+
+- **后端端点**:`POST /tomatoConfigController/putSyncTomatoConfig`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.pomo.config-set`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `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` _(只读)_
+
+按 clientVersion 拉取番茄钟配置增量。
+
+- **后端端点**:`POST /tomatoConfigController/getSyncTomatoConfigList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.pomo.sync-pull-config`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo project`
+
+### `zentodo project upsert`
+
+新建/更新/归档/删除项目(由 syncFlag 区分)。
+
+- **后端端点**:`POST /projectController/putSyncProject`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.project.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `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` _(只读 / 幂等)_
+
+列出当前用户所有项目。
+
+- **后端端点**:`POST /projectController/getAllProjectByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.project.list-all`
+
+### `zentodo project sync-pull` _(只读)_
+
+按 clientVersion 拉取项目增量。
+
+- **后端端点**:`POST /projectController/getSyncProjectList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.project.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo quadrant`
+
+### `zentodo quadrant upsert`
+
+新建/更新/删除四象限配置。
+
+- **后端端点**:`POST /quadrantController/putSyncQuadrant`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.quadrant.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `quadrant_key` | integer | 否 | 已存在的 quadrantKey。 |
+| `title` | string | 否 | 象限标题。 |
+| `index` | integer | 否 | 象限索引 0..3。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo quadrant list` _(只读 / 幂等)_
+
+列出四象限配置。
+
+- **后端端点**:`POST /quadrantController/getAllQuadrantByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.quadrant.list-all`
+
+### `zentodo quadrant sync-pull` _(只读)_
+
+按 clientVersion 拉取四象限增量。
+
+- **后端端点**:`POST /quadrantController/getSyncQuadrantList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.quadrant.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo reward`
+
+### `zentodo reward store-upsert`
+
+新建/更新/删除奖励商品。
+
+- **后端端点**:`POST /rewardStoreController/putSyncRewardStore`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.reward.store-sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `reward_key` | integer | 否 | 已存在的 rewardKey。 |
+| `name` | string | 否 | 奖励名称。 |
+| `cost` | integer | 否 | 兑换所需奖励币。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo reward store-list` _(只读 / 幂等)_
+
+列出奖励商品。
+
+- **后端端点**:`POST /rewardStoreController/getAllRewardStoreByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.reward.store-list`
+
+### `zentodo reward store-sync-pull` _(只读)_
+
+按 clientVersion 拉取奖励商品增量。
+
+- **后端端点**:`POST /rewardStoreController/getSyncRewardStoreList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.reward.store-sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+### `zentodo reward store-update-file`
+
+更新奖励商品关联的文件。
+
+- **后端端点**:`POST /rewardStoreController/updateRewardStoreFile`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.reward.store-update-file`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `reward_id` | integer | 是 | 奖励 id。 |
+| `file` | file | 是 | 文件。 |
+
+### `zentodo reward record-upsert`
+
+新建/更新/删除奖励兑换记录。
+
+- **后端端点**:`POST /rewardRecordController/putSyncRewardRecord`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.reward.record-sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `record_key` | integer | 否 | 已存在的记录 key。 |
+| `reward_key` | integer | 否 | 关联的奖励 key。 |
+| `cost` | integer | 否 | 消耗的奖励币。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo reward record-list` _(只读 / 幂等)_
+
+列出奖励兑换记录。
+
+- **后端端点**:`POST /rewardRecordController/getAllRewardRecordByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.reward.record-list`
+
+### `zentodo reward record-sync-pull` _(只读)_
+
+按 clientVersion 拉取奖励兑换记录增量。
+
+- **后端端点**:`POST /rewardRecordController/getSyncRewardRecordList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.reward.record-sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo scene`
+
+### `zentodo scene upsert`
+
+新建/更新/删除场景。
+
+- **后端端点**:`POST /sceneController/putSyncScene`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.scene.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `scene_key` | integer | 否 | 已存在的场景 key。 |
+| `name` | string | 否 | 场景名称。 |
+| `icon` | string | 否 | 图标标识。 |
+| `desc` | string | 否 | 场景描述。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo scene list` _(只读 / 幂等)_
+
+列出所有场景。
+
+- **后端端点**:`POST /sceneController/getAllSceneByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.scene.list-all`
+
+### `zentodo scene sync-pull` _(只读)_
+
+按 clientVersion 拉取场景增量。
+
+- **后端端点**:`POST /sceneController/getSyncSceneList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.scene.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo subproject`
+
+### `zentodo subproject upsert`
+
+新建/更新/删除子项目。
+
+- **后端端点**:`POST /subProjectController/putSyncSubProject`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.subproject.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `sub_project_key` | integer | 否 | 已存在的子项目 key。 |
+| `project_key` | integer | 是 | 父项目 projectKey。 |
+| `name` | string | 否 | 子项目名称。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo subproject list` _(只读 / 幂等)_
+
+列出所有子项目。
+
+- **后端端点**:`POST /subProjectController/getAllSubProjectByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.subproject.list-all`
+
+### `zentodo subproject sync-pull` _(只读)_
+
+按 clientVersion 拉取子项目增量。
+
+- **后端端点**:`POST /subProjectController/getSyncSubProjectList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.subproject.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo subtask`
+
+### `zentodo subtask upsert`
+
+新建/更新/删除子任务(根据 syncFlag)。
+
+- **后端端点**:`POST /subTaskController/putSyncSubTask`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.subtask.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `sub_task_key` | integer | 否 | 已存在的子任务 key(省略则新建)。 |
+| `task_key` | integer | 是 | 父任务 taskKey。 |
+| `title` | string | 否 | 子任务标题。 |
+| `state` | integer | 否 | 状态(0=完成, 1=未完成)。 |
+| `sync_flag` | string | 否 | M=修改, D=删除, I=新增。 |
+
+### `zentodo subtask list` _(只读 / 幂等)_
+
+列出当前用户所有子任务。
+
+- **后端端点**:`POST /subTaskController/getAllSubTaskByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.subtask.list-all`
+
+### `zentodo subtask sync-pull` _(只读)_
+
+按 clientVersion 拉取子任务增量。
+
+- **后端端点**:`POST /subTaskController/getSyncSubTaskList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.subtask.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo sync`
+
+### `zentodo sync server-version` _(只读 / 幂等)_
+
+查询某张表的服务器最新版本号。
+
+- **后端端点**:`POST /tableRecorderController/getTableRecordLatestVersion`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.sync.server-version`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `table_name` | string | 是 | 表名(如 task、project)。 |
+
+### `zentodo sync recorder-list` _(只读 / 幂等)_
+
+列出当前用户的所有表记录器。
+
+- **后端端点**:`POST /tableRecorderController/getAllTableRecorderByUserId`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.sync.recorder-list`
+
+## `zentodo target`
+
+### `zentodo target upsert`
+
+新建/更新/删除目标(Target)。
+
+- **后端端点**:`POST /targetController/putSyncTarget`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.target.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `target_key` | integer | 否 | 已存在的目标 key。 |
+| `title` | string | 否 | 目标标题。 |
+| `desc` | string | 否 | 目标描述。 |
+| `deadline` | date | 否 | 截止日期(ISO)。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo target list` _(只读 / 幂等)_
+
+列出所有目标。
+
+- **后端端点**:`POST /targetController/getAllTargetByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.target.list-all`
+
+### `zentodo target sync-pull` _(只读)_
+
+按 clientVersion 拉取目标增量。
+
+- **后端端点**:`POST /targetController/getSyncTargetList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.target.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo task`
+
+### `zentodo task add`
+
+创建一个新任务。
+
+- **后端端点**:`POST /taskController/insertTask`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.task.add`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `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 add --title "写周报" --due 2025-09-05T14:00 --priority 3
+```
+
+### `zentodo task update`
+
+更新任务。仅上传显式传入的字段。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.task.update`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `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` _(破坏性)_
+
+软删除任务(syncFlag=D)。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`destructive, write`
+- **对应 Skill 工具**:`zentodo.task.delete`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+
+### `zentodo task complete`
+
+将任务标记为今日完成。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.task.complete`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+
+### `zentodo task uncomplete`
+
+取消任务完成状态。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.task.uncomplete`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `task_state` | integer | 否 | 开放态(一般为 1)。 |
+| `task_completed_time` | string | 否 | 清空完成时间。 |
+
+### `zentodo task mit`
+
+设置或取消 MIT(今日最重要)。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.task.mit`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `is_mit` | boolean | 是 | 是否为 MIT。 |
+
+### `zentodo task quadrant`
+
+设置任务所属的时间四象限(0..3)。
+
+- **后端端点**:`POST /taskController/updateTask`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.task.quadrant`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `quadrant` | integer | 是 | 象限 0..3。 |
+
+### `zentodo task completed-today` _(只读 / 幂等)_
+
+列出今日完成的任务。
+
+- **后端端点**:`POST /taskController/getCompletedTasks`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.task.completed-today`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `is_templete` | boolean | 否 | 排除模板。 |
+| `sync_flag` | string | 否 | 同步标记过滤。 |
+| `task_state` | string | 否 | 已完成。 |
+| `task_completed_time` | string | 否 | 完成时间=今日。 |
+| `task_create_time_not_null` | boolean | 否 | 要求 createTime 非空。 |
+
+### `zentodo task mit-list` _(只读 / 幂等)_
+
+列出今日 MIT(最重要)任务。
+
+- **后端端点**:`POST /taskController/getMitTasks`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.task.mit-list`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `sync_flag` | string | 否 | 同步标记过滤。 |
+| `is_templete` | boolean | 否 | 排除模板。 |
+| `task_state` | string | 否 | 未完成。 |
+| `task_create_time_not_null` | boolean | 否 | 要求 createTime 非空。 |
+| `task_create_time` | string | 否 | 到今日为止。 |
+| `is_mit` | boolean | 否 | MIT 过滤。 |
+
+### `zentodo task calendar` _(只读 / 幂等)_
+
+按日期范围列出日历视图任务。
+
+- **后端端点**:`POST /taskController/getCalendarTaskByDate`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.task.calendar`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `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`
+
+更新任务的 createTime(拖拽到日历)。
+
+- **后端端点**:`POST /taskController/updateTaskCreateTime`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.task.move`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `task_create_time` | datetime | 是 | 新时间(ISO)。 |
+
+### `zentodo task sync-pull` _(只读)_
+
+按 clientVersion 拉取任务增量。
+
+- **后端端点**:`POST /taskController/getSyncTaskList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.task.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+### `zentodo task sync-push`
+
+向服务器推送单条任务记录。
+
+- **后端端点**:`POST /taskController/putSyncTask`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.task.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+| `record` | object | 否 | 完整记录字段(打平)。 |
+
+### `zentodo task list` _(只读 / 幂等)_
+
+列出当前用户所有任务。
+
+- **后端端点**:`POST /taskController/getAllTaskByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.task.list-all`
+
+## `zentodo timeline`
+
+### `zentodo timeline upsert`
+
+新建/更新/删除时间轴条目。
+
+- **后端端点**:`POST /timeLineController/putSyncTimeLine`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.timeline.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `time_line_key` | integer | 否 | 已存在的 timeLineKey。 |
+| `title` | string | 否 | 标题。 |
+| `content` | string | 否 | 正文。 |
+| `time` | datetime | 否 | 时间戳(ISO)。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo timeline list` _(只读 / 幂等)_
+
+列出时间轴条目。
+
+- **后端端点**:`POST /timeLineController/getAllTimeLineByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.timeline.list-all`
+
+### `zentodo timeline sync-pull` _(只读)_
+
+按 clientVersion 拉取时间轴增量。
+
+- **后端端点**:`POST /timeLineController/getSyncTimeLineList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.timeline.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo timer`
+
+### `zentodo timer start-task`
+
+为任务启动自由计时(非番茄钟)。
+
+- **后端端点**:`POST /timerController/startTaskTimer`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.timer.start-task`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 是 | 任务 taskKey。 |
+
+## `zentodo toplabel`
+
+### `zentodo toplabel upsert`
+
+新建/更新/删除顶级标签。
+
+- **后端端点**:`POST /topLabelController/putSyncTopLabel`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.toplabel.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `top_label_key` | integer | 否 | 已存在的顶级标签 key。 |
+| `name` | string | 否 | 名称。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo toplabel list` _(只读 / 幂等)_
+
+列出所有顶级标签。
+
+- **后端端点**:`POST /topLabelController/getAllTopLabelByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.toplabel.list-all`
+
+### `zentodo toplabel sync-pull` _(只读)_
+
+按 clientVersion 拉取顶级标签增量。
+
+- **后端端点**:`POST /topLabelController/getSyncTopLabelList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.toplabel.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo user`
+
+### `zentodo user info` _(只读 / 幂等)_
+
+获取当前用户资料。
+
+- **后端端点**:`POST /userController/getUserInfoByUsrKey`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.user.info`
+
+### `zentodo user update`
+
+更新用户资料(不含头像)。
+
+- **后端端点**:`POST /userController/updateUserWithoutPhoto`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.user.update`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `nickname` | string | 否 | 昵称。 |
+| `phone` | string | 否 | 手机号。 |
+| `gender` | string | 否 | 性别。 |
+| `birthday` | date | 否 | 生日(ISO 日期)。 |
+| `signature` | string | 否 | 个性签名。 |
+
+### `zentodo user avatar-get` _(只读 / 幂等)_
+
+获取当前用户头像 URL。
+
+- **后端端点**:`POST /userController/getUserAvatarByUsrKey`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.user.avatar-get`
+
+### `zentodo user invite-code` _(只读 / 幂等)_
+
+获取当前用户的邀请码。
+
+- **后端端点**:`POST /userController/getInviteCodeByUsrKey`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.user.invite-code`
+
+### `zentodo user reward-coin-get` _(只读 / 幂等)_
+
+查询奖励币余额。
+
+- **后端端点**:`POST /userController/getRewardCoinByUsrKey`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.user.reward-coin-get`
+
+### `zentodo user reward-coin-set` _(破坏性)_
+
+直接覆盖奖励币余额(破坏性)。
+
+- **后端端点**:`POST /userController/setRewardCoinByUsrKey`
+- **所需 scope**:`write, destructive`
+- **对应 Skill 工具**:`zentodo.user.reward-coin-set`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `reward_coin` | integer | 是 | 新的余额值。 |
+
+### `zentodo user vip-set`
+
+设置 VIP 到期日。
+
+- **后端端点**:`POST /userController/setVipEndDate`
+- **所需 scope**:`write, admin`
+- **对应 Skill 工具**:`zentodo.user.vip-set`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `vip_end_date` | date | 是 | VIP 到期日(ISO 日期)。 |
+
+### `zentodo user restore-default-label` _(破坏性)_
+
+恢复用户的默认标签(破坏性)。
+
+- **后端端点**:`POST /userController/restoreDefaultLabel`
+- **所需 scope**:`destructive, write`
+- **对应 Skill 工具**:`zentodo.user.restore-default-label`
+
+## `zentodo wheel`
+
+### `zentodo wheel upsert`
+
+新建/更新/删除滚轮视图配置。
+
+- **后端端点**:`POST /wheelViewController/putSyncWheelView`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.wheel.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `wheel_key` | integer | 否 | 已存在的 key。 |
+| `title` | string | 否 | 标题。 |
+| `sync_flag` | string | 否 | 同步标记。 |
+
+### `zentodo wheel list` _(只读 / 幂等)_
+
+列出滚轮视图配置。
+
+- **后端端点**:`POST /wheelViewController/getAllWheelByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.wheel.list-all`
+
+### `zentodo wheel sync-pull` _(只读)_
+
+按 clientVersion 拉取滚轮视图增量。
+
+- **后端端点**:`POST /wheelViewController/getSyncWheelViewList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.wheel.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+## `zentodo workstate`
+
+### `zentodo workstate start`
+
+开启一段工作状态记录。
+
+- **后端端点**:`POST /workStateController/saveWorkState`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.workstate.start`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `task_key` | integer | 否 | 关联任务 taskKey。 |
+| `scene_key` | integer | 否 | 关联场景 sceneKey。 |
+| `title` | string | 否 | 本次会话标题。 |
+
+### `zentodo workstate stop`
+
+结束一段正在进行的工作状态。
+
+- **后端端点**:`POST /workStateController/stopWorkState`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.workstate.stop`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `work_state_key` | string | 是 | 工作状态 key。 |
+
+### `zentodo workstate current` _(只读 / 幂等)_
+
+获取当前正在进行的工作状态。
+
+- **后端端点**:`POST /workStateController/getCurrentWorkState`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.workstate.current`
+
+### `zentodo workstate update`
+
+更新一条工作状态记录。
+
+- **后端端点**:`POST /workStateController/updateWorkState`
+- **所需 scope**:`write`
+- **对应 Skill 工具**:`zentodo.workstate.update`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `work_state_key` | string | 是 | 工作状态 key。 |
+| `title` | string | 否 | 新标题。 |
+| `note` | string | 否 | 备注。 |
+
+### `zentodo workstate list` _(只读 / 幂等)_
+
+列出所有工作状态。
+
+- **后端端点**:`POST /workStateController/getAllWorkStateByUserId`
+- **所需 scope**:`read`
+- **对应 Skill 工具**:`zentodo.workstate.list-all`
+
+### `zentodo workstate sync-pull` _(只读)_
+
+按 clientVersion 拉取工作状态增量。
+
+- **后端端点**:`POST /workStateController/getSyncWorkStateList`
+- **所需 scope**:`sync, read`
+- **对应 Skill 工具**:`zentodo.workstate.sync-pull`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `client_version` | integer | 是 | 客户端已知版本号。 |
+
+### `zentodo workstate sync-push`
+
+推送一条工作状态记录。
+
+- **后端端点**:`POST /workStateController/putSyncWorkState`
+- **所需 scope**:`sync, write`
+- **对应 Skill 工具**:`zentodo.workstate.sync-push`
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `work_state_key` | string | 否 | 已存在的 key。 |
+| `sync_flag` | string | 否 | 同步标记。 |