LSP（#163）和文本搜索（#503）之外，是否还需要 AST 结构搜索/替换原语？

[tt-a1i]

一句话问题：在只读 LSP（#163）和 fd/rg / fuzzy / semantic（#503）之外，OpenPI 还需要 AST 结构搜索/替换原语吗？还是让模型直接 bash ast-grep 就够？

这不是 commit 计划，也不是 Adopt。倾向 Discuss。本轮未安装、未运行。不提议新安装器。Pi 继续拥有 install / update / uninstall。不新增第二条 /openpi-setup。若做成模型工具，必须写入 CHILD_EXCLUDED_TOOL_NAMES 或 CHILD_SAFE_PACKAGE_TOOL_NAMES；未分类 = fail-closed。替换类工具默认不该进 child，除非有单独的 mutation 政策。

为什么目录里这个机制看起来有趣

冻结身份（last-seen 2026-09-08）：

包	版本 / 日期	来源
code-yeongyu/pi-ast-grep	git-only；main 4a7d1be（2026-06-05）	https://github.com/code-yeongyu/pi-ast-grep · 未进 npm Gallery
@gotgenes/pi-colgrep	npm 1.5.3（2026-08-19）	已在 #503（semantic），不是 AST rewrite
@ff-labs/pi-fff	npm 0.10.6	已在 #503（fuzzy）

公开 README 声明：AST-aware search/rewrite，自称从 oh-my-openagent 移植，支持多语言。本轮未读完其 mutation 默认值，也未运行。

事实

• code-intelligence: 研究按需加载的 Pi-native LSP 能力，而不是常驻第二套 IDE Runtime #163 研究的是按需 LSP，不是结构改写。
• fd/rg 之上，是否还需要 fuzzy / semantic 搜索工具？ #503 问的是文本 / fuzzy / embedding 搜索。AST query 是第三种索引。
• OpenPI 已有 fd/rg 工具。模型今天就能调用系统里的 ast-grep。
• Gallery 不收录无 pi-package keyword 的 git-only 包；漏看它不等于它不存在。
• 对照修订：OpenPI a9b40f0。本轮未安装、未运行。

推断

更强模型更会写 ast-grep CLI；包装成工具的收益可能只是 schema 约束和输出截断。若默认打开 rewrite，就会和 #163「mutation-off」以及 #500 hashline 编辑原语抢权。

建议

先用 #313 的标准问：结构化搜索是否比 bash ast-grep 值得完整工具成本。不要为了「看起来更像 IDE」加常驻工具。不要把 git-only 包 merge 进来。

未知

• 该包 rewrite 是否默认开启、输出是否有界、与 OpenPI child 的兼容性。
• 当前 Pi / OpenPI 用户机器上 ast-grep 的实际普及率。

关联

• code-intelligence: 研究按需加载的 Pi-native LSP 能力，而不是常驻第二套 IDE Runtime #163 LSP · fd/rg 之上，是否还需要 fuzzy / semantic 搜索工具？ #503 搜索 · 编辑原语：hashline 锚点是否比 Pi 原生 edit 更值得做成 OpenPI 机制？ #500 hashline · Evidence and Evaluation：怎样证明一项 Agent 能力值得它的完整成本？ #313 证据
• 研究记录：docs/research/PI_COMMUNITY_PLUGIN_SURVEY_2026-09-08.md

[tt-a1i]

2026-09-09 源码补 #510 正文里的未知项（clone code-yeongyu/pi-ast-grep 4a7d1be，未安装、未运行）。完整对照在 docs/research/EXPERIMENT_CODE_INTEL_2026-09-09.md。不改本帖 Discuss 倾向。

与 #163 / #503 仍是不同原语。 这是 tree-sitter/ast-grep 结构匹配，不是 JSON-RPC，也不是 fd/rg/BM25。

源码已读到的默认值：

• 两个工具都 always-on：ast_grep_search、ast_grep_replace。
• replace 默认 dry-run（dryRun !== false）；schema 仍接受 dryRun: false 并 updateAll。这不是构造上的 mutation-off。
• 输出有界：500 matches / 1 MiB / timeout。
• sg 可走 GitHub zip 自动下载；只有 TLS，无 checksum。PI_OFFLINE=1 可关。/ast-grep install 会强制下载。
• 无 npm、无 pi-package keyword。senpi README 把它标成可选插件。

建议仍是：不要 merge；不要为「像 IDE」加常驻工具。若做 OpenPI 工具，只注册 search，replace 进 CHILD_EXCLUDED 或根本不注册。第一批代码智能试点仍是 #163 的 1–3 个只读 LSP 工具。