kunhuang12345 avatar

pyright-lsp-tool

On-demand Pyright LSP query tool (references) without running a full editor LSP.

提供方 kunhuang12345|开源

pyright-lsp-tool

一个“可自由启停”的 Pyright LSP 小工具：需要查语义级引用时临时启动 pyright-langserver（或保持一段时间常驻），查询完成后退出即可。

本 skill 独立于其它 skill，不读取/依赖 ai-team-workflow 或其它配置文件；其它 skill 也不应引用它。

依赖

  • pyright（提供 pyright-langserver）
    • 推荐装到你的项目 venv：pip install pyright
  • node（pyright 运行时需要）

用法

进入目标仓库根目录后运行（默认会用 git rev-parse --show-toplevel 作为 project root）：

  • 交互模式（推荐：一次启动，多次查询；退出即停）

    • python3 .codex/skills/pyright-lsp-tool/scripts/pyright_lsp_tool.py repl
    • 在交互提示符里：
      • refs src/pages/common/login_page.py:62:9
    • 退出：exit

  • 单次查询（每次都会启动一次 server，冷启动会慢一些）

    • python3 .codex/skills/pyright-lsp-tool/scripts/pyright_lsp_tool.py refs src/pages/common/login_page.py:62:9

可选参数：

  • --root <path>：指定 project root（默认：git toplevel 或 cwd）
  • --venv <venv_dir>：指定 venv（用于定位 pyright-langserver）
下载 Skill