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 - 自由使用，歡迎貢獻！