更新 TAPD bug
tapd_writebackUpdate TAPD bugs with comments, status, title, description, assignees, custom fields, and more. Supports partial success reporting.
Instructions
对 TAPD bug 执行一个或多个已确认操作：回填评论、更新标题、更新描述正文、更新状态、更新处理人，以及更新优先级、严重程度、模块、版本、迭代、排期、各类人员、工时、标签等标准字段和自定义字段。各功能相互独立且可自由组合，至少提供 comment、title、description、target_status、target_owners、标准字段或 custom_fields 之一。注意：各动作分多次请求提交、非事务，可能出现部分成功（结果会逐项标明成功/失败）。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | 可选，抄送人。与处理人同为 TAPD 用户 nick，多个以分号分隔（如 a;b;） | |
| de | No | 可选，开发人员 TAPD nick | |
| os | No | 可选，操作系统 | |
| te | No | 可选，测试人员 TAPD nick | |
| due | No | 可选，预计结束日期（YYYY-MM-DD） | |
| size | No | 可选，规模 | |
| begin | No | 可选，预计开始日期（YYYY-MM-DD） | |
| fixer | No | 可选，修复人 TAPD nick | |
| label | No | 可选，标签，不存在时自动创建，多个以英文竖线（|）分隔 | |
| title | No | 可选，更新缺陷标题为该值 | |
| bug_id | Yes | TAPD bug ID | |
| closer | No | 可选，关闭人 TAPD nick | |
| effort | No | 可选，预估工时 | |
| module | No | 可选，模块 | |
| source | No | 可选，缺陷根源 | |
| auditer | No | 可选，审核人 TAPD nick | |
| bugtype | No | 可选，缺陷类型 | |
| comment | No | 可选，回填到 TAPD 的评论内容 | |
| feature | No | 可选，特性 | |
| deadline | No | 可选，解决期限（YYYY-MM-DD） | |
| estimate | No | 可选，预计解决时间 | |
| platform | No | 可选，软件平台 | |
| severity | No | 可选，严重程度 | |
| testmode | No | 可选，测试方式 | |
| testtype | No | 可选，测试类型 | |
| confirmed | Yes | 必须为 true，表示用户已明确确认本次评论、标题、描述、字段、状态变更和处理人变更 | |
| confirmer | No | 可选，验证人 TAPD nick | |
| frequency | No | 可选，重现规律 | |
| testphase | No | 可选，测试阶段 | |
| release_id | No | 可选，发布计划 ID | |
| resolution | No | 可选，解决方法 | |
| description | No | 可选，更新缺陷描述正文（支持 HTML 富文本）。注意：该字段会整体覆盖原描述，应先获取原描述并在其基础上修改后传入完整正文 | |
| originphase | No | 可选，发现阶段 | |
| sourcephase | No | 可选，引入阶段 | |
| version_fix | No | 可选，合入版本 | |
| iteration_id | No | 可选，迭代 ID | |
| participator | No | 可选，参与人。与处理人同为 TAPD 用户 nick，多个以分号分隔（如 a;b;） | |
| version_test | No | 可选，验证版本 | |
| workspace_id | Yes | TAPD 项目 ID（必填）。可先用 tapd_list_bugs / tapd_list_stories 跨项目查询，或 tapd_list_workspaces 获取目标项目 ID | |
| baseline_find | No | 可选，发现基线 | |
| baseline_join | No | 可选，合入基线 | |
| baseline_test | No | 可选，验证基线 | |
| custom_fields | No | 可选，自定义字段透传。key 为 TAPD 字段名（custom_field_*、cus_* 或 custom_plan_field_*），原样提交；具体字段名通过 TAPD 自定义字段配置接口获取 | |
| target_owners | No | 可选，将 bug 处理人更新为指定 TAPD 用户 nick 列表；应先调用 tapd_search_users 确认 | |
| target_status | No | 可选，将 bug 状态更新为 TAPD 工作流中的状态值，如 resolved；必须使用当前项目实际支持的状态枚举。写入前会校验是否为项目工作流合法状态，非法状态将被拒绝并返回可选状态清单 | |
| version_close | No | 可选，关闭版本 | |
| baseline_close | No | 可选，关闭基线 | |
| priority_label | No | 可选，优先级（对应 TAPD priority_label，兼容自定义优先级） | |
| version_report | No | 可选，发现版本 | |
| comment_root_id | No | 可选，评论的根评论 ID。传入时本条评论挂到该评论树下；需同时提供 comment | |
| comment_reply_id | No | 可选，被回复的评论 ID，表示本条评论是对它的回复；需同时提供 comment | |
| owner_update_mode | No | 可选，处理人更新方式。用户说“添加、加上、补上、也给”等追加语义时传 append；用户说“改为、替换为、转给、只保留”等替换语义时传 replace；不传默认 append |