# 小红书千帆店铺矩阵工具

一套完整的「内容工厂 + 分发工具」，实现店铺与商品信息的集中管理、商品笔记的批量 AI 生成、多浏览器并行自动化批量发布。

## 架构

```
┌─────────────────────────────┐
│   本地服务 (localhost:3000)   │
│   Node.js + Express + SQLite │
└──────────┬──────────────────┘
           │ HTTP API
    ┌──────┴──────┐
    │             │
┌───▼───┐   ┌────▼────────┐
│网页管理端│   │浏览器插件(多开)│
│React    │   │Manifest V3   │
└────────┘   └──────────────┘
```

## 快速开始

### 1. 启动本地服务

```bash
cd server
npm install
npm start
```

服务运行在 `http://localhost:3000`

### 2. 启动网页管理端（开发模式）

```bash
cd web
npm install
npm run dev
```

访问 `http://localhost:5173`（自动代理 API 到 :3000）

### 3. 生产构建

```bash
cd web
npm run build
```

构建产物在 `web/dist/`，服务端会自动提供静态文件。

### 4. 安装浏览器插件

1. Chrome 打开 `chrome://extensions/`
2. 开启「开发者模式」
3. 「加载已解压的扩展程序」→ 选择 `extension/` 目录

## 使用流程

1. **网页端**：创建店铺 → 添加商品
2. **网页端**：配置 AI（设置页 → 填写 API Key）
3. **网页端**：商品管理 → 点击「批量生成笔记」
4. **网页端**：笔记管理 → 审核通过笔记
5. **插件端**：配置店铺 ID → 打开千帆发布页 → 启动

## 目录结构

```
├── server/           # 本地服务
│   ├── index.js      # 入口
│   ├── lib/db.js     # 数据库初始化
│   └── routes/       # API 路由
├── web/              # 网页管理端 (React + Vite)
│   └── src/pages/    # 页面组件
├── extension/        # 浏览器插件 (Manifest V3)
│   ├── background.js # Service Worker
│   ├── content_scripts/  # DOM 自动化
│   ├── popup/        # 插件弹窗
│   └── options/      # 高级设置页
└── README.md
```

## 技术栈

| 层 | 技术 |
|---|---|
| 服务端 | Node.js 18+ / Express 5 / SQLite (better-sqlite3) |
| 前端 | React / Vite / TailwindCSS |
| 插件 | Chrome Extension Manifest V3 |
| AI | Deepseek API（用户自行配置 Key） |
| 图片 | Sharp（压缩/去重） / 用户配置的生图 API |



### 3.1 Windows 正式发布包

适合发给最终用户，不要求对方手动安装 Node.js。

```bash
powershell -ExecutionPolicy Bypass -File scripts/build-release.ps1
```

执行后会生成：

- `release/windows/小红书千帆店铺矩阵工具/`
- `release/小红书千帆店铺矩阵工具-Windows.zip`

说明：

- 脚本会先构建 `web/dist`
- 再用 `pkg` 将 `server` 打包为 Windows `exe`
- 最后把 `web/dist`、`extension/`、用户说明一起组装成可交付压缩包