Máy chủ LSP Intlayer

Máy chủ ngôn ngữ Intlayer là một hiện thực của Language Server Protocol (LSP) giúp IDE — và tác nhân AI — của bạn hiểu Intlayer. Nó kết nối một lệnh gọi như useIntlayer("home") với tệp .content.ts khai báo nó, theo cả hai chiều.

Tính năng

Có hai hành vi bổ sung đáng lưu ý:

• Từ điển được hợp nhất — một khóa trải trên nhiều tệp nội dung sẽ trả về một kết quả cho mỗi tệp, nhờ đó bạn có thể tới từng khai báo.
• Hỗ trợ monorepo — máy chủ phân giải tệp intlayer.config.* gần nhất với mỗi tệp, nhờ đó nhiều dự án trong cùng một workspace đều có từ điển riêng.

Các lệnh gọi được hỗ trợ

Khóa được đọc từ một đối số chuỗi theo vị trí, hoặc từ một đối tượng tùy chọn ({ namespace }, { id }).

Điều này áp dụng cho mọi gói *-intlayer (next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer, solid-intlayer, preact-intlayer, angular-intlayer, lit-intlayer, express-intlayer, hono-intlayer, fastify-intlayer, intlayer), cũng như cho các gói adapter compat cho phép bạn giữ nguyên cú pháp i18n hiện có.

Từ điển được đọc từ kết quả build, vì vậy hãy chạy npx intlayer build — hoặc giữ máy chủ phát triển đang chạy — để máy chủ có dữ liệu mà phân giải.

Cài đặt

Máy chủ được phát hành dưới dạng tệp nhị phân intlayer-lsp trong @intlayer/lsp:

npm install --save-dev @intlayer/lsp

Hãy cài đặt toàn cục (npm install -g @intlayer/lsp) nếu trình soạn thảo của bạn cần intlayer-lsp nằm trong PATH — đây là trường hợp của plugin Claude Code và của mọi cấu hình bên dưới gọi trực tiếp tệp nhị phân.

Thiết lập

npm install -g @intlayer/lsp

claude plugin marketplace add intlayer@github:aymericzip/intlayer
claude plugin install intlayer-lsp@intlayer

{
  "env": {
    "ENABLE_LSP_TOOL": "1"
  }
}

{
  "lsp": {
    "intlayer-lsp": {
      "binary": {
        "path": "npx",
        "arguments": ["--yes", "@intlayer/lsp"]
      }
    }
  },
  "languages": {
    "TypeScript": { "language_servers": ["intlayer-lsp", "..."] },
    "TSX": { "language_servers": ["intlayer-lsp", "..."] },
    "JavaScript": { "language_servers": ["intlayer-lsp", "..."] },
    "Vue.js": { "language_servers": ["intlayer-lsp", "..."] },
    "Svelte": { "language_servers": ["intlayer-lsp", "..."] }
  }
}

local lspconfig = require('lspconfig')
local configs = require('lspconfig.configs')

if not configs.intlayer_lsp then
  configs.intlayer_lsp = {
    default_config = {
      -- Khởi chạy máy chủ bằng npx để không cần cài đặt toàn cục
      cmd = { 'npx', '--yes', '@intlayer/lsp' },
      filetypes = {
        'typescript',
        'typescriptreact',
        'javascript',
        'javascriptreact',
        'vue',
        'svelte',
      },
      root_dir = lspconfig.util.root_pattern(
        'intlayer.config.ts',
        'intlayer.config.js',
        'package.json'
      ),
    },
  }
end

lspconfig.intlayer_lsp.setup({})

{
  "languageserver": {
    "intlayer": {
      "command": "npx",
      "args": ["@intlayer/lsp"],
      "filetypes": [
        "typescript",
        "typescriptreact",
        "javascript",
        "javascriptreact",
        "vue",
        "svelte"
      ],
      "rootPatterns": [
        "intlayer.config.ts",
        "intlayer.config.js",
        "package.json"
      ]
    }
  }
}

[language-server.intlayer-lsp]
command = "npx"
args = ["@intlayer/lsp"]

[[language]]
name = "typescript"
language-servers = ["intlayer-lsp", "typescript-language-server"]

[[language]]
name = "tsx"
language-servers = ["intlayer-lsp", "typescript-language-server"]

Ghi chú về tác nhân AI trên terminal

Claude Code hoạt động như một client LSP thực thụ — xem tab ở trên.

OpenAI Codex và phần lớn công cụ terminal khác không phải là client LSP: chúng đọc và ghi tệp trực tiếp. Chạy riêng máy chủ không giúp ích cho chúng; giá trị đến từ việc máy chủ đang hoạt động trong một trình soạn thảo đi kèm mà tác nhân có thể truy vấn chỉ mục (Cursor Composer, Windsurf Cascade, Copilot Chat).

Cách hoạt động

Với mỗi tệp, máy chủ tìm tệp intlayer.config.* gần nhất và nạp cấu hình của dự án đó để tìm các từ điển đã biên dịch. Cấu hình, từ điển và danh sách tệp nguồn được lưu vào bộ nhớ đệm với TTL ngắn, và bị vô hiệu mỗi khi một tệp nội dung đang được theo dõi thay đổi.

Khi có yêu cầu, máy chủ phân tích tài liệu (qua oxc) và xem xét vị trí con trỏ:

1. Trên một chuỗi khóa (useIntlayer("home")) → trả về mọi tệp nội dung khai báo khóa đó, đặt con trỏ tại dòng key: của nó.
2. Trên một chỗ dùng trường (content.title, một thuộc tính được phá cấu trúc, t('path.to.field'), <Trans>, …) → truy ngược biến về từ điển của nó và trả về trường tương ứng bên trong các tệp nội dung.
3. Từ một tệp nội dung → chạy tra cứu ngược, quét mã nguồn dự án để tìm các vị trí gọi khóa hoặc trường đó.

Khắc phục sự cố

Trong VS Code, máy chủ ghi log vào Xem → Output → “Intlayer LSP” — hữu ích để xác nhận cấu hình nào đã được phân giải và tìm thấy bao nhiêu từ điển.