查询 TAPD bug 列表
tapd_list_bugsQuery TAPD bugs by owner, project, or filter by ID, status, priority, and more. Supports cross-project aggregation and custom fields.
Instructions
查询 TAPD bug 列表,默认查询当前登录用户负责的缺陷;传入 current_owner 可查询指定处理人名下的缺陷。传入 id 或 story_id 时不限处理人(story_id 返回该需求全部处理人名下的关联缺陷),可查到已转给他人的缺陷;显式传入 current_owner 时再按该处理人取交集。传入 workspace_id 时只查该项目;不传 workspace_id 时会聚合处理人参与的所有项目的缺陷(按 story_id 过滤时仍需具体项目)。支持按字段过滤:缺陷 ID、关联需求、标题、描述、状态、报告人、处理人、创建时间,以及优先级、严重程度、中文状态、标签、迭代、模块、版本/基线、发布计划、特性、缺陷类型/根源/解决方法/重现规律、各类人员(测试/开发/参与/抄送/修复/验证/审核/关闭人等)、环境(操作系统/平台)、测试方式/阶段/类型、排期/解决/关闭/修改/流转时间、自定义字段等,并可自定义排序(order)。返回的状态会附带项目工作流中文名(如「已解决(resolved)」)。【展示约定】向用户呈现结果时,请直接原样输出本工具返回的 Markdown 表格,完整保留「序号」「id」在内的所有列(其中「缺陷」列已是内嵌超链接的 Markdown 写法,请勿拆成裸 URL、改成纯文本或删除链接),不要裁剪列、改列名或将表格拆分重排;如需补充分类或小结,可在表格之外另起段落,但表格本身保持原样。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | 可选,抄送人 TAPD nick | |
| de | No | 可选,开发人员 TAPD nick,支持模糊匹配 | |
| id | No | 缺陷 ID,TAPD 支持多 ID 查询。传入 id 时默认跳过处理人过滤(除非同时显式传入 current_owner),以便查到已转出的缺陷 | |
| os | No | 可选,操作系统 | |
| te | No | 可选,测试人员 TAPD nick,支持模糊匹配 | |
| due | No | 可选,预计结束时间 | |
| page | No | 页码,默认 1。聚合查询(不传 workspace_id)时按每个项目分别分页,并非跨项目全局分页 | |
| begin | No | 可选,预计开始时间 | |
| fixer | No | 可选,修复人 TAPD nick | |
| label | No | 可选,标签,TAPD 支持枚举查询 | |
| limit | No | 返回数量上限,默认 30,最大 200;聚合查询时为每个项目的上限 | |
| order | No | 可选,排序规则,格式「字段名 asc|desc」(如 created desc),不传默认 modified desc。注意:聚合查询(不传 workspace_id)时各项目内按此排序取数,但跨项目合并后最终仍按修改时间倒序展示 | |
| title | No | 缺陷标题,TAPD 支持模糊匹配 | |
| closed | No | 可选,关闭时间,TAPD 支持时间查询 | |
| closer | No | 可选,关闭人 TAPD nick | |
| module | No | 可选,模块,TAPD 支持枚举查询 | |
| source | No | 可选,缺陷根源,TAPD 支持枚举查询 | |
| status | No | 缺陷状态,TAPD 支持枚举查询和不等于查询 | |
| auditer | No | 可选,审核人 TAPD nick | |
| bugtype | No | 可选,缺陷类型 | |
| created | No | 创建时间,TAPD 支持时间查询 | |
| feature | No | 可选,特性 | |
| deadline | No | 可选,解决期限 | |
| estimate | No | 可选,预计解决时间 | |
| modified | No | 可选,最后修改时间,TAPD 支持时间查询 | |
| platform | No | 可选,软件平台 | |
| reporter | No | 报告人,TAPD 支持多用户查询 | |
| resolved | No | 可选,解决时间,TAPD 支持时间查询 | |
| severity | No | 可选,严重程度,TAPD 支持枚举查询 | |
| story_id | No | 关联需求 ID,返回该需求的关联缺陷;默认不按当前登录用户过滤(与按 id 精确查询一致,可查到他人名下的关联缺陷),仅在显式传入 current_owner 时按该处理人取交集。与 id 参数同时使用时取交集;该过滤需要具体项目,必须同时传入 workspace_id | |
| testmode | No | 可选,测试方式 | |
| testtype | No | 可选,测试类型 | |
| v_status | No | 可选,状态,支持传入中文状态名(如「已解决」) | |
| confirmer | No | 可选,验证人 TAPD nick | |
| frequency | No | 可选,重现规律,TAPD 支持枚举查询 | |
| testphase | No | 可选,测试阶段 | |
| lastmodify | No | 可选,最后修改人 TAPD nick | |
| release_id | No | 可选,发布计划 ID | |
| resolution | No | 可选,解决方法,TAPD 支持枚举查询 | |
| description | No | 缺陷详细描述,TAPD 支持模糊匹配 | |
| reject_time | No | 可选,拒绝时间,TAPD 支持时间查询 | |
| verify_time | No | 可选,验证时间,TAPD 支持时间查询 | |
| version_fix | No | 可选,合入版本 | |
| iteration_id | No | 可选,迭代 ID,TAPD 支持枚举查询 | |
| participator | No | 可选,参与人,支持多人员查询 | |
| version_test | No | 可选,验证版本 | |
| workspace_id | No | TAPD 项目 ID。传入则只查该项目;不传则聚合处理人参与的所有项目的缺陷。可先用 tapd_list_workspaces 查看会覆盖哪些项目 | |
| baseline_find | No | 可选,发现基线 | |
| baseline_join | No | 可选,合入基线 | |
| baseline_test | No | 可选,验证基线 | |
| current_owner | No | 单个处理人 TAPD nick,不传默认查询当前登录用户负责的缺陷;传入则查询指定处理人名下的缺陷,建议先用 tapd_search_users 确认 nick | |
| custom_fields | No | 可选,自定义字段过滤透传。key 为 TAPD 字段名(custom_field_*、cus_* 或 custom_plan_field_*),原样提交;具体字段名通过 TAPD 自定义字段配置接口获取 | |
| version_close | No | 可选,关闭版本 | |
| baseline_close | No | 可选,关闭基线 | |
| priority_label | No | 可选,优先级(推荐字段,兼容自定义优先级) | |
| version_report | No | 可选,发现版本,TAPD 支持枚举查询 | |
| in_progress_time | No | 可选,接受处理时间,TAPD 支持时间查询 |