本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

HoloGram

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• MCP 服务（hologram-engine serve）—— 接入 Claude Code / Cursor 等任意 MCP 客户端；
• 桌面应用（Tauri 2 壳）—— 3D 星图 + Monaco 编辑器 + 内置 Agent 工作台；
• DSH 插件（@a834063245/hologram-dsh）—— 引擎 + 星图打包进 DeepSeek Harness。
• • Windows: hologram-engine-windows-x64.zip
• • Linux: hologram-engine-linux-x64.tar.gz

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件支持哪些操作系统？

目前仅 Windows x64 受支持（postinstall 脚本会从 GitHub Releases 下载 win32-x64 引擎二进制）。Linux/macOS 在路线图中，安装时会被明确报错并中止。

引擎和 3D 星图用的是同一份图数据吗？

是的。引擎以 serve --tcp 单进程双入口运行，stdio MCP（35 个工具）与 TCP 9777（viewer）共享同一份内存图，watcher 增量更新同步生效，MCP 工具和 3D 星图读到的是同一份数据。

是否需要手动配置要分析的项目路径？

不需要。默认跟随 DSH 进程的当前工作目录（或当前会话的工作区），点开 3D 星图按钮的瞬间自动取当前会话 cwd 作为 ?project=。要分析固定路径才需要改 hologram-engine 行的 projectRoot 配置。

安装时报"unable to verify the first certificate"怎么办？

在企业自签 CA 环境，设置 NODE_EXTRA_CA_CERTS 环境变量指向根证书路径后重新安装；或者用 npm run pack:bin 手工放置引擎二进制后再装。

安装后需要重启 DSH 吗？

需要。引擎二进制与 host/client 包都装在 profile 的 node_modules 里，DSH web 运行中的进程持有文件句柄（EPERM: rename），所以更新或初次安装后必须重启 dsh web 才能看到侧边栏入口与 MCP 工具。

引擎二进制存放在哪里？

包内的 bin/hologram-engine.exe（约 60MB）。postinstall 时从 GitHub Releases 下载；本地开发可通过 npm run pack:bin 手工复制引擎产物。

onnxruntime.dll 是必需的吗？

不是。缺失不影响核心依赖图与 35 个 MCP 工具，只影响可选的向量/语义搜索功能（MiniLM embedding）。

如何卸载？

在 DSH 中运行 dsh plugin --profile web remove @a834063245/hologram-dsh，再重启 dsh web，侧边栏入口与 MCP 工具都会消失。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（peerDependencies 声明 @deepseek-ai/cordis ^4.0.1）
• Node: >=18

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则