
![](https://developer.qcloudimg.com/http-save/yehe-10389108/df1dc03afb104572714d57871c18ad61.png)

最近在使用opencode过程中，完全的黑盒状态，看不见交互的过程，显示的信息太少，就想到加一个插件实现白盒，查看完整的交互过程。

发现了opencode-observability。

opencode-observability 是面向 OpenCode AI 智能体的开源可观测性插件，专为实时监控与可视化设计，帮助开发者全面掌握智能体运行状态与行为细节。它基于 Bun 构建，由插件、后端服务、SQLite 存储与 Vue 可视化面板组成，部署简便，可跨项目追踪所有 OpenCode 会话。

该工具核心能力在于全链路数据采集，覆盖工具执行前后状态、会话生命周期（创建 / 空闲 / 错误 / 终止）、消息交互与权限变更，以及完整的输入输出 JSON 数据。所有事件经插件发送至后端，持久化后通过 WebSocket 实时推送至面板，实现毫秒级状态刷新。

可视化面板提供会话列表、事件流、调用时序与错误统计等视图，支持按项目、时间、状态筛选，快速定位异常会话与工具调用问题。它原生支持 OpenTelemetry 协议，可将链路、指标、日志导出至 Grafana、Datadog 等平台，适配企业级监控体系。

作为轻量级可观测性方案，opencode-observability 无需侵入业务代码，安装后自动全局生效，兼容 Linux、WSL 与 macOS 系统，是本地开发与团队协作环境下，保障 AI 智能体稳定运行、优化资源消耗与排查故障的重要工具。

**先说一下opencode-observability的安装过程。**

#1. 克隆仓库

```
git clone https://github.com/danilofalcao/opencode-observability.git
cd opencode-observability
```

#2. 执行安装脚本（自动装依赖、建配置）

```
./scripts/setup.sh
```
目录结构大概是：

```
opencode-observability/
├── apps/
│   ├── server/   # 后端 API + 数据库
│   └── dashboard/ # Web 看板
├── .env.opencode.observability
└── scripts/
    ├── setup.sh
    └── start-system.sh
```

配置（一般默认即可，可改端口）

```
# 编辑服务端配置
vim apps/server/.env
```

默认内容：

```
PORT=4000
DB_PATH=./data/events.db
```
#编辑插件配置

```
vim .env.opencode.observability
默认：
OPENCODE_OBSERVABILITY_URL=http://localhost:4000
```

启动监控系统（后端 + 看板）

```
./scripts/start-system.sh
```

输出看到下面就可以了：

```
Server running on http://localhost:4000
Dashboard running on http://localhost:5173
```

**在 OpenCode 启用插件**

 找到 OpenCode 全局配置文件

```
 ~/.config/opencode/opencode.json
```

 编辑加入插件

```
 vim ~/.config/opencode/opencode.json
```
把插件链接到 OpenCode（关键）

```
# 假设你放在 ~/opencode-observability
ln -s ~/opencode-observability ~/.config/opencode/plugins/opencode-observability
```

**查看所有交互（最核心）**

http://localhost:5173
![](https://developer.qcloudimg.com/http-save/yehe-10389108/062f69813a84e2d710e5e11192ac1184.png)
这样就可以使用了，看见交互事件了。

**常见的问题：**

1. q:安装 Bun 时的报错：error: unzip is required to install bun，意思是你的 Ubuntu 系统里缺少 unzip 工具，导致安装脚本无法解压文件。

a:先安装 unzip 依赖,sudo apt update && sudo apt install -y unzip,再重新运行 Bun 安装命令,生效环境变量（刷新 Shell 配置）source ~/.bashrc

2. q:内网端口访问不到

a: 修改端口监听

```
nano apps/client/package.json
"scripts": {
  "dev": "vite --port 5173 --host 0.0.0.0",
  "build": "vite build",
  "preview": "vite preview"
}
# 修改配置，把 localhost 改成你的服务器IP

cat > .env.local << EOF
VITE_API_URL=http://192.168.15.158:4000
VITE_WS_URL=ws://192.168.15.158:4000/stream
EOF
```

3. 分别开俩个终端启动命令


```
前端
cd ~/opencode-observability/apps/server
nohup bun run dev > server.log 2>&1 &

后端
cd ~/opencode-observability/apps/client
nohup bun run dev --host 0.0.0.0 --port 5173 > web.log 2>&1 &

opencode
```

最后总结一下，opencode-observability并不能满足我的需求，可能会满足部分人的需求，它目前只能可视化事件类型，无法查看对话内容。

但它的设计存在关键局限：作为事件采集器，它默认只记录事件骨架（如会话 ID、消息角色、时间戳），不会明文存储完整对话文本，这是出于性能和隐私保护的考量。因此，它不适合作为对话内容查看器，无法满足你查看详细对话的需求。

如果你需要查看完整对话，更推荐使用 OpenCode CLI 模式直接运行，终端会实时显示所有对话和工具调用内容；也可以通过 script 命令记录终端会话，或使用 OpenCode 原生 debug 日志（若版本支持）来获取完整交互信息。

但是部分的opencode版本也不支持查看详细的对话内容，这就很尴尬，大家如果有好的建议可以在评论区打出来。



最近在使用opencode过程中，完全的黑盒状态，看不见交互的过程，显示的信息太少，就想到加一个插件实现白盒，查看完整的交互过程。

opencode实时监控插件真实使用

架构师

人工智能

开发工具

OpenCode-observability是一款开源可观测性插件，专为OpenCodeAI智能体设计，提供实时监控与可视化功能。该工具支持全链路数据采集，包括工具执行状态、会话生命周期等关键信息，并通过WebSocket实现毫秒级状态刷新。安装简单，兼容Linux/WSL/macOS系统，适合开发者和团队协作使用，帮助优化AI智能体运行效率与故障排查。

数据库

服务器

智能体

SQLite

Ubuntu

Linux

JSON

腾讯云BI新客户首次购买9.9元起！


2026采购季 | AI焕新·智启新局

tencentdb-catalog

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenCode-observability是一款开源可观测性插件，专为OpenCodeAI智能体设计，提供实时监控与可视化功能。该工具支持全链路数据采集，包括工具执行状态、会话生命周期等关键信息，并通过WebSocket实现毫秒级状态刷新。安装简单，兼容Linux/WSL/macOS系统，适合开发者和团队协作使用，帮...

opencode实时监控插件真实使用-腾讯云开发者社区-腾讯云

opencode实时监控插件真实使用

opencode实时监控插件真实使用

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐