Relay16 - Nostr Social Client with AI Integration

Relay16 - 集成 AI 的 Nostr 社交客户端

Relay16 是一款现代化的 Nostr 社交客户端，通过 DVMCP（Data Vending Machine Context Protocol）集成 AI 工具，提升社交媒体体验。

✅ 状态：已准备就绪，可运行

应用已成功设置，随时可以开始开发。所有主要依赖项均已安装，配置问题也已解决。

功能

🌐 Nostr 协议支持

• 多中继连接 - 同时连接多个 Nostr 中继
• 实时动态 - 实时接收 Nostr 网络的更新
• 个人资料管理 - 创建和编辑你的 Nostr 身份
• 发布笔记 - 撰写并发布格式丰富的笔记
• 社交互动 - 点赞、回复和转发笔记

🤖 AI 驱动的功能

• 对话串总结 - 由 AI 总结长篇对话
• 写作辅助 - 获取 AI 建议，改进你的帖子
• 内容分析 - 情感分析和主题提取
• 智能话题标签生成 - 由 AI 生成相关话题标签

🔧 DVMCP 集成

• 工具发现 - 自动发现可用的 AI 工具
• 提供方管理 - 连接多个 DVMCP 提供方
• 请求跟踪 - 监控 AI 工具的使用情况和结果
• 可扩展架构 - 轻松集成新的 AI 服务

🎨 现代化 UI/UX

• 响应式设计 - 适用于桌面和移动设备
• 深色/浅色主题 - 自动切换主题
• 流畅动画 - 由 Framer Motion 驱动的过渡效果
• 组件库 - 基于 HeroUI 和 shadcn/ui 构建

技术栈

• 前端：React 18 + TypeScript
• 样式：Tailwind CSS + HeroUI + shadcn/ui + tailwindcss-animate
• 动画：Framer Motion
• 状态管理：Zustand
• Nostr 协议：nostr-tools（SimplePool API）
• AI 服务：OpenRouter API
• 存储：使用 Zustand 持久化的本地存储
• 构建工具：Vite

开始使用

先决条件

• Node.js 18+
• npm 或 yarn

安装

1. 克隆仓库：

git clone <repository-url>
cd relay16

2. 安装依赖项：

npm install

3. 启动开发服务器：

npm run dev

4. 打开浏览器并访问 http://localhost:3000

最近应用的修复

配置

Nostr 设置

1. 前往 Settings → Identity
2. 生成新密钥或导入现有私钥
3. 在 Settings → Relays 中添加 Nostr 中继

AI 服务设置

1. 从 OpenRouter 获取 API 密钥
2. 前往 Settings → AI Services
3. 输入你的 OpenRouter API 密钥

项目结构

src/
├── components/          # Reusable UI components
│   ├── Layout.tsx      # Main app layout
│   └── ui/             # shadcn/ui components
├── pages/              # Main application pages
│   ├── Feed.tsx        # Social feed ✅
│   ├── Profile.tsx     # User profiles (needs fixes)
│   ├── Compose.tsx     # Note composition ✅
│   ├── Tools.tsx       # AI tools interface (needs fixes)
│   └── Settings.tsx    # App settings (needs fixes)
├── hooks/              # Custom React hooks
│   ├── useNostr.ts     # Nostr protocol integration ✅
│   └── useDVMCP.ts     # DVMCP tool integration ✅
├── stores/             # Zustand state stores
│   ├── nostr.ts        # Nostr state management ✅
│   ├── dvmcp.ts        # DVMCP state management ✅
│   └── ai.ts           # AI services state ✅
├── services/           # External service integrations
│   └── ai.ts           # OpenRouter AI service ✅
├── types/              # TypeScript type definitions
│   ├── nostr.ts        # Nostr protocol types ✅
│   ├── dvmcp.ts        # DVMCP types ✅
│   └── ai.ts           # AI service types ✅
├── lib/                # Utility functions
│   └── utils.ts        # Common utilities ✅
└── App.tsx             # Main application component ✅

开发状态

✅ 已完成且可用

• 基本项目设置和配置
• 依赖项管理和构建系统
• 核心 TypeScript 类型和接口
• 基于 SimplePool 的 Nostr 协议集成
• AI 服务集成基础
• 基本 UI 组件和布局
• Feed 和 Compose 页面

🔧 仍需完善

• Profile 页面（缺少部分钩子方法）
• Tools 页面（DVMCP 存储属性映射）
• Settings 页面（缺少部分存储属性）
• 完整的 DVMCP 提供方集成
• 高级 Nostr 功能（私信、关注）

可用脚本

• npm run dev - 启动开发服务器 ✅
• npm run build - 构建生产版本
• npm run preview - 预览生产构建
• npm run lint - 运行 ESLint
• npm run type-check - 运行 TypeScript 类型检查

后续开发步骤

1. 补齐缺失的存储属性：为 Profile、Tools 和 Settings 页面所用的存储添加缺失属性
2. 实现真实的 DVMCP 集成：用实际的 DVMCP 提供方发现功能替换模拟数据
3. 添加高级 Nostr 功能：实现私信、关注和高级中继管理
4. 改进 UI/UX：添加更精致的动画并改进响应式设计

贡献

1. Fork 此仓库
2. 创建功能分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m 'Add amazing feature'
4. 将分支推送到远程：git push origin feature/amazing-feature
5. 发起 Pull Request

架构亮点

Nostr 集成

• 使用 nostr-tools 中的 SimplePool，高效管理多个中继
• 通过将密钥转换为 Uint8Array，妥善管理密钥以执行加密操作
• 使用 finalizeEvent 对事件签名并发布

状态管理

• 使用 Zustand 管理轻量级、适配 TypeScript 的全局状态
• 使用 持久化存储保存用户数据和偏好设置
• 在所有组件中实现响应式更新

AI 服务

• 集成 OpenRouter API，访问多种 AI 模型
• 以 DVMCP protocol 为基础，实现去中心化 AI 工具发现
• 采用模块化服务架构，便于扩展

故障排除

常见问题

1. 端口 3000 已被占用：在 vite.config.ts 中更改端口，或结束现有进程
2. 模块解析错误：确保使用 npm install 安装了所有依赖项
3. TypeScript 错误：运行 npm run type-check，查找并修复类型问题

依赖项

所有主要依赖项均已安装并配置：

• React 生态系统（React、React-DOM、React Router）
• UI 库（HeroUI、Tailwind CSS、Framer Motion）
• Nostr 工具和加密库
• 开发工具（Vite、TypeScript、ESLint）

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。

致谢

• Nostr Protocol - 去中心化社交协议
• OpenRouter - AI 模型 API 聚合服务
• HeroUI - React 组件库
• shadcn/ui - 组件集合
• Framer Motion - 动画库

---

Relay16 - 为去中心化的未来连接社交媒体与 AI。

🚀 准备好开始开发！运行 npm run dev，然后访问 http://localhost:3000