# 局域网书房

一个部署在局域网环境里的内部网站，当前包含三块核心能力：

1. 局域网聊天室
2. 小说书架与阅读器
3. OpenClaw Agent 观察室

## 当前技术栈

- Next.js 15
- React 19
- TypeScript
- SQLite
- 本地文件上传目录

## 当前功能

### 1. 局域网聊天室

- 支持文字消息
- 支持图片和文件上传
- 支持聊天记录持久化
- 支持清理服务器历史聊天记录
- 支持局域网内设备在线状态显示

### 2. 小说书架与阅读器

- 书架页
- 阅读页
- 字号、主题、版心切换
- 桌面端与移动端阅读适配

### 3. Agent 观察室

- 展示 OpenClaw agent 当前任务
- 展示心跳、队列、今日完成数
- 支持从本地 JSON 数据源读取真实状态
- 没有真实数据时回退到演示数据

## 本地启动

安装依赖：

```bash
npm install
```

开发模式：

```bash
npm run dev
```

生产构建：

```bash
npm run build
```

生产启动：

```bash
npm run start -- --hostname 0.0.0.0 --port 3000
```

## 重要目录

```text
storage/chat.sqlite
storage/chat-uploads/
storage/agents/openclaw-agents.json
```

## 重要文档

- `docs/macbook-deployment.md`
- `docs/openclaw-ops-runbook.md`
- `docs/openclaw-agent-feed.md`
- `docs/openclaw-handoff.md`

## 说明

这个项目当前面向局域网部署场景，推荐部署到一台 MacBook 上，并由 OpenClaw 的 ops 运维专员负责日常维护。