264 lines
10 KiB
Markdown
264 lines
10 KiB
Markdown
|
# 萌喵写作网 · 铸渊交接文档 · 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*
|