# 萌喵写作网 · 铸渊交接文档 · 全量代码+部署+阶段总览 · 2026-06-06

```jsx
HLDP://feimao/mengmiao/handover/zhuyuan · 2026-06-06
├── what: 萌喵写作网全量交接文档 · 给铸渊编译器
├── author: 舒舒 · PER-SS001 · 肥猫爸爸的宝宝
├── audience: 铸渊 · 执行层编译器人格体
├── status: 前端已部署运行 · 后端未开始
└── ⊢ 读完本文档 = 可以立刻上手继续开发
```

---

## 🖥️ 服务器信息

| 项目 | 详情 |
| --- | --- |
| IP | 43.133.36.90 |
| 域名 | [guanghu.site](http://guanghu.site)（待 DNS 生效） |
| 地域 | 新加坡 · 腾讯云 |
| OS | Ubuntu · 2GB RAM · 50GB 磁盘（已用 8.3G） |
| Node.js | v20.20.2 |
| PM2 进程 | feimao-platform (3002) · shushu-chat (3333) · shushu-memory |
| Nginx | 80 端口双站点分流（按 server_name） |
| PostgreSQL | [localhost:5432](http://localhost:5432) · 已安装 · 未建表 |
| 项目路径 | /home/ubuntu/feimao-platform/src/app/ |

---

## 📁 代码文件清单 · 服务器上的实际情况

<aside>
⚠️

**重要**：服务器上存在两套代码的混合。2026-05-31 重设计覆盖了 Phase 2 的部分文件，但旧文件可能残留。
铸渊接手后建议先 `ls -la /home/ubuntu/feimao-platform/src/app/` 查看实际文件结构，清理冗余。

</aside>

### 当前生效的文件（2026-05-31 重设计版 + 2026-06-03 修复）

```
/home/ubuntu/feimao-platform/
├── package.json
├── next.config.ts
├── tailwind.config.ts          ← Tailwind v4 @import 方式（无 v3 config 冲突）
│
└── src/app/
    ├── globals.css              ← 光湖设计系统 CSS 变量（已修复 v4 兼容）
    ├── layout.tsx               ← 根布局（Inter + Noto Sans SC 字体）
    ├── page.tsx                 ← 🔐 邀请码门禁页（入口）
    │
    ├── onboarding/
    │   └── page.tsx             ← 🌊 人格体引导页（3步创建流程）
    │
    ├── app/
    │   ├── layout.tsx           ← 💬 主应用框架（左侧 70px 图标栏）
    │   ├── page.tsx             ← 主应用首页·对话界面
    │   ├── learn/page.tsx       ← 📚 学习模块
    │   ├── write/page.tsx       ← ✍️ 写作模块
    │   ├── script/page.tsx      ← 🎬 剧本模块
    │   ├── create/page.tsx      ← 💡 创意模块
    │   ├── forum/page.tsx       ← 💬 论坛模块
    │   └── works/page.tsx       ← 📁 作品库
    │
    └── components/
        └── ModuleChat.tsx       ← 共享对话组件（5个模块复用）
```

### 旧代码残留（可能需要清理）

```
可能仍存在:
├── home/page.tsx               ← Phase 2 旧主页（已被新路由替代）
├── login/page.tsx               ← Phase 2 旧登录页（已融合进 onboarding）
├── register/page.tsx            ← Phase 2 旧注册页（已融合进 onboarding）
├── chat/page.tsx                ← Phase 1 旧对话页
├── dashboard/page.tsx           ← Phase 1 旧工作台
└── admin/                       ← 管理后台代码（未部署·代码在 Notion 备用区）
    ├── layout.tsx
    ├── page.tsx
    └── codes/page.tsx
```

---

## 🗺️ 路由结构 · 当前线上实际路由

| 路由 | 功能 | 状态 |
| --- | --- | --- |
| / | 🔐 邀请码门禁页 | ✅ 运行中 |
| /onboarding | 🌊 人格体引导页（3步：欢迎→创建→诞生） | ✅ 运行中 |
| /app | 💬 主应用·对话首页 | ✅ 运行中 |
| /app/learn | 📚 学习模块 | ✅ 运行中 |
| /app/write | ✍️ 写作模块 | ✅ 运行中 |
| /app/script | 🎬 剧本模块 | ✅ 运行中 |
| /app/create | 💡 创意模块 | ✅ 运行中 |
| /app/forum | 💬 论坛模块 | ✅ 运行中 |
| /app/works | 📁 作品库 | ✅ 运行中 |
| /admin | 📊 管理后台 | ⏳ 代码已写·未部署 |

---

## 🎨 设计语言 · 已实现

```css
/* 光湖设计系统 CSS 变量（globals.css） */
--bg-deep: #0a0a14
--bg-primary: #0f0f1a
--bg-card: #1a1a2e
--bg-hover: #252540
--border: #2d2d4a
--border-active: rgba(126,207,255,0.4)
--text-primary: #e2e8f0
--text-muted: #94a3b8
--accent: #6366f1
--accent-light: #a5b4fc
--glow: rgba(99,102,241,0.15)
--success: #10b981
--danger: #ef4444
```

- 深色渐变背景：`radial-gradient(ellipse at center, #1a1a3e 0%, #0f0f1a 70%)`
- 卡片：半透明底 + 1px 发光边框 + 圆角 16-20px
- 按钮：渐变 accent 色 + hover 上浮阴影
- 输入框：深色底 + 聚焦发光边框
- 动效：fadeInUp / fadeIn / particleRise
- 字体：Inter + Noto Sans SC

---

## 🔧 技术栈

| 层级 | 技术 |
| --- | --- |
| 框架 | Next.js 14 (App Router) |
| 样式 | Tailwind CSS v4 + CSS 自定义变量 |
| 语言 | TypeScript |
| 渲染 | 客户端组件（"use client"）· localStorage 做临时状态 |
| 部署 | PM2 + Nginx 反向代理 |
| 数据库 | PostgreSQL（已安装·未使用） |
| 动效 | 纯 CSS animation（未引入 Framer Motion） |

---

## ✅ 已完成 vs ⏳ 待完成

### ✅ 已完成

| 项目 | 说明 |
| --- | --- |
| Next.js 地基 | Phase 1 · 2026-05-23 搭建 |
| Nginx + PM2 | 双站点 80 端口分流 |
| PostgreSQL 安装 | 已装·未建表 |
| 邀请码门禁页 | 前端完整·后端验证是 `setTimeout` 模拟 |
| 人格体引导页 | 三步流程·偏好选择·随机人格体名生成 |
| 主应用框架 | 左侧 70px 图标栏·五模块导航·用户头像入口 |
| 对话界面 | 气泡样式·输入框·模拟回复 |
| 5个模块页面 | 共享 ModuleChat 组件·各有开场白 |
| 作品库页面 | 左侧列表+右侧详情·空状态引导 |
| 光湖设计系统 | CSS 变量+全局样式+动效 |
| TS 编译 | tsc --noEmit 零错误（2026-06-03 修复） |
| 构建 | npm run build 14/14 页编译成功 |
| PM2 运行 | feimao-platform online |

### ⏳ 待完成（铸渊接手）

<aside>
🔧

**P0 · 必须最先做**

</aside>

| 任务 | 说明 |
| --- | --- |
| PostgreSQL 建表 | 用户表 + 邀请码表 + 作品表 |
| 后端 API 搭建 | FastAPI 或 Node.js Express · 放在新目录 |
| 邀请码验证 | 替换门禁页的 `setTimeout` 模拟 → 真实 DB 查询 |
| 注册/登录 | 替换 localStorage 模拟 → JWT + bcrypt |
| 管理后台部署 | 代码在 Notion「Phase 2 · 前端页面代码」页底部备用区 |

<aside>
📌

**P1 · 核心体验**

</aside>

| 任务 | 说明 |
| --- | --- |
| 人格体对话接入 AI | 替换所有 ModuleChat 的模拟回复 → 真实 AI API |
| 对话历史持久化 | 当前刷新即丢失（localStorage 无对话存储） |
| 作品库 CRUD | 新建作品·导入文档（doc/txt 分章解析） |
| 字数额度系统 | 邀请码 50万字额度·已用/剩余追踪 |

<aside>
💡

**P2 · 功能模块**

</aside>

| 任务 | 说明 |
| --- | --- |
| 写作模块 | 码字编辑器 + AI 辅助续写 |
| 学习模块 | 拆书分析（按章数递增维度） |
| 创意模块 | 五大作坊（大纲/书名/简介/世界观/取名） |
| 剧本模块 | 剧本创作 + 格式输出 |
| 论坛模块 | 社区发帖·积分体系 |

---

## 📄 关键参考文档（Notion 页面）

<aside>
📖

**铸渊必须先读这些页面**

</aside>

- **产品需求文档 v2.0**：完整功能设计·五大模块·管理后台·开发优先级
- **HLDP 重设计文档**：设计语言·用户旅程·路由结构·色彩/动效规范
- **全站重设计 · 终端粘贴执行版**：服务器上所有代码的原始来源
- **Phase 2 前端页面代码**：旧版代码 + 管理后台备用代码
- **2026-06-03 交互记录**：最新修复记录（TS 编译错误 + Tailwind v4 冲突）
- **2026-05-27 交互记录**：Phase 2 执行记录·服务器现状·踩坑
- **Phase 1 地基搭建记录**：初始环境搭建详情
- **Phase 1 网页搭建记录**：v1/v2/v3 三代首页迭代历史

---

## ⚠️ 已知踩坑

1. **Tailwind v3/v4 冲突**：v3 用 tailwind.config.ts + `@tailwind base`，v4 用 `@import "tailwindcss"` + CSS 变量。混用导致样式全丢。当前用 v4 方式。
2. **TSX `.map()` 闭合**：heredoc 粘贴时 `)))}` 被写成 `))))}` 导致编译失败。sed 修复过，下次写新代码注意。
3. **端口占用**：3001 被残留进程占用 → 改用 3002
4. **Nginx IP 分流**：IP `43.133.36.90` 在 shushu 和 feimao-platform 之间只属于一个 server block
5. **目录权限**：`/opt/guanghu/modules/` 归 root，改用 `/home/ubuntu/`
6. **Notion 花括号吞没**：`style=`  在 Notion 页面里显示异常 → 代码用 `style=` 字符串写法

---

## 🔐 当前认证状态

<aside>
🚨

**没有任何真实认证**。当前所有"登录/注册"效果都是 localStorage 模拟。
邀请码验证是 `setTimeout(800)` 假延迟。任何人都能进入 /app。
这是铸渊接手后的 P0 第一件事。

</aside>

---

## 🚀 快速重启命令

```bash
# SSH 进新加坡服务器
ssh ubuntu@43.133.36.90

# 进入项目
cd /home/ubuntu/feimao-platform

# 构建 + 重启
npm run build && pm2 restart feimao-platform

# 查看状态
pm2 status
pm2 logs feimao-platform

# 验证
curl http://localhost:3002
```

---

```jsx
HLDP://handover/complete
├── 文档版本: v1.0 · 2026-06-06
├── 编写: 舒舒 · PER-SS001
├── 审核: 肥猫爸爸
├── 交付: 铸渊编译器
└── ⊢ 前端已完整 · 后端从零开始 · 设计文档齐全 · 可以立刻动手
```