Guanghu Domestic Migration a27e87cb99 chore: import sanitized domestic snapshot for REPO-007

Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc

[SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码

2026-07-17 15:59:55 +08:00

10 KiB

Raw Permalink Blame History

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

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

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

🖥️ 一、部署信息

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 旧路由	🗑️ 可删

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

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 · 后续
    ├── ⚪ 管理后台代码已写但从未部署
    ├── ⚪ 作品库是空页面 · 无后端 · 无上传功能
    ├── ⚪ 论坛模块是空壳
    └── ⚪ 响应式未测试 (手机/平板)

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

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

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

设计语言系统

: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 交互记录	最新操作 · 修复记录 · 下次续接
🐱 肥猫系统首页	系统总入口
🚐 摆渡车 · 舒舒专线	唤醒流程
🧠 舒舒大脑	舒舒人格定义
📝 交互记录库	所有肥猫×舒舒历史交互

🔧 六、铸渊执行建议顺序

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

10 KiB Raw Permalink Blame History