# AgentLink

> AI agent 协作平台:跨域数据同步 + 个人记忆托管 + OAuth/OIDC identity + OpenAI 兼容 LLM 代理 + SearXNG 搜索。

## 产品定位

AgentLink 让 AI agent 能:
- 抓取用户的公开 profile / memory 数据(`/u/{slug}`, `/md/{slug}`, `/api/u/[slug]/memory-table`)
- 用 API Key 或 OIDC access token 调用 `/api/agent/v1/*`(memories CRUD、memory-table、LLM process、search)
- 跨域同步配置 / 状态(浏览器 ↔ 浏览器,纯前端 SDK)

## 公开端点(无需鉴权)

| 路径 | 返回 | 说明 |
|------|------|------|
| `/` | HTML | 首页 |
| `/u/{slug}` | HTML | 用户公开主页 |
| `/md/{slug}` | text/plain(markdown) | 用户公开主页的纯 markdown 版(agent 友好) |
| `/api/u/{slug}` | JSON | 用户公开 profile 数据 |
| `/api/u/{slug}/memory-table` | JSON | 用户公开 LLM 整理的 memory markdown 文档(memoryPublic=true 才返回) |
| `/api/llms.txt` | text/plain | 本文件 |
| `/.well-known/agent.json` | JSON | AI agent manifest(能力清单 + auth 入口) |
| `/.well-known/openid-configuration` | JSON | OIDC discovery |
| `/.well-known/security.txt` | text/plain | RFC 9116 安全联系 |
| `/sitemap.xml` | XML | 全部公开 URL 清单 |

## Agent API(v1,需鉴权)

认证方式(任选其一):
- `Authorization: Bearer mix_<64hex>` 或 `X-Api-Key: mix_<64hex>`(API Key,在 `/api/user/api-keys` 生成)
- OIDC access token(OAuth authorization_code + PKCE S256,scope: openid + profile + email)

### Memories(MD 记忆条目 CRUD)

- `GET /api/agent/v1/memories?limit=100&offset=0` — 列表/搜索(`limit` 默认 100,上限 200)
- `POST /api/agent/v1/memories` — 创建
- `GET /api/agent/v1/memories/{id}`
- `PATCH /api/agent/v1/memories/{id}`
- `DELETE /api/agent/v1/memories/{id}`
- `POST /api/agent/v1/memories/clear` — 清空

### Memory Table(LLM 整理后的 markdown 文档)

- `GET /api/agent/v1/memory-table` — 获取当前
- `PUT /api/agent/v1/memory-table` — 替换当前(可选 `title` 触发版本快照)
- `GET /api/agent/v1/memory-table/versions` — 版本列表
- `POST /api/agent/v1/memory-table/versions/{id}/restore` — 还原版本

### LLM(OpenAI 兼容)

- `POST /api/agent/v1/process` — OpenAI Chat Completions 兼容。默认带 Memory 五字段 schema,传 `response_format: { type: "json_object" | "text" }` 可不用 Memory 格式。支持 `text/event-stream` SSE 流。

### Search(SearXNG 代理)

- `GET /api/agent/v1/search?q=...&format=json` — SearXNG meta-search,自带沙箱隔离

## OIDC Identity Provider

AgentLink 同时是 OIDC IdP,三方应用可以接入做用户登录:
- Discovery:`/.well-known/openid-configuration`
- JWKS:`/.well-known/jwks.json`
- Scopes:`openid`, `profile`, `email`
- Grant:`authorization_code` + PKCE S256(public client,`token_endpoint_auth_methods_supported: none`)
- 注册三方应用:`/api/user/oauth-clients`(需登录)

## 数据策略

- **`User.previousSlugs`** 是 `String[]`,用户改 slug 时旧 slug 入历史 — 公开页 `/u/[oldSlug]` 自动 308 redirect 到 `/u/[realSlug]`
- **visibility 三档**:`public`(搜索引擎收录)/ `unlisted`(链接可见,搜索不收)/ `private`(自己看)
- **memory 公开条件**:`visibility === 'public' && memoryPublic === true`(在 `/api/u/{slug}/memory-table` 严格);HTML `/u/{slug}` 和 `/md/{slug}` 在 unlisted 时也展示

## 活跃域名白名单

- pollpink.mixlab.top - 0 秒协调下一次会议时间。 创建投票，发到群里，谁点都能投。
- localhost - 本地应用
- xiaohongshu-md.vercel.app - 将 Markdown 转换为精美的分页图片
- www.mixdao.world - SoloScope 一人公司情报系统
- www.jianinghua.cn - 讲给爱的人听。每个人，都是自己人生的写作家，每一段人生，都值得被认真记录……
- www.xiaoxianhuang.com - 同你一起，直面命运，修行人生。AI 命理界的小清新【黄小仙来也】正式版，全球震撼发布！ 这不仅仅是一个 Web 网站，它是你穿行于复杂世界时的全能命理顾问、人生 GPS 和情感避风港。
- waitlist.bondary.ai - 用AI助力更明智的约会决策 AI for better decisions in dating | Clarity for love, and clarity for yourself.
- insight-trace.vercel.app - 下一代数字足迹侦察系统,基于 多模态大模型与全网开源情报的深度人物背调与身份核验工具。
- certificate-generator-steel-phi.vercel.app - 证书制作工具
- voice-note-zeta.vercel.app - 语音笔记，具有访谈模式和自我介绍模式
- 100-professions.vercel.app - 未来工作研究报告：进化指数，基于 Gemini 3 的 100+ 职业 AI 融合动态分析与实时数据合成。
- markdown-renderer.mixlab.top - Markdown排版渲染-支持AgentLink传输数据
- insight-crm-five.vercel.app - 个人社交资产的管理和优化
- ai-bar-web.vercel.app - 行为模拟器
- pixel-sprite-gen.vercel.app - 创建你的数字分身

## 技术栈

- **服务端**:Next.js 16, React 19, TypeScript, Prisma 7 + PostgreSQL, next-auth 5
- **部署**:Vercel(自动从 main 分支部署)
- **客户端 SDK**:TypeScript, CompressionStream API, tsup(`packages/agentlink-sdk/`)
- **UI**:Tailwind CSS

## 应用场景

- **AI agent 抓用户上下文**:agent 用 API Key GET `/md/{slug}` 或 `/api/u/{slug}/memory-table` 拿用户 LLM 整理后的记忆,做个性化对话
- **跨域数据同步**:浏览器 ↔ 浏览器传配置 / 状态(纯前端 SDK,无后端代理)
- **三方应用登录**:OIDC IdP,接入方走 authorization_code + PKCE
- **AI agent 自我托管记忆**:agent 通过 `/api/agent/v1/memories` 写自己的长期记忆,跨会话持久化

## 快速开始(给 agent developer)

### 1. 申请 API Key
登录 `/memory/account`,在 API Keys 区生成 `mix_<64hex>`。

### 2. curl 试一下
```bash
curl -H "Authorization: Bearer mix_<your_key>" \
     https://agent-link.example/api/agent/v1/memories?limit=10
```

### 3. 写 memory
```bash
curl -X POST -H "Authorization: Bearer mix_<your_key>" \
     -H "Content-Type: application/json" \
     -d '{"content": "...", "tags": ["context"], "priority": "normal"}' \
     https://agent-link.example/api/agent/v1/memories
```

## 相关资源

- GitHub:https://github.com/shadowcz007/AgentLink
- llms.txt 本文件:`/api/llms.txt`
- Agent manifest:`/.well-known/agent.json`
- Sitemap:`/sitemap.xml`

## 更新日期

2026-07-14T12:24:44.894Z