📖 用户使用指南

版本 1.0.7 2025年12月

🎯 软件简介

STOP? STOP! 是一款 Windsurf IDE 扩展,旨在解决 AI 编程助手在对话过程中"想停就停"的问题。

核心功能

💬 对话控制

当 AI 想要结束对话时,会弹出确认框让用户决定是继续还是结束

⚡ 快捷指令

自定义快捷按钮,一键发送常用指令

✨ AI 优化

集成 AI 能力,优化和强化用户输入

📊 统计追踪

记录对话次数和节省的 API 请求数

工作原理

扩展通过 MCP (Model Context Protocol) 协议与 AI 助手通信。当 AI 调用 stop_stop 工具时,扩展会:

  1. 弹出对话框显示 AI 想要结束的原因
  2. 让用户选择"继续"或"结束"
  3. 如果继续,用户可以输入新指令
  4. 将用户的选择和指令返回给 AI

📦 安装指南

系统要求

项目 要求
编辑器 Windsurf 最新版 或 VS Code 1.80.0+
操作系统 Windows 10/11、macOS 10.15+、Linux
提示:HTTP 传输模式下,扩展内置了服务器,无需额外安装 Node.js。

安装方式

方法 A:拖拽安装(最简单)

  1. 获取 .vsix 文件
  2. 打开扩展面板(Ctrl+Shift+X)
  3. 将 .vsix 文件拖拽到扩展面板中
  4. 安装完成后,重启编辑器

方法 B:命令面板安装

  1. 按 Ctrl+Shift+P 打开命令面板
  2. 输入 Extensions: Install from VSIX...
  3. 选择下载的 .vsix 文件
  4. 安装完成后,重启编辑器

验证安装

安装成功后,你会看到:

  • 左侧活动栏出现 STOP? STOP! 图标
  • 状态栏右下角显示 $(warning) STOP?STOP!(未激活状态)

🔑 激活与授权

获取激活码

请通过渠道购买激活码。激活码格式为:XXXX-XXXX-XXXX-XXXX(16位大写字母和数字)

激活步骤

  1. 点击左侧活动栏的 STOP? STOP! 图标,打开侧边栏
  2. 在激活输入框中输入你的激活码
  3. 点击"🚀 激活扩展"按钮
  4. 激活成功后,状态栏会显示 $(check) STOP?STOP!

激活状态说明

状态栏显示 含义
$(warning) STOP?STOP! 未激活或试用期
$(check) STOP?STOP! 已激活

⚙️ 配置说明

MCP 服务器配置

扩展需要配置 MCP 服务器才能与 AI 助手通信。

手动配置

打开 MCP 配置文件:

  • Windsurf:~/.codeium/windsurf/mcp_config.json
  • VS Code + Continue:~/.continue/config.json

添加以下配置:

{
  "mcpServers": {
    "stop_stop": {
      "command": "node",
      "args": ["<扩展安装路径>/out/mcp-server-entry.js"],
      "env": {}
    }
  }
}

传输模式

模式 说明 适用场景
stdio(默认) 标准输入输出,稳定性高 大多数情况
HTTP HTTP 协议,需要配置端口 特殊网络环境

🎮 基本功能操作

创建规则文件

  1. 打开侧边栏 → 工具箱
  2. 点击"📝 新建规则"
  3. 扩展会在工作区根目录创建 .windsurfrules 文件

使用对话框

当 AI 调用 stop_stop 工具时,会弹出对话框:

  • 查看原因:对话框顶部显示 AI 想要结束的原因
  • 输入新指令:在文本框中输入你的新要求
  • 使用快捷按钮:点击预设的快捷按钮快速填入常用指令
  • 添加图片:点击图片区域上传截图或粘贴(Ctrl+V)

拖拽文件

对话框支持拖拽文件,方便向 AI 展示代码或文档:

  • 拖拽上传:直接将文件拖拽到对话框中
  • 支持格式:文本文件、代码文件、图片等
  • 自动解析:文本文件内容会自动显示在对话中

快捷键

快捷键 功能
Enter 继续对话
Shift+Enter 换行
Esc 结束对话
Ctrl+V 粘贴图片

🚀 高级功能

AI 优化功能

配置 AI 提供商后,可以使用以下功能:

✨ 一键优化

自动优化你输入的指令,使其更清晰、更专业。点击"一键优化"按钮,查看优化结果预览后可选择采用或重试。

🔧 强化指令

使用自定义的强化规则修改指令,如"更详细"、"加入代码示例"等。

图片支持

  • 点击上传:点击图片区域选择文件
  • 粘贴上传:Ctrl+V 粘贴剪贴板中的图片

❓ 常见问题

Q1: 安装后侧边栏没有出现扩展图标

确认扩展已成功安装,尝试重启编辑器,检查是否有其他扩展冲突。

Q2: 激活码输入后提示"激活码无效"

确保激活码格式为 XXXX-XXXX-XXXX-XXXX,全部大写。检查网络连接,扩展需要在线验证。

Q3: AI 不调用 stop_stop 工具

确认已创建 .windsurfrules 文件,确认 MCP 服务器已正确配置。在对话开始时提醒 AI:Read and follow .windsurfrules

Q4: 对话框弹出后卡住或无响应

等待几秒钟,可能是加载中。按 Esc 关闭对话框,重新触发。重启编辑器。

Q5: MCP 服务器启动失败

确认 Node.js 已正确安装。检查 MCP 配置文件语法。确认扩展安装路径没有中文或特殊字符。

Q6: HTTP 传输模式连接失败

检查端口是否被占用,确认防火墙允许本地端口通信,尝试更换端口号。

Q7: 状态栏显示"激活已过期"

激活码有时效限制,到期后需要续费。联系客服获取新的激活码,重新在侧边栏输入。

Q8: AI 优化功能不可用

确认已配置 AI 提供商和 API Key,检查 API Key 是否有效,检查网络是否能访问 AI 服务。

Q9: 快捷按钮修改后不生效

修改后需要刷新侧边栏(关闭再打开),确认修改已保存(输入框失去焦点后自动保存)。

Q10: 扩展更新后功能异常

完全卸载旧版本,重启编辑器,安装新版本,重新配置 MCP 服务器。

📞 联系支持

📧 技术支持

邮箱:[email protected]

更新日志

版本 日期 更新内容
v1.0.7 2025-12 优化VSIX包大小,修复更新服务器
v1.0.2 2025-12 新增一机一码验证机制
v1.0.0 2025-11 首次发布,核心功能完成