DSH Plugin HubDSH 插件市场

Jaylor-Wang/dsh-tool-ast-grep

Plugin插件 Native原生 ⭐ 2 MIT Sessions & Context会话与上下文

AST-based structural code search and syntax outline tool for DeepSeek Harness powered by ast-grep

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-tool-ast-grep is an AST-based structural code search and outline plugin built specifically for DeepSeek Harness (DSH), wrapping the ast-grep CLI as its core engine. The plugin exposes two tool functions that coding agents can call directly. The first, ast_search, performs structural matching using AST patterns with meta-variables such as $NAME and $$$, or by node kind like function_declaration, interface_declaration, and class_declaration, supporting smart, relaxed, ast, and cst strictness modes plus glob filtering. The second, ast_outline, produces an ultra-compact outline of functions, classes, types, interfaces, and exports from a single source file, reducing token consumption by roughly 80% to 95% compared with reading the entire file, and accepts a depth parameter to toggle top-level-only versus nested class methods.

Installation is documented in two ways. The recommended path runs dsh plugin --profile web add dsh-tool-ast-grep in a terminal, after which the plugin becomes searchable under Settings → Plugin Market and can be installed with one click. The alternative path mounts the plugin inside an agent preset by editing ~/.dsh/.agent-presets/<your-agent>/agent.cordis.yml and listing it under tools with a tool-ast-grep id, a dsh-tool-ast-grep name, and configuration entries such as maxResults: 50 and timeoutMs: 60000. The tool then streams results back through a child-process JSON channel, sidestepping Windows shell quoting pitfalls that often break naive CLI wrappers.

A hard prerequisite is that the ast-grep binary must already exist on the host PATH, installable via npm install -g @ast-grep/cli, pip install ast-grep-cli, cargo install ast-grep --locked, or brew install ast-grep, with ast-grep --version used to verify. Supported languages include TypeScript, JavaScript, Python, Rust, Go, Java, C, and C++. The project is released under the MIT license by Jaylor Wang; with only two GitHub stars at the time of writing, prospective users should weigh the limited community footprint against the operational benefits before adopting it in production pipelines.

dsh-tool-ast-grep 是面向 DeepSeek Harness（DSH）的 AST 结构化代码搜索与大纲插件，基于 ast-grep CLI 实现。它为编码代理提供 ast_search 与 ast_outline 两个工具：前者用 AST 模式（function $NAME($$$) { $$$ }）和节点类型匹配跨行结构，覆盖 TypeScript、JavaScript、Python、Rust、Go、Java、C、C++ 等语言；后者提取函数、类、类型、接口、导出的紧凑大纲，相对整文件读取节省 80%–95% token。工具通过子进程 JSON 流式调用，规避 Windows Shell 引号转义问题。

插件可通过两种方式集成：在 DSH 终端运行 dsh plugin --profile web add dsh-tool-ast-grep 经 Plugin Market 安装，或挂载到 ~/.dsh/.agent-presets/<agent>/agent.cordis.yml 中以 cordis tool 形式声明 maxResults 与 timeoutMs 等 config。它适合需要在大仓库中高效定位函数、类、接口结构或快速预览源码骨架的代理开发者，可在不加载完整文件的情况下完成检索与结构梳理。

使用前需全局安装 ast-grep CLI（npm i -g @ast-grep/cli、pip install ast-grep-cli、cargo install ast-grep --locked 或 brew install ast-grep），并通过 ast-grep --version 验证。默认 maxResults=50、depth=1，调用须走 child_process JSON 流。仓库以 MIT 协议发布，作者 Jaylor Wang。需注意当前 stars 仅 2，功能成熟度需自行评估。

View on GitHub在 GitHub 查看

Recommended强烈推荐 Send to your DSH发给你的 DSH 安装 
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-tool-ast-grep（Jaylor-Wang/dsh-tool-ast-grep）
仓库：https://github.com/Jaylor-Wang/dsh-tool-ast-grep
本站详情页：https://www.yhbd.top/plugins/jaylor-wang-dsh-tool-ast-grep/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 2 · 最近提交 2026-09-18 · 主语言 JavaScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2，几乎没人在用，遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装 

dsh plugin --profile web add dsh-tool-ast-grep

把 Jaylor-Wang/dsh-tool-ast-grep 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.8 KB · 缓存于 2026-10-03 22:12:39 · 3.8 KB

dsh-tool-ast-grep

English | 中文

npm version license GitHub release

AST-based structural code search and outline plugin for DeepSeek Harness (DSH), powered by ast-grep.

Provides structural code searching and outline inspection capabilities for coding agents, dramatically outperforming traditional regular expression search (grep) in token efficiency and semantic accuracy.

Features

  • ast_search: Search code structures using AST patterns and meta-variables ($NAME, $$$).
    • Finds structural patterns across multiple lines regardless of formatting or whitespace.
    • Supports node kind queries (e.g. function_declaration, interface_declaration, class_declaration).
    • Supports strictness modes (smart, relaxed, ast, cst).
    • Supports file path and glob filtering.
  • ast_outline: Extract an ultra-compact structural outline (functions, classes, types, interfaces, exports) from a source file.
    • Saves 80%–95% tokens compared to reading the entire file.
    • Supports depth control (top-level vs. nested methods).
  • Zero Shell Quoting Issues: Invoked safely via child processes with JSON streaming — immune to Windows shell argument escaping and quoting pitfalls.

Prerequisites

This plugin requires ast-grep CLI installed on your machine:

  • npm:
    npm install -g @ast-grep/cli
  • pip:
    pip install ast-grep-cli
  • cargo:
    cargo install ast-grep --locked
  • brew (macOS/Linux):
    brew install ast-grep

Verify with:

ast-grep --version

Tip for custom installations: If ast-grep is installed in a non-standard location or custom npm prefix, the plugin will automatically probe directories in your PATH. You can also set the AST_GREP_PATH environment variable to its full path directly.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 Jaylor-Wang/dsh-tool-ast-grep 的 README.md。 在 GitHub 查看原文 →

Related相关推荐

← 上一个 Prev dsh-plugin-maker 下一个 Next dsh-oauth →