@zentodo/cli 0.1.1 → 0.1.2

package/dist/skills/zentodo/references/error-codes.md

@@ -0,0 +1,62 @@
+# 错误码 & 退出码
+
+当 `ok === false` 时,ZenTodo CLI / Skill 返回的 `error` 对象结构统一为:
+
+```
+{
+  "ok": false,
+  "data": null,
+  "error": {
+    "code": "ErrXxx",
+    "message": "可读描述",
+    "detail": <后端原始负载>,
+    "hint": "修复建议"
+  },
+  "meta": { "requestId": "...", "durationMs": N, "scopeChecked": [...] }
+}
+```
+
+## 错误码
+
+| Code | HTTP 来源 | 含义 | 建议处理 |
+| --- | --- | --- | --- |
+| `ErrUnknown` | 兜底 | 未知错误 | 重试,检查 `detail` |
+| `ErrUsage` | — | CLI 参数错误或工具入参错误 | 查看 `--help` |
+| `ErrConfig` | — | 本地配置异常 | 运行 `zentodo doctor` |
+| `ErrNetwork` | 传输层 | DNS / TLS / socket / 超时 | 稍后重试;检查 `--server` |
+| `ErrOfflineUnsupported` | — | `--local` 但该能力没有离线实现 | 去掉 `--local` 或等待本地模式落地 |
+| `ErrUnauthorized` | 401 | 凭证缺失或无效 | `zentodo auth login-password` |
+| `ErrEnoAuth` | — | 当前 Profile 未登录 | 同上 |
+| `ErrForbidden` | 403 | Token 的 scope 不够 | 重签 scope 更大的 Token |
+| `ErrNotFound` | 404 | 资源不存在 | 核对 key |
+| `ErrConflict` | 409 | 同步冲突 | `zentodo sync conflict resolve ...`(后续版本) |
+| `ErrValidation` | 422 | 后端拒绝入参 | 看 `detail.message` |
+| `ErrRateLimit` | 429 | 服务器要求退避 | 客户端已按 `Retry-After` 自动重试;高频循环请降低 QPS |
+| `ErrServer` | 5xx | 后端错误 | 重试;必要时提单 |
+| `ErrInvalidFlags` | — | 互斥的输出 flag 同时出现 | `--json` / `--ndjson` / `--yaml` 三选一 |
+| `ErrInvalidSetting` | — | 未知的 settings key | `zentodo settings get` 查看已有 key |
+
+## 退出码
+
+| Exit | Error codes | 含义 |
+| --- | --- | --- |
+| 0 | — | 成功 |
+| 1 | `ErrUnknown` 及兜底 | 通用失败 |
+| 2 | `ErrUsage`、`ErrInvalidFlags`、`ErrInvalidSetting` | 调用方用法错误 |
+| 3 | `ErrConfig` | 配置问题 |
+| 4 | `ErrNetwork` | 网络失败 |
+| 5 | `ErrOfflineUnsupported` | 本地模式不支持该操作 |
+| 401 | `ErrUnauthorized`、`ErrEnoAuth` | 认证失败 |
+| 403 | `ErrForbidden` | Scope 不足 |
+| 404 | `ErrNotFound` | 资源不存在 |
+| 409 | `ErrConflict` | 同步冲突 |
+| 422 | `ErrValidation` | 入参被拒绝 |
+| 429 | `ErrRateLimit` | 触发限流 |
+| 500 | `ErrServer` | 后端错误 |
+
+在 Shell 脚本中可以这样判断:
+
+```pwsh
+zentodo task get --task-key 999
+if ($LASTEXITCODE -eq 404) { echo "未找到" }
+```

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

@@ -0,0 +1,115 @@
+# CLI ↔ Skill ↔ 后端 对照表
+
+| 领域 | CLI 命令 | MCP 工具 | 后端端点 | Scope |
+| --- | --- | --- | --- | --- |
+| auth | `zentodo auth login-password` | `zentodo.auth.login-password` | `POST /userController/loginXzbb` | read |
+| auth | `zentodo auth email-code` | `zentodo.auth.email-code` | `POST /userController/sendAuthEmailCode` | read |
+| auth | `zentodo auth register` | `zentodo.auth.register` | `POST /userController/regisiterApp` | write |
+| auth | `zentodo auth find-password` | `zentodo.auth.find-password` | `POST /userController/findPasswordByUsrEmail` | read |
+| auth | `zentodo auth change-password` | `zentodo.auth.change-password` | `POST /userController/updateUserWithoutPhoto` | write |
+| auth | `zentodo auth delete-account` | `zentodo.auth.delete-account` | `POST /userController/deleteUsrByUsrKey` | destructive, admin |
+| auth | `zentodo auth email-exists` | `zentodo.auth.email-exists` | `POST /userController/isEmailExist` | read |
+| auth | `zentodo auth phone-exists` | `zentodo.auth.phone-exists` | `POST /userController/isPhoneExist` | read |
+| user | `zentodo user info` | `zentodo.user.info` | `POST /userController/getUserInfoByUsrKey` | read |
+| user | `zentodo user update` | `zentodo.user.update` | `POST /userController/updateUserWithoutPhoto` | write |
+| user | `zentodo user avatar-get` | `zentodo.user.avatar-get` | `POST /userController/getUserAvatarByUsrKey` | read |
+| user | `zentodo user invite-code` | `zentodo.user.invite-code` | `POST /userController/getInviteCodeByUsrKey` | read |
+| user | `zentodo user reward-coin-get` | `zentodo.user.reward-coin-get` | `POST /userController/getRewardCoinByUsrKey` | read |
+| user | `zentodo user reward-coin-set` | `zentodo.user.reward-coin-set` | `POST /userController/setRewardCoinByUsrKey` | write, destructive |
+| user | `zentodo user vip-set` | `zentodo.user.vip-set` | `POST /userController/setVipEndDate` | write, admin |
+| user | `zentodo user restore-default-label` | `zentodo.user.restore-default-label` | `POST /userController/restoreDefaultLabel` | destructive, write |
+| task | `zentodo task add` | `zentodo.task.add` | `POST /taskController/insertTask` | write |
+| task | `zentodo task update` | `zentodo.task.update` | `POST /taskController/updateTask` | write |
+| task | `zentodo task delete` | `zentodo.task.delete` | `POST /taskController/updateTask` | destructive, write |
+| task | `zentodo task complete` | `zentodo.task.complete` | `POST /taskController/updateTask` | write |
+| task | `zentodo task uncomplete` | `zentodo.task.uncomplete` | `POST /taskController/updateTask` | write |
+| task | `zentodo task mit` | `zentodo.task.mit` | `POST /taskController/updateTask` | write |
+| task | `zentodo task quadrant` | `zentodo.task.quadrant` | `POST /taskController/updateTask` | write |
+| task | `zentodo task completed-today` | `zentodo.task.completed-today` | `POST /taskController/getCompletedTasks` | read |
+| task | `zentodo task mit-list` | `zentodo.task.mit-list` | `POST /taskController/getMitTasks` | read |
+| task | `zentodo task calendar` | `zentodo.task.calendar` | `POST /taskController/getCalendarTaskByDate` | read |
+| task | `zentodo task move` | `zentodo.task.move` | `POST /taskController/updateTaskCreateTime` | write |
+| task | `zentodo task sync-pull` | `zentodo.task.sync-pull` | `POST /taskController/getSyncTaskList` | sync, read |
+| task | `zentodo task sync-push` | `zentodo.task.sync-push` | `POST /taskController/putSyncTask` | sync, write |
+| task | `zentodo task list` | `zentodo.task.list-all` | `POST /taskController/getAllTaskByUserId` | read |
+| subtask | `zentodo subtask upsert` | `zentodo.subtask.sync-push` | `POST /subTaskController/putSyncSubTask` | sync, write |
+| subtask | `zentodo subtask list` | `zentodo.subtask.list-all` | `POST /subTaskController/getAllSubTaskByUserId` | read |
+| subtask | `zentodo subtask sync-pull` | `zentodo.subtask.sync-pull` | `POST /subTaskController/getSyncSubTaskList` | sync, read |
+| project | `zentodo project upsert` | `zentodo.project.sync-push` | `POST /projectController/putSyncProject` | sync, write |
+| project | `zentodo project list` | `zentodo.project.list-all` | `POST /projectController/getAllProjectByUserId` | read |
+| project | `zentodo project sync-pull` | `zentodo.project.sync-pull` | `POST /projectController/getSyncProjectList` | sync, read |
+| subproject | `zentodo subproject upsert` | `zentodo.subproject.sync-push` | `POST /subProjectController/putSyncSubProject` | sync, write |
+| subproject | `zentodo subproject list` | `zentodo.subproject.list-all` | `POST /subProjectController/getAllSubProjectByUserId` | read |
+| subproject | `zentodo subproject sync-pull` | `zentodo.subproject.sync-pull` | `POST /subProjectController/getSyncSubProjectList` | sync, read |
+| scene | `zentodo scene upsert` | `zentodo.scene.sync-push` | `POST /sceneController/putSyncScene` | sync, write |
+| scene | `zentodo scene list` | `zentodo.scene.list-all` | `POST /sceneController/getAllSceneByUserId` | read |
+| scene | `zentodo scene sync-pull` | `zentodo.scene.sync-pull` | `POST /sceneController/getSyncSceneList` | sync, read |
+| target | `zentodo target upsert` | `zentodo.target.sync-push` | `POST /targetController/putSyncTarget` | sync, write |
+| target | `zentodo target list` | `zentodo.target.list-all` | `POST /targetController/getAllTargetByUserId` | read |
+| target | `zentodo target sync-pull` | `zentodo.target.sync-pull` | `POST /targetController/getSyncTargetList` | sync, read |
+| label | `zentodo label upsert` | `zentodo.label.sync-push` | `POST /labelController/putSyncLabel` | sync, write |
+| label | `zentodo label list` | `zentodo.label.list-all` | `POST /labelController/getAllLabelByUserId` | read |
+| label | `zentodo label upload-bg` | `zentodo.label.upload-bg` | `POST /labelController/uploadLabelBkFile` | write |
+| toplabel | `zentodo toplabel upsert` | `zentodo.toplabel.sync-push` | `POST /topLabelController/putSyncTopLabel` | sync, write |
+| toplabel | `zentodo toplabel list` | `zentodo.toplabel.list-all` | `POST /topLabelController/getAllTopLabelByUserId` | read |
+| toplabel | `zentodo toplabel sync-pull` | `zentodo.toplabel.sync-pull` | `POST /topLabelController/getSyncTopLabelList` | sync, read |
+| quadrant | `zentodo quadrant upsert` | `zentodo.quadrant.sync-push` | `POST /quadrantController/putSyncQuadrant` | sync, write |
+| quadrant | `zentodo quadrant list` | `zentodo.quadrant.list-all` | `POST /quadrantController/getAllQuadrantByUserId` | read |
+| quadrant | `zentodo quadrant sync-pull` | `zentodo.quadrant.sync-pull` | `POST /quadrantController/getSyncQuadrantList` | sync, read |
+| timeline | `zentodo timeline upsert` | `zentodo.timeline.sync-push` | `POST /timeLineController/putSyncTimeLine` | sync, write |
+| timeline | `zentodo timeline list` | `zentodo.timeline.list-all` | `POST /timeLineController/getAllTimeLineByUserId` | read |
+| timeline | `zentodo timeline sync-pull` | `zentodo.timeline.sync-pull` | `POST /timeLineController/getSyncTimeLineList` | sync, read |
+| attach | `zentodo attach upload-task` | `zentodo.attach.upload-task` | `POST /attachmentController/uploadTaskAttachmentFile` | write |
+| attach | `zentodo attach upload-thinkmap` | `zentodo.attach.upload-thinkmap` | `POST /attachmentController/uploadThinkMapAttachmentFile` | write |
+| attach | `zentodo attach upload-rewardstore` | `zentodo.attach.upload-rewardstore` | `POST /attachmentController/uploadRewardStoreFile` | write |
+| attach | `zentodo attach list` | `zentodo.attach.list-all` | `POST /attachmentController/getAllAttachmentByUserId` | read |
+| attach | `zentodo attach sync-pull` | `zentodo.attach.sync-pull` | `POST /attachmentController/getSyncAttachmentList` | sync, read |
+| attach | `zentodo attach sync-push` | `zentodo.attach.sync-push` | `POST /attachmentController/putSyncAttchment` | sync, write |
+| pomo | `zentodo pomo start` | `zentodo.pomo.start` | `POST /timerController/startPomodoro` | write |
+| pomo | `zentodo pomo stop` | `zentodo.pomo.stop` | `POST /timerController/stopTimer` | write |
+| pomo | `zentodo pomo history` | `zentodo.pomo.history` | `POST /tomatoWorkerController/getAllTomatoByUserId` | read |
+| pomo | `zentodo pomo sync-pull-worker` | `zentodo.pomo.sync-pull-worker` | `POST /tomatoWorkerController/getSyncTomatoWorkerList` | sync, read |
+| pomo | `zentodo pomo sync-push-worker` | `zentodo.pomo.sync-push-worker` | `POST /tomatoWorkerController/putSyncTomatoWorker` | sync, write |
+| pomo | `zentodo pomo config-get` | `zentodo.pomo.config-get` | `POST /tomatoConfigController/getAllTomatoConfigByUserId` | read |
+| pomo | `zentodo pomo config-set` | `zentodo.pomo.config-set` | `POST /tomatoConfigController/putSyncTomatoConfig` | sync, write |
+| pomo | `zentodo pomo sync-pull-config` | `zentodo.pomo.sync-pull-config` | `POST /tomatoConfigController/getSyncTomatoConfigList` | sync, read |
+| timer | `zentodo timer start-task` | `zentodo.timer.start-task` | `POST /timerController/startTaskTimer` | write |
+| workstate | `zentodo workstate start` | `zentodo.workstate.start` | `POST /workStateController/saveWorkState` | write |
+| workstate | `zentodo workstate stop` | `zentodo.workstate.stop` | `POST /workStateController/stopWorkState` | write |
+| workstate | `zentodo workstate current` | `zentodo.workstate.current` | `POST /workStateController/getCurrentWorkState` | read |
+| workstate | `zentodo workstate update` | `zentodo.workstate.update` | `POST /workStateController/updateWorkState` | write |
+| workstate | `zentodo workstate list` | `zentodo.workstate.list-all` | `POST /workStateController/getAllWorkStateByUserId` | read |
+| workstate | `zentodo workstate sync-pull` | `zentodo.workstate.sync-pull` | `POST /workStateController/getSyncWorkStateList` | sync, read |
+| workstate | `zentodo workstate sync-push` | `zentodo.workstate.sync-push` | `POST /workStateController/putSyncWorkState` | sync, write |
+| diary | `zentodo diary title-list` | `zentodo.diary.title-list` | `POST /mdTitleController/getAllMDTitleByUserId` | read |
+| diary | `zentodo diary title-sync-pull` | `zentodo.diary.title-sync-pull` | `POST /mdTitleController/getSyncMDTitleList` | sync, read |
+| diary | `zentodo diary title-upsert` | `zentodo.diary.title-sync-push` | `POST /mdTitleController/putSyncMDTitle` | sync, write |
+| diary | `zentodo diary content-list` | `zentodo.diary.content-list` | `POST /mdContentController/getAllMdContentByUserId` | read |
+| diary | `zentodo diary content-sync-pull` | `zentodo.diary.content-sync-pull` | `POST /mdContentController/getSyncMdContentList` | sync, read |
+| diary | `zentodo diary content-upsert` | `zentodo.diary.content-sync-push` | `POST /mdContentController/putSyncMdContent` | sync, write |
+| mindmap | `zentodo mindmap upsert` | `zentodo.mindmap.sync-push` | `POST /gdMetaController/putSyncGDMeta` | sync, write |
+| mindmap | `zentodo mindmap list` | `zentodo.mindmap.list-all` | `POST /gdMetaController/getAllGDMetaByUserId` | read |
+| mindmap | `zentodo mindmap sync-pull` | `zentodo.mindmap.sync-pull` | `POST /gdMetaController/getSyncGDMetaList` | sync, read |
+| reward | `zentodo reward store-upsert` | `zentodo.reward.store-sync-push` | `POST /rewardStoreController/putSyncRewardStore` | sync, write |
+| reward | `zentodo reward store-list` | `zentodo.reward.store-list` | `POST /rewardStoreController/getAllRewardStoreByUserId` | read |
+| reward | `zentodo reward store-sync-pull` | `zentodo.reward.store-sync-pull` | `POST /rewardStoreController/getSyncRewardStoreList` | sync, read |
+| reward | `zentodo reward store-update-file` | `zentodo.reward.store-update-file` | `POST /rewardStoreController/updateRewardStoreFile` | write |
+| reward | `zentodo reward record-upsert` | `zentodo.reward.record-sync-push` | `POST /rewardRecordController/putSyncRewardRecord` | sync, write |
+| reward | `zentodo reward record-list` | `zentodo.reward.record-list` | `POST /rewardRecordController/getAllRewardRecordByUserId` | read |
+| reward | `zentodo reward record-sync-pull` | `zentodo.reward.record-sync-pull` | `POST /rewardRecordController/getSyncRewardRecordList` | sync, read |
+| fasttime | `zentodo fasttime upsert` | `zentodo.fasttime.sync-push` | `POST /fastTimeRecordController/putSyncFastTimeRecord` | sync, write |
+| fasttime | `zentodo fasttime list` | `zentodo.fasttime.list-all` | `POST /fastTimeRecordController/getAllFastTimeByUserId` | read |
+| fasttime | `zentodo fasttime sync-pull` | `zentodo.fasttime.sync-pull` | `POST /fastTimeRecordController/getSyncFastTimeRecordList` | sync, read |
+| wheel | `zentodo wheel upsert` | `zentodo.wheel.sync-push` | `POST /wheelViewController/putSyncWheelView` | sync, write |
+| wheel | `zentodo wheel list` | `zentodo.wheel.list-all` | `POST /wheelViewController/getAllWheelByUserId` | read |
+| wheel | `zentodo wheel sync-pull` | `zentodo.wheel.sync-pull` | `POST /wheelViewController/getSyncWheelViewList` | sync, read |
+| invite | `zentodo invite list` | `zentodo.invite.list-all` | `POST /inviteController/getAllInviteByUserId` | read |
+| app | `zentodo app latest-version` | `zentodo.app.latest-version` | `POST /appUpdateController/getLastestVersionCode` | read |
+| app | `zentodo app update-info` | `zentodo.app.update-info` | `POST /appUpdateController/getLastestAppUpdateItem` | read |
+| app | `zentodo app service-time` | `zentodo.app.service-time` | `POST /serviceController/getServiceTime` | read |
+| pay | `zentodo pay price` | `zentodo.pay.price` | `POST /xzbbPriceController/getXzbbPrice` | read |
+| pay | `zentodo pay wechat-order` | `zentodo.pay.wechat-order` | `POST /payController/getWechatOrderInfo` | pay |
+| pay | `zentodo pay alipay-order` | `zentodo.pay.alipay-order` | `POST /payController/getAlipayOrderInfo` | pay |
+| pay | `zentodo pay coupon` | `zentodo.pay.coupon` | `POST /couponController/getCouponByCouponId` | read |
+| sync | `zentodo sync server-version` | `zentodo.sync.server-version` | `POST /tableRecorderController/getTableRecordLatestVersion` | sync, read |
+| sync | `zentodo sync recorder-list` | `zentodo.sync.recorder-list` | `POST /tableRecorderController/getAllTableRecorderByUserId` | sync, read |