SuperAPI AI 工具集

platform-lsp-integrate

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:这是一个文档/参考类技能,不编写或部署代码,用于说明如何正确使用 Salesforce LSP。salesforce-development 插件托管本地 MCP 服务器 salesforce-lsp,按需启动 Salesforce 语言服务器子进程,并将其语义能力暴露为 MCP 工具。本构建仅内置 Apex 与 SOQL;LWC 语言服务器未打包,lwc.* 工具始终返回不可用。

主要能力:Apex 工具(apex.diagnostics 编译检查 .cls/.trigger、apex.hover、apex.documentSymbol、apex.completion)会启动 Apex LSP,首次调用有数秒冷启动。SOQL 工具:validate_soql 解析语法错误;complete_soql 基于组织架构做模式感知补全;extract_soql_from_apex 纯静态提取内联查询;check_soql_selectivity 选择性启发式(默认不启动);refresh_org_schema 使缓存的 describe 失效,用于部署后架构滞后;lsp.health 只读查看状态,从不启动子进程。坐标均为 1 基。

调用/回退契约:优先用 LSP 工具而非猜测;任何错误信封都视为“不可用”而非“通过”;应降级而非失败,记录 tool=unavailable: code 并走回退路径。若宿主缺失,工具不注册,回退方式包括:apex.diagnostics 用 sf project deploy 读 CLI 错误;validate_soql 用 sf data query --json 只读冒烟;complete_soql 用 sf sobject describe --sobject <O> --json;extract_soql_from_apex 手工查找。

错误码:lsp_disabled、spawn_timeout、circuit_open 为瞬态/配置状态;no_apex_workspace、no_org_connected 为特定上下文下正常状态。调试可用 lsp.health、bin/lsp-doctor(支持 --json、--no-spawn)及 SFDX_LSP_DEBUG=1。kill switch 变量 SFDX_LSP 取值:unset/all(默认)、apex-only、disabled。PreToolUse 钩子 bin/lsp-precheck 在部署前运行 Apex 诊断,fail-open,由 SFDX_LSP_DEPLOY_GATE(off|warn|block,默认 warn)控制。

适用场景:询问如何使用 LSP、有哪些工具、某工具含义或如何读输出、遇错误码如何恢复、审查调用 LSP 的技能、调试 LSP。限制:本构建无 LWC;不编写部署代码;缺失事实暂未提供。