面向编程 Agent 的本地代码知识图谱:提供 10 个 MCP 工具,覆盖分层上下文压缩、DAG 规划、增量 AST 建图、跨会话技能飞轮、诊断与图谱产物导入导出。
安装
# npm 包(预构建)
dsh plugin --profile web add @roarpeng/graphflow
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Roarpeng/GraphFlow
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 简体中文
面向编码 agent 的省 Token 外科手术引擎。 当前 package 版本为 v3.9.2;此工作区包含 v4 本地安全与证据升级。仍只提供四个确定性 MCP 工具。
四个外科手术工具
| 工具 | 能力 |
|---|---|
gf_read |
精确切片符号(file.ts#fn),自动跨文件类型闭合 + 爆炸半径调用点;中英双语关键词检索(q: "启动 / launch");AST 骨架折叠(−93% token)。 |
gf_edit |
符号/行级编辑与跨仓重命名;写前契约检查、可选 prepare/commit、SHA 冲突检测及多文件恢复日志。 |
gf_exec |
affected-tests 最多六跳反向导入路由;结构化验证状态、失败指纹与重复失败停止。run:true 执行,否则预览。 |
gf_macro |
本地习惯宏与可验证配方。有副作用的宏需 propose → approve → activate;命令参数以 argv 执行,codemod 走编辑事务。 |
Prompt Reflex
输入命中命令宏时,未获授权的宏只会给出提示。命令和写文件宏不会被 prompt hook 默认自动执行。总闸:GRAPHFLOW_PROMPT_REFLEX=0。
- 第一档 —— 提示词钩子(自动注册):ZCode、Claude Code、Codex CLI、Gemini CLI、Cursor、Windsurf、Trae、Qoder、Kimi Code、Continue CLI。
- 第二档 —— 注入/改写:OpenCode、Kilo Code、Cline(Unix)、DeepSeek Harness。
- 第三档 —— 回退(
gf_macroMCP):VS Code Copilot、Zed、Claude Desktop、PearAI、Antigravity、Roo Code(已归档)。
逐宿主配置与安全说明:docs/prompt-reflex.md。
快速开始
npm install -g @roarpeng/graphflow # Node 18+
graphflow install # 一键注册 MCP + Skill + Rules + Hooks 到检测到的 agent
graphflow status # 各 agent 注册状态
graphflow-mcp # stdio MCP 服务器
仅装技能:npx skills add Roarpeng/GraphFlow。读 mcpServers JSON 的宿主手动注册:{ "mcpServers": { "graphflow": { "command": "graphflow-mcp" } } }。
支持语言
| 语言 | 后端 |
|---|---|
| TypeScript / JavaScript | 真 AST(@babel/parser) |
| Python / Go / Rust / C / C++ / C# | 可选 tree-sitter-* 语法的真 AST(缺失时结构化兜底;GRAPHFLOW_TREE_SITTER=0 关闭) |
运行时依赖:@babel/parser、@modelcontextprotocol/sdk、tree-sitter + 可选语法包。tree-sitter 仅做语法;跨文件类型推断保持启发式(有已记录的边界)。
22-agent 自动安装器
graphflow install 检测已装 agent 并注册 MCP + Skill + Rules + Hooks——钩子合并幂等且保留用户条目;graphflow uninstall 只移除 GraphFlow 拥有的注册。用 --agents <id1,id2> / --all / --workspace 收窄范围。
覆盖:Cursor、VS Code、Windsurf、Trae、Zed、Claude Code、Codex、Gemini CLI、Antigravity、Kimi Code、DeepSeek Harness、OpenCode、ZCode、Cline、Roo Code、Kilo Code、Continue、PearAI、Qoder、Claude Desktop、Amazon Q、WorkBuddy。
DeepSeek Harness(DSH)
DSH 读 Cordis patch 而非 mcp.json。graphflow install 在 ~/.dsh/cordis.patch.yml 写入托管块(# GRAPHFLOW-DSH-BEGIN/END)并把 cwd 钉到你的工作区——请在工作区里运行以保证相对目标可解析。替代方案:纯配置 bundle @roarpeng/graphflow-dsh(二选一,同时用会产生重复行)。
VS Code 扩展
Marketplace / Open VSX 搜索 "GraphFlow"(roarpeng.graphflow)——预构建启动器:安装 / 挖掘 git / 查看状态三个命令。手动 VSIX:VSIX-INSTALL.md。
CLI 参考
| 命令 | 用途 |
|---|---|
graphflow install [--workspace] [--agents <id1,id2>] |
注册 MCP + Skill + Rules + Hooks(钩子合并,保留用户条目) |
graphflow uninstall [--agents <id1,id2>] [--all] |
移除 GraphFlow 注册(仅自有条目);默认检测到的 agent,--all 清理全部 |
graphflow status [--agents <id1,id2>] [--all] |
各 agent 注册状态([MCP ✓] [Skill ✓] [Rule -] [Hook ✓]) |
graphflow read [targets...] [-q <query>] [--skeleton] [--dedup] |
终端外科读取 |
graphflow edit <file> [--symbol <sym>] [--new <code>] [--rename <name>] |
外科编辑 / 重命名 |
graphflow exec [cmd] [--run] [--root <dir>] |
affected-tests 路由或任意命令脱水执行(--run 才执行) |
graphflow macro <list|run|save|mine|mine-git> [id] [args...] |
宏与 git 共变挖掘 |
graphflow task <list|show|record|run|log|harvest> |
本地任务反射:记录、提升重复指令、离线回放 |
graphflow reflect "<instruction>" [args...] |
本地运行已记录/近似的任务指令(未知返回 MISS) |
graphflow hook <pre-tool|post-tool|user-prompt> [--protocol generic|cursor|gemini] |
宿主钩子拦截入口(内部) |
graphflow graph / graphflow brief |
知识图谱 HTML 导出 / 跨 agent 交接简报 |
graphflow doctor parsers [--strict] / graphflow parsers |
tree-sitter 引擎诊断(--strict 无真 AST 时非零退出) |
graphflow version | help |
版本 / 用法 |
环境变量与调优
| 变量 | 默认 | 作用 |
|---|---|---|
GRAPHFLOW_EXEC_TIMEOUT_MS |
600000 |
单条 gf_exec 命令的墙钟预算。被预算截断时返回 TIMEOUT(exit 124)并附最后输出与 handle,不会伪装成普通 FAIL。 |
GRAPHFLOW_MAX_FILES |
20000 |
工作区扫描上限。旧版硬编码 5000,会静默截断更大的仓库。 |
GRAPHFLOW_SEMANTIC_CACHE |
开 | 持久化 L0 语义索引(semantic-index.json 及其 semantic-index-delta.json 覆盖层)。=0 关闭。 |
GRAPHFLOW_SEMANTIC_FRESH_MS |
50 |
语义索引的新鲜度复检窗口;0 表示每次查询都复检。 |
GRAPHFLOW_NAME_INDEX |
开 | 逐文件标识符集合,用于在不读源码的情况下预过滤爆炸半径候选。=0 回退为原文扫描。 |
GRAPHFLOW_AST_CACHE |
开 | .graphflow/ast-cache/ 下的 AST 分片持久化。 |
GRAPHFLOW_GRAPH_DEBUG |
关 | 打印知识图谱构建的分阶段耗时。 |
在 9 902 文件的合成工作区实测:单符号读取(含爆炸半径)0.62–0.69 s,知识图谱无改动重建 0.17–0.28 s、改 1 个文件 约 1.7 s、全冷建 约 30 s。
开发
npm install && npm test # 40 个测试文件(含 MCP stdio e2e)
npm run build # tsc → dist/
npm run bench # 本地基准 → benchmarks/latest.md
npm run verify:parsers # 真 AST vs 结构化矩阵
npm run preflight # 发布前静态检查
文档
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 37587
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37004
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
superdesigndev/treg★ 8181
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5867
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 2153
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
helloHub1212/dsh-windows-mcp★ 1490
通过官方 MCP 客户端桥接层把 CursorTouch/Windows-MCP 桌面自动化服务器接入 DSH,把截屏、UI 树快照、鼠标键盘输入、剪贴板、进程与注册表等工具注册成 mcp__windows__* 供模型调用,并附带 windows_mcp_doctor 诊断工具;Computer Use 默认关闭,需在插件面板里打开。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。