插件关系图谱cordisplugins/cordis-plugin-graph

cordis-plugin-graph

一个 DSH / Cordis Web 插件，在 Settings → Plugins 中 Plugin list 旁边添加一个 Plugin graph 标签页。它渲染运行中的 Cordis 运行时的实时、可缩放 Cytoscape 图 —— 包括静态包图无法展示的内容：哪个 provider 实际解析了每个 inject、哪些被禁用，以及实时流经的工具调用。

你会看到什么

两个平面（切换：client / host / both）：

- client —— 渲染器 Cordis 上下文，在进程内检查：每个 dsh-client-ui-* 插件、slot 渲染器、连接、主题、语言环境、设置。
- host —— 引擎上下文（会话、代理、工具、模型适配器、持久化），从 host 半边提供的同源路由轮询。在无法访问 Web 服务器的地方（打包桌面端、无头环境）优雅降级为仅 client。

节点 = 插件 fiber，按生命周期阶段着色（active / pending / loading / failed / unloading / disposed），外加针对被关闭的 Loader 行的 disabled —— 因此该图展示的是整个组合，而不仅仅是正在运行的部分。大小随所提供的服务数量缩放。

边，可单独切换：

- requires (inject) —— fiber 的硬 inject，绘制到实际解析它的 fiber。
- provides to —— 反向。
- nested in (Loader tree) —— Loader 树父级（组合 / 继承）。

运行时活动 —— 当显示 host 平面时，实时显示最近工具执行的动态流（来自 tools/result 订阅），并且工具节点在每次调用时脉冲。运行一个代理任务，观察它在图中移动。

点击节点 → 模块说明符、Loader 条目 id、提供的服务、实时 effect 标签。按名称/模块搜索。在实时启用/禁用后重新捕获。

安装

dsh plugin add cordis-plugin-graph

重启 Host；该标签页会出现在 Settings → Plugins 下。有关 GitHub / 本地目录安装以及 ACRYL Desktop，请参阅 install/INSTALL.md。

可移植性

仅使用上游原语 —— settings.plugins.tab、公开的 @deepseek-ai/cordis 上下文 API，以及（可选）可独立降级的 tools + webServer 作用域注入。适用于任何 web 配置的部署：ACRYL 或原版 DSH Desktop。

渲染器平面检查遍历（src/inspect.ts）最初是 acryl-desktop 的 plugin-architecture-inspector.ts 的精简移植 —— 纯 @deepseek-ai/cordis 公开 API。

构建

pnpm install
pnpm run build      # lib/index.js + lib/inspect.js (host), lib/client.js (browser, cytoscape bundled)
pnpm run check      # build + typecheck + tests

许可证

MIT