██████╗ ██████╗ ███████╗███████╗██████╗ ██╗ ██╗ █████╗ ██╗ ██╔═══██╗██╔══██╗██╔════╝██╔════╝██╔══██╗██║ ██║██╔══██╗██║ ██║ ██║██████╔╝███████╗█████╗ ██████╔╝██║ ██║███████║██║ ██║ ██║██╔══██╗╚════██║██╔══╝ ██╔══██╗╚██╗ ██╔╝██╔══██║██║ ╚██████╔╝██████╔╝███████║███████╗██║ ██║ ╚████╔╝ ██║ ██║███████╗ ╚═════╝ ╚═════╝ ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═══╝ ╚═╝ ╚═╝╚══════╝ Observal是内部AI组件的控制平面和记录系统。如果你觉得Observal有用，请考虑给它一个星标。这有助于其他人发现这个项目，并保持开发的进行。什么是Observal，它解决了什么？Observal是内部AI组件的控制平面和记录系统。每个技术前沿的组织今天都创建内部技能、代理、MCP服务器和其他AI组件以提高生产力。尽管这些组件的创建非常繁多，但这种组件的采用和使用却很少。今天的开发者/AI用户最终创建了他们自己版本的AI组件，而没有重用现有的软件包。造成这种情况的主要原因有两个：缺乏可发现性层。组织将其AI组件和代理存储在孤立的github库中，几乎没有文档。用户无法找到类似的组件，这导致多个开发者再次创建相同/相似的组件。缺失的反馈循环。任何软件，如果没有理解使用模式而违反了用户中心开发的原则，它往往会被忽视。这就是MCP、技能和代理开发所面临的问题。开发者发布和维护这些组件，却对它们的实际使用状况几乎没有可见性。此外，AI故障不会触发静态错误代码：它们会产生幻觉或提供微妙不正确的答案。这让用户对出错原因感到困惑，加剧了反馈问题。Observal通过提供一个中心化的AI组件发现层以及关于AI使用模式的有用洞察来解决这个问题。它将静默失败转化为可操作的反馈，确保内部AI工具持续为使用它们的人进行优化。Observal支持Claude Code、Cursor、Kiro、Pi、Copilot、Codex、OpenCode和其他工具。团队为什么使用Observal 将组件打包成可重用的代理：将技能、MCP服务器、钩子、提示和沙箱打包成一个版本单位。运行受管理的注册表：审查提交，批准内部代理，检查版本差异，为开发者提供一个可信的安装地点。跨多个编码IDE/CLI渲染：为每个支持的工具生成正确的配置，而不是为每个工具维护单独的设置说明。了解什么是有效的：使用真实的采用和会话数据来寻找哪些代理、工具、提示和工作流程能够帮助团队。需要时重放会话：使用跟踪作为调试、审查、审计和更深入分析的证据。支持的工具工具 Claude Code Kiro Cursor Pi Copilot (CLI & VS Code扩展) Codex OpenCode Antigravity CLI 一条命令安装任何代理到任何支持的工具。配置文件会自动为每个工具生成。快速开始 Observal有两个部分：一个自托管的服务器（API + 网页UI + 数据库），以及一个在每个开发者机器上安装的CLI。1. 部署服务器 单行安装（需要Docker Engine ≥ 24.0 和Compose v2）：curl -fsSL https://raw.githubusercontent.com/Observal/Observal/main/install-server.sh | bash 这将下载一个Docker Compose包，运行引导设置（域名、机密、端口），从GHCR拉取容器镜像，并启动整个堆栈（API、网页UI、PostgreSQL、ClickHouse、Redis、工作者、负载均衡器、Prometheus、Grafana）。部署文档直接从此README链接： 设置指南：从零到运行堆栈的最快路径 自托管概述：部署模型和操作文档 生产部署：坚固的生产拓扑 数据库：Postgres、ClickHouse、迁移、保留 升级：安全升级和回滚流程 备份和恢复：升级前的备份计划 从源代码（供贡献者使用）： git clone https://github.com/Observal/Observal.git && cd Observal cp .env.example .env make up 2. 安装CLI 独立二进制文件（不需要Python）：curl -fsSL https://raw.githubusercontent.com/Observal/Observal/main/install.sh | bash Python (3.11+)：uv tool install observal-cli #或：pipx install observal-cli 3. 连接你的工具 observal auth login observal doctor --patch 这将与你的服务器进行身份验证，检测你的工具，安装遥测钩子，开始自动捕获会话，并为代理安装和注册命令做好准备。一旦登录，运行/observal在你的工具中，它将承担控制。 拉取代理，提交组件，浏览注册表，运行诊断： /observal pull security-auditor /observal scan /observal doctor 或者只需告诉你的代理你想要什么，它会找出正确的命令。 Observal如何工作 代理是p...