📖 用户使用指南
🎯 软件简介
STOP? STOP! 是一款 Windsurf IDE 扩展,旨在解决 AI 编程助手在对话过程中"想停就停"的问题。
核心功能
💬 对话控制
当 AI 想要结束对话时,会弹出确认框让用户决定是继续还是结束
⚡ 快捷指令
自定义快捷按钮,一键发送常用指令
✨ AI 优化
集成 AI 能力,优化和强化用户输入
📊 统计追踪
记录对话次数和节省的 API 请求数
工作原理
扩展通过 MCP (Model Context Protocol) 协议与 AI 助手通信。当 AI 调用 stop_stop 工具时,扩展会:
- 弹出对话框显示 AI 想要结束的原因
- 让用户选择"继续"或"结束"
- 如果继续,用户可以输入新指令
- 将用户的选择和指令返回给 AI
📦 安装指南
系统要求
| 项目 | 要求 |
|---|---|
| 编辑器 | Windsurf 最新版 或 VS Code 1.80.0+ |
| 操作系统 | Windows 10/11、macOS 10.15+、Linux |
安装方式
方法 A:拖拽安装(最简单)
- 获取
.vsix文件 - 打开扩展面板(
Ctrl+Shift+X) - 将
.vsix文件拖拽到扩展面板中 - 安装完成后,重启编辑器
方法 B:命令面板安装
- 按
Ctrl+Shift+P打开命令面板 - 输入
Extensions: Install from VSIX... - 选择下载的
.vsix文件 - 安装完成后,重启编辑器
验证安装
安装成功后,你会看到:
- 左侧活动栏出现 STOP? STOP! 图标
- 状态栏右下角显示
$(warning) STOP?STOP!(未激活状态)
🔑 激活与授权
获取激活码
请通过渠道购买激活码。激活码格式为:XXXX-XXXX-XXXX-XXXX(16位大写字母和数字)
激活步骤
- 点击左侧活动栏的 STOP? STOP! 图标,打开侧边栏
- 在激活输入框中输入你的激活码
- 点击"🚀 激活扩展"按钮
- 激活成功后,状态栏会显示
$(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 协议,需要配置端口 | 特殊网络环境 |
🎮 基本功能操作
创建规则文件
- 打开侧边栏 → 工具箱
- 点击"📝 新建规则"
- 扩展会在工作区根目录创建
.windsurfrules文件
使用对话框
当 AI 调用 stop_stop 工具时,会弹出对话框:
- 查看原因:对话框顶部显示 AI 想要结束的原因
- 输入新指令:在文本框中输入你的新要求
- 使用快捷按钮:点击预设的快捷按钮快速填入常用指令
- 添加图片:点击图片区域上传截图或粘贴(Ctrl+V)
拖拽文件
对话框支持拖拽文件,方便向 AI 展示代码或文档:
- 拖拽上传:直接将文件拖拽到对话框中
- 支持格式:文本文件、代码文件、图片等
- 自动解析:文本文件内容会自动显示在对话中
快捷键
| 快捷键 | 功能 |
|---|---|
Enter |
继续对话 |
Shift+Enter |
换行 |
Esc |
结束对话 |
Ctrl+V |
粘贴图片 |
🚀 高级功能
AI 优化功能
配置 AI 提供商后,可以使用以下功能:
✨ 一键优化
自动优化你输入的指令,使其更清晰、更专业。点击"一键优化"按钮,查看优化结果预览后可选择采用或重试。
🔧 强化指令
使用自定义的强化规则修改指令,如"更详细"、"加入代码示例"等。
图片支持
- 点击上传:点击图片区域选择文件
- 粘贴上传:
Ctrl+V粘贴剪贴板中的图片
❓ 常见问题
确认扩展已成功安装,尝试重启编辑器,检查是否有其他扩展冲突。
确保激活码格式为 XXXX-XXXX-XXXX-XXXX,全部大写。检查网络连接,扩展需要在线验证。
确认已创建 .windsurfrules 文件,确认 MCP 服务器已正确配置。在对话开始时提醒 AI:Read and follow .windsurfrules
等待几秒钟,可能是加载中。按 Esc 关闭对话框,重新触发。重启编辑器。
确认 Node.js 已正确安装。检查 MCP 配置文件语法。确认扩展安装路径没有中文或特殊字符。
检查端口是否被占用,确认防火墙允许本地端口通信,尝试更换端口号。
激活码有时效限制,到期后需要续费。联系客服获取新的激活码,重新在侧边栏输入。
确认已配置 AI 提供商和 API Key,检查 API Key 是否有效,检查网络是否能访问 AI 服务。
修改后需要刷新侧边栏(关闭再打开),确认修改已保存(输入框失去焦点后自动保存)。
完全卸载旧版本,重启编辑器,安装新版本,重新配置 MCP 服务器。
📞 联系支持
📧 技术支持
更新日志
| 版本 | 日期 | 更新内容 |
|---|---|---|
| v1.0.7 | 2025-12 | 优化VSIX包大小,修复更新服务器 |
| v1.0.2 | 2025-12 | 新增一机一码验证机制 |
| v1.0.0 | 2025-11 | 首次发布,核心功能完成 |