【Bug】ZenTao 开源版 REST API 无法通过 PUT /bugs/1166 正确添加 Bug 备注（Comment）

1. 环境信息 (Environment)

系统版本： ZenTao 开源版 22.6 (自建部署)

API 版本： REST API v1 (api.php/v1)

认证方式： Token 认证

2. 问题现象 (Observed Behavior)

当前通过 REST API 接口无法为 Bug 添加备注（即操作历史中的 Comment）。只有通过网页端操作才能实现此功能。具体表现如下：

一、 PUT /api.php/v1/bugs/bugID 接口问题：

当请求体中包含 comment 字段时，虽然字段更新成功，并生成了 edited 的操作历史记录，但实际的备注内容被系统忽略（操作历史中的备注字段显示为空）。如果请求体中仅包含 comment 字段而没有其他字段变化，则整个请求不会产生任何效果。

二、 缺少独立备注端点：

目前不存在专门用于添加备注的独立 API 端点（例如 POST /api.php/v1/bugs/id/comments 形式），尝试调用返回 404 错误。

三、 对比验证：

状态流转动作（如 resolve、close、activate、confirm）的 comment 参数可以正常写入备注。这表明底层模型和数据存储机制是支持备注功能的，问题在于 API 层的暴露缺失。1. 环境信息 (Environment)

系统版本： ZenTao 开源版 22.6 (自建部署)

API 版本： REST API v1 (api.php/v1)

认证方式： Token 认证

2. 问题现象 (Observed Behavior)

当前通过 REST API 接口无法为 Bug 添加备注（即操作历史中的 Comment）。只有通过网页端操作才能实现此功能。具体表现如下：

一、 PUT /api.php/v1/bugs/bugID 接口问题：

当请求体中包含 comment 字段时，虽然字段更新成功，并生成了 edited 的操作历史记录，但实际的备注内容被系统忽略（操作历史中的备注字段显示为空）。如果请求体中仅包含 comment 字段而没有其他字段变化，则整个请求不会产生任何效果。

二、 缺少独立备注端点：

目前不存在专门用于添加备注的独立 API 端点（例如 POST /api.php/v1/bugs/id/comments 形式），尝试调用返回 404 错误。

三、 对比验证：

状态流转动作（如 resolve、close、activate、confirm）的 comment 参数可以正常写入备注。这表明底层模型和数据存储机制是支持备注功能的，问题在于 API 层的暴露缺失。

3. 预期结果 (Expected Behavior)

我们期望实现以下任一方案：

方案一： 修改 PUT /bugs/id 接口，使其能够正确接收并保存 comment 字段的内容，与网页端行为保持一致。

方案二： 新增一个独立的备注创建端点。

4. 业务影响 (Impact)

由于缺乏纯粹的备注 API，导致所有依赖 API 进行自动化操作的场景（如自动化回执、机器人通知、CI/CD 流程的回写等）无法实现纯粹的备注操作，必须依赖于触发状态流转或手动操作网页端，极大地限制了自动化能力。

5. 补充说明 (Notes)

网页端提交备注是通过 action-comment 页面实现的（涉及 actioncomment 和 uid 字段）。如果短期内不计划增加 API 支持，请务必在 API 文档中明确指出此项功能受限。3. 预期结果 (Expected Behavior)

我们期望实现以下任一方案：

方案一： 修改 PUT /bugs/id 接口，使其能够正确接收并保存 comment 字段的内容，与网页端行为保持一致。

方案二： 新增一个独立的备注创建端点。

4. 业务影响 (Impact)

由于缺乏纯粹的备注 API，导致所有依赖 API 进行自动化操作的场景（如自动化回执、机器人通知、CI/CD 流程的回写等）无法实现纯粹的备注操作，必须依赖于触发状态流转或手动操作网页端，极大地限制了自动化能力。

5. 补充说明 (Notes)

网页端提交备注是通过 action-comment 页面实现的（涉及 actioncomment 和 uid 字段）。如果短期内不计划增加 API 支持，请务必在 API 文档中明确指出此项功能受限。