5分钟上手Observal从本地部署到看到第一条AI会话追踪的完整快速入门教程【免费下载链接】ObservalObserval is self-hosted registry for your coding agent extensions with a built in insight engine. Setup Observal, define the scope and share your Skills, MCPs and Agents with your peers.项目地址: https://gitcode.com/gh_mirrors/ob/ObservalObserval 是一款自托管的 AI 编码代理Agent组件注册中心内置 AI 洞察引擎与 AI 会话追踪能力它可以统一管理你的 Skills、MCP 服务器和 Agents并把 Claude Code、Cursor、Copilot 等工具中每一次 AI 编程会话完整记录成可回放、可分析的数据。本教程带你完成 Observal 本地部署约 5 分钟即可在网页中看到第一条 AI 会话追踪记录。开始前的准备工作3 个环境要求要求最低版本说明Docker Engine24.0含 Compose v2使用docker compose命令内存4 GBClickHouse 是主要内存消耗者建议 6 GB磁盘5 GB用于镜像与数据卷 用docker version和docker compose version快速确认版本。CLI 安装若走 Python 方式需要 Python 3.11。第一步安装 Observal CLI1分钟完成Observal 分为两部分自托管的服务端API 网页界面 数据库和安装在开发者机器上的CLI 命令行。CLI 用于登录、安装会话追踪钩子、拉取 Agent。最推荐用uv安装也支持pipx/pipuv tool install observal-cli observal --version更多安装细节见官方文档 docs/getting-started/installation.md。第二步一键启动 Observal 服务端最快配置方法在终端中执行以下命令从源码启动完整的服务端堆栈git clone https://gitcode.com/gh_mirrors/ob/Observal cd Observal cp .env.example .env docker compose -f docker/docker-compose.yml up --build -d.env.example自带可运行的默认配置本地开发无需修改。首次启动会拉取镜像并编译前端预计 35 分钟之后启动只需 30 秒内。核心服务说明完整版见 SETUP.md服务地址用途observal-lbnginxhttp://localhost反向代理API Web 入口observal-webhttp://localhost:3000网页 UI 直连地址observal-dblocalhost:5432PostgreSQL 16注册中心数据observal-clickhouselocalhost:8123ClickHouse会话与审计事件observal-redislocalhost:6379任务队列 发布订阅等待 1530 秒让 API 通过健康检查然后验证curl http://localhost/health # → {status: ok} 返回ok即表示 Observal 服务端已就绪。生产部署建议参阅 docs/self-hosting/production-deploy.md 与 docs/self-hosting/docker-compose.md。第三步用演示账号登录 Observalobserval auth login按提示操作Server URL 直接回车默认http://localhost登录方式选Email然后输入演示账号角色邮箱密码超级管理员superdemo.examplesuper-changeme管理员admindemo.exampleadmin-changeme普通用户userdemo.exampleuser-changeme推荐用超级管理员体验最少限制的功能。验证登录成功observal auth whoami # → superdemo.example (super_admin)凭据保存在~/.observal/config.json权限0600。第四步扫描环境并安装 AI 会话追踪钩子先看看你的编码工具里已有哪些 MCP 服务器、Skills 和 Agentsscan只读不修改任何配置observal scan接着为所有受支持的编码工具安装会话追踪钩子observal doctor patch --all-harnesses该命令会安装受支持的会话钩子与扩展不会改动 MCP 配置。重启你的编码工具如 Claude Code、Cursor、Copilot 等使钩子生效然后随便开一个 AI 编程会话比如让它帮你写个函数或跑条命令等会话完成即可。第五步在 Dashboard 看到第一条 AI 会话追踪 打开浏览器访问http://localhost/traces刷新后即可看到刚刚被索引的会话列表包括用户、平台、Token 消耗、工具调用次数、时长等点击任意一条会话进入详情页查看 Token 输入/输出、缓存读写、API 调用次数、使用的模型和工具以及逐轮对话时间线展开某一轮Turn可以看到完整的用户 Prompt、每一次工具调用、AI 的思考过程Thinking以及助手回复——AI 会话追踪的每个细节都可回放也可以直接用 CLI 查看最近 5 条追踪记录observal ops traces --limit 5至此Observal 会话追踪链路已经跑通你的编码工具 → 本地会话钩子 → 摄入 API → ClickHouse 存储 → 网页仪表盘。完整原理可阅读 docs/core-concepts/session-tracking.md。加餐把 AI Agent 变成团队共享的组件包Observal 的注册中心Registry是它的另一半核心价值把 MCP 服务器、Skills、Hooks、Prompts、Sandboxes 五种组件打包成一个可安装、可版本化的 Agent一条命令装进任意受支持的编码工具observal agent list # 浏览可用的 Agent observal agent pull security-auditor --harness pi管理员侧还有审核队列、版本 Diff 对比、下载排行榜和 AI 洞察报告Insights帮助团队了解哪些 Agent 真正好用——详见 docs/use-cases/README.md。快速回顾5 步完成 Observal 快速入门✅uv tool install observal-cli安装 CLI✅ Docker Compose 启动服务端✅observal auth login演示账号登录✅observal doctor patch --all-harnesses安装追踪钩子✅ 打开http://localhost/traces查看 AI 会话追踪接下来想做什么参考文档理解注册中心身份与概念docs/core-concepts/README.md用追踪数据调试 Agent 故障docs/use-cases/debug-agent-failures.md配置生产环境docs/self-hosting/README.md深入某条 CLI 命令docs/cli/README.mdObserval 快速入门就到这里——你的 AI 编码会话从此有据可查、可回放、可优化。【免费下载链接】ObservalObserval is self-hosted registry for your coding agent extensions with a built in insight engine. Setup Observal, define the scope and share your Skills, MCPs and Agents with your peers.项目地址: https://gitcode.com/gh_mirrors/ob/Observal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
NgRx Router Store 安装指南：使用 `ng add` 与手动方式快速接入 前端状态管理 【免费下载链接】platform Reactive State for Angular 项目地址： https://gitcode.com/gh_mirrors/pl/platform 点击查看 免费下载 导读
ngrx/router-store 是 NgRx 生态中连接 Angular Router 与 Store 的核心绑定库，它通过监听路由事件… · 2026/9/27 0:42:22
室内设计师之路网站图解步骤：零基础避坑指南 室内设计师之路网站图解步骤：零基础避坑指南 不会写代码，却想做一个展示自己作品的室内设计师之路网站？别慌，这比你想的简单。 很多设计师卡在第一步，以为建站得先啃完Python或HTML，结果劝退无数人。 其实，通过可视化的 图解步骤… · 2026/9/27 0:42:02
前端视频处理方案 video-use：从采集到播放的完整链路设计 video-use 是不是某个现成的开源库？严格来说不是，它是我给手头一个视频业务项目起的代号，意思就一句话：把视频真正用起来。我做了几年视频相关的前端开发，最大的感受是，用户和产品都默认“视频不就是播放一… · 2026/9/27 0:41:24
《线性系统理论》核心难点拆解：从状态空间到极点配置 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 1:21:36
中兴F50无线调试全攻略：不拆机不刷机，ADB远程连接实战 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 1:21:35
ai-marketing-skills 专家团评测：7-10位AI领域专家递归打磨内容直到90+分 ai-marketing-skills 专家团评测：7-10位AI领域专家递归打磨内容直到90分 【免费下载链接】ai-marketing-skills Open-source AI marketing skills — growth experiments, sales pipeline, content ops, outbound, SEO, and finance automation 项目地址: https:/… · 2026/9/27 1:21:35
从零搭建Gazebo+ROS智能小车仿真环境：URDF建模到SLAM导航全流程 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 1:21:35
广州地区艺考美术学习阶段目标与画室适配评估逻辑框架拆解 本文中立拆解广州地区美术艺考全周期学习的阶段目标设计、能力达标评估维度，以及学员与教学体系适配性的判断逻辑，所有阶段划分、验收标准均参考广州本地具备22年办学积淀的正规艺考培训机构（人艺画室）经过18000余名学员实战验证的… · 2026/9/27 1:21:29
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现 简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急 汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习 简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现 简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急 汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习 简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
