跳到正文

834063245-creator/HoloGram

241最近提交 2026年8月16日

HoloGram DSH 插件

HoloGram 使用 tree-sitter 静态分析将代码库编译成统一的 IR 依赖图,通过 MCP 协议暴露 34 个图查询工具,使 AI Agent 能够确定性地推理依赖关系,而非猜测。DSH 插件将引擎与 3D 星图可视化打包,在 DSH web 界面中直接渲染项目依赖图。

如何安装 HoloGram DSH 插件

dsh plugin --profile web add @a834063245/hologram-dsh

复制不会执行命令。安装 HoloGram DSH 插件前请核对仓库和版本。

HoloGram DSH 插件数据来源

HoloGram DSH 插件快照日期:2026年8月16日

discovered

HoloGram DSH 插件能做什么

  • 34 个 MCP 工具,涵盖依赖查询、风险分析、架构诊断、执行流和数据流(启发式)。
  • 3D 星图可视化(Three.js WebGL),通过 DSH web 侧边栏访问。
  • 支持 27 种语言(tree-sitter 语法),其中 18 种经过手工调优的结构抽取。
  • 增量更新由 watcher 驱动;单二进制引擎,零配置。
  • 改前检查、循环依赖检测、影响面追踪、脆弱模块识别。

HoloGram DSH 插件适合哪些场景

  • 在提交前分析修改函数或模块的影响范围。
  • 检测大型代码库中的循环依赖和脆弱模块。
  • 理解代码架构和数据流路径,用于入职或重构。
  • 将确定性依赖推理集成到 AI 编程助手中。

HoloGram DSH 插件适合谁

  • 需要可靠代码库理解的 AI Agent 开发者。
  • 维护大型复杂代码库的软件架构师和工程师。
  • 使用 DSH 并寻求高级静态分析能力的团队。

HoloGram DSH 插件的限制

  • 仅支持 Windows 和 Linux(当前版本不支持 macOS)。
  • 动态代码模式(eval、动态 import)标记为盲区,不进行完整解析。
  • 需要 AI 编程工具或 DSH 环境来使用 MCP 工具;引擎本身是 CLI/MCP 二进制。
  • 大型项目分析可能需要较长时间(如 Linux 内核约 1770 秒)和内存(RSS 约 646MB)。

HoloGram DSH 插件的仓库 README 摘录

以下文字摘自 HoloGram DSH 插件的上游仓库 834063245-creator/HoloGram 的 README,版权归原作者,仅作引用。

HoloGram 把代码库编译成一张统一 IR 依赖图(节点=符号/函数/类/模块,边=调用/继承/读写/时序),并通过 MCP 协议向 AI Agent 暴露 34 个图查询工具(注册表 35 个 schema,`symbol_history` 为 legacy 不默认暴露)。 **核心主张:依赖推理应当是确定性的,而不是猜的。** LLM 分析"改 A 会炸什么"时,靠逐文件读源码推测依赖——弱模型会漏,大项目会翻不动。HoloGram 用 tree-sitter 静态分析预先算好整张依赖图:Agent 一次工具调用拿到结构化事实(影响面、循环、脆弱模块、数据流路径),而不是源文件文本。单点查询省 ~70% token,全局分析省 90%+;省 token 是次要的,**可靠性**是主要的。 引擎是单文件二进制,本地运行、零配置、代码不出机器。 ## 快速开始 ### MCP 模式(推荐,1 分钟) 引擎随 [Releases](https://github.com/834063245-creator/HoloGram/releases) 发布(Windows / Linux),安装脚本一键完成。也可以把下面这段话直接发给你的 AI 编程工具,让它自己装: ``` 请帮我安装 HoloGram MCP 服务。步骤: 1. 从 https://github.com/834063245-creator/HoloGram/releases 下载: - Windows: hologram-engine-windows-x64.zip - Linux: hologram-engine-linux-x64.tar.gz 2. 解压后运行安装脚本: - Windows: 双击 install.cmd - Linux: ./install.sh --user 3. 在当前 AI 编程工具的 MCP 配置中注册: - command: hologram-engine - args: serve 4. 重启 AI 编程工具,调 engine_status 验证 ``` <details> <summary>手动配置</summary> **Claude Code** — `~/.claude/mcp.json`: ```json { "mcpServers": { "hologram": { "command": "hologram-engine", "args": ["serve"] } } } ``` **Cursor** — Settings → MCP → Add new MCP server:command `hologram-engine`,args

阅读完整 README仓库许可: MIT

HoloGram DSH 插件常见问题

如何安装 HoloGram DSH 插件?

执行 `dsh plugin --profile web add @a834063245/hologram-dsh`,然后重启 DSH web。插件会提供 34 个 MCP 工具和侧边栏的 3D 星图入口。确保你的 DSH 环境支持插件 bundle。

HoloGram 支持哪些语言?

它通过 tree-sitter 语法支持 27 种语言。其中 18 种语言(Python、TypeScript、Rust、Go、Java、C/C++、C#、Ruby、PHP、Swift、Dart、Scala、Zig、Elixir、Lua、Bash、R)有手工调优的结构抽取。其他语言(OCaml、Haskell、Nix 等)使用通用语法兜底。Kotlin、Markdown、TOML 动态加载。

HoloGram 支持 macOS 吗?

当前版本仅提供 Windows 和 Linux 的预构建二进制文件,不支持 macOS。你可能需要从源码构建或等待未来版本。

我能不使用 DSH 单独使用 HoloGram 吗?

可以。HoloGram 也作为独立的 CLI/MCP 二进制运行。从 Releases 下载后运行 `hologram-engine serve`,然后在你的 AI 编程工具(如 Claude Code、Cursor)中配置即可。DSH 插件是面向 DSH 用户的可选 bundle。

HoloGram 如何处理 eval 或动态 import 等动态代码?

HoloGram 将这些模式标记为盲区,不假装知道运行时才知道的事。动态 import 标记为动态站点,eval 标记为不可达。这样确保分析结果如实反映其局限性。