Commit Graph

25 Commits

Author SHA1 Message Date
wonder e8abc41c2a docs: 优化 README 与文档索引结构
- README 新增目录导航、参考链接、路线图、文档索引模块
- README 采用居中标题、Badge 行、快速链接栏的顶级开源项目风格
- 技术栈表增加说明列,项目结构细化各模块用途
- API 已实现/规划中拆分展示,合并近期新增接口
- docs/_index 新增 ASCII 系统架构图、核心概念概览、命令行参考
2026-05-25 20:48:50 +08:00
wonder 5100a52bca fix: 七牛云私有 bucket 下载 URL 签名支持
对私有读 bucket,通过 HMAC-SHA1 签名生成带 e(过期时间)和 token(下载凭证)
参数的临时下载 URL,前端获取的素材 URL 和下载接口均返回签名 URL。

新增配置项 GEN2D_QINIU_URL_EXPIRE,默认 3600 秒。
2026-05-25 19:05:55 +08:00
wonder 0847d126a2 fix: 任务创建后直接进入 running 状态,避免前端显示排队中
- 移除任务初始状态 pending,改为直接创建为 running
- 初始进度设为 5%,stage 设为 prompt_builder
- 更新文档以反映实际执行流程(无队列机制)
- 修复前端轮询时因竞态条件显示排队中的问题
2026-05-25 18:16:21 +08:00
wonder 8d98472a05 docs: 修正工程管理文档中的认证方式说明
从 Cookie 携带 Token 修正为 Authorization Bearer header,与实际实现一致。
2026-05-25 16:58:19 +08:00
wonder 6a87cbe23f docs: 更新 API 文档反映实现状态
- 标记工程管理相关接口为已完成
- 标记工程风格接口为已完成
2026-05-25 16:40:59 +08:00
wonder a603f5548c refactor: 前端重构为项目+任务双核心模型
- 新增 HomePage 项目画廊页,支持新建/删除工程
- 新增 ProjectDetailPage 三栏工作台(配置+生成+任务列表)
- 新增 CustomTagsEditor 支持自定义风格标签(custom: 前缀存入 kvPairs)
- 重构 project store 为 draft/commit 模式,支持手动保存/取消
- 新增 projectList store 管理工程列表
- 扩展 mock.ts 为多工程数据结构
- 扩展 api/project.ts 新增项目 CRUD API(mock-gated)
- 简化 ResultPage,仅展示素材预览
- 删除 GeneratePage、ProjectPage 及未使用的 hooks
- 更新 docs/ 文档(frontend.md、api.md、style-keys.md、_index.md)
2026-05-25 16:15:31 +08:00
wonder 2f8e7ead17 fix: 修复前端无法加载七牛云图片的问题
1. 修复 buildURL 中 url.PathEscape 对路径分隔符 / 的错误编码(/→%2F),
   改为逐段编码后拼接
2. AssetResponse 新增 key 字段,返回七牛云对象存储 Key
3. 前端改用 /api/v1/assets/download 接口加载图片,通过后端 302 重定向
   访问 CDN,避免浏览器直接访问 CDN 可能出现的跨域或编码问题
4. 更新 api.md 文档,补充 key 字段说明和 download 接口公开属性
2026-05-25 15:25:40 +08:00
wonder cc8310860b Merge branch 'develop' of gitee.com:hezhaohui123/gen2d into feat/async-generate-pipeline
Signed-off-by: 何朝晖 <hezhaohui0807@163.com>
2026-05-25 06:38:14 +00:00
wonder 2471f97066 docs: 更新后端文档,补充日志系统说明 2026-05-25 14:31:09 +08:00
Gmarker689 ecb74a2aed feat: 异步生成管线 + 前端轮询 + 图片编辑 + JWT 中间件
后端:
- 异步生成: POST /api/v1/generate 立即返回 taskId,后台执行管线
- 任务轮询: GET /api/v1/tasks/:id + GET /api/v1/tasks/:id/assets
- 图片保存: 生成图片写入 ../generation/{projectId}/{taskId}/,静态服务
- 图片编辑: POST /api/v1/images/edit (multipart/form-data)
- JWT 中间件: mildware/auth.go 保护生成/编辑端点
- config.yml 清空敏感默认值,交由 .env 控制
- ImageGenConfig 新增 Quality 字段

前端:
- api/generate.ts: 对接真实 API (submitGenerate + poll getTask/getAssets)
- api/types.ts: 新增 GenerateResponse, AssetsResponse, Task 类型
- stores/generation.ts: 异步提交→轮询进度→获取素材→完成
- stores/task.ts: 默认分辨率 256→1024
- GenerateForm: 分辨率范围 1024-1536
- GeneratePage: 显示状态文本,完成后可查看结果/继续生成
- ResultPage: 从 store 读取,下载功能实现
2026-05-25 14:08:08 +08:00
wonder 83d3d2663d feat: 接入七牛云存储,替换本地文件存储
- generate handler 中的本地文件写入替换为 storageSvc.Upload() 调用
- 移除 main.go 中的本地 generation 目录创建和静态文件服务
- 更新 api.md 接口状态标记
2026-05-25 13:48:37 +08:00
wonder f61508a249 docs: 更新架构文档,文件存储切换为七牛云对象存储
- _index.md: 技术栈加入七牛云对象存储
- api.md: 新增素材下载接口,asset URL 改为 CDN URL
- backend.md: 分层结构新增 storage.go,FormatAdapter 职责增加上传
- database.md: 文件存储改为七牛云,配置表新增 GEN2D_QINIU_* 环境变量
2026-05-25 12:57:41 +08:00
wonder bc9c511ac3 docs(api): 同步 api.md 与后端实际行为
修正认证方式为 Bearer Token(非 Set-Cookie),修正端点路径
为 /auth/*,修正注册字段约束(email 可选、password 6-64、
username 3-32),补充登录响应完整字段。
2026-05-24 21:27:26 +08:00
Gmarker689 36a6465f26 docs: 更新 README 与 API 文档,描述提示词优化链路
- README 新增提示词优化链路章节(流程图 + 特性 + API 说明)
- docs/api.md 新增提示词优化接口文档与调用链路
- 更新架构描述:PromptBuilder → PromptOptimizer
2026-05-24 20:45:24 +08:00
wonder 6a88ec0d46 fix(deploy): 修复 Docker 部署两个问题
1. 后端 Dockerfile 开启 CGO(go-sqlite3 依赖),安装 gcc/musl-dev
2. nginx 添加 /auth/ 反向代理,修复注册登录 405 错误
2026-05-24 14:33:45 +08:00
wonder a2736f722c feat(frontend): 构建前端 MVP,实现完整 UI 框架与 mock 数据层
- 安装 zustand + react-router-dom 依赖
- 修复 Vite 代理配置,添加 /auth 路由转发
- 实现 API 封装层(client.ts 统一 fetch、auth.ts 真实调用)
- 实现 mock 数据层(mock.ts 模拟 WebSocket 管线进度)
- 实现 4 个 zustand stores(auth/project/task/generation)
- 实现 5 个组件(StyleSelector/PromptEditor/GenerateForm/ProgressBar/AssetPreview)
- 实现 5 个页面(Login/Register/Project/Generate/Result)
- 实现路由含 ProtectedRoute 守卫
- 添加暗色主题全局样式
- 更新前端文档与 API 文档
2026-05-24 14:18:39 +08:00
wonder cba24349cb docs: 更新 API 与后端文档,对齐已实现功能
- api.md: 标记 register/login 接口为已完成(handler + User model)
- backend.md: 分层结构标注已有文件,与实际代码对齐
2026-05-24 13:34:44 +08:00
wonder cbcda82515 docs: 适配单机场景,简化存储与认证方案
- 数据库:MySQL → SQLite,去掉连接池配置和 golang-migrate
- 文件存储:OSS 对象存储 → 本地文件系统,统一 Gin 静态文件服务
- ID 生成:Sonyflake → 前缀+随机字符串
- 认证:Bearer Token → httpOnly Cookie,WebSocket 同步改为 Cookie 认证
- 质检重试:PromptBuilder 重试时注入 RejectReason 改进提示词
- 合并 multi-agent-pipeline.md 到 backend.md,消除文档重复
- 移除缓存管理 API(暴露内部实现细节)
2026-05-24 10:56:40 +08:00
wonder f4c1a10403 docs: 交叉检查修复文档疏漏与不一致
- 修复 api.md 修改密码接口混入注册场景的 409 错误
- 补充 api.md WebSocket 示例缺失的 quality_supervisor running 消息
- 补充 api.md 注册接口格式校验错误响应、缓存接口详细说明
- 补充 frontend.md Task 接口缺失的 error 字段
- 补充 frontend.md 错误处理章节(API 错误、WebSocket 断连、加载状态)
- frontend.md 风格键表改为引用 style-keys.md,消除重复
- async-tasks.md 去重/文件存储改为引用 database.md,消除重复
- backend.md ER 图改为引用 database.md,消除重复
- 补充 backend.md 目录结构中缺失的 auth/project handler 和 user model
- 补充 backend.md 缓存层设计说明
- 补充 database.md GEN2D_SERVER_PORT 环境变量和迁移文件归属说明
- 补充 multi-agent-pipeline.md 到 backend.md 和 async-tasks.md 的交叉引用
- 补充 async-tasks.md 超时控制说明
2026-05-24 10:47:00 +08:00
wonder 5a6bcaffaf docs: 新增用户认证、OSS 存储、异步任务设计
- database.md: 新增 user 表,project 关联 user_id,恢复 OSS 对象存储,
  移除 60 分钟文件过期,新增 JWT/OSS 环境变量配置
- api.md: 新增认证章节和错误码表,补充用户注册/登录/修改密码接口,
  工程管理新增列表/详情/删除接口,各接口补充错误响应说明
- async-tasks.md: 完善任务队列设计、Worker 流程、并发控制、管线进度、
  质检重试与任务级重试策略、进度推送方式
2026-05-24 10:38:31 +08:00
wonder 172914c7f2 docs: 后端采用 Eino 框架编排管线,完善前后端文档对齐
- 后端管线从手写编排改为 Eino compose.Graph,含质检重试分支
- 移除 CORS 中间件
- api.md 补充工程管理接口、任务状态机、管线阶段、WebSocket 消息示例
- frontend.md 组件树和交互流程改用 mermaid 图,stores 对齐 PipelineInput/Output
- CLAUDE.md 修复死链,技术栈补充 Eino
2026-05-24 10:22:15 +08:00
wonder 4f3598c521 docs: 拆分架构设计文档为多篇专项文档 2026-05-23 18:49:50 +08:00
Gmarker689 f21f25c4bf docs: 修改架构设计文档 2026-05-23 16:37:01 +08:00
Gmarker689 693af03ba4 docs: 新增架构设计文档 2026-05-23 13:22:39 +08:00
wonder e4a5f8059a docs: 新增接口文档 /health 2026-05-23 12:19:53 +08:00