Reading Buddy

A social reading platform enabling users to register books, create and join virtual reading rooms, and share real-time chat and reading insights.

Reading Buddy - 社交阅读平台

一个让用户一起读书、交流心得的社交阅读平台。

功能特性

1. 书目注册中心

• 发布书目（书名、作者、简介、封面、标签、分类）
• 浏览书目列表
• 搜索书目（按标题、作者、简介）
• 按标签/分类筛选

2. 虚拟读书室

• 创建读书室（选择书目、设置开放时间、人数上限）
• 加入/退出读书室
• 读书室列表/搜索
• 房间状态管理（未开始、进行中、已结束）

3. 读书交流

• 实时聊天（文字消息）
• 心得分享（特殊消息类型）
• 聊天记录保存与导出

安装

cd ~/.openclaw/workspace/skills/reading-buddy
npm install
npm run build

初始化数据库

npm run init-db
# 或
reading-buddy init

CLI 命令

书目管理

# 添加书目
reading-buddy book add -t "书名" -a "作者" -d "简介" --tags "标签1,标签2" -c "分类"

# 列出书目
reading-buddy book list

# 搜索书目
reading-buddy book search "关键词"

# 查看书目详情
reading-buddy book show <id>

读书室管理

# 创建读书室
reading-buddy room create -b <bookId> -n "房间名" -u <userId>

# 列出读书室
reading-buddy room list
reading-buddy room list -s active

# 加入读书室
reading-buddy room join <roomId> -u <userId> -n "用户名"

# 退出读书室
reading-buddy room leave <roomId> -u <userId>

# 查看成员
reading-buddy room members <roomId>

# 开始/结束读书室（仅房主）
reading-buddy room start <roomId> -u <userId>
reading-buddy room end <roomId> -u <userId>

聊天功能

# 发送消息
reading-buddy chat send <roomId> -u <userId> -n "用户名" -m "消息内容"

# 查看聊天记录
reading-buddy chat history <roomId>

# 分享心得
reading-buddy chat insight <roomId> -u <userId> -n "用户名" -c "心得内容"

# 导出聊天记录
reading-buddy chat export <roomId>

用户管理

# 注册用户
reading-buddy user register -i <userId> -n "用户名"

# 查看用户信息
reading-buddy user show <userId>

技术栈

• 运行时: Node.js + TypeScript
• 数据库: SQLite (better-sqlite3)
• CLI: Commander.js
• 实时通信: EventEmitter (可扩展为 WebSocket)

数据存储

数据库文件位于: ~/.reading-buddy/reading-buddy.db

API 使用

import { BookService, RoomService, ChatService, UserService } from 'reading-buddy';

// 书目操作
const book = BookService.create({ title: '...', author: '...', ... });
const books = BookService.list();

// 读书室操作
const room = RoomService.create({ bookId: 1, name: '...', ... });
RoomService.joinRoom(roomId, userId, userName);

// 聊天操作
ChatService.sendMessage(roomId, userId, userName, 'Hello!');
ChatService.shareInsight(roomId, userId, userName, '我的读书心得...');

项目结构

reading-buddy/
├── src/
│   ├── cli.ts              # CLI 入口
│   ├── index.ts            # 库入口
│   ├── types.ts            # 类型定义
│   ├── db/
│   │   ├── database.ts     # 数据库连接
│   │   └── init.ts         # 初始化脚本
│   └── services/
│       ├── bookService.ts  # 书目服务
│       ├── roomService.ts  # 读书室服务
│       ├── chatService.ts  # 聊天服务
│       └── userService.ts  # 用户服务
├── package.json
├── tsconfig.json
└── SKILL.md