# 写操作工具（`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 小时，可能超过 1.5 小时。`site_info_refresh` 以长任务方式执行：工具会先检查同步状态再决定是否触发，不会重复触发。

1. **用户要求同步**：直接调用 `site_info_refresh`（不带 `force`）。
   - 触发了新同步，或已有同步在进行（改为跟踪它）：工具立即返回“已转为后台执行”。告诉用户已提交、需要较长时间、完成后 `site_search` 才会更新，然后结束这一轮。**同步结束后平台会把结果作为新消息发给你**（完成时间、站点数、耗时，或失败原因），收到后向用户汇报。不要轮询。
   - 未触发：最近 24 小时内已成功同步（`skipped_fresh`），或上次同步超过 6 小时未完成、疑似中断（`skipped_stale`）。把原因和数据截至的时间告诉用户；用户确认仍要同步时，再调用 `site_info_refresh` 并设置 `force=true`。
2. **用户只问数据是否最新、同步进度如何**：用只读工具 `mcp__gateway__fwh__site_info_sync_status`（无需审批），按 `advice` 回答，不触发同步。
3. **结果为失败**：说明失败原因，询问用户是否稍后重新同步；不要自动重试。

通用规则：

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