Confer · Confer docs

**[官网](https://hyhmrright.github.io/Confer/)** · **[文档](../)** · **[Claude Code 插件](../../plugins/confer-a2a/README.md)** · **[版本发布](https://github.com/hyhmrright/Confer/releases)** [![Release](https://img.shields.io/github/v/release/hyhmrright/Confer?style=flat-square&color=e6a23c)](https://github.com/hyhmrright/Confer/releases) [![License](https://img.shields.io/github/license/hyhmrright/Confer?style=flat-square&color=e6a23c)](../../LICENSE) [![CI](https://img.shields.io/github/actions/workflow/status/hyhmrright/Confer/ci.yml?branch=main&style=flat-square)](https://github.com/hyhmrright/Confer/actions/workflows/ci.yml) [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6?style=flat-square)](../../tsconfig.json) [English](../../README.md) · 简体中文 · [日本語](/Confer/i18n/README.ja.html)

这是什么

让你的 AI，和任何人的 AI 对话。

你的编程 Agent 不了解你的内部系统、团队约定，也不清楚你正在集成的第三方 SDK 有哪些坑。于是它靠猜，而你把一天的时间花在往对话框里粘文档。

Confer 给这些知识一个地址。 你运行自己的 Agent——它承载你的文档、你的知识库、你的规则。 Claude Code 通过 MCP 咨询它，拿到带引用的答案，并把验证过的事实写进 .claude/peers/，跟着 git 走，下次自动复用。

同一条通道也能跨组织。当对方也跑着一个 Agent——供应商、合作方、另一个团队——两个 Agent 就通过带签名、可验证身份的协议直接对话。双方的人都不用啃对方的文档。

它凭什么值得一看

一个节点就能用。 把它指向你自己的文档，编程 Agent 就不再靠猜。不需要等别人先加入。
答案带引用。 每条事实都能追回源文档，并保留原文语言。
知识不随会话消失。 .claude/peers/{peer}/facts.md 是纯 Markdown，提交进你的仓库—— 跨上下文窗口、跨机器、跨同事都在。
中间没有平台。 构建在开放协议之上：A2A、W3C DID:web、HTTP 消息签名（RFC 9421）、 NANDA AgentFacts、MCP。自托管，并和任何人联邦互通。
密钥归你。 LLM 与 embedding 密钥按用户 AES-256-GCM 加密，永不离开 gateway。
同意是闸门，不是形式。 对端在你接受之前够不到你；三层权限模型（L1/L2/L3）决定 Agent 在无人值守时能做什么。

快速开始

1 · 跑起你自己的实例

需要 Docker，以及能跑 npx 的 Node 18+。不用 clone，也不用构建——这条命令会拉取已发布的镜像、生成这个实例自己的密钥、执行数据库迁移，并一直等到 Web UI 真的能响应：

npx confer-cli

打开 http://localhost，注册第一个账号，然后在设置里填入你的 LLM API key （按用户加密存储）。npx confer-cli down 停掉全部服务并保留数据；npx confer-cli logs 跟踪 gateway 日志。

它写下的东西都在 ~/.confer 里，其中的 .env 请保存好：实例里存的 API key 是用 ENCRYPTION_KEY 解密的，弄丢它就等于弄丢那些 key。端口、镜像 tag、安装目录等参数见 CLI 说明。

机器上没有 Node？用纯 Docker Compose 也一样

```bash curl -O https://raw.githubusercontent.com/hyhmrright/Confer/main/docker-compose.ghcr.yml printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env docker compose -f docker-compose.ghcr.yml up -d ``` 镜像相同，compose 文件也就是 CLI 自带的那一份。两点差别：没有任何东西去确认这套栈真的起来了；Postgres 与 MinIO 的密码会停留在文件里的默认值——除非这台机器只有你自己用，否则请在那份 `.env` 里一并设置 `POSTGRES_PASSWORD` 和 `MINIO_ROOT_PASSWORD`。

镜像在每次推送到 main 时构建，同时提供 linux/amd64 与 linux/arm64。想从源码构建见 3 · 开发 Confer 本身。

配置、反向代理与排错见 docs/09-deployment.md。

2 · 接上 Claude Code

针对刚才启动的实例安装 confer-a2a 插件：

/plugin marketplace add hyhmrright/Confer
/plugin install confer-a2a@confer

启动 Claude Code 之前在 shell 里设好凭据——签名私钥永远留在 gateway，插件只携带 bearer token：

export CONFER_USERNAME=你的用户名
export CONFER_PASSWORD=你的密码
export CONFER_GATEWAY_URL=http://localhost   # 上面那套栈由 nginx 服务在 80 端口

然后照常干活即可。Claude Code 会咨询你 Confer 账号里的联系人，并把学到的东西写进项目记忆：

> 给 X100 写 Modbus 温度读取

插件与它暴露的工具见 plugins/confer-a2a/README.md。

3 · 开发 Confer 本身

infra 跑在 Docker 里，gateway 与客户端热重载：

bun install
docker compose up -d    # 仅 infra：Postgres、Redis、NATS、Qdrant、MinIO
bun run db:migrate
bun run dev

Web 预览：http://localhost:1420
原生桌面应用：cd packages/client && bunx tauri dev

monorepo 布局、测试栈与代码约定见 CONTRIBUTING.md。

架构

[Clients] (Tauri 2.0: iOS/Android/Win/Mac/Linux)
       │
       ▼
[Edge Gateway] (Bun + Hono, JWT for users, HTTP signatures for peers)
       │
       ├── [Agent Runtime]    LLM + tools + memory
       ├── [Conversation]     messages, fan-out
       └── [Identity & A2A]   DID:web, federation
                 │
       [PostgreSQL · Redis · NATS · Qdrant · S3]
                 │
                 ▼
   External: LLM providers · MCP tool servers · Other instances' Agents

详见 docs/02-architecture.md。

技术栈

后端：Bun + TypeScript + Hono
客户端：Tauri 2.0 + React 19 + TypeScript + Tailwind
数据：PostgreSQL 18 + Qdrant + MinIO
协议：W3C DID、HTTP 消息签名（RFC 9421）、MCP、A2A、NANDA AgentFacts
LLM：自带密钥（Claude · GPT · DeepSeek · Qwen · GLM · Ollama）

文档地图

文档	内容
`docs/01-product.md`	产品定义、目标用户、Hero scenarios
`docs/02-architecture.md`	系统架构
`docs/03-protocol.md`	A2A、DID:web、AgentFacts、权限协议
`docs/04-data-model.md`	数据库 schema、TypeScript 类型
`docs/05-api.md`	REST + WebSocket + A2A 接口
`docs/06-claude-code-plugin.md`	MCP 插件设计
`docs/07-project-memory.md`	`.claude/peers/` 格式
`docs/08-mvp-backlog.md`	路线图与任务清单
`docs/09-deployment.md`	自托管、配置、排错
`CONTRIBUTING.md`	开发环境、monorepo 布局、测试栈
`SECURITY.md`	安全政策与加固建议
`CLAUDE.md`	给 Claude Code 看：项目约定与入口

状态

v0.4.0 —— 可用，未到 1.0，仅自托管。

已交付：A2A 咨询流程、RFC 9421 HTTP 签名、DID:web 身份、RAG 知识库（MinIO + Qdrant + 多provider embedding）、Agent 长期记忆、三层权限、管理后台、三语界面（EN/中文/日本語），以及 confer-a2a Claude Code 插件。每个 PR 都会在真实的 Postgres + Qdrant + MinIO 栈上跑完整测试。

还没有的：没有官方托管的公共实例——需要你自托管。桌面与移动端每个版本都会构建，但测试覆盖不如 Web 客户端。剩余范围见 docs/08-mvp-backlog.md。

Confer Web 客户端

参与贡献

欢迎提 issue 和 PR——开发环境见 CONTRIBUTING.md， good first issue 里有适合上手的任务。问题和想法欢迎去 Discussions。

安全问题：请按 SECURITY.md 的流程私下报告，不要开公开 issue。

许可证

Apache License 2.0。

← 返回 Confer A2A · DID:web · RFC 9421 · NANDA