dsh-plugin 使用指南

把 AgentSight 可观测性能力接入 DSH，使 Agent 可调用 agentsight_status 工具查询插件自身状态与版本。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

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

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add --allow-build=@agentsight/dsh-plugin github:alibaba/anolisa#path:src/agentsight/dsh-plugin

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

— 源: plugins.install

— 源: plugin_wiki.readme_zh (fallback readme_raw)

这个插件能做什么？

它只注册一个工具 agentsight_status，让 Agent 调用后返回插件名、版本号、激活状态以及当前可用的能力列表。它本身不采集或分析数据。

安装后还需要额外配置吗？

不需要。该插件只通过 Cordis 注入并注册一个内置工具，没有 Schema 配置项、不读取环境变量、不读写外部文件。

它和 AgentSight 主程序是什么关系？

它是 DSH 与 AgentSight 之间的轻量桥接层，仅暴露状态查询能力；真正的 eBPF 数据采集和 Dashboard 由 AgentSight 主程序提供，需要单独部署。

卸载会影响已采集的数据吗？

该插件本身不持久化任何数据，所以卸载它是安全的；它不会触碰 AgentSight 主程序的 SQLite、配置或追踪记录。

能在 macOS 或 Windows 上跑吗？

插件代码本身是跨平台的 TypeScript/Node.js 代码，但其所桥接的 AgentSight 主程序依赖 Linux 内核的 eBPF 能力。如果只启用此插件而没有安装主程序，工具会始终报告 active=true 但 capabilities 仅含 status。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

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

— 来源：通用规则