wecom-session-control git:20261020.59bc834B

Immutable. This exact content never changes and is served at /api/v1/blob/56d8f0ea1e547563.

---
name: wecom-session-control
description: >
  当前运行环境是企业微信智能机器人桥接模式。用户如果要求“停止当前任务”“中断这次执行”“新建会话”“重置会话”“清掉当前上下文”，应调用 bridge 提供的 session 管理 API，只操作当前 chat 对应的 session。
---

# 企业微信会话控制

## Description
当前运行环境是企业微信智能机器人桥接模式。你可以控制当前会话的运行状态，包括：
- 中断当前正在跑的任务，但保留上下文
- 新建 session 并保留旧上下文，或者原地重置当前 session

这类操作只影响当前 `chatKey` 对应的 session，不影响其他人的会话。

## Rules
- 只能操作当前 BridgeContext 里的 `chatKey` / `sessionId`
- 不要去中断别人的会话
- 优先使用当前 BridgeContext 里的 `sessionId`
- new/reset 会同时取消当前 chat 对应的本地文件回传请求；取消结果以当前会话为范围
- 如果当前 Codex 运行在 sandbox 中，不要直接访问 localhost API
- 只有在宿主机模式或外部控制器环境下，才使用 bridge API
- 只在用户明确表达“停止、取消、新建会话、清空当前会话”时使用
- 回复用户时只说结果，不暴露 URL、curl、JSON 或内部实现

## 调用方式

当前技能默认是“会话控制意图说明”技能，不强制在 sandbox 内直接调用 API。

如果当前运行环境允许直接访问 bridge API，例如：

- `CODEX_EXEC_MODE=host`
- 或者当前动作由外部控制器执行

才使用下面的 API 示例。

## API 示例

中断当前任务，但保留 thread 上下文：

```bash
python3 - <<'PY'
import json, urllib.parse, urllib.request
bots = json.loads(urllib.request.urlopen('http://127.0.0.1:9299/api/bots').read().decode())
chat_key = "single:userid"
bot = next((b for b in bots if any(s.get("key") == chat_key for s in b.get("sessions", []))), None)
if not bot:
    raise SystemExit("bot/session not found")
chat_key_encoded = urllib.parse.quote(chat_key, safe='')
url = f"http://127.0.0.1:9299/api/bots/{bot['id']}/sessions/{chat_key_encoded}/interrupt"
req = urllib.request.Request(url, data=b"", method="POST")
print(urllib.request.urlopen(req).read().decode())
PY
```

新建 session 并保留旧 session，旧会话之后仍可通过 `/bridge-resume` 选择：

```bash
python3 - <<'PY'
import json, urllib.parse, urllib.request
bots = json.loads(urllib.request.urlopen('http://127.0.0.1:9299/api/bots').read().decode())
chat_key = "single:userid"
bot = next((b for b in bots if any(s.get("key") == chat_key for s in b.get("sessions", []))), None)
if not bot:
    raise SystemExit("bot/session not found")
chat_key_encoded = urllib.parse.quote(chat_key, safe='')
url = f"http://127.0.0.1:9299/api/bots/{bot['id']}/sessions/{chat_key_encoded}/new"
req = urllib.request.Request(url, data=b"", method="POST")
print(urllib.request.urlopen(req).read().decode())
PY
```

## 参数来源
- `chat_key`：来自当前 BridgeContext 的 `chatKey`
- `bot.id`：通过 `GET /api/bots` 找到持有当前会话的 bot

## 何时用 interrupt
- 用户说“停止当前任务”
- 用户说“不要继续跑了”
- 用户说“把这次卡住的停掉”

## 何时用 new
- 用户说“新建会话”
- 用户明确要求保留旧会话，稍后可以恢复

## 何时用 reset
- 用户说“清掉当前上下文”
- 用户说“从头开始”或“重置当前会话”

reset 使用与上面相同的 URL 结构，但 endpoint 为 `/reset`；对应企微文本命令 `/bridge-reset`。

## 回复规范
- interrupt 成功：
  - “当前任务已停止。”
- new 成功：
  - “新会话已就绪，下一条消息会绑定新的 thread。”
- reset 成功：
  - “当前会话已重置，下一条消息会绑定新的 thread。”