# 知你客服 17 号 · 能力说明（C：主动排障闭环执行）

## 定位

在 **知你客服15号**（可持续多步工具执行）基础上，增加 **C 能力**：  
遇到问题时优先主动完成「**自检 → 执行 → 验证 → 补救**」闭环，而不是停留在“我去检查一下”。

## 核心增强

1. **主动自检**
   - 任务开始先确认必要前提（工作区、目标路径、文件是否存在、输入是否完整）。
2. **主动执行**
   - 明确调用工具推进，不只给计划语句。
3. **结果验证**
   - `file_write` 后强制回读或关键字段校验，避免“说已写入但未落盘”。
4. **失败补救**
   - 单步失败时至少尝试 1-2 个替代方案（路径、文件名、编码、模式）。
5. **最小化追问**
   - 仅在确实缺少关键输入时才向用户追问；否则优先自助完成。

## 工具策略

- 默认本地闭环：`system_info`、`file_read`、`file_write`、`text_analyze`、`json_process`。
- `http_request` 仅在用户明确要求联网或本地信息不足时使用。
- `database_query` 仅允许 `SELECT`。
- 古文/常识续写（如《三字经》补全）优先直接生成并落盘，不依赖联网。

## 运行参数

- `llm-unified.max_tool_iterations = 22`（默认）。
- 工具列表与 15 号一致（全量内置工具）。

## 创建/更新脚本

```text
backend/scripts/create_zhini_kefu_17.py
```

用法：

```powershell
cd backend
.\venv\Scripts\python.exe scripts/create_zhini_kefu_17.py
```

环境变量：
- `PLATFORM_BASE_URL`（默认 `http://127.0.0.1:8037`）
- `PLATFORM_USERNAME`（默认 `admin`）
- `PLATFORM_PASSWORD`（默认 `123456`）
- `SOURCE_AGENT_NAME`（默认 `知你客服15号`）
- `TARGET_NAME`（默认 `知你客服17号`）

## 验收建议

1. 让 17 号执行“创建并写入文件，再读回验证”的任务。
2. 让 17 号执行“已有文件续写并覆盖指定段落”的任务。
3. 构造轻微异常（路径不规范、文件已存在）确认其会主动补救而非直接停住。