🐭 BlueMouse v6.6

The AI Safety Layer for Cursor & Claude | AI 代碼安全層

Stop Vibe Coding. Start Engineering. | 拒絕憑感覺寫代碼，回歸工程思維。 https://bluemouse.app

Contact | 聯繫: bluemouse.ai@gmail.com

🌐 Works Everywhere | 全平台支援

BlueMouse is a standard MCP Server that works with ANY MCP-compatible client:

[EN] Don't have Cursor? No problem! BlueMouse works as a standalone web tool.
[中文] 沒有 Cursor？沒關係！BlueMouse 可以當獨立網頁工具使用。

🌟 Why BlueMouse? | 為什麼選擇 BlueMouse？

[EN] In the era of Vibe Coding, AI generates code faster than we can read. But even the best AI (Claude 3.5 / 4.5) hallucinates. BlueMouse is your Airbag. It's not another coding tool—it's a Quality Gate that stops bad code before it happens.

[中文] 在 Vibe Coding 盛行的時代，AI 產生代碼的速度比我們閱讀的速度還快。但即使是最強的 AI (Claude 3.5 / 4.5) 也會出現邏輯幻覺。BlueMouse 是您的安全氣囊。 它不是另一個寫代碼的工具，它是阻止爛代碼發生的守門員。

The Problem | 問題所在

• ❌ [EN] AI generates code by "vibes" without deep logic validation

• ❌ [中文] AI 憑感覺生成代碼，沒有深度邏輯驗證

• ❌ [EN] Edge cases are completely ignored

• ❌ [中文] 邊界情況完全沒考慮

• ❌ [EN] Tech debt explodes silently

• ❌ [中文] 技術債默默爆炸

• ❌ [EN] You find bugs in production, not development

• ❌ [中文] 在正式環境才發現 Bug，不是在開發階段

The Solution | 解決方案

• ✅ 17-Layer Validation | 17層驗證 - Every line passes through AST parsing, type checking, and security audits | 每一行代碼都經過 AST 解析、型別檢查和安全審計

• ✅ Socratic Interview | 蘇格拉底式面試 - AI must answer logic questions before generating code | AI 必須先回答邏輯問題才能生成代碼

• ✅ Zero Infrastructure Cost | 零基礎設施成本 - 100% local execution, no servers needed | 100% 本地執行，不需要伺服器

• ✅ One-Word Start | 一鍵啟動 - Just type "Start" in Cursor | 只需在 Cursor 中輸入 "Start"

🔥 Core Features | 核心功能

🦠 Parasitic Architecture | 寄生架構

[EN] $0 Infrastructure Cost. BlueMouse sits between you and the compiler, intercepting commands in <10ms. No servers, no subscriptions, no cloud dependencies.

[中文] $0 營運成本。BlueMouse 寄生於您的開發環境，以 <10ms 的速度攔截指令。無需伺服器、訂閱或雲端依賴。

🧠 Socratic Logic Gate | 蘇格拉底邏輯門

[EN] Before writing code, BlueMouse interviews the AI with critical questions:

• "For concurrent orders, pessimistic lock or optimistic lock?"

• "On payment failure, rollback immediately or retry 3 times?"

[中文] 在寫代碼之前，BlueMouse 會用關鍵問題面試 AI：

• 「對於並發訂單，使用悲觀鎖還是樂觀鎖？」

• 「支付失敗時，立即回滾還是重試 3 次？」

Forces you (and AI) to think before coding. | 強制您（和 AI）在寫代碼前先思考。

🛡️ 17-Layer Validation | 17層驗證

[EN] Code generation passes through 17 logic gates:

[中文] 代碼生成必須通過 17 道邏輯閘：

1. Syntax | 語法 - Correctness | 正確性

2. Type | 型別 - Static type checking (Pydantic/MyPy) | 靜態型別檢查

3. Security | 安全 - OWASP Top 10 scanning | OWASP Top 10 掃描

4. Logic | 邏輯 - Business logic integrity | 業務邏輯完整性

5. Performance | 性能 - Complexity analysis | 複雜度分析 ... and 12 more layers | ...以及另外 12 層

👆 One-Word Start | 一鍵啟動

BlueMouse automatically injects .cursorrules and starts protecting your code.

BlueMouse 會自動注入 .cursorrules 並開始保護您的代碼。

📐 System Architecture | 系統架構

[EN] BlueMouse uses a 4-layer hybrid architecture with intelligent fallback:

[中文] BlueMouse 使用 4 層混合架構,具有智能降級機制:

Key Features | 核心特性:

• ✅ Zero Single Point of Failure | 無單點故障 - 4-layer fallback ensures 100% uptime | 4層降級確保 100% 可用性

• ✅ Offline-First | 離線優先 - Works without internet | 無需網路即可運行

• ✅ BYOK (Bring Your Own Key) | 自帶密鑰 - Use your own API keys or local models | 使用您自己的 API 密鑰或本地模型

• ✅ 180k Knowledge Base | 18萬知識庫 - Pre-loaded with 28 high-risk scenarios | 預載 28 個高風險場景

🏆 Industrial Grade Certification | 工業級認證

BlueMouse v6.6 has passed rigorous stress tests | BlueMouse v6.6 已通過嚴格的壓力測試：

🚀 Quick Start | 快速開始

Three Steps. That's It. | 三步驟,就這樣。

That's literally it. No Docker, no config files, no cloud setup.
就這樣。 沒有 Docker、沒有配置檔、沒有雲端設定。

Alternative: Use as Web Tool | 替代方案：當網頁工具用

Don't have Cursor? Open http://localhost:8001 after running ./Start.
沒有 Cursor？執行 ./Start 後打開 http://localhost:8001。

Detailed Setup | 詳細設定

For manual installation or troubleshooting, see CURSOR_GUIDE.md.
手動安裝或疑難排解，請參考 CURSOR_GUIDE.md。

📖 Usage | 使用方法

1. Enter Your Vision | 輸入您的構想

[EN] Describe what you want to build:

[中文] 描述您想建立的系統：

2. Answer Socratic Questions | 回答蘇格拉底式問題

[EN] BlueMouse will ask critical logic questions:

• Database concurrency strategy?

• Error handling approach?

• Security measures?

[中文] BlueMouse 會詢問關鍵邏輯問題：

• 資料庫並發策略？

• 錯誤處理方式？

• 安全措施？

3. Get Validated Code | 獲得驗證過的代碼

[EN] After passing 17 layers of validation, download your project ZIP containing:

[中文] 通過 17 層驗證後，下載包含以下內容的專案 ZIP：

• ✅ Source code | 原始碼

• ✅ Architecture diagrams | 架構圖

• ✅ Installation guide | 安裝指南

• ✅ Cost estimation | 成本估算

• ✅ Validation report | 驗證報告

🛡️ Enterprise Security | 企業安全

100% Local Execution | 100% 本地執行

• ✅ No data leaves your machine | 數據不離開您的電腦

• ✅ No cloud dependencies | 無雲端依賴

• ✅ No telemetry or tracking | 無遙測或追蹤

• ✅ Works in air-gapped environments | 可在隔離環境運行

AGPLv3 License | AGPLv3 授權

• ✅ Open source for transparency | 開源透明

• ✅ Commercial use requires compliance | 商業使用需遵守協議

• ✅ Protects against closed-source forks | 防止閉源分支

Read our for technical details.

**閱讀我們的隱私白皮書**了解技術細節。

🔧 Troubleshooting | 故障排除

python3: command not found

Mac/Linux:

Windows: Download from python.org

pip install fails | pip install 失敗

Try using a mirror | 嘗試使用鏡像：

Port 8001 already in use | 端口 8001 已被占用

Permission denied | 權限被拒絕

ModuleNotFoundError | 模組未找到

Browser doesn't open | 瀏覽器未打開

Manually navigate to | 手動訪問: http://localhost:8001

📚 Documentation | 文檔

• System Architecture | 系統架構 - Technical deep dive | 技術深入解析

• Changelog | 更新日誌 - Version history | 版本歷史

• Privacy Policy | 隱私政策 - Data handling details | 數據處理細節

• License | 授權 - AGPLv3 terms | AGPLv3 條款

• Cursor Integration Guide | Cursor 整合指南 - IDE setup | IDE 設定

🌍 Community | 社群

• GitHub Issues: Report bugs or request features | 回報錯誤或請求功能

• Discussions: Join the conversation | 加入討論

• Email | 電子郵件: bluemouse.ai@gmail.com

🎯 Roadmap | 路線圖

v6.6 (Current | 當前版本)

• ✅ 17-Layer validation system | 17層驗證系統

• ✅ Socratic question library (22 questions, 10 categories) | 蘇格拉底問題庫（22 個問題，10 個類別）

• ✅ Bilingual support (zh-TW / en-US) | 雙語支援（繁中/英文）

• ✅ Zero-cost parasitic architecture | 零成本寄生架構

v7.0 (Planned | 計劃中)

• 🔄 Frontend template generation | 前端模板生成

• 🔄 Custom question library | 自定義問題庫

• 🔄 Team collaboration features | 團隊協作功能

• 🔄 Enterprise audit logs | 企業審計日誌

❓ FAQ | 常見問題

Q1: BlueMouse 啟動後，Cursor 沒有反應？

A: 請確認以下步驟：

1. 完全關閉 Cursor (Cmd+Q / Ctrl+Q)

2. 重新打開 Cursor

3. 檢查 .vscode/mcp.json 是否存在

4. 如果還是沒反應，手動配置 MCP (參考 CURSOR_GUIDE.md)

Q2: 出現 "Address already in use" 錯誤？

A: 端口 8001 被佔用。解決方法：

Q3: CRITICAL STOP 沒有觸發？

A: CRITICAL STOP 功能已實現!確認以下條件:

• 您的需求包含 DROP TABLE 或 DELETE FROM 等關鍵字

• BlueMouse 服務正在運行 (檢查 http://localhost:8001)

• 在蘇格拉底問題階段會自動觸發

測試方法:

Q4: 需要 API Key 嗎？

A: 不需要！ BlueMouse 可以完全本地運行。

• 如果您有 Anthropic/OpenAI API Key，可以獲得更好的 AI 輔助

• 如果沒有，BlueMouse 仍然會執行 17-Layer Validation

Q5: 支援 Windows 嗎？

A: 支援！使用 Start.bat 啟動。 注意：部分功能可能需要 WSL (Windows Subsystem for Linux)

Q6: 如何解除安裝？

A:

Q7: 可以用在其他 IDE 嗎？

A: 可以！BlueMouse 是標準的 MCP Server，支援：

• Cursor ✅

• Claude Desktop ✅

• VS Code (需要 MCP 插件) ✅

• 任何支援 MCP 協議的客戶端 ✅

📄 License | 授權

BlueMouse is licensed under AGPLv3 | BlueMouse 採用 AGPLv3 授權。

What this means | 這意味著:

• ✅ Free for personal use | 個人使用免費

• ✅ Free for open-source projects | 開源專案免費

• ⚠️ Commercial use requires compliance (or contact us for licensing) | 商業使用需遵守協議（或聯繫我們獲取授權）

See LICENSE for details | 詳見 LICENSE。

🙏 Acknowledgments | 致謝

Built with | 使用以下技術構建:

• FastAPI - Modern Python web framework | 現代 Python Web 框架

• Pydantic - Data validation | 數據驗證

• Anthropic Claude - AI reasoning (optional) | AI 推理（可選）

• Ollama - Local AI models (optional) | 本地 AI 模型（可選）

📊 Stats | 統計

Made with ❤️ by developers who care about code quality

由關心代碼品質的開發者用心打造

Stop Vibe Coding. Start Engineering. | 拒絕憑感覺寫代碼，回歸工程思維。 🐭