# 写操作工具（`mcp__gateway__fwhops__*`）

只在勾选了 `fwhops` 服务的配置中提供。每次调用都会弹出审批卡片，由用户确认后才执行；被拒绝时停止该操作，按用户给出的原因调整，不要换个方式绕过。

工具以服务账号身份执行，业务系统中记录的操作人是“AI 助手”，不是当前用户。

| 工具 | 用途 | 规则 |
| --- | --- | --- |
| `feedback_create` | 在 Plane 创建问题反馈 / 需求 | 调用前先向用户摘要标题、类型（bug / feature）、优先级和描述；描述中写清背景、复现步骤或期望效果 |
| `tou_template_save` | 新增或更新**测试服** TOU 模版 | 只支持测试服；先按 tou-template.md 的规则构建并自检（时段覆盖整天、日类型成对、数值类型正确），向用户摘要“新增/更新、模版名、地区、策略与关键时段”，保存后用 `mcp__gateway__fwh__tou_template_get`（`env=test`）回读核对 |
| `site_info_refresh` | 触发站点信息表从 FWH 平台重新同步 | 见下方“站点信息同步” |

## 站点信息同步

同步在主服务后台执行，耗时可能超过 1.5 小时；`site_info_refresh` 立即返回，不等同步完成。

1. **先查状态**：调用只读工具 `mcp__gateway__fwh__site_info_sync_status`（无需审批），按 `state` 处理：
   - `syncing`：同步进行中，**不要触发**，告诉用户已进行多久，之后再用本工具查看；
   - `stale`：超过 6 小时未完成，疑似中断（如主服务重启）。向用户说明情况，用户确认后才用 `force=true` 重新触发；
   - `idle` 且最近一次成功同步在 24 小时内（`advice` 会说明）：数据较新，告诉用户数据截至 `lastSuccess.completedAt`，一般无需同步；用户坚持要最新数据时用 `force=true`；
   - `idle` 且超过 24 小时、上次失败，或 `never`：可以触发。
2. **再触发**：调用 `site_info_refresh`。工具会再次检查状态，按返回的 `action` 回复：`triggered`（已触发）、`tracking`（同步中，未重复触发）、`skipped_fresh` / `skipped_stale`（未触发，原因见 `message`）。
3. **跟踪**：触发后告诉用户同步需要较长时间、完成后 `site_search` 才会更新；用户之后询问进度时用 `site_info_sync_status` 查看，不要在一轮对话中反复轮询。

通用规则：

1. 调用前在回复中说明将要写入什么、写到哪个环境，再调用工具（审批卡片会同时显示参数）。
2. 写操作失败时把错误原样告诉用户，不要自动重试。
3. 没有这些工具时，告诉用户当前配置不支持修改数据，可以到 ToolBox 对应页面操作。