devops-analyzer 0.1.1__tar.gz → 0.1.3__tar.gz

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/MANIFEST.in

@@ -1,2 +1,3 @@
 include LICENSE README.md requirements.txt
 include devops/scan/scan.h
+include devops/tree_sitter/languages.h

{devops_analyzer-0.1.1/devops_analyzer.egg-info → devops_analyzer-0.1.3}/PKG-INFO

@@ -1,15 +1,14 @@
 Metadata-Version: 2.4
 Name: devops-analyzer
-Version: 0.1.1
+Version: 0.1.3
 Summary: 扫描源码、提取代码块、大模型分析并生成 README.md
 Author: ZHUHK
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/dadaozhichen/OpenDevOps
-Requires-Python: >=3.11
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: tree-sitter<0.22,>=0.21.0
-Requires-Dist: tree-sitter-languages>=1.10.0
 Requires-Dist: openai>=1.40.0
 Provides-Extra: zhipuai
 Requires-Dist: zhipuai>=2.0.0; extra == "zhipuai"

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/devops/analysis.py

@@ -5,22 +5,90 @@ from __future__ import annotations
 from collections import defaultdict
 from datetime import datetime, timezone
 from pathlib import Path
-from typing import Any
+from typing import Any, Optional
 
 from devops.extract import CodeBlock, extract_blocks_from_paths
 from devops.models import BaseChatModel, get_chat_model
+from devops.ui import thinking
 
 MAX_CODE_LINES = 80
 MAX_CHARS_PER_REQUEST = 24_000
 
-SYSTEM_PROMPT = """你是一名资深代码审查专家。
-请根据给出的代码块，输出简洁、结构化的中文分析，包含：
-1. 文件/模块职责概述
-2. 主要函数/类的作用
-3. 潜在问题或改进建议（如有）
-4. 关键依赖或调用关系（如能看出）
+SYSTEM_PROMPT = """你是一名资深技术文档工程师，擅长从代码和项目结构中提炼出清晰、实用的技术文档。
 
-直接输出分析正文，不要重复粘贴完整源码。"""
+## 输入说明
+- 用户提供的是 Tree-sitter 提取的代码块（函数、类、方法等），通常不是完整仓库。
+- 单块源码可能被截断（约 80 行以内），省略处会标注。
+- 可能缺少完整目录树、部署脚本或配置文件正文；不得编造，无法确认时写「需结合仓库补充」或「根据代码推断（待确认）」。
+
+## 通用输出要求
+1. 使用 Markdown，简体中文，专业、客观、条理清晰。
+2. 不要大段粘贴源码；最多引用函数/方法签名（例如 `def create_user(name: str) -> int`）。
+3. 对公共 API（对外导出的函数、类、CLI 入口）优先用表格：名称 | 参数 | 返回值 | 说明。
+4. 区分「事实」（代码中可见）与「推断」（架构意图、部署方式）。
+5. 具体章节结构以用户消息中的任务说明为准；单文件分析不写整篇项目 README，项目级总览再写完整章节。
+
+## 禁止
+- 虚构不存在的模块、环境变量、命令或依赖。"""
+
+FILE_ANALYSIS_PROMPT_PREFIX = """请分析以下源文件中的代码块，输出 Markdown（不要外层 # 标题，从 ### 小节开始）。
+
+必须包含：
+### 职责概述
+本文件在项目中的作用（1–3 句）。
+
+### 主要符号
+列出重要的类、函数、常量；对公共接口用表格（名称 | 参数 | 返回值 | 说明）。
+
+### 依赖与调用
+本文件依赖的项目内模块或第三方库（仅从代码块可见部分归纳）。
+
+### 配置与安全
+若出现配置、密钥、路径相关逻辑则简要说明；否则写「本文件未体现」。
+
+### 注意事项
+至少 1 条边界情况、潜在风险或改进点；无明显问题时写「未发现明显问题」。
+
+若本文件几乎是项目唯一核心文件，可在末尾增加 ### 项目补充，用 3–5 条要点概括安装/运行/架构（能推断则写，否则标待补充）。
+
+---
+"""
+
+OVERVIEW_PROMPT_PREFIX = """以下是多个源文件的逐项分析。请生成项目级 Markdown 总览（将写入 README 的「概览」一节）。
+
+必须按顺序包含以下章节（使用 ## 标题）：
+
+## 项目概述
+一句话定位 + 核心能力列表（3–6 条）。
+
+## 快速开始
+安装、配置、最小运行示例；信息不足时列出「待补充」项。
+
+## 架构设计
+模块划分与核心数据流（可用 Mermaid 代码块）。
+
+## 模块与文件关系
+各目录/文件如何协作；归纳即可，勿重复粘贴各文件分析全文。
+
+## 配置说明
+汇总配置项、环境变量、配置文件路径。
+
+## 依赖关系
+关键第三方库与项目内模块依赖（归纳，不罗列依赖文件全文）。
+
+## 部署与运维
+构建、启动、日志/输出要点；无法推断则标明「需补充」。
+
+## 常见问题与注意事项
+至少 2 条潜在坑点、扫描/分析范围限制或工具约束。
+
+## 架构与质量建议
+共性问题或改进建议（3–5 条，可选）。
+
+---
+逐项分析如下：
+
+"""
 
 
 def _truncate_code(code: str, max_lines: int = MAX_CODE_LINES) -> str:
@@ -44,16 +112,17 @@ def _format_blocks_for_prompt(blocks: list[CodeBlock]) -> str:
 
 
 def _chat(model: BaseChatModel, prompt: str) -> str:
-    return model.chat(SYSTEM_PROMPT, prompt, temperature=0.2)
+    with thinking():
+        return model.chat(SYSTEM_PROMPT, prompt, temperature=0.2)
 
 
 def analyze_blocks(
     blocks: list[CodeBlock],
     *,
-    provider: str | None = None,
-    api_key: str | None = None,
-    model_name: str | None = None,
-    base_url: str | None = None,
+    provider: Optional[str] = None,
+    api_key: Optional[str] = None,
+    model_name: Optional[str] = None,
+    base_url: Optional[str] = None,
 ) -> dict[str, Any]:
     """按文件分批调用大模型，并生成总览。"""
     chat_model = get_chat_model(
@@ -83,6 +152,7 @@ def analyze_blocks(
             body = body[:MAX_CHARS_PER_REQUEST] + "\n\n...(内容过长已截断)"
 
         prompt = (
+            f"{FILE_ANALYSIS_PROMPT_PREFIX}"
             f"文件路径: {file_path}\n"
             f"语言: {file_blocks[0].language}\n"
             f"代码块数量: {len(file_blocks)}\n\n"
@@ -98,13 +168,7 @@ def analyze_blocks(
         )
         file_summaries.append(f"【{file_path}】\n{analysis}")
 
-    overview_prompt = (
-        "以下是多个源文件的逐项分析，请生成一份项目级总览（中文）：\n"
-        "1. 项目整体结构\n"
-        "2. 各文件之间的关系\n"
-        "3. 共性问题或架构建议\n\n"
-        + "\n\n---\n\n".join(file_summaries)
-    )
+    overview_prompt = OVERVIEW_PROMPT_PREFIX + "\n\n---\n\n".join(file_summaries)
     if len(overview_prompt) > MAX_CHARS_PER_REQUEST:
         overview_prompt = overview_prompt[:MAX_CHARS_PER_REQUEST] + "\n...(已截断)"
 
@@ -127,10 +191,10 @@ def analyze_blocks(
 def analyze_files(
     paths: list[str],
     *,
-    provider: str | None = None,
-    api_key: str | None = None,
-    model_name: str | None = None,
-    base_url: str | None = None,
+    provider: Optional[str] = None,
+    api_key: Optional[str] = None,
+    model_name: Optional[str] = None,
+    base_url: Optional[str] = None,
 ) -> dict[str, Any]:
     """从文件路径列表提取代码块并分析。"""
     blocks = extract_blocks_from_paths(paths)
@@ -146,10 +210,10 @@ def analyze_files(
 def analyze_folder(
     folder: str,
     *,
-    provider: str | None = None,
-    api_key: str | None = None,
-    model_name: str | None = None,
-    base_url: str | None = None,
+    provider: Optional[str] = None,
+    api_key: Optional[str] = None,
+    model_name: Optional[str] = None,
+    base_url: Optional[str] = None,
 ) -> dict[str, Any]:
     """扫描目录、提取代码块并分析。"""
     from devops.scan import scan_code_files

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/devops/cli.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import argparse
 import sys
 from pathlib import Path
+from typing import Optional
 
 from devops import __version__
 from devops.analysis import analyze_folder, write_project_readme
@@ -159,7 +160,7 @@ def _run_analyze(args: argparse.Namespace) -> int:
         return 1
 
 
-def main(argv: list[str] | None = None) -> int:
+def main(argv: Optional[list[str]] = None) -> int:
     argv = list(argv) if argv is not None else sys.argv[1:]
 
     # devops /path/to/project -> 自动当作 analyze

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/devops/config_cmd.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import getpass
 import sys
+from typing import Optional
 
 from devops.config import (
     CONFIG_FILE,
@@ -81,7 +82,7 @@ def run_config_interactive() -> int:
     return 0
 
 
-def run_config(argv: list[str] | None = None) -> int:
+def run_config(argv: Optional[list[str]] = None) -> int:
     args = argv or []
     if "--show" in args or "-s" in args:
         return run_config_show()

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/devops/extract.py

@@ -4,10 +4,11 @@ from __future__ import annotations
 
 from dataclasses import asdict, dataclass
 from pathlib import Path
-from typing import Iterator, Optional
+from typing import Iterator, Optional, Union
 
 from tree_sitter import Node, Tree
-from tree_sitter_languages import get_parser
+
+from devops.tree_sitter import get_parser
 
 from devops.scan import scan_code_files
 
@@ -34,7 +35,6 @@ EXT_TO_LANGUAGE: dict[str, str] = {
     ".rb": "ruby",
     ".php": "php",
     ".cs": "c_sharp",
-    ".swift": "swift",
     ".kt": "kotlin",
     ".scala": "scala",
     ".sh": "bash",
@@ -64,12 +64,8 @@ LANGUAGE_NODE_TYPES: dict[str, tuple[str, ...]] = {
     "kotlin": ("function_declaration", "class_declaration"),
     "scala": ("function_definition", "class_definition", "object_definition"),
     "bash": ("function_definition",),
-    "swift": ("function_declaration", "class_declaration", "struct_declaration"),
 }
 
-_parser_cache: dict[str, object] = {}
-
-
 @dataclass
 class CodeBlock:
     file_path: str
@@ -84,16 +80,10 @@ class CodeBlock:
         return asdict(self)
 
 
-def language_for_path(path: str | Path) -> Optional[str]:
+def language_for_path(path: Union[str, Path]) -> Optional[str]:
     return EXT_TO_LANGUAGE.get(Path(path).suffix.lower())
 
 
-def _get_parser(language: str):
-    if language not in _parser_cache:
-        _parser_cache[language] = get_parser(language)
-    return _parser_cache[language]
-
-
 def _read_source(path: Path) -> Optional[bytes]:
     try:
         return path.read_bytes()
@@ -186,7 +176,7 @@ def _extract_from_tree(
     return blocks
 
 
-def extract_blocks_from_file(path: str | Path) -> list[CodeBlock]:
+def extract_blocks_from_file(path: Union[str, Path]) -> list[CodeBlock]:
     p = Path(path)
     language = language_for_path(p)
     if language is None:
@@ -197,7 +187,7 @@ def extract_blocks_from_file(path: str | Path) -> list[CodeBlock]:
         return []
 
     try:
-        tree = _get_parser(language).parse(source)
+        tree = get_parser(language).parse(source)
     except Exception:
         return []
 

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/devops/models/__init__.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from typing import Optional
+
 from devops.config import ModelConfig, list_providers
 from devops.models.base import BaseChatModel
 from devops.models.openai import OpenAIChatModel
@@ -24,10 +26,10 @@ def create_chat_model(config: ModelConfig) -> BaseChatModel:
 
 def get_chat_model(
   *,
-  provider: str | None = None,
-  api_key: str | None = None,
-  model: str | None = None,
-  base_url: str | None = None,
+  provider: Optional[str] = None,
+  api_key: Optional[str] = None,
+  model: Optional[str] = None,
+  base_url: Optional[str] = None,
 ) -> BaseChatModel:
   from devops.config import load_config
 

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/devops/scan/scan.cpp

@@ -63,7 +63,7 @@ bool isCodeFile(const fs::path& path) {
         ".c", ".cc", ".cpp", ".cxx", ".h", ".hpp",
         ".py", ".js", ".ts", ".tsx", ".jsx",
         ".java", ".go", ".rs", ".rb", ".php",
-        ".cs", ".swift", ".m", ".mm",
+        ".cs", ".m", ".mm",
         ".sh", ".sql", ".html", ".css",
         ".vue", ".kt", ".scala",
     };

devops_analyzer-0.1.3/devops/tree_sitter/__init__.py

@@ -0,0 +1,22 @@
+
+
+from __future__ import annotations
+
+try:
+    from devops.tree_sitter.tree_sitter_native import get_parser as _native_get_parser
+except ImportError as exc:
+    raise ImportError(
+        "devops.tree_sitter 原生扩展未安装。请先执行 "
+        "bash scripts/vendor_tree_sitter.sh,再运行 pip install -e ."
+    ) from exc
+
+_parser_cache: dict[str, object] = {}
+
+
+def get_parser(language: str):
+    if language not in _parser_cache:
+        _parser_cache[language] = _native_get_parser(language)
+    return _parser_cache[language]
+
+
+__all__ = ["get_parser"]

devops_analyzer-0.1.3/devops/tree_sitter/build_sources.py

@@ -0,0 +1,84 @@
+
+from __future__ import annotations
+
+from pathlib import Path
+
+# 与 setup.py 同级的项目根目录；setuptools 要求源路径为相对路径
+PROJECT_ROOT = Path(__file__).resolve().parent.parent.parent
+VENDOR_ROOT = Path(__file__).resolve().parent / "vendor"
+TREE_SITTER_CORE = VENDOR_ROOT / "tree-sitter"
+
+
+def _rel(path: Path) -> str:
+    return path.relative_to(PROJECT_ROOT).as_posix()
+
+GRAMMAR_DIRS = (
+    "tree-sitter-bash",
+    "tree-sitter-c",
+    "tree-sitter-c-sharp",
+    "tree-sitter-cpp",
+    "tree-sitter-go",
+    "tree-sitter-java",
+    "tree-sitter-javascript",
+    "tree-sitter-kotlin",
+    "tree-sitter-php",
+    "tree-sitter-python",
+    "tree-sitter-ruby",
+    "tree-sitter-rust",
+    "tree-sitter-scala",
+    "tree-sitter-typescript",
+)
+
+# 部分 grammar 仓库将 src 放在子目录（如新版 php/typescript）
+GRAMMAR_SRC_SUBDIRS: dict[str, tuple[str, ...]] = {
+    "tree-sitter-php": ("php/src", "src"),
+    "tree-sitter-typescript": ("typescript/src", "src"),
+}
+
+
+def _grammar_src_dirs(grammar: str) -> tuple[Path, ...]:
+    root = VENDOR_ROOT / grammar
+    subdirs = GRAMMAR_SRC_SUBDIRS.get(grammar, ("src",))
+    return tuple(root / sub for sub in subdirs)
+
+
+def vendor_ready() -> bool:
+    return (TREE_SITTER_CORE / "lib" / "include" / "tree_sitter" / "api.h").is_file()
+
+
+def collect_sources() -> tuple[list[str], list[str]]:
+    if not vendor_ready():
+        raise FileNotFoundError(
+            "tree-sitter vendor 未就绪。请先运行: bash scripts/vendor_tree_sitter.sh"
+        )
+
+    sources: list[str] = []
+    include_dirs: list[str] = [_rel(TREE_SITTER_CORE / "lib" / "include")]
+
+    def add_include(path: Path) -> None:
+        s = _rel(path)
+        if s not in include_dirs:
+            include_dirs.append(s)
+
+    for grammar in GRAMMAR_DIRS:
+        parser_c = None
+        src_dir = None
+        for candidate in _grammar_src_dirs(grammar):
+            path = candidate / "parser.c"
+            if path.is_file():
+                parser_c = path
+                src_dir = candidate
+                break
+        if parser_c is None:
+            raise FileNotFoundError(
+                f"缺少 grammar 源文件 parser.c,已检查: {_grammar_src_dirs(grammar)}"
+            )
+        sources.append(_rel(parser_c))
+        if (src_dir / "tree_sitter").is_dir():
+            add_include(src_dir)
+        for scanner_name in ("scanner.c", "scanner.cc"):
+            scanner = src_dir / scanner_name
+            if scanner.is_file():
+                sources.append(_rel(scanner))
+
+    return sources, include_dirs

devops_analyzer-0.1.3/devops/tree_sitter/languages.h

@@ -0,0 +1,30 @@
+#pragma once
+
+#include <string>
+
+#include "tree_sitter/api.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+TSLanguage* tree_sitter_bash(void);
+TSLanguage* tree_sitter_c(void);
+TSLanguage* tree_sitter_c_sharp(void);
+TSLanguage* tree_sitter_cpp(void);
+TSLanguage* tree_sitter_go(void);
+TSLanguage* tree_sitter_java(void);
+TSLanguage* tree_sitter_javascript(void);
+TSLanguage* tree_sitter_kotlin(void);
+TSLanguage* tree_sitter_php(void);
+TSLanguage* tree_sitter_python(void);
+TSLanguage* tree_sitter_ruby(void);
+TSLanguage* tree_sitter_rust(void);
+TSLanguage* tree_sitter_scala(void);
+TSLanguage* tree_sitter_typescript(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+const TSLanguage* languageForName(const std::string& language);

devops_analyzer-0.1.3/devops/ui.py

@@ -0,0 +1,41 @@
+"""终端 UI 辅助（等待动画等）。"""
+
+from __future__ import annotations
+
+import sys
+import threading
+from contextlib import contextmanager
+from typing import Iterator
+
+_SPINNER = ("⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏")
+
+
+@contextmanager
+def thinking(message: str = "thinking") -> Iterator[None]:
+    """在阻塞操作期间于 stderr 显示转圈与文案。"""
+    if not sys.stderr.isatty():
+        print(f"{message}...", file=sys.stderr, flush=True)
+        yield
+        return
+
+    stop = threading.Event()
+    prefix = f"{message} "
+
+    def _spin() -> None:
+        i = 0
+        while not stop.wait(0.08):
+            frame = _SPINNER[i % len(_SPINNER)]
+            sys.stderr.write(f"\r{frame} {prefix}")
+            sys.stderr.flush()
+            i += 1
+
+    thread = threading.Thread(target=_spin, daemon=True)
+    thread.start()
+    try:
+        yield
+    finally:
+        stop.set()
+        thread.join(timeout=0.5)
+        clear = "\r" + " " * (len(prefix) + 2) + "\r"
+        sys.stderr.write(clear)
+        sys.stderr.flush()

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3/devops_analyzer.egg-info}/PKG-INFO

@@ -1,15 +1,14 @@
 Metadata-Version: 2.4
 Name: devops-analyzer
-Version: 0.1.1
+Version: 0.1.3
 Summary: 扫描源码、提取代码块、大模型分析并生成 README.md
 Author: ZHUHK
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/dadaozhichen/OpenDevOps
-Requires-Python: >=3.11
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: tree-sitter<0.22,>=0.21.0
-Requires-Dist: tree-sitter-languages>=1.10.0
 Requires-Dist: openai>=1.40.0
 Provides-Extra: zhipuai
 Requires-Dist: zhipuai>=2.0.0; extra == "zhipuai"

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/devops_analyzer.egg-info/SOURCES.txt

@@ -11,6 +11,7 @@ devops/cli.py
 devops/config.py
 devops/config_cmd.py
 devops/extract.py
+devops/ui.py
 devops/models/__init__.py
 devops/models/base.py
 devops/models/openai.py
@@ -19,6 +20,9 @@ devops/scan/__init__.py
 devops/scan/scan.cpp
 devops/scan/scan.h
 devops/scan/scan_bindings.cpp
+devops/tree_sitter/__init__.py
+devops/tree_sitter/build_sources.py
+devops/tree_sitter/languages.h
 devops_analyzer.egg-info/PKG-INFO
 devops_analyzer.egg-info/SOURCES.txt
 devops_analyzer.egg-info/dependency_links.txt

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/devops_analyzer.egg-info/requires.txt

@@ -1,5 +1,4 @@
 tree-sitter<0.22,>=0.21.0
-tree-sitter-languages>=1.10.0
 openai>=1.40.0
 
 [all]

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/pyproject.toml

@@ -4,16 +4,15 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devops-analyzer"
-version = "0.1.1"
+version = "0.1.3"
 description = "扫描源码、提取代码块、大模型分析并生成 README.md"
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.9"
 license = "MIT"
 authors = [{ name = "ZHUHK" }]
 dependencies = [
-    # tree-sitter-languages 尚未适配 py-tree-sitter 0.22+ 的 Language API，见 grantjenks/py-tree-sitter-languages#77
+    # tree-sitter-languages 尚未适配 py-tree-sitter 0.22+；grammar 由 devops.tree_sitter 原生扩展提供
     "tree-sitter>=0.21.0,<0.22",
-    "tree-sitter-languages>=1.10.0",
     "openai>=1.40.0",
 ]
 

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/requirements.txt

@@ -1,5 +1,4 @@
 # 推荐使用: pip install -e .
 tree-sitter>=0.21.0,<0.22
-tree-sitter-languages>=1.10.0
 openai>=1.40.0
 pybind11>=2.11

{devops_analyzer-0.1.1 → devops_analyzer-0.1.3}/setup.py

@@ -1,10 +1,22 @@
+import importlib.util
 import shutil
 import subprocess
 import sys
+from pathlib import Path
 
 from setuptools import setup
 from pybind11.setup_helpers import Pybind11Extension, build_ext
 
+_spec = importlib.util.spec_from_file_location(
+    "tree_sitter_build_sources",
+    Path(__file__).parent / "devops/tree_sitter/build_sources.py",
+)
+_ts_build = importlib.util.module_from_spec(_spec)
+assert _spec.loader is not None
+_spec.loader.exec_module(_ts_build)
+collect_sources = _ts_build.collect_sources
+vendor_ready = _ts_build.vendor_ready
+
 
 def platform_compile_args():
     compile_args = []
@@ -42,6 +54,32 @@ ext_modules = [
     ),
 ]
 
+if vendor_ready():
+    _ts_sources, _ts_include_dirs = collect_sources()
+    _ts_compile = list(_compile_args)
+    if sys.platform != "win32":
+        _ts_compile.append("-fvisibility=hidden")
+    ext_modules.append(
+        Pybind11Extension(
+            "devops.tree_sitter.tree_sitter_native",
+            [
+                "devops/tree_sitter/tree_sitter_bindings.cpp",
+                "devops/tree_sitter/languages.cpp",
+                *_ts_sources,
+            ],
+            include_dirs=_ts_include_dirs,
+            cxx_std=17,
+            extra_compile_args=_ts_compile,
+            extra_link_args=_link_args,
+        )
+    )
+else:
+    print(
+        "warning: tree-sitter vendor 缺失，跳过 devops.tree_sitter 扩展。"
+        "运行 bash scripts/vendor_tree_sitter.sh 后重新 pip install -e .",
+        file=sys.stderr,
+    )
+
 setup(
     cmdclass={"build_ext": build_ext},
     ext_modules=ext_modules,