Peraturan AI (AI Rule)

Selepas integrasi dengan ServBay MCP, alat AI memang boleh memanggil ServBay, tetapi tidak semestinya tahu bila dan cara yang betul untuk berbuat demikian. Peraturan AI (AI Rule) ialah satu set panduan khusus untuk AI—ia memberitahu AI bahawa bila melibatkan isu seperti servis tempatan, laman web, domain, HTTPS, port, pangkalan data, sandaran dan sebagainya, AI mesti memeriksa dan mengendalikan melalui ServBay MCP terlebih dahulu, bukannya mengubah kod aplikasi untuk mengatasi masalah persekitaran. Dokumen ini menerangkan cara memasang Peraturan AI.

Masalah yang Diselesaikan oleh Peraturan AI

• Memastikan AI keutamaan MCP — Apabila berlaku masalah persekitaran tempatan seperti "laman tidak boleh dibuka / 502 / port digunakan / ralat sijil", AI akan memeriksa status melalui ServBay MCP terlebih dahulu, bukannya terus mengubah kod secara membabi buta.
• Menentukan sempadan keselamatan yang jelas — Untuk operasi tulis atau operasi yang boleh merosakkan, AI perlu beri penjelasan dan pengesahan terlebih dahulu, serta tidak meminta atau menampal maklumat sensitif seperti kunci dalam perbualan.
• Kurangkan penjelasan berulang-ulang — Peraturan AI sentiasa aktif, jadi setiap sesi AI mendapat peraturan tingkah laku yang konsisten.

Prasyarat

• ServBay telah dipasang dan dijalankan.
• Disarankan integrasi ServBay MCP telah lengkap.

Peringkat Workspace vs Peringkat Global

Peraturan AI boleh dipasang pada dua peringkat:

• Workspace (Projek Khusus) — Fail peraturan diletakkan di dalam direktori projek tertentu, hanya terpakai untuk projek tersebut. Sesuai untuk peraturan tersuai mengikut projek.
• Global — Fail peraturan diletakkan dalam konfigurasi pengguna alat AI, berfungsi untuk semua projek. Kini hanya Claude Code dan Codex menyokong peringkat global.

Cara Memasang Peraturan AI

Pergi ke ServBay Settings (Tetapan) → AI Client Integration (Integrasi AI IDE), kemudian klik Install AI Rule (Pasang Peraturan AI) pada baris klien yang sesuai. Untuk pemasangan di peringkat workspace, pilih dahulu direktori projek sasaran. ServBay akan mencipta atau mengemaskini fail peraturan yang berkaitan. Untuk membuang peraturan, klik Remove AI Rule (Buang Peraturan AI).

Lokasi Fail Peraturan untuk Peringkat Workspace

Klien	Fail Peraturan (relatif kepada root projek)
VS Code	.github/instructions/servbay-mcp.instructions.md
Cursor	.cursor/rules/servbay-mcp.mdc
Codex	AGENTS.md
Claude Code	CLAUDE.md

Lokasi Fail Peraturan untuk Peringkat Global

Klien	Fail Peraturan
Claude Code	~/.claude/CLAUDE.md (ingatan rasmi pengguna, dimuat pada permulaan sesi)
Codex	~/.codex/AGENTS.md (ingatan rasmi global)

Strategi Gabungan: Kandungan Anda Tidak Dilenyapkan

ServBay menggunakan strategi gabungan berasaskan penanda untuk menulis peraturan: kandungan peraturan yang dihoskan oleh ServBay dibalut dengan penanda khusus, dan hanya kawasan di antara penanda yang akan dikemas kini, semua kandungan lain dalam fail itu akan kekal. Jadi, anda boleh menulis peraturan ke dalam CLAUDE.md atau AGENTS.md anda tanpa bimbang kehilangan kandungan sedia ada. Apabila peraturan dibuang, hanya bahagian yang dihoskan ServBay akan dipadamkan.

Soalan Lazim (FAQ)

• S: Adakah pemasangan Peraturan AI akan menindih fail CLAUDE.md atau AGENTS.md saya yang sedia ada?
  • J: Tidak. ServBay hanya mengemaskini bahagian yang dibalut penanda khusus, kandungan lain tetap kekal.
• S: Kenapa klien saya tiada pilihan "peraturan global"?
  • J: Ketika ini, hanya Claude Code dan Codex menyokong peraturan peringkat global. Klien lain sila gunakan pemasangan peringkat workspace.
• S: Apakah hubungan antara Peraturan AI dan integrasi MCP?
  • J: Integrasi MCP membolehkan AI boleh memanggil ServBay, manakala Peraturan AI memberitahu AI bila dan cara menggunakan ServBay dengan betul. Gabungan kedua-duanya beri hasil terbaik.
• S: Adakah fail peraturan dalam projek Cursor / VS Code akan dimasukkan ke dalam Git?
  • J: Fail peraturan berada dalam direktori projek, sama ada ia diurus dalam kawalan versi bergantung kepada kandungan .gitignore anda, jadi uruskan mengikut amalan pasukan anda.

Kesimpulan

Peraturan AI ialah "buku panduan penggunaan" untuk ServBay MCP yang membolehkan AI menggunakan ServBay dengan lebih tepat, selamat dan berkesan apabila menangani isu persekitaran pembangunan tempatan. Menyokong pemasangan pada peringkat workspace atau global, dengan strategi gabungan berasaskan penanda untuk melindungi kandungan anda yang sedia ada. Selepas pemasangan, alat AI anda benar-benar boleh menjadi pembantu yang cekap untuk pengurusan persekitaran tempatan.