$git clone https://github.com/imhuso/cunzhi> AI 对话"早泄"终结者,让交流持续到底
| 1 | # 寸止 🛑 |
| 2 | |
| 3 | > **AI 对话"早泄"终结者,让交流持续到底** |
| 4 | |
| 5 | 还在为 AI 助手总是提前结束对话而抓狂吗?明明还有很多要聊,它却说"还有什么需要帮助的吗?"**寸止** 专治这个毛病! |
| 6 | |
| 7 | 当 AI 想要"草草了事"时,寸止会及时弹出对话框,让你能够继续深入交流,直到真正解决问题为止。 |
| 8 | |
| 9 | ## 🌟 核心特性 |
| 10 | |
| 11 | - 🛑 **智能拦截**:AI 想结束时自动弹出继续选项 |
| 12 | - 🧠 **记忆管理**:按项目存储开发规范和偏好 |
| 13 | - 🎨 **优雅交互**:Markdown 支持、多种输入方式 |
| 14 | - ⚡ **即装即用**:3 秒安装,跨平台支持 |
| 15 | |
| 16 | ## 📸 看看效果 |
| 17 | |
| 18 | ### 🛑 智能拦截弹窗 |
| 19 |  |
| 20 | |
| 21 | *当 AI 想要结束对话时,寸止智能弹窗及时出现,提供预定义选项快速选择,让交流持续深入* |
| 22 | |
| 23 | ### ⚙️ 设置管理界面 |
| 24 |  |
| 25 | |
| 26 | *优雅的设置界面,支持记忆管理、功能开关、主题切换和智能提示词生成* |
| 27 | |
| 28 | ## 🚀 开始使用 |
| 29 | |
| 30 | ### 方式一:快速安装(推荐) |
| 31 | |
| 32 | **macOS 用户:** |
| 33 | ```bash |
| 34 | # 3 秒安装,无需等待编译 |
| 35 | brew tap imhuso/cunzhi && brew install cunzhi |
| 36 | ``` |
| 37 | |
| 38 | > ⚠️ **故障排除**:如果遇到 404 下载错误,请执行以下步骤: |
| 39 | > |
| 40 | > ```bash |
| 41 | > # 清除旧的 tap 缓存 |
| 42 | > brew untap imhuso/cunzhi |
| 43 | > # 重新安装 |
| 44 | > brew tap imhuso/cunzhi && brew install cunzhi |
| 45 | > ``` |
| 46 | > |
| 47 | > **常见错误示例:** |
| 48 | > ``` |
| 49 | > curl: (56) The requested URL returned error: 404 |
| 50 | > Error: cunzhi: Failed to download resource "cunzhi" |
| 51 | > Download failed: https://github.com/imhuso/cunzhi/releases/download/v0.2.0/cunzhi-cli-v0.2.4-macos-aarch64.tar.gz |
| 52 | > ``` |
| 53 | > |
| 54 | > 这通常是由于之前版本的缓存问题导致版本号不匹配。清除 tap 后重新安装即可解决。 |
| 55 | |
| 56 | **Windows/Linux 用户:** |
| 57 | 推荐使用方式二手动下载,简单快捷! |
| 58 | |
| 59 | ### 方式二:手动下载 |
| 60 | |
| 61 | 1. 访问 [Releases 页面](https://github.com/imhuso/cunzhi/releases) |
| 62 | 2. 下载适合你系统的版本: |
| 63 | - 🐧 **Linux**: `cunzhi-cli-v*-linux-x86_64.tar.gz` |
| 64 | - 🍎 **macOS (Intel)**: `cunzhi-cli-v*-macos-x86_64.tar.gz` |
| 65 | - 🍎 **macOS (Apple Silicon)**: `cunzhi-cli-v*-macos-aarch64.tar.gz` |
| 66 | - 🪟 **Windows**: `cunzhi-cli-v*-windows-x86_64.zip` |
| 67 | |
| 68 | 3. 解压后将 `寸止` 和 `等一下` 添加到系统 PATH |
| 69 | |
| 70 | ## ⚡ 快速上手 |
| 71 | |
| 72 | ### 第一步:配置 MCP 客户端 |
| 73 | |
| 74 | 在你的 MCP 客户端(如 Claude Desktop)配置文件中添加: |
| 75 | |
| 76 | ```json |
| 77 | { |
| 78 | "mcpServers": { |
| 79 | "寸止": { |
| 80 | "command": "寸止" |
| 81 | } |
| 82 | } |
| 83 | } |
| 84 | ``` |
| 85 | |
| 86 | ### 第二步:打开设置界面 |
| 87 | |
| 88 | ```bash |
| 89 | # 运行设置命令 |
| 90 | 等一下 |
| 91 | ``` |
| 92 | |
| 93 | ### 第三步:配置提示词 |
| 94 | |
| 95 | 在设置界面的"参考提示词"标签页: |
| 96 | 1. 查看自动生成的提示词 |
| 97 | 2. 点击复制按钮 |
| 98 | 3. 将提示词添加到你的 AI 助手中 |
| 99 | |
| 100 | ### 第四步:开始使用 |
| 101 | |
| 102 | 现在你的 AI 助手就拥有了智能拦截、记忆管理和弹窗交互功能! |
| 103 | |
| 104 | > 💡 **小贴士**:你可以参考生成的提示词进行个性化修改,打造专属的 AI 交互体验。 |
| 105 | |
| 106 | ## 🔧 工具说明 |
| 107 | |
| 108 | 寸止提供了多个 MCP 工具来增强 AI 助手的能力: |
| 109 | |
| 110 | - **代码搜索工具**:基于 ACE 的语义代码搜索,帮助 AI 理解项目代码结构 |
| 111 | - 📖 [详细使用说明](./ACEMCP.md) |
| 112 | |
| 113 | ### 🙏 致谢 |
| 114 | |
| 115 | 感谢以下开源项目及其贡献者: |
| 116 | |
| 117 | - **[acemcp](https://github.com/qy527145/acemcp)** - 由 [@qy527145](https://github.com/qy527145) 开发,提供了强大的代码库语义搜索能力。本项目在保留原有功能的基础上,使用 Rust 重写了核心逻辑并集成到寸止的 MCP 工具生态中。 |
| 118 | |
| 119 | ## 🤝 参与贡献 |
| 120 | |
| 121 | 寸止是开源项目,我们欢迎所有形式的贡献! |
| 122 | |
| 123 | ### 🛠️ 本地开发 |
| 124 | ```bash |
| 125 | git clone https://github.com/imhuso/cunzhi.git |
| 126 | cd cunzhi |
| 127 | pnpm install |
| 128 | pnpm tauri:dev |
| 129 | ``` |
| 130 | |
| 131 | ## 📄 开源协议 |
| 132 | |
| 133 | MIT License - 自由使用,欢迎贡献! |
| 134 | |
| 135 | </div> |