deepdemos/ds-demos-showcase

20 stars 质量 59 趋势 30AGPL-3.0

展示deepseek及其他模型生成demo的网站

概览

: A public gallery for AI-generated web demos — every work ships with its first prompt, generation session logs, a version timeline, and a sandboxed live preview. Anyone can upload, including AI agents. 线上站点：https://deepdemos.top · API 根：/api/v1 · OpenAPI 文档：/docs · 机器可读入口：/llms.txt 「AI 网页 Demo」的展示站：把 AI 用一句话生成出来的网页作品收在一起，。它解决的是这么一件事：网上到处是 AI 生成的网页，但你看不到「AI 到底被怎么点单的」。这个站要求每个作品都附上**和** —— 于是「同一句话交给不同模型，答成什么样」变成可以横向比较的东西（作品库里的「提示词」视图 + 探索页的同题对比，就是为这个做的）。上传是开放的：注册用户能传，（匿名身份统一显示为 public，管理员后台放行）。线上站点 https://deepdemos.top 首屏实拍（1440×960，2026-09 本会话）。左侧是站点定位与统计，右侧是随机换池的精选作品预览。 /demos 实拍：顶部「常规 / 提示词」模式切换，标签 chip 上的数字是该标签的作品数，卡片底部是模型徽章与浏览/下载/评论计数。上传向导（四步：作品是什么 → 谁做的 → 说清楚 → 核对发布，带必填项进度条）：

README

DeepDemos Showcase

DeepDemos 展示站的完全重构：React 前端 + Go 后端。旧 Vue 3 + FastAPI 实现保留在 main 历史中。许可证：AGPL-3.0-only。协作规则见 AGENTS.md，开发/评审/合并门禁见 docs/development-workflow.md。

快速开始（前端 / Dev Room）

需要 Node 24.19+ 与 pnpm 11.21+。

pnpm --dir web install
pnpm --dir web dev

首页：
Dev Room（仅开发环境）：

后端

需要 Go 1.27.3+。

cd backend
go run ./cmd/api
# GET http://127.0.0.1:8080/healthz

检查

pnpm --dir web format:check
pnpm --dir web lint
pnpm --dir web typecheck
pnpm --dir web test
pnpm --dir web build
pnpm --dir web check:ui

node scripts/check-file-size.mjs

cd backend && go test ./...

开发门禁

每个 PR 必须关联 issue；CI 红或发现 bug 先建 issue，再修复。
每个 PR 必须独立 review，结果用 gh pr review 回复在 PR（普通 issue comment 不算）；review 必须晚于最新 commit，push 后重新 review；有潜在问题禁止合并。
不确定先 ask：需求/边界/选型/数据/安全等不确定问题先问用户，不要自行假设。
一个 PR 只做一类修改；修改 >500 行或 >20 文件会被 pr-guard 打回。
单文件 >500 行报告过耦合风险（警告），>800 行失败；完整流程见 docs/development-workflow.md。

api/                        OpenAPI 契约（下一步接入生成链）
backend/
  cmd/api/                  HTTP 入口
  internal/platform/        config / httpserver（后续加 db、auth、storage、jobs）
web/
  src/app/                  路由、Provider、布局
  src/components/ui/        控件库（页面唯一控件来源）
  src/dev-room/             Dev Room（站内 /dev-room，生产不注册）
  src/features/             业务功能（空）
  src/lib/                  基础库（QueryClient 等）
  src/routes/               页面
  src/styles/               全局样式
  scripts/check-ui-contract.mjs  ui-contract 检查
docs/development-workflow.md  开发 / 评审 / 合并门禁
scripts/check-file-size.mjs   单文件行数门禁
scripts/check-pr.mjs          PR issue / 类型 / 规模门禁
.github/pull_request_template.md PR 模板
.github/workflows/ci.yml      backend / frontend / ui-contract / file-size / pr-guard

控件与 Dev Room 约定

页面只能从 src/components/ui 取控件，禁止直接 import Ring UI；简单自定义样式用 Tailwind CSS 4，复杂样式可用 CSS Modules。
控件注册名格式为 /（如 button/primary）：同一种控件可以登记多种样式；注册名稳定、唯一、kebab-case，已在用的注册名不改名。
每个注册项在 components/ui/registry.tsx 中带 component（对应控件库导出）、中文 name、category 和 Dev Room 示例；分类由 controlCategories 统一维护。
Dev Room 支持分类筛选、分页（?category=input&page=2）以及浅色/暗色切换；页面文案使用中文。
每个注册项渲染 data-control-id=""，用户与 agent 用它精确指代控件；控件库导出的每个控件至少登记一种样式。
Dev Room 外的控件必须接线；pnpm --dir web check:ui 在 CI 中强制组件/注册项/分类/注册名/接线规则。

技术栈（已定）

层	选型
前端	React 18.3 + TypeScript 6.0 + Vite 8 + React Router 7 + TanStack Query 5
UI	Ring UI 7（`@jetbrains/ring-ui-built`）+ Tailwind CSS 4.3 + CSS Modules
后端	Go 1.27.3 + chi 5.5 + slog
数据	PostgreSQL 18（自托管）+ sqlc + pgx
接口	OpenAPI 3.1，oapi-codegen + orval（下一步接入）
部署	Nginx 静态 + Go API 同域反代；OSS 预签名直传

尚未接入：OpenAPI 生成链、数据库 schema/migration、登录会话、上传、业务页面。下一步先做契约与 schema，不写业务代码。

在 GitHub 查看完整 README

安装

npx skillfish add deepdemos/ds-demos-showcase

新手？先看 mcpskill.org 教程 →