# demo123

**Repository Path**: dot123dot/demo123

## Basic Information

- **Project Name**: demo123
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-30
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小红书自动发布工具 Demo

一个简化版的小红书图文自动发布工具，包含后台服务和Chrome浏览器插件。

## 项目结构

```
redbook-auto-publish-demo/
├── server/                 # 后台服务
│   ├── index.js           # 服务主文件
│   ├── package.json       # 依赖配置
│   └── data.db            # SQLite数据库(运行后生成)
├── extension/             # Chrome插件
│   ├── manifest.json      # 插件配置
│   ├── popup.html         # 弹窗页面
│   ├── css/
│   │   └── popup.css      # 弹窗样式
│   ├── js/
│   │   ├── popup.js       # 弹窗脚本
│   │   ├── background.js  # 后台脚本
│   │   └── content.js     # 内容脚本
│   └── images/            # 图标(需自行添加)
└── docs/                  # 文档
    ├── PROJECT_REQUIREMENTS.md  # 项目需求文档
    ├── ADMIN_UI_PROMPT.md       # 后台UI生成提示词
    └── API.md                   # API接口文档
```

## 快速开始

### 1. 启动后台服务

```bash
cd server

# 安装依赖
npm install

# 启动服务
npm start

# 或开发模式(自动重启)
npm run dev
```

服务启动后访问: http://localhost:3000

### 2. 安装Chrome插件

1. 打开Chrome浏览器，访问 `chrome://extensions/`
2. 开启右上角的"开发者模式"
3. 点击"加载已解压的扩展程序"
4. 选择 `extension` 文件夹

> **注意**: 需要在 `extension/images/` 目录下添加图标文件:
> - icon16.png (16x16)
> - icon48.png (48x48)
> - icon128.png (128x128)

### 3. 使用流程

1. **注册账号**: 调用API创建用户账号
   ```bash
   curl -X POST http://localhost:3000/api/auth/register \
     -H "Content-Type: application/json" \
     -d '{"username":"admin","password":"123456"}'
   ```

2. **登录获取Token**: 记录返回的token
   ```bash
   curl -X POST http://localhost:3000/api/auth/login \
     -H "Content-Type: application/json" \
     -d '{"username":"admin","password":"123456"}'
   ```

3. **配置插件**: 
   - 打开小红书网站并登录
   - 点击插件图标
   - 填入服务器地址和用户Token
   - 点击"同步Cookie"

4. **创建发布任务**:
   ```bash
   curl -X POST http://localhost:3000/api/tasks \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <your-token>" \
     -d '{
       "xhs_account_id": 1,
       "title": "测试标题",
       "content": "这是测试内容",
       "images": []
     }'
   ```

5. **发布**: 
   - 在插件中点击"连接服务"建立SSE连接
   - 调用发布API或等待定时任务
   - 插件会自动接收指令并执行发布

## 核心功能

### 用户系统
- 用户注册/登录
- JWT Token认证

### 小红书账号管理
- 绑定多个小红书账号
- 自动同步Cookie
- 账号状态检测

### 发布任务
- 创建图文发布任务
- 支持定时发布
- 任务状态跟踪

### 实时通信
- SSE长连接
- 发布指令推送
- 结果实时回调

## 完整文档

| 文档 | 说明 |
|------|------|
| [安装部署指南](docs/INSTALL_GUIDE.md) | 详细的安装、部署、使用说明 |
| [API接口文档](docs/API.md) | 完整的API接口说明 |
| [项目需求文档](docs/PROJECT_REQUIREMENTS.md) | 项目背景和功能需求 |
| [后台UI提示词](docs/ADMIN_UI_PROMPT.md) | 生成Vue3后台界面的AI提示词 |

## 生成后台管理界面

本项目不包含前端管理界面，但提供了生成提示词。

查看 [docs/ADMIN_UI_PROMPT.md](docs/ADMIN_UI_PROMPT.md)，将提示词提供给AI可以生成完整的Vue3后台管理界面。

## 技术栈

### 后台服务
- **Express.js** - Web框架
- **better-sqlite3** - SQLite数据库
- **jsonwebtoken** - JWT认证
- **bcryptjs** - 密码加密

### Chrome插件
- **Manifest V3** - 最新插件规范
- **Service Worker** - 后台运行
- **Content Script** - 页面交互

## 注意事项

1. **Cookie安全**: Cookie包含敏感登录信息，请妥善保管
2. **发布频率**: 避免频繁发布，防止触发风控
3. **图片处理**: 生产环境需要实现图片上传到小红书的功能
4. **HTTPS**: 生产环境必须使用HTTPS

## 扩展开发

### 添加新功能
1. 多账号批量发布
2. 发布内容模板
3. 数据统计分析
4. Webhook通知

### 数据库迁移
如需使用MySQL/PostgreSQL，修改 `server/index.js` 中的数据库配置。

## License

MIT