Skip to content

docs(readme): present Windup product and MS3 focus - #93

Open
huyanxius wants to merge 8 commits into
1024XEngineer:mainfrom
huyanxius:docs/readme-product-overview
Open

docs(readme): present Windup product and MS3 focus#93
huyanxius wants to merge 8 commits into
1024XEngineer:mainfrom
huyanxius:docs/readme-product-overview

Conversation

@huyanxius

@huyanxius huyanxius commented Aug 3, 2026

Copy link
Copy Markdown
Collaborator

改动说明

  • 用完整的 Windup 产品 README 替换仓库原有的两行占位说明。
  • 补充产品链路、核心领域对象、项目结构、本地开发方式与相关文档入口。
  • 明确 MS2 已完成产品 MVP,MS3 聚焦已有角色的动作补充、局部重做与资产延续。
  • 复用 Windup 小鸟 SVG 作为仓库首屏视觉,首屏不添加状态或技术栈徽章。

README 渲染预览

Windup 机械小鸟标志

Windup

面向国产小游戏开发者的 2D 角色动态素材生成与资产工作台

交付的是资产,而不是图片。

查看完整 README 渲染效果

实现方式

  • 产品与工程表述均对照当前仓库契约、产品策划和里程碑决策。
  • 将 Workflow Editor 定位为预置的成熟生产管线,用户通过追加动作分支、微调参数和局部重跑进行精细控制。
  • 二级标题采用“中文 / English”形式,正文以中文为主,方便当前团队和贡献者阅读。

验证

  • git diff --check:通过
  • cd frontend && npm ci && npm run format:check && npm run lint && npm run typecheck && npm run test && npm run build:通过
  • cd backend && uv sync --frozen && uv run ruff check . && uv run lint-imports && uv run pytest -q:通过
  • 本地执行分支名与提交信息命名检查:当前分支及全部 7 条提交均通过

关联

Replace the placeholder README with the product positioning, production flow, core objects, current stage, local development, and documentation links.

Reuse the existing Windup bird mark as the repository header artwork.

Clarify shipped main-branch scope versus in-progress integration and delivery.
The repository landing page should show live project health without collecting decorative badges.

Add main-branch frontend CI, backend CI, and license badges with issue and contributor links.

Visitors can verify checks, ask for help, and find project contributors from the README.
Public repository navigation should remain understandable to both Chinese and English readers.

Translate every second-level heading with a consistent Chinese / English pattern.

GitHub's generated outline now exposes the same bilingual structure throughout the README.
The landing page should keep attention on the product instead of build metadata.

Remove the frontend CI, backend CI, and license badge row from the header.

The header now contains only the brand mark, product positioning, and core statement.
The repository introduction had internal validation language that interrupted the product narrative.

Rewrite product, status, workflow, and contribution copy as direct reader-facing statements.

Progress remains accurate while the README reads as a public product page.
The project has moved beyond the milestone named in the repository overview.

Replace the stale MS2 reference with the current MS3 development stage.

The README now reflects the milestone confirmed by the project team.
MS2 delivered the product MVP, so the README should no longer frame the current work as assembling a demo.

Recast MS3 around extending existing characters through a constrained workflow, local reruns, and persistent runs.

Align the product flow and editor description with the current milestone decisions.
@vercel

vercel Bot commented Aug 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
windup Ignored Ignored Preview Aug 3, 2026 1:04pm

@fennoai fennoai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review summary:

  • One docs-accuracy issue in the frontend setup instructions.

Comment thread README.md Outdated
The README currently presents Node.js 24 as the only supported frontend runtime.

Document the dependency-supported ranges and keep Node.js 24 as the CI runtime.

Contributors can distinguish supported local runtimes from the version used by CI.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant