按 ID 获取单条禅道 Bug 的完整信息，含重现步骤(steps)。

Args:

• id (number): Bug 的数字 ID

• include_steps (boolean): 是否包含 steps 纯文本，默认 true

Returns: { id, title, status, severity, pri, product, assignedTo, openedBy, openedDate, resolution, steps? }

只读，不修改任何数据。

列出某产品下的 Bug，服务端分页。可选按状态/指派人过滤。

Args:

• product (number): 产品 ID

• limit (number): 每页条数 1-200，默认 50

• page (number): 页码，从 1 开始，默认 1

• status ('active'|'resolved'|'closed'): 可选

• assigned_to (string): 可选，按指派人 account 过滤当前页

Returns: { product, page, limit, total, count, bugs: [...], has_more }

只读。禅道返回的 total 可能不准（随 limit 变），以翻页实际列出为准。

在某产品下按关键词搜索 Bug（匹配标题与 steps）。底层拉取分页列表后客户端过滤。

Args:

• product (number): 产品 ID

• keyword (string): 关键词

• scan_limit (number): 最多扫描多少条(分页累加)，默认 200，上限 1000

Returns: { product, keyword, scanned, matched, bugs: [...] }

只读。命中范围受 scan_limit 限制，必要时调大。

⚠️ 禅道 v1 REST API 不支持为 Bug 添加独立备注（实测：editBug 的 comment 字段被静默丢弃， 且无 /comment 动作端点）。调用本工具会直接返回错误，不会假装成功。 如需加备注：请在禅道 Web UI 手工操作，或改用旧版 session API（?m=action&f=comment）。 Args: id (number), comment (string)

把 Bug 标记为已解决。高风险：默认只预览，带 confirm=true 才真正提交。 Args: id, resolution(bydesign/duplicate/external/fixed/notrepro/postponed/willnotfix/tostory), resolvedBuild?(默认 trunk), comment?, confirm(默认 false)

关闭一个已解决的 Bug。高风险：默认预览，confirm=true 才执行。 Args: id, comment?, confirm(默认 false)

重新激活一个已解决/关闭的 Bug。高风险：默认预览，confirm=true 才执行。 Args: id, assignedTo?(重新指派给谁), comment?, confirm(默认 false)

确认一个 Bug（is_confirmed=1）。高风险：默认预览，confirm=true 才执行。 Args: id, assignedTo?, confirm(默认 false)

把 Bug 指派给某人（走 PUT /bugs/{id} editBug）。高风险：默认预览，confirm=true 才执行。 ⚠️ 禅道 v1 REST 无独立指派端点，comment 无法经此记录（会被丢弃），仅指派本身生效。 Args: id, assignedTo(account), comment?(不生效), confirm(默认 false)