@zentodo/cli 0.1.13 → 0.1.14

package/skills/zentodo/references/commands.md

@@ -119,7 +119,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 auth`
@@ -334,9 +340,16 @@ zentodo auth login-email --email a@b.com
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
@@ -382,8 +395,12 @@ zentodo auth login-email --email a@b.com
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `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` _(只读 / 幂等)_
@@ -419,9 +436,17 @@ zentodo auth login-email --email a@b.com
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
@@ -566,8 +591,11 @@ zentodo auth login-email --email a@b.com
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
@@ -588,11 +616,12 @@ zentodo auth login-email --email a@b.com
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读)_
@@ -620,12 +649,16 @@ zentodo auth login-email --email a@b.com
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `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` _(只读 / 幂等)_
@@ -701,9 +734,16 @@ zentodo auth login-email --email a@b.com
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
@@ -738,9 +778,13 @@ zentodo auth login-email --email a@b.com
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
@@ -786,9 +830,12 @@ zentodo auth login-email --email a@b.com
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
@@ -824,9 +871,8 @@ zentodo auth login-email --email a@b.com
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `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` _(只读 / 幂等)_
@@ -861,9 +907,12 @@ zentodo auth login-email --email a@b.com
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
@@ -900,8 +949,8 @@ zentodo auth login-email --email a@b.com
 | --- | --- | --- | --- |
 | `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` _(只读 / 幂等)_
@@ -959,9 +1008,15 @@ zentodo auth login-email --email a@b.com
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `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` _(只读 / 幂等)_
@@ -996,17 +1051,17 @@ zentodo auth login-email --email a@b.com
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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)。 |
 
 **示例:**
 
@@ -1025,15 +1080,15 @@ zentodo task add --title "写周报" --due 2025-09-05T14:00 --priority 3
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | `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` _(破坏性)_
@@ -1233,10 +1288,17 @@ zentodo task add --title "写周报" --due 2025-09-05T14:00 --priority 3
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
@@ -1473,9 +1535,12 @@ zentodo task add --title "写周报" --due 2025-09-05T14:00 --priority 3
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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` _(只读 / 幂等)_
 
@@ -1507,5 +1572,8 @@ zentodo task add --title "写周报" --due 2025-09-05T14:00 --priority 3
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `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 | 否 | 同步标记。 |