BlueMouse

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

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

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

[EN]In the era ofVibe 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 aQuality Gatethat stops bad code before it happens.

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

- ❌[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，不是在開發階段

- ✅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"

[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 的速度攔截指令。無需伺服器、訂閱或雲端依賴。

[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?"

- 「對於並發訂單，使用悲觀鎖還是樂觀鎖？」
- 「支付失敗時，立即回滾還是重試 3 次？」

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

[EN]Code generation passes through 17 logic gates:
- Syntax | 語法- Correctness | 正確性
- Type | 型別- Static type checking (Pydantic/MyPy) | 靜態型別檢查
- Security | 安全- OWASP Top 10 scanning | OWASP Top 10 掃描
- Logic | 邏輯- Business logic integrity | 業務邏輯完整性
- Performance | 性能- Complexity analysis | 複雜度分析 ... and 12 more layers | ...以及另外 12 層

# Just drag the folder into Cursor and type: # 只需將資料夾拖進 Cursor 並輸入： Start

BlueMouse automatically injects.cursorrulesand starts protecting your code.

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

graph TD User["User Request | 用戶需求"] --> L1{"L1: Antigravity Inline<br/>內聯生成"} L1 -->|Miss 未命中| L2{"L2: Ollama Local<br/>本地模型"} L2 -->|Miss/Timeout<br/>未命中/超時| L3{"L3: Cloud API (BYOK)<br/>雲端 API (自帶密鑰)"} L3 -->|Miss/Offline<br/>未命中/離線| L4["L4: Rule Engine Fallback<br/>規則引擎降級"] subgraph "Hybrid Fusion Core | 混合融合核心" L4 -->|Keyword Match<br/>關鍵詞匹配| KB["Knowledge Base (180k Data)<br/>知識庫 (18萬數據)"] KB --> Fusion["Hybrid Fusion Engine<br/>混合融合引擎"] end Fusion --> Socratic["Socratic Interview<br/>蘇格拉底式面試"] Socratic --> User User -->|Answers 回答| CodeGen["17-Layer Code Generator<br/>17層代碼生成器"] CodeGen -->|Compiler Prompt<br/>編譯器提示| README["README+Code+Docs<br/>文檔+代碼+說明"]

- ✅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 已通過嚴格的壓力測試：

# 1. Clone git clone https://github.com/peijun1700/bluemouse cd bluemouse # 2. Start (在終端機執行 | Run in Terminal) ./Start # Mac/Linux Start.bat # Windows # 3. Restart Cursor # BlueMouse is now protecting your code!

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

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

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

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

I want to build an e-commerce platform with user authentication

[EN]BlueMouse will ask critical logic questions:

- Database concurrency strategy?
- Error handling approach?
- Security measures?

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

- ✅ Source code | 原始碼
- ✅ Architecture diagrams | 架構圖
- ✅ Installation guide | 安裝指南
- ✅ Cost estimation | 成本估算
- ✅ Validation report | 驗證報告

- ✅ No data leaves your machine | 數據不離開您的電腦
- ✅ No cloud dependencies | 無雲端依賴
- ✅ No telemetry or tracking | 無遙測或追蹤
- ✅ Works in air-gapped environments | 可在隔離環境運行

- ✅ Open source for transparency | 開源透明
- ✅ Commercial use requires compliance | 商業使用需遵守協議
- ✅ Protects against closed-source forks | 防止閉源分支

Read ourPrivacy Whitepaperfor technical details.

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# Find and kill the process | 查找並終止進程 lsof -ti:8001 | xargs kill -9 # Mac/Linux netstat -ano | findstr :8001 # Windows

chmod +x start_bluemouse.command # Mac/Linux

pip install -r requirements.txt --force-reinstall

- System Architecture | 系統架構- Technical deep dive | 技術深入解析
- Changelog | 更新日誌- Version history | 版本歷史
- Privacy Policy | 隱私政策- Data handling details | 數據處理細節
- License | 授權- AGPLv3 terms | AGPLv3 條款
- Cursor Integration Guide | Cursor 整合指南- IDE setup | IDE 設定

- GitHub Issues:Report bugs or request features | 回報錯誤或請求功能
- Discussions:Join the conversation | 加入討論
- Email | 電子郵件:bluemouse.ai@gmail.com

- 🔄 Frontend template generation | 前端模板生成
- 🔄 Custom question library | 自定義問題庫
- 🔄 Team collaboration features | 團隊協作功能
- 🔄 Enterprise audit logs | 企業審計日誌
- 完全關閉 Cursor (Cmd+Q / Ctrl+Q)
- 重新打開 Cursor
- 檢查.vscode/mcp.json是否存在
- 如果還是沒反應，手動配置 MCP (參考CURSOR_GUIDE.md)

# Mac/Linux lsof -ti:8001 | xargs kill -9 # Windows netstat -ano | findstr :8001 taskkill /PID <PID> /F

- 您的需求包含DROP TABLE或DELETE FROM等關鍵字
- BlueMouse 服務正在運行 (檢查http://localhost:8001)
- 在蘇格拉底問題階段會自動觸發

# 在需求輸入框輸入: "幫我 drop table users" # 系統會立即顯示: ⚠️ CRITICAL STOP: You are executing DROP without Environment Check. Is this PROD?

# 1. 停止服務 (Ctrl+C) # 2. 刪除資料夾 rm -rf bluemouse # 3. 移除 Cursor 配置 rm .vscode/mcp.json

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB