# 萌喵写作网 · 铸渊交接文档 · 2026-06-06 · 舒舒整理

# 萌喵写作网 · 铸渊交接文档

```jsx
HLDP://handoff/mengmiao/to-zhuyuan · 2026-06-06T11:51+08:00
├── from: 舒舒 · PER-SS001 · 肥猫爸爸的宝宝
├── to: 铸渊编译器
├── purpose: 萌喵写作网全量现状交接 · 铸渊据此继续开发
└── status: 交接中
```

---

## 🖥️ 一、部署信息

```jsx
HLDP://deploy
├── 服务器: 腾讯云新加坡 · 43.133.36.90
├── 项目路径: /home/ubuntu/feimao-platform/
├── 源码路径: /home/ubuntu/feimao-platform/src/app/
├── 进程管理: PM2 · 进程名 feimao-platform
├── 域名:
│   ├── guanghu.site → 萌喵写作网主站 (Nginx → localhost:3002)
│   ├── guanghushushu.site → 舒舒对话页 (Nginx → localhost:3333)
│   └── dwcs.admin.kandzww.cn → 管理后台域名 (预留)
├── 数据库: PostgreSQL · localhost:5432
├── Nginx: 80端口双站点代理
├── 技术栈: Next.js 14 (App Router) + Tailwind CSS
└── PM2 进程列表:
    ├── feimao-platform · online
    ├── shushu-chat · online
    └── shushu-memory · online
```

---

## 📦 二、当前运行代码版本

**版本**: 全站重设计 v1 (2026-05-31)  

**状态**: ✅ 已部署上线 · 编译通过 (14/14 pages) · PM2 运行中  

**上次操作**: 2026-06-03 舒舒修复 5 个 TS 编译错误 → `npx tsc --noEmit` 零错误 → `npm run build` 成功 → PM2 restart

### 当前路由表与文件清单

| 路由 | 文件 | 状态 | 说明 |
| --- | --- | --- | --- |
| `/` | `page.tsx` | ✅ 运行中 | 邀请码门禁页 · 深色渐变背景 · 正方形卡片 · 光湖 Logo |
| `/onboarding` | `onboarding/page.tsx` | ✅ 运行中 | 人格体引导页 · 三步流程 (欢迎→注册+偏好→人格体诞生) |
| `/app` | `app/layout.tsx`  • `app/page.tsx` | ✅ 运行中 | 主应用框架 (左侧图标栏 70px) + 对话首页 |
| `/app/learn` | `app/learn/page.tsx` | ✅ 运行中 | 学习模块 · 共享 ModuleChat 组件 |
| `/app/write` | `app/write/page.tsx` | ✅ 运行中 | 写作模块 · 共享 ModuleChat 组件 |
| `/app/script` | `app/script/page.tsx` | ✅ 运行中 | 剧本模块 · 共享 ModuleChat 组件 |
| `/app/create` | `app/create/page.tsx` | ✅ 运行中 | 创意模块 · 共享 ModuleChat 组件 |
| `/app/forum` | `app/forum/page.tsx` | ✅ 运行中 | 论坛模块 · 共享 ModuleChat 组件 |
| `/app/works` | `app/works/page.tsx` | ✅ 运行中 | 作品库 (空状态·左右栏布局·额度显示) |
| — | `globals.css` | ✅ 运行中 | 光湖设计系统 CSS 变量 + 全局样式 |
| — | `layout.tsx` (根) | ✅ 运行中 | Inter + Noto Sans SC 字体引入 |
| — | `components/ModuleChat.tsx` | ✅ 运行中 | 共享对话组件 (消息气泡+输入框+发送) |

### 不在路由表里的旧文件 (已废弃但未删除)

| 文件 | 来源 | 状态 |
| --- | --- | --- |
| `/home/page.tsx` | Phase 2 旧主页 | 🗑️ 新路由替代 · 可删 |
| `/login/page.tsx` | Phase 2 旧登录页 | 🗑️ 融合进 onboarding · 可删 |
| `/register/page.tsx` | Phase 2 旧注册页 | 🗑️ 融合进 onboarding · 可删 |
| `/admin/*` | Phase 2 管理后台代码 | 📦 代码在页面底部备用区 · 未部署 · 未跑通 |
| `/chat/*` | Phase 1 旧路由 | 🗑️ 可删 |
| `/dashboard/*` | Phase 1 旧路由 | 🗑️ 可删 |

---

## 🔴 三、已知问题 (铸渊接手后优先修)

```jsx
HLDP://issues
├── P0 · 紧急
│   ├── 🔴 Tailwind v4 + v3 tailwind.config.ts 冲突
│   │   ├── 现象: 页面白底 · 所有样式丢失
│   │   ├── 原因: globals.css 用了 @import "tailwindcss" (v4语法) 但项目可能有 tailwind.config.ts (v3配置)
│   │   ├── 临时修复: 不知道上次怎么跑通的 · 可能是 npm run build 时恰好没触发冲突
│   │   └── 建议: 彻底迁到 Tailwind v4 (移除 tailwind.config.ts) 或统一回 v3
│   │
│   └── 🔴 与冰朔光湖短剧平台质感差距大
│       ├── 爸爸反馈: 打开页面感觉不像同一个团队做的
│       ├── 原因: 现有代码只是实现了布局骨架 · 设计语言没有真正落地
│       └── 建议: 参考 HLDP 重设计文档 §设计语言系统 · 逐像素对齐
│
├── P1 · 重要
│   ├── 🟡 所有 AI 回复都是硬编码占位文字
│   │   └── "收到～让我想想怎么帮你。（后端 API 接入后这里会变成真正的 AI 回复）"
│   ├── 🟡 邀请码验证是假的 (localStorage.setItem 直接放行)
│   ├── 🟡 登录/注册是假的 (localStorage 模拟 · 无后端校验)
│   ├── 🟡 人格体名随机选取 · 无后端持久化
│   └── 🟡 没有用户系统 · 没有数据库表 · 没有 API
│
└── P2 · 后续
    ├── ⚪ 管理后台代码已写但从未部署
    ├── ⚪ 作品库是空页面 · 无后端 · 无上传功能
    ├── ⚪ 论坛模块是空壳
    └── ⚪ 响应式未测试 (手机/平板)
```

---

## 📐 四、产品设计 (铸渊需要知道的所有产品决策)

### 设计文档来源 (按优先级)

1. **HLDP 重设计文档 ← 最终设计方向**
2. PRD v2.0 ← 功能清单和业务规则
3. 终端粘贴执行版 ← 当前实际代码

### 设计语言系统

```css
:root {
  --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;
}
```

### 爸爸的核心指令 (不可违背)

> 「不要依次从上到下排列模块」 → 左侧图标栏 + 主区域
> 

> 「核心是人格体偏向写作」 → 所有功能通过人格体对话驱动
> 

> 「参考豆包APP」 → 聊天框是核心交互入口
> 

> 「质感高级，不像草台班子」 → 深色光湖风格 · 克制 · 留白 · 动效精准
> 

### 五大功能模块

| 模块 | 路由 | 人格体开场白 | 详细设计 |
| --- | --- | --- | --- |
| 📚 学习 | /app/learn | 「想拆哪本书？上传文档或者告诉我书名，我们一起分析。」 | 拆书分析·章节结构·节奏·人物弧光 |
| ✍️ 写作 | /app/write | 「今天写什么？续写、新章还是大纲？」 | 码字编辑器·多风格·关联作品上下文 |
| 🎬 剧本 | /app/script | 「告诉我想写什么类型的剧本，我帮你搭框架。」 | 新建剧本·改编·场景格式 |
| 💡 创意 | /app/create | 「没灵感？来，我们脑暴一下～五大作坊随时待命。」 | 大纲/书名/简介/世界观/取名五大作坊 |
| 💬 论坛 | /app/forum | 「看看大家在聊什么，或者发你的经验赚积分。」 | 创意分享·心得·建议·积分机制 |

### 用户旅程

```
邀请码门禁 → 人格体引导(三步) → 主应用(左侧栏+对话)
                                      ├── 学习 📚
                                      ├── 写作 ✍️
                                      ├── 剧本 🎬
                                      ├── 创意 💡
                                      ├── 论坛 💬
                                      └── 作品库 📁
```

### 邀请码规则

- 管理后台生成 · 每码 50万字免费额度
- 超额需解锁积分
- 积分 = 论坛发有效经验
- 积分可打折换算人格体对话次数/额度

---

## 🗂️ 五、所有相关页面的 Notion 链接

| 页面 | 说明 |
| --- | --- |
| 🎨 HLDP 重设计文档 | 最终设计方向 · 铸渊必读 |
| 🖥️ 终端粘贴执行版 | 当前实际代码 (heredoc 格式) |
| 📋 PRD v2.0 | 功能清单 + 业务规则 + 优先级 |
| 🔧 Phase 2 交互记录 | 5/27 执行记录 · 服务器现状 |
| 🔧 6/3 交互记录 | 最新操作 · 修复记录 · 下次续接 |
| 🐱 肥猫系统首页 | 系统总入口 |
| 🚐 摆渡车 · 舒舒专线 | 唤醒流程 |
| 🧠 舒舒大脑 | 舒舒人格定义 |
| 📝 交互记录库 | 所有肥猫×舒舒历史交互 |

---

## 🔧 六、铸渊执行建议顺序

```jsx
HLDP://zhuyuan/todo

§1 · 修复基础设施 (先让页面正常显示)
├── 解决 Tailwind v4/v3 冲突 → 统一到一个版本
├── 确认所有页面样式正常渲染
├── 确认 npm run build 零错误
└── 确认 PM2 在线 · 所有路由可访问

§2 · 对齐设计语言 (爸爸要的质感)
├── 读 HLDP 重设计文档 §设计语言系统
├── 对比冰朔光湖短剧平台视觉
├── 调整颜色 · 间距 · 字体 · 动效 · 发光效果
└── 让爸爸看 · 确认质感达标

§3 · 后端基础 (让功能真正跑起来)
├── 设计 PostgreSQL 表: users · invite_codes · works · chapters
├── 搭建 API 路由 (Next.js API routes 或独立后端)
├── 邀请码验证接口 (对接管理后台生成)
├── 注册/登录接口 (JWT 或 session)
├── 人格体信息持久化
└── 字数额度追踪

§4 · 核心功能
├── 人格体对话接入 AI API (Kimi K2.5 / DeepSeek 等)
├── 作品库: 新建作品 + 章节目录
├── 文本导入: .doc/.docx/.txt 解析
├── 学习模块: 拆书分析功能
├── 写作模块: 码字编辑器 + AI辅助
└── 创意模块: 五大作坊

§5 · 管理后台
├── 部署 admin 页面 (代码已有 · 在备用区)
├── 对接后端 API
├── 兑换码管理: 生成 · 核销 · 返现
├── 用户管理: 列表 · 封禁 · 额度调整
└── 数据监控面板

§6 · 扩展
├── 论坛模块
├── 积分体系
├── 剧本模块
└── 响应式适配 (手机/平板)
```

---

## ⊢ 锁定

> **当前状态**: 前端骨架已全部部署运行 · 但只是骨架 · 没有后端 · 没有 AI · 没有数据库
> 

> **核心差距**: 设计语言未完全落地 → 需要铸渊先对齐光湖统一设计语言
> 

> **下一步**: §1 修复基础设施 → §2 对齐设计语言 → 让爸爸看 → 确认后继续
> 

---

*整理: 舒舒 · PER-SS001 · 2026-06-06 · 肥猫爸爸口述需求 · 舒舒从交互记录中提取*

*编码: HLDP-dual/v1*

*版权: 国作登字-2026-A-00037559*