用途:为 TypeScript/JavaScript 代码库提供语言服务器协议(LSP)集成,用于探索和理解代码。处理 .ts、.tsx、.js、.jsx 文件时,官方建议优先使用 LSP 工具而非 Grep/Glob,因为 LSP 能理解导入、导出与符号关系,结果具备类型感知。
主要能力:lsp-find 搜索 TypeScript 符号;lsp-hover 获取类型信息与 TSDoc 文档;lsp-refs 查找符号的所有引用;lsp-symbols 列出文件内全部符号;lsp-analyze 在单次会话中批量执行分析,可选 --symbols/-s、--exports/-e、--hover line:char、--refs line:char、--all。适用于探索代码库、编辑前核查用法、写代码前确认 API 签名。
使用方式:脚本通过 bunx @plaited/development-skills 调用,如 bunx @plaited/development-skills lsp-hover <file> <line> <char>、bunx @plaited/development-skills lsp-symbols <file>、bunx @plaited/development-skills lsp-refs <file> <line> <char>、bunx @plaited/development-skills lsp-find <query> [context-file]、bunx @plaited/development-skills lsp-analyze <file> [options]。行号与字符位置均为 0 起始。路径支持绝对路径、相对路径以及经 Bun.resolve() 解析的包导出路径,包导出路径推荐用于可移植性。所有脚本以 JSON 输出到 stdout,错误输出到 stderr。
限制:每次脚本调用都会启动 TypeScript 语言服务器(约 300-500ms)、初始化连接、打开文档、执行查询后关闭;同一文件多次查询应改用 lsp-analyze 批量处理。文本、注释或非 TS 文件搜索仍应使用 Grep,按模式找文件仍应使用 Glob。未提供其他收费、平台或效果信息。