خوادم LSP
يمكن أن يتكامل OpenCode مع خوادم Language Server Protocol (LSP) لاستخدام التشخيصات كملاحظات للوكيل.
يأتي OpenCode مع عدة خوادم LSP مدمجة للغات الشائعة:
| خادم LSP | الامتدادات | المتطلبات |
|---|---|---|
| astro | .astro | يثبت تلقائيا لمشاريع Astro |
| bash | .sh, .bash, .zsh, .ksh | يثبت bash-language-server تلقائيا |
| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | يثبت تلقائيا لمشاريع C/C++ |
| csharp | .cs | تثبيت .NET SDK |
| clojure-lsp | .clj, .cljs, .cljc, .edn | توفر أمر clojure-lsp |
| dart | .dart | توفر أمر dart |
| deno | .ts, .tsx, .js, .jsx, .mjs | توفر أمر deno (يكتشف تلقائيا deno.json/deno.jsonc) |
| elixir-ls | .ex, .exs | توفر أمر elixir |
| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | وجود تبعية eslint في المشروع |
| fsharp | .fs, .fsi, .fsx, .fsscript | تثبيت .NET SDK |
| gleam | .gleam | توفر أمر gleam |
| gopls | .go | توفر أمر go |
| hls | .hs, .lhs | توفر أمر haskell-language-server-wrapper |
| jdtls | .java | تثبيت Java SDK (version 21+) |
| kotlin-ls | .kt, .kts | يثبت تلقائيا لمشاريع Kotlin |
| lua-ls | .lua | يثبت تلقائيا لمشاريع Lua |
| nixd | .nix | توفر أمر nixd |
| ocaml-lsp | .ml, .mli | توفر أمر ocamllsp |
| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | وجود تبعية oxlint في المشروع |
| php intelephense | .php | يثبت تلقائيا لمشاريع PHP |
| prisma | .prisma | توفر أمر prisma |
| pyright | .py, .pyi | تثبيت تبعية pyright |
| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | توفر أمري ruby و gem |
| rust | .rs | توفر أمر rust-analyzer |
| sourcekit-lsp | .swift, .objc, .objcpp | تثبيت swift (على macOS عبر xcode) |
| svelte | .svelte | يثبت تلقائيا لمشاريع Svelte |
| terraform | .tf, .tfvars | يثبت تلقائيا من إصدارات GitHub |
| tinymist | .typ, .typc | يثبت تلقائيا من إصدارات GitHub |
| typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | وجود تبعية typescript في المشروع |
| vue | .vue | يثبت تلقائيا لمشاريع Vue |
| yaml-ls | .yaml, .yml | يثبت yaml-language-server من Red Hat تلقائيا |
| zls | .zig, .zon | توفر أمر zig |
تكون ميزة LSP معطلة افتراضيا. عند تفعيلها، تبدأ الخوادم عند اكتشاف أحد امتدادات الملفات المذكورة أعلاه واستيفاء المتطلبات.
عند تفعيل LSP وفتح opencode لملف، فإنه:
- يفحص امتداد الملف مقابل جميع خوادم LSP المفعّلة.
- يشغّل خادم LSP المناسب إذا لم يكن قيد التشغيل بالفعل.
يمكن أن تساعد LSP الوكيل على العثور على المشاكل وإصلاحها عبر توفير التشخيصات من خوادم اللغة. هذا مفيد في بعض المشاريع، لكنه ليس دائما مكسبا صافيا.
قد تخرج خوادم اللغة عن المزامنة، وتستهلك ذاكرة كبيرة، وتختلف حسب الإصدار أو المشروع، وتبطئ سير عمل الوكيل. في كثير من المشاريع، يكون من الأفضل أن يشغّل الوكيل lint أو typecheck أو أدوات CLI التشخيصية الأخرى مباشرة، بحيث تعود الأخطاء إلى حلقة الوكيل دون هذه المفاضلات. وثّق هذه الأوامر في ملفات التعليمات مثل AGENTS.md أو المهارات حتى يعرف الوكيل ما يجب تشغيله. فعّل LSP عندما يستفيد مشروعك من ملاحظات إضافية من خادم اللغة.
يمكنك تفعيل خوادم LSP وتخصيصها عبر قسم lsp في إعدادات opencode.
لتفعيل جميع خوادم LSP المدمجة، اضبط lsp على true.
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}استخدم كائنا لإبقاء الخوادم المدمجة مفعلة أثناء إعداد التجاوزات أو الخوادم المخصصة.
{
"$schema": "https://opencode.ai/config.json",
"lsp": {}
}يدعم كل خادم LSP ما يلي:
| الخاصية | النوع | الوصف |
|---|---|---|
disabled | boolean | اضبطها على true لتعطيل خادم LSP |
command | string[] | الأمر المستخدم لتشغيل خادم LSP |
extensions | string[] | امتدادات الملفات التي يجب أن يعالجها خادم LSP هذا |
env | object | متغيرات البيئة التي تُضبط عند تشغيل الخادم |
initialization | object | خيارات التهيئة التي تُرسل إلى خادم LSP |
لنلق نظرة على بعض الأمثلة.
استخدم الخاصية env لضبط متغيرات البيئة عند تشغيل خادم LSP:
{
"$schema": "https://opencode.ai/config.json",
"lsp": {
"rust": {
"env": {
"RUST_LOG": "debug"
}
}
}
}استخدم الخاصية initialization لتمرير خيارات التهيئة إلى خادم LSP. هذه إعدادات خاصة بالخادم تُرسل أثناء طلب LSP initialize:
{
"$schema": "https://opencode.ai/config.json",
"lsp": {
"typescript": {
"initialization": {
"preferences": {
"importModuleSpecifierPreference": "relative"
}
}
}
}
}إذا تم حذف lsp، فستكون جميع خوادم LSP معطلة. لتعطيل جميع خوادم LSP بعد أن فعّلها إعداد آخر، اضبط lsp على false:
{
"$schema": "https://opencode.ai/config.json",
"lsp": false
}لتعطيل خادم LSP بعينه، اضبط disabled على true:
{
"$schema": "https://opencode.ai/config.json",
"lsp": {
"typescript": {
"disabled": true
}
}
}يمكنك إضافة خوادم LSP مخصصة عبر تحديد الأمر وامتدادات الملفات:
{
"$schema": "https://opencode.ai/config.json",
"lsp": {
"custom-lsp": {
"command": ["custom-lsp-server", "--stdio"],
"extensions": [".custom"]
}
}
}يوفر PHP Intelephense ميزات مدفوعة عبر مفتاح ترخيص. يمكنك تزويده بمفتاح الترخيص عبر وضع (فقط) المفتاح داخل ملف نصي في:
- على macOS/Linux:
$HOME/intelephense/license.txt - على Windows:
%USERPROFILE%/intelephense/license.txt
يجب أن يحتوي الملف على مفتاح الترخيص فقط دون أي محتوى إضافي.