外部用户 (浏览器 / curl)
    ↕ HTTP + WebSocket (端口 3456)
┌──────────────────────────────┐
│   kimi-debug-tunnel MCP 服务器 │
│   ├─ Express HTTP Server      │
│   ├─ WebSocket Server         │
│   ├─ WireClient (REST + WS推送 + 心跳重连) │
│   ├─ SessionWatcher (后台监听)     │
│   └─ MCP stdio transport      │
└─────────────┬────────────────┘
              ↕ Bearer Token REST API
┌─────────────────────────────┐
│   Kimi Server (kimi web)    │  端口 5494
│   POST /api/v1/sessions/... │
└─────────────────────────────┘

git clone https://github.com/FirenzeClaw/kimi-debug-tunnel.git
cd kimi-debug-tunnel
npm install
npm run build

# 1. 启动 Kimi Server
kimi web --no-open --port 5494

# 2. 设置 token（Kimi Server 启动时打印）
export KIMI_SERVER_TOKEN="your-token-here"

# 3. 启动 Tunnel
npm start

{
  "mcpServers": {
    "kimi-debug-tunnel": {
      "command": "node",
      "args": ["C:/Users/FirenzeClaw/kimi-debug-tunnel/dist/index.js"],
      "env": {
        "KIMI_SERVER_TOKEN": "your-token-here"
      }
    }
  }
}

curl -X POST http://localhost:3456/api/execute \
  -H "Content-Type: application/json" \
  -d '{"prompt":"写一个 Python hello world","timeout_ms":60000}'

src/
├── index.ts                 # 入口：创建 TunnelServices，启动 HTTP+MCP
├── types.ts                 # TunnelServices 依赖注入接口
├── mcp-server.ts            # MCP stdio 服务器（注册 18 个工具）
├── http-server.ts           # Express + WebSocket 装配入口
├── wire-client.ts           # Kimi Server REST + WS 推送 + 心跳探测自动重连
├── message-queue.ts         # WebSocket pub/sub 广播
├── session-store.ts         # 文件系统扫描 + 路径解析
├── session-log-reader.ts    # wire.jsonl 日志解析 + IO 提取 + 状态轮询
├── session-orchestrator.ts  # 多轮任务编排引擎
├── workflow-template.ts     # 模板类型定义 + YAML 解析 + Zod 校验
├── workflow-store.ts        # 模板持久化（CRUD）
├── workflow-engine.ts       # 自适应工作流引擎
├── session-watcher.ts        # WS 后台监听器
├── tools/
│   ├── execute-prompt.ts    # 发送 prompt 并等待完整回复
│   ├── chat-with-session.ts # 全自动多轮编排
│   ├── create-session.ts    # 通过 REST API 创建新 session
│   ├── stream-response.ts   # 实时推送到 WebSocket 客户端
│   ├── list-sessions.ts     # 列出所有 session
│   ├── get-session-info.ts  # 查看 session 详情
│   ├── read-session-log.ts  # 读取对话日志
│   ├── list-io-records.ts   # 快速查看输入输出记录
│   ├── poll-session.ts      # 结构化轮询 session 状态
│   ├── run-flow.ts           # 分步流程执行引擎
│   ├── learn-workflow.ts    # 从描述或历史 session 学习模板
│   ├── execute-workflow.ts  # 执行工作流模板
│   ├── list-workflow-templates.ts # 列出可用模板
│   ├── continue-workflow.ts # 暂停工作流的决策处理
│   ├── session-watch.ts     # 后台监听工具 (watch/get/continue/set_watch)
│   └── get-tunnel-status.ts # Wire 连接状态、客户端数、运行时间（含 wsConnected）
└── public/
    ├── console.html          # Web 调试控制台
    └── workflow-console.html # 工作流实时监管页面