loser/st
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0f9c9c9b9cd31a19a8af18aa0114376b132df0dc
st/docs/重构进度管理.md

7.4 KiB
Raw Blame History

云酒馆项目进度管理

项目定位：面向普通用户的类酒馆 AI 角色对话平台 核心理念：让不懂代码的用户也能轻松导入角色卡、配置 AI、与角色对话 技术栈：Go (Gin + GORM) + Vue 3 (Element Plus) + PostgreSQL 开始日期：2026-02-10 当前状态：阶段四 AI 对话核心功能已完成 P0

📊 总体进度

阶段 进度 状态
一、基础设施 100% 🟢 已完成
二、用户系统 100% 🟢 已完成
三、角色卡管理 100% 🟢 已完成
四、AI 接入与对话（核心） 80% 🟡 P0 已完成
五、用户体验优化 0% ⚪ 未开始
六、部署上线 0% ⚪ 未开始

🎯 普通用户最小功能集

一个普通用户打开这个平台，最基本的使用流程：

注册/登录 → 浏览角色广场 → 选择/导入角色卡 → 配置 AI 接口 → 开始对话

必须有（MVP）

功能 说明 后端 前端
注册/登录 邮箱注册 ✅ 已完成 ✅ 已完成
角色广场 浏览公开角色卡 ✅ 已完成 ✅ 已完成
导入角色卡 支持 PNG 卡片和 JSON ✅ 已完成 ✅ 已完成
创建角色卡 简易表单创建 ✅ 已完成 ✅ 已完成
配置 AI 接口 填 API Key + 选模型 ✅ 已完成 ✅ 已完成
AI 对话 与角色卡聊天（SSE 流式） ✅ 已完成 ✅ 已完成
对话记录 查看历史、多轮对话 ✅ 已完成 ✅ 已完成

第二优先级

功能 说明 后端 前端
世界书 角色背景设定增强 ✅ 已完成 ✅ 已完成
预设管理 AI 参数预设（温度等） 🔸 模型已有 ❌ 待开发
收藏角色 收藏喜欢的角色 🔸 模型已有 ❌ 待开发
消息重新生成 不满意可重新生成回复 ✅ 后端已有 ❌ 待开发
消息编辑 编辑已发送的消息 ✅ 后端已有 ❌ 待开发

后续增强（不急）

功能 说明 状态
正则脚本 高级文本处理 ✅ 已完成（保留）
扩展系统 SillyTavern 扩展兼容 ✅ 已完成（保留）
群聊 多角色群聊 模型已有
向量记忆 长期记忆增强 模型已有
数据导入导出 从原版酒馆迁移数据 未开始

🟢 阶段一：基础设施（已完成）

  • 数据库设计：13张核心表（用户、角色卡、对话、消息、世界书、扩展等）
  • Go 后端框架搭建：GVA 框架 + 分层架构
  • Vue 3 前端项目初始化：Element Plus + UnoCSS + TypeScript
  • JWT 认证中间件
  • CORS 跨域配置
  • Swagger API 文档

🟢 阶段二：用户系统（已完成）

  • 用户注册/登录/登出
  • Token 刷新机制
  • 用户信息获取与更新
  • 密码修改
  • 前端登录/注册页面

🟢 阶段三：角色卡管理（已完成）

  • 角色卡 CRUD（创建、编辑、删除）
  • PNG 卡片导入（SillyTavern V1/V2 格式）
  • JSON 格式导入导出
  • 公开/私密切换
  • 角色广场（公开角色列表 + 搜索排序）
  • 我的角色卡列表
  • 角色详情页

🟡 阶段四：AI 接入与对话（核心 — P0 已完成）

这是整个平台最核心的功能。P0 核心功能已全部实现。

4.1 AI 提供商配置 ✅

  • T4.1.1 后端：AI 提供商管理 API

    • 提供商 CRUD（OpenAI/兼容、Claude、Gemini、自定义）
    • API Key 加密存储（XOR 混淆）
    • 模型管理（预设常见模型 + 自定义添加，支持 chat/image_gen 类型）
    • 连通性测试接口（OpenAI /models、Claude /messages、Gemini /models）
    • 设为默认提供商
    • 文件：server/service/app/provider.go、server/api/v1/app/provider.go、server/router/app/provider.go

  • T4.1.2 前端：AI 配置页面

    • 可视化平台选择器（OpenAI/Claude/Gemini/自定义 四选一）
    • 简洁配置表单：选平台 → 填 Key → 填地址 → 测试连接
    • 模型卡片管理（预设快捷添加 + 手动添加）
    • 提供商卡片列表展示
    • 文件：web-app-vue/src/views/provider/ProviderList.vue、ProviderDialog.vue、ModelDialog.vue

4.2 对话核心功能 ✅

  • T4.2.1 后端：对话管理 API

    • 创建对话（选角色卡 → 自动发送首条消息）
    • 对话列表（按最近活跃排序，含最后一条消息预览）
    • 对话详情（加载全部历史消息）
    • 删除对话
    • 文件：server/service/app/chat.go、server/api/v1/app/chat.go、server/router/app/chat.go

  • T4.2.2 后端：消息发送与 AI 回复

    • 统一多提供商 AI 客户端（OpenAI/Claude/Gemini）
    • SSE 流式响应（基于 Go channel）
    • Prompt 构建（系统提示 + 角色卡描述/性格/场景/示例消息 + 历史消息）
    • Token 计数记录
    • 文件：server/service/app/ai_client.go

  • T4.2.3 后端：消息操作

    • 消息编辑 API
    • 消息删除 API
    • 重新生成（Regenerate）后端接口已准备
    • 文件：同 chat.go

4.3 对话前端页面 ✅

  • T4.3.1 对话列表页

    • 角色头像 + 角色名 + 最后一条消息预览 + 时间
    • 新建对话入口（弹窗选角色卡）
    • 对话删除
    • 文件：web-app-vue/src/views/chat/ChatList.vue

  • T4.3.2 聊天界面

    • 消息气泡样式（用户蓝色/角色灰色）
    • 输入框 + 发送按钮（Enter 发送、Shift+Enter 换行）
    • SSE 流式打字效果（逐字显示 AI 回复）
    • 角色头像和名称
    • 加载历史消息 + 自动滚动到底部
    • 简单 Markdown 渲染（粗体、斜体、代码、换行）
    • 文件：web-app-vue/src/views/chat/ChatView.vue

  • T4.3.3 对话增强（P1，待开发）

    • 前端重新生成按钮
    • 前端消息编辑 UI
    • 复制消息
    • 清空对话

⚪ 阶段五：用户体验优化

  • 预设管理（"创意/平衡/精确"快捷预设）
  • 角色卡收藏
  • 移动端适配
  • 深色/浅色主题
  • 消息 Markdown 渲染
  • 头像上传

⚪ 阶段六：部署上线

  • Docker 容器化
  • Nginx 反向代理 + HTTPS
  • 数据库备份策略
  • 监控与日志

📦 已完成但暂不在主线的功能（代码保留）

功能 后端 前端 备注
世界书管理 ✅ ✅ 完整 CRUD + 条目管理
正则脚本 ✅ ✅ 完整正则验证和管理
扩展系统 ✅ ✅ 安装/启用/设置/资源管理
扩展运行时 ✅ ✅ SillyTavern 兼容层 + Shim
邮件插件 ✅ ✅ 邮件发送功能

📅 开发优先级

P0（必须，阻塞上线）：
  AI 提供商配置 → 对话功能 → 聊天界面 → Prompt 构建

P1（重要，上线后快速补充）：
  消息重新生成 → 消息编辑 → 预设管理 → 收藏功能

P2（后续增强）：
  群聊 → 向量记忆 → 数据迁移 → 扩展系统