Ck Ask

🚀 CK-ASK

AI 对话暂停工具 - 让 AI 等待你的指令。该工具能绕过 MCP 限制，采用纯 HTTP 通信，具备终端和弹窗双模式，为用户与 AI 的交互提供便利。

🚀 快速开始

方式一：直接使用 Node.js 脚本

# 克隆项目
git clone https://github.com/1837620622/ck-ask.git
cd ck-ask

# 运行暂停脚本
node pause_dialog.js "任务已完成" "/your/workspace/path"

方式二：配合 Python MCP Server

# 安装依赖
pip install mcp

# 配置 MCP (编辑 ~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "ck-ask": {
      "command": "python3",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "WORKSPACE_PATH": "${workspaceFolder}"
      }
    }
  }
}

方式三：安装 VSIX 扩展（推荐）

1. 打开 Windsurf
2. Cmd+Shift+P → Extensions: Install from VSIX
3. 选择 windsurf-ask-continue-1.3.2.vsix
4. 重启 Windsurf

✨ 主要特性

📦 安装指南

项目克隆

git clone https://github.com/1837620622/ck-ask.git
cd ck-ask

依赖安装

Node.js 脚本运行

确保已安装 Node.js 18+，直接运行脚本即可。

Python MCP Server

pip install mcp

VSIX 扩展安装

按上述快速开始中的方式三进行安装。

💻 使用示例

基础用法

终端模式输出

[Node.js] 回调服务器已启动，端口 23990
[Node.js] Ask Continue 暂停脚本启动
[Node.js] 原因: 代码修改完成
[Node.js] 扩展端口: 23983
[Node.js] 回调端口: 23990

==================================================
📋 代码修改完成
==================================================
请输入后续指令（输入 exit 结束对话）：
> 继续优化性能

高级用法

返回 JSON 格式

{
  "should_continue": true,
  "user_instruction": "继续优化性能",
  "image_paths": null
}

📚 详细文档

架构

┌─────────────────────────────────────────────────────────────────┐
│                         Windsurf / Cursor                        │
│  ┌───────────┐    subprocess    ┌────────────────────────────┐  │
│  │    AI     │ ───────────────► │   pause_dialog.js          │  │
│  │  (模型)   │                  │   (Node.js 暂停脚本)        │  │
│  └───────────┘                  └────────────────────────────┘  │
│                                          │                       │
│                            ┌─────────────┴─────────────┐        │
│                            ▼                           ▼        │
│                   ┌──────────────┐           ┌──────────────┐   │
│                   │  终端输入    │           │  VSIX 扩展   │   │
│                   │  (备选方案)  │           │  (弹窗 UI)   │   │
│                   └──────────────┘           └──────────────┘   │
└─────────────────────────────────────────────────────────────────┘

工作原理

1️⃣ AI 调用暂停 ──► 2️⃣ Node.js 启动回调服务器
                            │
                            ▼
3️⃣ 发送 HTTP 请求 ──► 4️⃣ 扩展显示弹窗 / 终端等待输入
                            │
                            ▼
5️⃣ 用户输入 ──► 6️⃣ 回调返回结果 ──► 7️⃣ AI 继续执行

HTTP 接口

文件说明

为什么选择 CK-ASK？

🔧 技术细节

CK-ASK 采用纯 HTTP 通信，通过 Node.js 脚本实现对话暂停功能。其智能端口发现和回调机制，能自动处理用户输入并返回结果给 AI。在绕过 MCP 限制方面，避免了复杂的 MCP 配置，使通信更加简洁高效。终端模式和弹窗模式为用户提供了多样化的交互方式，满足不同场景的需求。

👨‍💻 作者

传康 KK

💬 微信: 1837620622
🐟 咸鱼/B站: 万能程序员

⭐ 支持项目

如果这个项目对你有帮助，请给个 Star ⭐ 支持一下！

📄 许可证

MIT License - 自由使用，欢迎贡献！