伙伴——代理优先知识图
 
LLM和AI代理的基于图形的知识基板，带有人类可读的仪表板。
buddy是一个MCP服务器，它提供了25个用于管理知识图的工具。代理将概念、事实、决策、模板和配置存储为 节点，按类型连接 边缘人类通过服务器渲染的仪表板看到一切。
特性
- 统一节点模型 --一个实体类型替换5个（知识、文档、记忆、变量、技能）
- 知识图谱 --使用验证矩阵在节点、项目和任务之间键入边
- 25个MCP工具 --CRUD、全文搜索（FTS5）、图遍历、上下文加载
- 健康评分 --基于势头、截止日期和新鲜度的每个项目得分（A-F）
- 仪表盘 --节点浏览器、图形可视化（D3.js）、项目中心、活动日志
- OAuth 2.1 --强制执行PKCE，与Claude.ai、Gemini CLI、Mistral Le Chat兼容
- 加密 --AES-256-GCM
secret通过HKDF密钥推导节点 - 图形完整性 --自动验证、孤儿检测、健康评分影响
- 令牌优化 —
context_load设计用于最小的令牌使用（\" }
} } }
OAuth 2.1发现： `/.well-known/oauth-authorization-server`
### 工具筛选
通过以下方式限制暴露的工具 `?tools=` 查询参数：
/mcp?tools=nodes — Node + Edge tools only /mcp?tools=tasks — Task tools only /mcp?tools=nodes,tasks — Combination /mcp — All 25 tools
## 节点类型
|类型|描述|替换（v2）|
|---|---|---|
| `concept` |概念知识|知识|
| `fact` |原子性的、可验证的事实|记忆|
| `decision` |架构决策、ADR |文件|
| `template` |方法、提示模板、工作流|技能|
| `secret` |加密凭据（AES-256-GCM）|变量（机密）|
| `config` |配置值、URL、标志|变量（纯）|
所有节点类型都支持可选 `url` 用于链接到外部资源（产品页面、文档、RFC等）的字段。带有URL的节点在项目侧栏中显示为可点击的链接。
## 边缘关系
|关系|允许|
|---|---|
| `depends_on` |节点→ 节点|
| `relates_to` |任何组合|
| `supersedes` |节点→ 节点|
| `documented_by` |节点/项目→ 节点|
| `deployed_on` |节点→ 节点|
| `implements` |节点→ 节点|
| `produced_by` |节点/任务→ 节点|
## 仪表盘
|路线|描述|
|---|---|
| `/` |主页--健康评分、注意力任务、草稿、活动、统计数据|
| `/nodes` |节点浏览器——按类型、上下文、状态过滤|
| `/nodes/:id` |节点细节——渲染的标记、边缘、完整性|
| `/project/:id` |项目中心——任务、相关节点、运行状况|
| `/graph` |知识图——D3.js力定向，缩放/平移|
| `/activity` |带有安全审计跟踪的活动日志|
系统字体（无外部请求）。黑暗/光明主题。缩放S/M/L。
## 文档
- [安装指南](docs/installation.md) --完整设置，包括速率限制
- [Cloudflare API代币](docs/cloudflare-token.md) --所需权限
- [MCP工具参考](docs/mcp-tools.md) --所有25个工具及其示例
- [图形完整性](docs/graph-integrity.md) --验证矩阵、健康评分
- [代币轮换](docs/token-rotation.md) --BUDDY_TOKEN旋转，秘密重新加密
## 技术栈
- **运行时间：** Cloudflare Workers（V8隔离）
- **数据库：** Cloudflare D1（SQLite+FTS5）
- **隐藏物：** Cloudflare KV（60秒TTL）
- **框架：** [荣誉](https://hono.dev) v4
- **MCP：** [@模型上下文协议/sdk](https://github.com/modelcontextprotocol/sdk) v1.27
## MCP提供商兼容性
buddy与每个主要的MCP兼容AI提供商都有本地合作：
|提供者|连接|状态|
|---|---|---|
| **克劳德** （Anthropic）| OAuth 2.1（Claude.ai）、承载令牌（Claude Code）、MCP配置（Claude Desktop）|在所有平台上完全支持|
| **米斯特拉尔** （Le Chat）| OAuth 2.1，主权欧洲人工智能|本地兼容|
| **双子星命令行工具** （谷歌）|OAuth 2.1 |原生兼容|
| **任何MCP客户端** |带有PKCE|流式HTTP传输的承载令牌或OAuth 2.1|
## 伙伴与替代品
|功能|好友|Mem0|Zep|线性|
|---|:---:|:---:|:---:|:---:|
|基于图形（节点+边）|是|否|否|不|
|MCP原生|是|是|否|
|自托管（Cloudflare）|是|云|云||
|代理优先设计|是|是|否|
|包含仪表板|是|否|否|是|
|加密（机密）|是|否|否|不|
|开源| Apache 2.0 |部分|部分|否|
## 路线图
**伙伴团队** --具有共享知识图的多用户版。范围（个人/团队/组织）、基于角色的访问（管理员/成员/读者）、并发编辑的乐观锁定。单个代码库 `--mode=team` 旗帜。
**Prem上的好友** --Docker自托管部署，适用于数据不得离开网络的环境。基于SQLite，无云依赖。相同的MCP界面，相同的仪表板。
**信号服务** --GitHub webhooks、CI/CD事件和监控警报的外部摄取端点。在基于LLM的相关性过滤后，通过MCP向好友提供单独的微服务。
## 贡献
看 [贡献.md](CONTRIBUTING.md) 关于架构、开发设置以及如何添加工具或视图。
## 安全
看 [安全.md](SECURITY.md) 用于报告漏洞。
## 许可证
Apache 2.0——请参阅 [许可证](LICENSE)