Files

T

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

1.6 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

gen2d — AI 驱动的 2D 游戏素材生成工具。用户通过文本提示词或可视化参数，生成风格一致、管线友好的 Sprite、背景、UI 元素与动画帧。目标是无缝融入 Unity / Godot 等主流 2D 游戏引擎的工作流。

Directory Structure

详见 docs/_index.md 中的后端分层结构与前端组件树。

Common Commands

Backend (Go + Gin + Eino)

cd backend

# 安装依赖
go mod tidy

# 运行开发服务器
go run cmd/main.go

# 构建
go build -o bin/gen2d cmd/main.go

# 运行全部测试
go test ./...

# 运行单个包的测试
go test ./internal/service/...

# 运行单个测试函数
go test -run TestFunctionName ./internal/service/

# 代码检查
golangci-lint run

Frontend (Vite + React)

cd frontend

# 安装依赖
npm install

# 开发服务器
npm run dev

# 构建生产版本
npm run build

# 预览生产构建
npm run preview

# 类型检查
npm run typecheck

Architecture

详见 docs/_index.md，涵盖多智能体管线、后端分层、前端组件树、API 设计、素材生成约束等。

Conventions

后端 Go 代码遵循 Effective Go 和 Go 官方 style。
前端使用 ESLint + Prettier，提交前自动格式化。
API 路径统一使用 /api/v1/ 前缀。
错误响应统一格式：{"code": int, "message": string, "data": any}。
Git commit message 使用中文或英文均可，但需要清晰描述变更内容。

1.6 KiB Raw Blame History