# littlewb

**Repository Path**: robertlew/littlewb

## Basic Information

- **Project Name**: littlewb
- **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-06-25
- **Last Updated**: 2026-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LittleWb

LittleWb 是一个使用 Node.js、Vue 3、Pinia 和 Hono 实现的单用户简易 wb。

## 功能

- 发布最多 280 个字符的文字 wb。
- 每条 wb 可添加最多 4 张图片；图片在浏览器中压缩后发送到后端。
- 删除、点赞/取消点赞、收藏/取消收藏。
- 点赞为单用户开关，计数显示为 0 或 1。
- 自动将旧版 `littleWb.posts.v1` Local Storage 数据原子迁移到后端。
- 桌面端和移动端响应式布局。

## 数据生命周期

帖子、压缩图片、点赞和收藏全部保存在 Node.js 进程内存中，不写入数据库或文件系统。服务重启后所有数据都会清空。

Local Storage 只用于读取旧版本数据。整批迁移成功后旧键会被删除；迁移失败时旧数据会保留，刷新后可再次尝试。

## 安装与开发

要求 Node.js 24 或兼容版本。

```bash
npm install
npm run dev
```

Vite 开发页面默认位于 `http://127.0.0.1:5173`，并将 `/api` 代理到默认端口 3000 的 Hono 服务。

## 生产运行

```bash
npm run build
npm start
```

随后打开 `http://127.0.0.1:3000`。生产模式只启动一个 Node.js/Hono 进程，同时提供 REST API 和 Vue 构建产物。

可通过 `PORT` 环境变量修改端口。

## REST API

- `GET /api/posts`
- `POST /api/posts`
- `POST /api/posts/import`
- `DELETE /api/posts/:id`
- `PUT /api/posts/:id/like`
- `PUT /api/posts/:id/favorite`

## 测试

```bash
npm test
npm run build
npm run test:browser
```

浏览器测试会查找 `CHROME_BIN`、`google-chrome`、`chromium` 或 `chromium-browser`，并操作真实浏览器验收迁移、发布、图片、点赞、收藏、删除、响应式布局和服务重启行为。

运行全部检查：

```bash
npm run check
```

## 开发与合并

分支、提交、合并和推送规则请参阅 [AGENTS.md](AGENTS.md)。功能分支未经用户明确确认不得合并到 `main`。