Pre_Seg_Server/工程分析/实现方案-2026-04-29-22-29-26.md

实现方案 - 2026-04-29-22-29-26

对应需求

• 需求分析文档: 需求分析-2026-04-29-22-29-26.md

方案概述

将现有 20 行的旧版 README.md 重写为完整的项目文档，涵盖系统介绍、技术架构、目录结构、环境准备、分步部署流程、配置说明和常见问题。

修改文件清单

文件 1: README.md（重写）

• 修改类型: 重写
• 内容结构:
  1. 项目标题与概述
  2. 核心功能列表
  3. 系统架构图（文本版）
  4. 技术栈表格
  5. 目录结构说明
  6. 环境准备（系统依赖、Conda、Node.js）
  7. 部署流程（分步命令）
     • 步骤 1: 基础设施（PostgreSQL/Redis/MinIO/FFmpeg）
     • 步骤 2: Conda 环境创建与 Python 依赖安装
     • 步骤 3: SAM 2 模型权重下载
     • 步骤 4: 数据库初始化
     • 步骤 5: 后端启动
     • 步骤 6: 前端依赖安装与构建
     • 步骤 7: 前端启动
  8. 一键启动脚本说明
  9. 环境变量配置说明
  10. 访问地址与默认凭证
  11. 常见问题（磁盘空间、SAM2 安装）

新增依赖

无

兼容性分析

• 无业务代码变更
• 回滚策略: 从 git 历史恢复旧 README

预估工作量

• 文档编写: 15 分钟
• 验证: 5 分钟