Reading Buddy

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 

读书室管理

# 创建读书室
reading-buddy room create -b  -n "房间名" -u 
列出读书室
reading-buddy room list
reading-buddy room list -s active
加入读书室
reading-buddy room join  -u  -n "用户名"
退出读书室
reading-buddy room leave  -u 
查看成员
reading-buddy room members 
开始/结束读书室（仅房主）
reading-buddy room start  -u 
reading-buddy room end  -u 

聊天功能

# 发送消息
reading-buddy chat send  -u  -n "用户名" -m "消息内容"
查看聊天记录
reading-buddy chat history 
分享心得
reading-buddy chat insight  -u  -n "用户名" -c "心得内容"
导出聊天记录
reading-buddy chat export 

用户管理

# 注册用户
reading-buddy user register -i  -n "用户名"
查看用户信息
reading-buddy user show 

技术栈

数据存储

数据库文件位于: ~/.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