tribal

用途

Tribal 面向工程团队，用于捕获和查询那些通常不会写进代码或工单的隐性知识（tacit knowledge）。它关注的是：一个关键决策背后的推理、某人反复使用的启发式方法、解决一个棘手 bug 的突破点。它不试图记住所有内容，而是保留工作完成后仍然有用的部分。

主要能力

• 作为 Model Context Protocol（MCP）服务器运行，可被兼容的智能体框架（agent harness）像调用其他 MCP 工具一样调用。
• 按需摄取文本，并暴露一个由条目组成的图谱，条目之间通过“支持（support）”“矛盾（contradict）”“细化（refine）”等关系连接。
• 支持摄取知识、查询知识、遍历图谱以及评价检索质量。
• 提供 tribal bootstrap 作为规范化的首次运行命令，用于初始化数据库、应用模型与图谱设置、可选注册工作树，并确保生成带命名空间的默认凭据。
• 提供 tribal check 诊断套件，检查配置、数据库可达性、迁移状态、项目解析、令牌有效性、通告 URL 可达性以及 PATH 上的二进制唯一性；加 --providers 可扩展探测嵌入与推理提供方。
• 支持通过 tribal integration mcp-config 生成标准 MCP 配置，供兼容的智能体框架接入。
• 提供技能（skills）：installing-tribal 和 using-tribal，用于指导安装、验证、接线和故障排查，以及教导智能体何时、如何调用各工具。

使用方式

安装路径可选：Homebrew（macOS）、Shell 安装器（macOS 或 Linux）、Docker Compose（自带 Postgres）。Docker Compose 文件将镜像固定到特定发布版本，应从发布标签获取，而非复用旧检出；该栈自带 Postgres 并在首次启动时自举。若要在某个阶段指向云提供方而非本地 Ollama，需在首次 docker compose up 前配置 .env。

对于 Homebrew 和 Shell 安装器路径，需在 git 仓库内执行自举。这会运行设置、将仓库注册为项目、生成 bearer 令牌，并打印智能体框架所需的 MCP 配置片段。

前置条件：Postgres 14 或更高版本并安装 pgvector 扩展；一个用于嵌入和推理的提供方，可以是本地 Ollama 安装（含所需模型），也可以是环境中设置的支持的云提供方 API 密钥。tribal bootstrap 本身不调用提供方，但会验证配置，因此运行它时已配置的云提供方 API 密钥必须已在环境中。摄取时的提供方可达性由 tribal check --providers 单独验证。

tribal bootstrap 可安全地对同一持久状态重复运行。常用标志包括：--project-path DIRECTORY 将项目注册纳入自举组合；--transport stdio|http|sse 选择集成回执的连接形态；--auth oauth|persisted-bearer 选择网络认证方式（导出 bearer 是显式的，且不适用于 stdio）；--json 输出结构化 JSON 记录。

日常使用通过智能体框架进行。MCP 服务器接线完成后，框架可以摄取知识、查询、遍历图谱并评价检索质量。using-tribal 技能会教导框架何时以及如何调用每个工具，以及如何措辞摄取内容，使其在工作完成后仍长期存在于图谱中。

适用场景

• 工程团队希望保存并查询代码和工单之外的隐性知识。
• 团队使用兼容 MCP 的智能体框架，希望让智能体能够访问团队的历史决策与推理。
• 需要自托管、基于 Postgres + pgvector 的语义记忆方案。

限制与注意事项

• 需要 Postgres 14+ 与 pgvector 扩展。
• 需要嵌入与推理提供方（本地 Ollama 或受支持的云提供方 API 密钥）。
• 云提供方 API 密钥需在启动智能体框架前于 shell 中导出，否则框架及其生成的 Tribal 二进制不会继承；在框架已运行的终端中导出的密钥需重新启动后才会被拾取。
• 常见运维问题包括：端口被占用、凭据状态错误、Docker 卷损坏、项目上下文过期、缺少提供方环境变量。日志写入标准错误；支持结构化输出的命令可用 --json。
• 当 tribal check 报告 ok: true 但仍可见问题时，通常是网络层问题（如 VPN 或防火墙位于二进制与数据库之间），而非 Tribal 本身。
• 卸载需手动执行：移除二进制、删除 $XDG_CONFIG_HOME/tribal/credentials/ 下的命名空间凭据目录、删除 Tribal 使用的 Postgres 数据库、用 npx skills remove installing-tribal using-tribal 移除技能。

暂未提供

关于收费、价格、平台支持范围、具体效果指标等信息，资料中暂未提供。