From c1f26b9c59797adc2023549a7c1c2a75d12bbf9d Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Mar 2026 22:46:23 +0000 Subject: [PATCH 1/3] Add CLAUDE.md with comprehensive codebase documentation for AI assistants Covers project type (Claude Skill), repo structure, skill execution flow, auto-detection logic, required CDN dependencies, generated HTML layout, Three.js/SVG specs, design system, language conventions, and AI constraints. https://claude.ai/code/session_01Ph737eAipuUpGu1mNbuYXh --- CLAUDE.md | 273 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 273 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..1017a04 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,273 @@ +# CLAUDE.md — AetherViz Master + +This file provides guidance for AI assistants working in this repository. + +--- + +## Project Overview + +**AetherViz Master** (v5.0) is a **Claude Code Skill** — a prompt specification that guides an AI to generate complete, self-contained interactive 3D educational visualization web pages from a single topic input. There is no traditional source code; the output is always a single-file HTML document delivered directly to the user. + +- **Repository type**: Claude Skill specification + documentation only +- **No build system, no package manager, no test suite** +- **License**: MIT +- **Author**: andyhuo520 + +--- + +## Repository Structure + +``` +aetherviz-master/ +├── CLAUDE.md # This file +├── README.md # User-facing documentation (Chinese) +├── SKILL.md # Authoritative skill specification (Claude reads this when invoked) +└── LICENSE # MIT License +``` + +There are intentionally **no source files, no `node_modules`, no `package.json`**, and no compiled assets. The project is a generative specification, not a traditional codebase. + +--- + +## How the Skill Works + +When a user invokes `/aetherviz-master` (or types a topic) in Claude Code, Claude: + +1. Reads `SKILL.md` as the authoritative specification +2. Auto-detects the subject domain and render mode from the topic keywords +3. Generates a **complete, runnable, single-file HTML document** — nothing else +4. Outputs the raw HTML directly (no markdown fences, no explanation) + +### Output Contract (strict) + +- Output starts with `` and ends with `` +- Zero external file dependencies (all libraries via CDN) +- Must run by saving as `.html` and opening in any modern browser +- Must support mobile touch (rotate, pinch-zoom) +- Must include the footer credit: `由 AetherViz Master 为你生成 ❤️` + +--- + +## Auto-Detection Logic + +### Subject → Color Theme + +| Subject | Color Gradient | +|---------|---------------| +| Physics | Blue `#3B82F6 → #0EA5E9` | +| Chemistry | Orange-Red `#F59E0B → #EF4444` | +| Biology | Emerald `#10B981 → #22D3EE` | +| Math | Golden `#F59E0B → #EAB308` | +| Astronomy | Deep Blue `#1E40AF → #3B82F6` | +| Programming | Green-Teal `#22C55E → #14B8A6` | + +### Topic → Render Mode + +```javascript +// Three.js 3D keywords: 运动, 粒子, 碰撞, 旋转, 天体, 分子, 机械, 力, 磁场, 电场 +// SVG 2D keywords: 函数, 图像, 曲线, 图表, 统计, 证明, 几何, 坐标 +// Hybrid keywords: 牛顿, 运动定律, 波动, 振动, 电磁, 能量 + +// Render mode resolution: +// hybrid → if hasHybrid || (hasThree && hasSVG) +// svg → if only hasSVG +// three → default (3D only) +``` + +--- + +## Required CDN Dependencies (Generated HTML) + +Every generated HTML file must load these via CDN — never from local files: + +| Library | CDN URL | +|---------|---------| +| Three.js r134 | `https://cdnjs.cloudflare.com/ajax/libs/three.js/r134/three.min.js` | +| Tailwind CSS v3.4+ | `https://cdn.tailwindcss.com` | +| KaTeX 0.16.11 CSS | `https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css` | +| KaTeX 0.16.11 JS | `https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.js` | +| KaTeX auto-render | `https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/contrib/auto-render.min.js` | +| D3.js v7 (optional) | `https://d3js.org/d3.v7.min.js` | + +**OrbitControls**: Must be inlined as a simplified self-contained implementation (no CDN available for this). It must support `enableDamping`, touch input, and zoom limits. + +--- + +## Generated HTML Structure + +Every generated page must follow this layout: + +``` +┌─────────────────────────────────────────────────────────────┐ +│ NAV BAR: Title (topic name) | Reset | Random | Fullscreen | About │ +├───────────────────┬─────────────────────────────────────────┤ +│ LEFT SIDEBAR │ MAIN CANVAS (Three.js / SVG / Hybrid) │ +│ (30%, collapsible)│ (70%, gradient background) │ +│ - Learning goals │ │ +│ (checkboxes) │ │ +│ - KaTeX formulas │ │ +│ - Principles │ │ +│ - Applications │ │ +├───────────────────┴─────────────────────────────────────────┤ +│ CONTROL PANEL: Sliders + KaTeX results + Play/Pause/Step │ +├─────────────────────────────────────────────────────────────┤ +│ QUIZ PANEL (collapsible, 360px wide, right-side): │ +│ - Hide button (✕) → collapses to floating button (bottom-right) │ +│ - Smooth transition (0.3s ease) │ +└─────────────────────────────────────────────────────────────┘ +``` + +--- + +## Three.js Scene Requirements + +When using the 3D renderer, the scene must include: + +- `PerspectiveCamera(fov: 60, near: 0.1, far: 1000)` +- `WebGLRenderer({ antialias: true, shadowMap.enabled: true })` +- `HemisphereLight` (ambient) + `DirectionalLight` (castShadow: true) +- `MeshStandardMaterial` or `MeshPhongMaterial` with adjustable metalness/roughness +- `THREE.ArrowHelper` for vectors: Force=red `#EF4444`, Velocity=blue `#3B82F6`, Acceleration=green `#22C55E` +- `THREE.Points + BufferGeometry` for particle systems +- `THREE.Line + BufferAttribute` with fixed-length ring buffer for trails +- Physics via Verlet or Euler integration using `THREE.Clock.getDelta()` +- `THREE.Raycaster` for click-to-highlight interactions +- Sprite-based labels synced via `vector.project(camera)` + +--- + +## Hybrid Rendering (Three.js + SVG) + +When render mode is `hybrid`: + +```javascript +// SVG overlay sits above the Three.js canvas +const svgContainer = document.createElement('div'); +svgContainer.style.cssText = + 'position:absolute;top:0;left:0;width:100%;height:100%;pointer-events:none;'; + +// 3D → 2D coordinate projection +function syncSVGto3D(x, y, z) { + const vector = new THREE.Vector3(x, y, z); + vector.project(camera); + return { + x: (vector.x * 0.5 + 0.5) * width, + y: (-(vector.y * 0.5) + 0.5) * height + }; +} +``` + +Slider changes must update both Three.js object properties and SVG path `d` attributes simultaneously. + +--- + +## Design System + +### Core Color Palette + +```css +/* Backgrounds */ +--bg-gradient: linear-gradient(180deg, #0F172A 0%, #164E63 50%, #155E75 100%); + +/* Primary brand */ +--primary-gradient: linear-gradient(135deg, #14B8A6 0%, #06B6D4 50%, #22D3EE 100%); + +/* Glassmorphism */ +--glass-bg: rgba(255, 255, 255, 0.08); +--glass-border: rgba(255, 255, 255, 0.15); +--glass-shadow: 0 8px 32px rgba(0, 0, 0, 0.3); + +/* Text */ +--text-primary: #F8FAFC; +--text-secondary: #CBD5E1; +--text-muted: #94A3B8; +``` + +### Style Conventions + +- **Glassmorphism** on all panels and cards +- **Neon accent colors** on interactive elements +- **60fps animations** with spring easing +- Font: `Inter, system-ui, sans-serif` +- All UI panels use `backdrop-filter: blur(...)` and semi-transparent backgrounds + +--- + +## Language Detection + +- If the topic is Chinese → output the entire page in Chinese +- If the topic is English → output the entire page in English +- The skill supports bilingual input/output automatically + +--- + +## Development Conventions + +Since this repo is documentation-only, "development" means editing the specification files. + +### When modifying `SKILL.md` + +- Keep the YAML frontmatter (`name`, `description`) intact at the top +- The skill is invoked by Claude Code as `/aetherviz-master` +- Preserve all numbered sections and their headings — Claude parses them structurally +- CDN versions are pinned (Three.js r134, KaTeX 0.16.11) — do not upgrade without testing + +### When modifying `README.md` + +- README is primarily Chinese; maintain that convention +- Screenshots/GIFs go in `docs/` or are linked from GitHub issue uploads +- Keep the changelog section (`## 📝 更新日志`) up to date + +### Commit message conventions + +Use concise imperative messages, e.g.: +- `Add hybrid SVG+3D render mode to SKILL.md` +- `Update CDN URLs for KaTeX 0.16.12` +- `Fix quiz panel collapse animation spec` + +### Branch naming + +Feature branches follow: `feature/` or `claude/-` + +--- + +## Testing + +There is no automated test suite. Manual testing process: + +1. Invoke the skill with a topic (e.g., `牛顿第二定律`, `Sine function`, `DNA replication`) +2. Save the generated HTML output as `test.html` +3. Open in Chrome/Edge/Firefox and verify: + - 3D scene renders without errors + - Sliders update the scene in real time + - KaTeX formulas render correctly + - Quiz panel collapses/expands with animation + - Mobile touch controls work (use browser DevTools device emulation) + +--- + +## Running Generated Output Locally + +The generated HTML files are self-contained. Serve them with any static file server: + +```bash +python -m http.server 8080 +# or +npx serve . +# or +php -S localhost:8080 +``` + +Then open `http://localhost:8080/your-file.html` in a WebGL-capable browser. + +--- + +## Key Constraints for AI Assistants + +1. **Never add source code files** — this repo is spec-only +2. **Never add a build system or package manager** — not applicable +3. **Output is always raw HTML** — no markdown code fences, no preamble +4. **CDN versions are pinned** — Three.js r134, not latest +5. **OrbitControls must be inlined** — no CDN exists for this module +6. **Both Chinese and English topics are valid** — handle both gracefully +7. **Single file output only** — no multi-file projects, no imports From 635f3c01bca5ed98a90b1a3878922963c20bb37b Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 20 Apr 2026 00:29:47 +0000 Subject: [PATCH 2/3] Add AetherViz Video web app (Next.js + HyperFrames + Claude API) Full-stack MVP: user inputs a topic, gets an interactive 3D preview (AetherViz-style), then can render it as a 3-4 minute HyperFrames MP4. - web/app/page.tsx: single-page UI with input/preview/rendering/done states - web/app/api/generate: Claude streams interactive HTML to iframe preview - web/app/api/render: Claude generates GSAP timeline HTML, HyperFrames renders MP4 - web/lib/prompts.ts: system prompts for both interactive and video modes - web/lib/renderer.ts: HyperFrames CLI wrapper with temp dir + asset injection - web/server-assets/: bundled three.min.js + gsap.min.js (CDN blocked in Puppeteer) https://claude.ai/code/session_01Ph737eAipuUpGu1mNbuYXh --- web/.gitignore | 41 + web/AGENTS.md | 5 + web/CLAUDE.md | 1 + web/README.md | 36 + web/app/api/generate/route.ts | 46 + web/app/api/render/route.ts | 57 ++ web/app/favicon.ico | Bin 0 -> 25931 bytes web/app/globals.css | 28 + web/app/layout.tsx | 15 + web/app/page.tsx | 234 +++++ web/lib/prompts.ts | 94 ++ web/lib/renderer.ts | 46 + web/next.config.ts | 7 + web/package-lock.json | 1713 ++++++++++++++++++++++++++++++++ web/package.json | 24 + web/postcss.config.mjs | 7 + web/public/file.svg | 1 + web/public/globe.svg | 1 + web/public/next.svg | 1 + web/public/vercel.svg | 1 + web/public/window.svg | 1 + web/server-assets/gsap.min.js | 11 + web/server-assets/three.min.js | 6 + web/tsconfig.json | 34 + 24 files changed, 2410 insertions(+) create mode 100644 web/.gitignore create mode 100644 web/AGENTS.md create mode 100644 web/CLAUDE.md create mode 100644 web/README.md create mode 100644 web/app/api/generate/route.ts create mode 100644 web/app/api/render/route.ts create mode 100644 web/app/favicon.ico create mode 100644 web/app/globals.css create mode 100644 web/app/layout.tsx create mode 100644 web/app/page.tsx create mode 100644 web/lib/prompts.ts create mode 100644 web/lib/renderer.ts create mode 100644 web/next.config.ts create mode 100644 web/package-lock.json create mode 100644 web/package.json create mode 100644 web/postcss.config.mjs create mode 100644 web/public/file.svg create mode 100644 web/public/globe.svg create mode 100644 web/public/next.svg create mode 100644 web/public/vercel.svg create mode 100644 web/public/window.svg create mode 100644 web/server-assets/gsap.min.js create mode 100644 web/server-assets/three.min.js create mode 100644 web/tsconfig.json diff --git a/web/.gitignore b/web/.gitignore new file mode 100644 index 0000000..5ef6a52 --- /dev/null +++ b/web/.gitignore @@ -0,0 +1,41 @@ +# See https://help.github.com/articles/ignoring-files/ for more about ignoring files. + +# dependencies +/node_modules +/.pnp +.pnp.* +.yarn/* +!.yarn/patches +!.yarn/plugins +!.yarn/releases +!.yarn/versions + +# testing +/coverage + +# next.js +/.next/ +/out/ + +# production +/build + +# misc +.DS_Store +*.pem + +# debug +npm-debug.log* +yarn-debug.log* +yarn-error.log* +.pnpm-debug.log* + +# env files (can opt-in for committing if needed) +.env* + +# vercel +.vercel + +# typescript +*.tsbuildinfo +next-env.d.ts diff --git a/web/AGENTS.md b/web/AGENTS.md new file mode 100644 index 0000000..8bd0e39 --- /dev/null +++ b/web/AGENTS.md @@ -0,0 +1,5 @@ + +# This is NOT the Next.js you know + +This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices. + diff --git a/web/CLAUDE.md b/web/CLAUDE.md new file mode 100644 index 0000000..43c994c --- /dev/null +++ b/web/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/web/README.md b/web/README.md new file mode 100644 index 0000000..e215bc4 --- /dev/null +++ b/web/README.md @@ -0,0 +1,36 @@ +This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app). + +## Getting Started + +First, run the development server: + +```bash +npm run dev +# or +yarn dev +# or +pnpm dev +# or +bun dev +``` + +Open [http://localhost:3000](http://localhost:3000) with your browser to see the result. + +You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file. + +This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel. + +## Learn More + +To learn more about Next.js, take a look at the following resources: + +- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API. +- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial. + +You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome! + +## Deploy on Vercel + +The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js. + +Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details. diff --git a/web/app/api/generate/route.ts b/web/app/api/generate/route.ts new file mode 100644 index 0000000..81eb545 --- /dev/null +++ b/web/app/api/generate/route.ts @@ -0,0 +1,46 @@ +import Anthropic from '@anthropic-ai/sdk'; +import { INTERACTIVE_SYSTEM_PROMPT } from '@/lib/prompts'; + +const client = new Anthropic(); + +export async function POST(request: Request) { + const { topic } = await request.json(); + + if (!topic?.trim()) { + return Response.json({ error: '请输入主题' }, { status: 400 }); + } + + const stream = await client.messages.create({ + model: 'claude-sonnet-4-6', + max_tokens: 16000, + system: [ + { + type: 'text', + text: INTERACTIVE_SYSTEM_PROMPT, + cache_control: { type: 'ephemeral' }, + }, + ], + messages: [{ role: 'user', content: `生成主题：${topic}` }], + stream: true, + }); + + const encoder = new TextEncoder(); + + const readable = new ReadableStream({ + async start(controller) { + for await (const event of stream) { + if ( + event.type === 'content_block_delta' && + event.delta.type === 'text_delta' + ) { + controller.enqueue(encoder.encode(event.delta.text)); + } + } + controller.close(); + }, + }); + + return new Response(readable, { + headers: { 'Content-Type': 'text/plain; charset=utf-8' }, + }); +} diff --git a/web/app/api/render/route.ts b/web/app/api/render/route.ts new file mode 100644 index 0000000..1fa50e9 --- /dev/null +++ b/web/app/api/render/route.ts @@ -0,0 +1,57 @@ +import Anthropic from '@anthropic-ai/sdk'; +import { VIDEO_SYSTEM_PROMPT } from '@/lib/prompts'; +import { renderToMp4 } from '@/lib/renderer'; + +const client = new Anthropic(); + +export async function POST(request: Request) { + const { topic, previewHtml } = await request.json(); + + if (!topic?.trim()) { + return Response.json({ error: '缺少主题' }, { status: 400 }); + } + + // Step 1: Generate HyperFrames-compatible timeline HTML + const message = await client.messages.create({ + model: 'claude-sonnet-4-6', + max_tokens: 16000, + system: [ + { + type: 'text', + text: VIDEO_SYSTEM_PROMPT, + cache_control: { type: 'ephemeral' }, + }, + ], + messages: [ + { + role: 'user', + content: previewHtml + ? `基于以下交互式预览，生成适合视频渲染的 HyperFrames HTML（主题：${topic}）。保留相同的视觉风格和教学内容，但改为全自动 GSAP timeline 驱动，4分钟结构。\n\n预览参考：\n${previewHtml.slice(0, 4000)}` + : `生成主题：${topic}，视频版 HyperFrames HTML`, + }, + ], + }); + + const videoHtml = + message.content[0].type === 'text' ? message.content[0].text : ''; + + if (!videoHtml.includes('%i@8hT6>)&Gu{h#Oeyszu?xtw#Zb1mO{pgX9699l+Qppw7jXaYf~-84xW z)w4x8?=youko|}Vr~(D$UXIbiXABHh`p1?nn8Po~fxRJv}|0e(BPs|G`(TT%kKVJAdg5*Z|x0leQq0 zkdUBvb#>9F()jo|T~kx@OM8$9wzs~t2l;K=woNssA3l6|sx2r3+kdfVW@e^8e*E}v zA1y5{bRi+3Z`uD3{F7LgFJDdvm;nJilkzDku>BwXH(8ItVCXk*-lSJnR?-2UN%hJ){&rlvg`CDTj z)Bzo!3v7Ou#83zEDEFcKt(f1E0~=rqeEbTnMvWR#{+9pg%7G8y>u1OVRUSoox-ovF z2Ydma(;=YuBY(eI|04{hXzZD6_f(v~H;C~y5=DhAC{MMS>2fm~1H_t2$56pc$NH8( z5bH|<)71dV-_oCHIrzrT`2s-5w_+2CM0$95I6X8p^r!gHp+j_gd;9O<1~CEQQGS8) zS9Qh3#p&JM-G8rHekNmKVewU;pJRcTAog68KYo^dRo}(M>36U4Us zfgYWSiHZL3;lpWT=zNAW>Dh#mB!_@Lg%$ms8N-;aPqMn+C2HqZgz&9~Eu z4|Kp<`$q)Uw1R?y(~S>ePdonHxpV1#eSP1B;Ogo+-Pk}6#0GsZZ5!||ev2MGdh}_m z{DeR7?0-1^zVs&`AV6Vt;r3`I`OI_wgs*w=eO%_#7Kepl{B@xiyCANc(l zzIyd4y|c6PXWq9-|KM8(zIk8LPk(>a)zyFWjhT!$HJ$qX1vo@d25W<fvZQ2zUz5WRc(UnFMKHwe1| zWmlB1qdbiA(C0jmnV<}GfbKtmcu^2*P^O?MBLZKt|As~ge8&AAO~2K@zbXelK|4T<{|y4`raF{=72kC2Kn(L4YyenWgrPiv z@^mr$t{#X5VuIMeL!7Ab6_kG$&#&5p*Z{+?5U|TZ`B!7llpVmp@skYz&n^8QfPJzL z0G6K_OJM9x+Wu2gfN45phANGt{7=C>i34CV{Xqlx(fWpeAoj^N0Biu`w+MVcCUyU* zDZuzO0>4Z6fbu^T_arWW5n!E45vX8N=bxTVeFoep_G#VmNlQzAI_KTIc{6>c+04vr zx@W}zE5JNSU>!THJ{J=cqjz+4{L4A{Ob9$ZJ*S1?Ggg3klFp!+Y1@K+pK1DqI|_gq z5ZDXVpge8-cs!o|;K73#YXZ3AShj50wBvuq3NTOZ`M&qtjj#GOFfgExjg8Gn8>Vq5 z`85n+9|!iLCZF5$HJ$Iu($dm?8~-ofu}tEc+-pyke=3!im#6pk_Wo8IA|fJwD&~~F zc16osQ)EBo58U7XDuMexaPRjU@h8tXe%S{fA0NH3vGJFhuyyO!Uyl2^&EOpX{9As0 zWj+P>{@}jxH)8|r;2HdupP!vie{sJ28b&bo!8`D^x}TE$%zXNb^X1p@0PJ86`dZyj z%ce7*{^oo+6%&~I!8hQy-vQ7E)0t0ybH4l%KltWOo~8cO`T=157JqL(oq_rC%ea&4 z2NcTJe-HgFjNg-gZ$6!Y`SMHrlj}Etf7?r!zQTPPSv}{so2e>Fjs1{gzk~LGeesX%r(Lh6rbhSo_n)@@G-FTQy93;l#E)hgP@d_SGvyCp0~o(Y;Ee8{ zdVUDbHm5`2taPUOY^MAGOw*>=s7=Gst=D+p+2yON!0%Hk` zz5mAhyT4lS*T3LS^WSxUy86q&GnoHxzQ6vm8)VS}_zuqG?+3td68_x;etQAdu@sc6 zQJ&5|4(I?~3d-QOAODHpZ=hlSg(lBZ!JZWCtHHSj`0Wh93-Uk)_S%zsJ~aD>{`A0~ z9{AG(e|q3g5B%wYKRxiL2Y$8(4w6bzchKuloQW#e&S3n+P- z8!ds-%f;TJ1>)v)##>gd{PdS2Oc3VaR`fr=`O8QIO(6(N!A?pr5C#6fc~Ge@N%Vvu zaoAX2&(a6eWy_q&UwOhU)|P3J0Qc%OdhzW=F4D|pt0E4osw;%<%Dn58hAWD^XnZD= z>9~H(3bmLtxpF?a7su6J7M*x1By7YSUbxGi)Ot0P77`}P3{)&5Un{KD?`-e?r21!4vTTnN(4Y6Lin?UkSM z`MXCTC1@4A4~mvz%Rh2&EwY))LeoT=*`tMoqcEXI>TZU9WTP#l?uFv+@Dn~b(>xh2 z;>B?;Tz2SR&KVb>vGiBSB`@U7VIWFSo=LDSb9F{GF^DbmWAfpms8Sx9OX4CnBJca3 zlj9(x!dIjN?OG1X4l*imJNvRCk}F%!?SOfiOq5y^mZW)jFL@a|r-@d#f7 z2gmU8L3IZq0ynIws=}~m^#@&C%J6QFo~Mo4V`>v7MI-_!EBMMtb%_M&kvAaN)@ZVw z+`toz&WG#HkWDjnZE!6nk{e-oFdL^$YnbOCN}JC&{$#$O27@|Tn-skXr)2ml2~O!5 zX+gYoxhoc7qoU?C^3~&!U?kRFtnSEecWuH0B0OvLodgUAi}8p1 zrO6RSXHH}DMc$&|?D004DiOVMHV8kXCP@7NKB zgaZq^^O<7PoKEp72kby@W0Z!Y*Ay{&vfg#C&gG@YVR9g?FEocMUi1gSN$+V+ayF45{a zuDZDTN}mS|;BO%gEf}pjBfN2-gIrU#G5~cucA;dokXW89%>AyXJJI z9X4UlIWA|ZYHgbI z5?oFk@A=Ik7lrEQPDH!H+b`7_Y~aDb_qa=B2^Y&Ow41cU=4WDd40dp5(QS-WMN-=Y z9g;6_-JdNU;|6cPwf$ak*aJIcwL@1n$#l~zi{c{EW?T;DaW*E8DYq?Umtz{nJ&w-M zEMyTDrC&9K$d|kZe2#ws6)L=7K+{ zQw{XnV6UC$6-rW0emqm8wJoeZK)wJIcV?dST}Z;G0Arq{dVDu0&4kd%N!3F1*;*pW zR&qUiFzK=@44#QGw7k1`3t_d8&*kBV->O##t|tonFc2YWrL7_eqg+=+k;!F-`^b8> z#KWCE8%u4k@EprxqiV$VmmtiWxDLgnGu$Vs<8rppV5EajBXL4nyyZM$SWVm!wnCj-B!Wjqj5-5dNXukI2$$|Bu3Lrw}z65Lc=1G z^-#WuQOj$hwNGG?*CM_TO8Bg-1+qc>J7k5c51U8g?ZU5n?HYor;~JIjoWH-G>AoUP ztrWWLbRNqIjW#RT*WqZgPJXU7C)VaW5}MiijYbABmzoru6EmQ*N8cVK7a3|aOB#O& zBl8JY2WKfmj;h#Q!pN%9o@VNLv{OUL?rixHwOZuvX7{IJ{(EdPpuVFoQqIOa7giLVkBOKL@^smUA!tZ1CKRK}#SSM)iQHk)*R~?M!qkCruaS!#oIL1c z?J;U~&FfH#*98^G?i}pA{ z9Jg36t4=%6mhY(quYq*vSxptes9qy|7xSlH?G=S@>u>Ebe;|LVhs~@+06N<4CViBk zUiY$thvX;>Tby6z9Y1edAMQaiH zm^r3v#$Q#2T=X>bsY#D%s!bhs^M9PMAcHbCc0FMHV{u-dwlL;a1eJ63v5U*?Q_8JO zT#50!RD619#j_Uf))0ooADz~*9&lN!bBDRUgE>Vud-i5ck%vT=r^yD*^?Mp@Q^v+V zG#-?gKlr}Eeqifb{|So?HM&g91P8|av8hQoCmQXkd?7wIJwb z_^v8bbg`SAn{I*4bH$u(RZ6*xUhuA~hc=8czK8SHEKTzSxgbwi~9(OqJB&gwb^l4+m`k*Q;_?>Y-APi1{k zAHQ)P)G)f|AyjSgcCFps)Fh6Bca*Xznq36!pV6Az&m{O8$wGFD? zY&O*3*J0;_EqM#jh6^gMQKpXV?#1?>$ml1xvh8nSN>-?H=V;nJIwB07YX$e6vLxH( zqYwQ>qxwR(i4f)DLd)-$P>T-no_c!LsN@)8`e;W@)-Hj0>nJ-}Kla4-ZdPJzI&Mce zv)V_j;(3ERN3_@I$N<^|4Lf`B;8n+bX@bHbcZTopEmDI*Jfl)-pFDvo6svPRoo@(x z);_{lY<;);XzT`dBFpRmGrr}z5u1=pC^S-{ce6iXQlLGcItwJ^mZx{m$&DA_oEZ)B{_bYPq-HA zcH8WGoBG(aBU_j)vEy+_71T34@4dmSg!|M8Vf92Zj6WH7Q7t#OHQqWgFE3ARt+%!T z?oLovLVlnf?2c7pTc)~cc^($_8nyKwsN`RA-23ed3sdj(ys%pjjM+9JrctL;dy8a( z@en&CQmnV(()bu|Y%G1-4a(6x{aLytn$T-;(&{QIJB9vMox11U-1HpD@d(QkaJdEb zG{)+6Dos_L+O3NpWo^=gR?evp|CqEG?L&Ut#D*KLaRFOgOEK(Kq1@!EGcTfo+%A&I z=dLbB+d$u{sh?u)xP{PF8L%;YPPW53+@{>5W=Jt#wQpN;0_HYdw1{ksf_XhO4#2F= zyPx6Lx2<92L-;L5PD`zn6zwIH`Jk($?Qw({erA$^bC;q33hv!d!>%wRhj# zal^hk+WGNg;rJtb-EB(?czvOM=H7dl=vblBwAv>}%1@{}mnpUznfq1cE^sgsL0*4I zJ##!*B?=vI_OEVis5o+_IwMIRrpQyT_Sq~ZU%oY7c5JMIADzpD!Upz9h@iWg_>>~j zOLS;wp^i$-E?4<_cp?RiS%Rd?i;f*mOz=~(&3lo<=@(nR!_Rqiprh@weZlL!t#NCc zO!QTcInq|%#>OVgobj{~ixEUec`E25zJ~*DofsQdzIa@5^nOXj2T;8O`l--(QyU^$t?TGY^7#&FQ+2SS3B#qK*k3`ye?8jUYSajE5iBbJls75CCc(m3dk{t?- zopcER9{Z?TC)mk~gpi^kbbu>b-+a{m#8-y2^p$ka4n60w;Sc2}HMf<8JUvhCL0B&Btk)T`ctE$*qNW8L$`7!r^9T+>=<=2qaq-;ll2{`{Rg zc5a0ZUI$oG&j-qVOuKa=*v4aY#IsoM+1|c4Z)<}lEDvy;5huB@1RJPquU2U*U-;gu z=En2m+qjBzR#DEJDO`WU)hdd{Vj%^0V*KoyZ|5lzV87&g_j~NCjwv0uQVqXOb*QrQ zy|Qn`hxx(58c70$E;L(X0uZZ72M1!6oeg)(cdKO ze0gDaTz+ohR-#d)NbAH4x{I(21yjwvBQfmpLu$)|m{XolbgF!pmsqJ#D}(ylp6uC> z{bqtcI#hT#HW=wl7>p!38sKsJ`r8}lt-q%Keqy%u(xk=yiIJiUw6|5IvkS+#?JTBl z8H5(Q?l#wzazujH!8o>1xtn8#_w+397*_cy8!pQGP%K(Ga3pAjsaTbbXJlQF_+m+-UpUUent@xM zg%jqLUExj~o^vQ3Gl*>wh=_gOr2*|U64_iXb+-111aH}$TjeajM+I20xw(((>fej-@CIz4S1pi$(#}P7`4({6QS2CaQS4NPENDp>sAqD z$bH4KGzXGffkJ7R>V>)>tC)uax{UsN*dbeNC*v}#8Y#OWYwL4t$ePR?VTyIs!wea+ z5Urmc)X|^`MG~*dS6pGSbU+gPJoq*^a=_>$n4|P^w$sMBBy@f*Z^Jg6?n5?oId6f{ z$LW4M|4m502z0t7g<#Bx%X;9<=)smFolV&(V^(7Cv2-sxbxopQ!)*#ZRhTBpx1)Fc zNm1T%bONzv6@#|dz(w02AH8OXe>kQ#1FMCzO}2J_mST)+ExmBr9cva-@?;wnmWMOk z{3_~EX_xadgJGv&H@zK_8{(x84`}+c?oSBX*Ge3VdfTt&F}yCpFP?CpW+BE^cWY0^ zb&uBN!Ja3UzYHK-CTyA5=L zEMW{l3Usky#ly=7px648W31UNV@K)&Ub&zP1c7%)`{);I4b0Q<)B}3;NMG2JH=X$U zfIW4)4n9ZM`-yRj67I)YSLDK)qfUJ_ij}a#aZN~9EXrh8eZY2&=uY%2N0UFF7<~%M zsB8=erOWZ>Ct_#^tHZ|*q`H;A)5;ycw*IcmVxi8_0Xk}aJA^ath+E;xg!x+As(M#0=)3!NJR6H&9+zd#iP(m0PIW8$ z1Y^VX`>jm`W!=WpF*{ioM?C9`yOR>@0q=u7o>BP-eSHqCgMDj!2anwH?s%i2p+Q7D zzszIf5XJpE)IG4;d_(La-xenmF(tgAxK`Y4sQ}BSJEPs6N_U2vI{8=0C_F?@7<(G; zo$~G=8p+076G;`}>{MQ>t>7cm=zGtfbdDXm6||jUU|?X?CaE?(<6bKDYKeHlz}DA8 zXT={X=yp_R;HfJ9h%?eWvQ!dRgz&Su*JfNt!Wu>|XfU&68iRikRrHRW|ZxzRR^`eIGt zIeiDgVS>IeExKVRWW8-=A=yA`}`)ZkWBrZD`hpWIxBGkh&f#ijr449~m`j6{4jiJ*C!oVA8ZC?$1RM#K(_b zL9TW)kN*Y4%^-qPpMP7d4)o?Nk#>aoYHT(*g)qmRUb?**F@pnNiy6Fv9rEiUqD(^O zzyS?nBrX63BTRYduaG(0VVG2yJRe%o&rVrLjbxTaAFTd8s;<<@Qs>u(<193R8>}2_ zuwp{7;H2a*X7_jryzriZXMg?bTuegABb^87@SsKkr2)0Gyiax8KQWstw^v#ix45EVrcEhr>!NMhprl$InQMzjSFH54x5k9qHc`@9uKQzvL4ihcq{^B zPrVR=o_ic%Y>6&rMN)hTZsI7I<3&`#(nl+3y3ys9A~&^=4?PL&nd8)`OfG#n zwAMN$1&>K++c{^|7<4P=2y(B{jJsQ0a#U;HTo4ZmWZYvI{+s;Td{Yzem%0*k#)vjpB zia;J&>}ICate44SFYY3vEelqStQWFihx%^vQ@Do(sOy7yR2@WNv7Y9I^yL=nZr3mb zXKV5t@=?-Sk|b{XMhA7ZGB@2hqsx}4xwCW!in#C zI@}scZlr3-NFJ@NFaJlhyfcw{k^vvtGl`N9xSo**rDW4S}i zM9{fMPWo%4wYDG~BZ18BD+}h|GQKc-g^{++3MY>}W_uq7jGHx{mwE9fZiPCoxN$+7 zrODGGJrOkcPQUB(FD5aoS4g~7#6NR^ma7-!>mHuJfY5kTe6PpNNKC9GGRiu^L31uG z$7v`*JknQHsYB!Tm_W{a32TM099djW%5e+j0Ve_ct}IM>XLF1Ap+YvcrLV=|CKo6S zb+9Nl3_YdKP6%Cxy@6TxZ>;4&nTneadr z_ES90ydCev)LV!dN=#(*f}|ZORFdvkYBni^aLbUk>BajeWIOcmHP#8S)*2U~QKI%S zyrLmtPqb&TphJ;>yAxri#;{uyk`JJqODDw%(Z=2`1uc}br^V%>j!gS)D*q*f_-qf8&D;W1dJgQMlaH5er zN2U<%Smb7==vE}dDI8K7cKz!vs^73o9f>2sgiTzWcwY|BMYHH5%Vn7#kiw&eItCqa zIkR2~Q}>X=Ar8W|^Ms41Fm8o6IB2_j60eOeBB1Br!boW7JnoeX6Gs)?7rW0^5psc- zjS16yb>dFn>KPOF;imD}e!enuIniFzv}n$m2#gCCv4jM#ArwlzZ$7@9&XkFxZ4n!V zj3dyiwW4Ki2QG{@i>yuZXQizw_OkZI^-3otXC{!(lUpJF33gI60ak;Uqitp74|B6I zgg{b=Iz}WkhCGj1M=hu4#Aw173YxIVbISaoc z-nLZC*6Tgivd5V`K%GxhBsp@SUU60-rfc$=wb>zdJzXS&-5(NRRodFk;Kxk!S(O(a0e7oY=E( zAyS;Ow?6Q&XA+cnkCb{28_1N8H#?J!*$MmIwLq^*T_9-z^&UE@A(z9oGYtFy6EZef LrJugUA?W`A8`#=m literal 0 HcmV?d00001 diff --git a/web/app/globals.css b/web/app/globals.css new file mode 100644 index 0000000..aaeeaff --- /dev/null +++ b/web/app/globals.css @@ -0,0 +1,28 @@ +@import "tailwindcss"; + +:root { + --background: #0F172A; + --foreground: #F8FAFC; +} + +body { + background: var(--background); + color: var(--foreground); + font-family: Inter, system-ui, sans-serif; +} + +.glass { + background: rgba(255,255,255,0.07); + border: 1px solid rgba(255,255,255,0.12); + backdrop-filter: blur(12px); +} + +.btn-primary { + background: linear-gradient(135deg, #14B8A6, #06B6D4); + color: #fff; + font-weight: 600; + border-radius: 10px; + transition: opacity 0.2s; +} +.btn-primary:hover:not(:disabled) { opacity: 0.85; } +.btn-primary:disabled { opacity: 0.4; cursor: not-allowed; } diff --git a/web/app/layout.tsx b/web/app/layout.tsx new file mode 100644 index 0000000..a224010 --- /dev/null +++ b/web/app/layout.tsx @@ -0,0 +1,15 @@ +import type { Metadata } from 'next'; +import './globals.css'; + +export const metadata: Metadata = { + title: 'AetherViz Video — 教学主题 → 3D 动画视频', + description: '输入任意教学主题，生成可交互 3D 预览，一键导出教学视频', +}; + +export default function RootLayout({ children }: { children: React.ReactNode }) { + return ( + + {children} + + ); +} diff --git a/web/app/page.tsx b/web/app/page.tsx new file mode 100644 index 0000000..2cf9fbd --- /dev/null +++ b/web/app/page.tsx @@ -0,0 +1,234 @@ +'use client'; + +import { useState, useRef, useCallback } from 'react'; + +type AppState = 'input' | 'generating' | 'preview' | 'rendering' | 'done'; + +const EXAMPLE_TOPICS = ['牛顿第二定律', '光合作用', '三角函数', 'DNA复制', '行星运动', 'Sorting Algorithms']; + +export default function Home() { + const [topic, setTopic] = useState(''); + const [state, setState] = useState('input'); + const [previewHtml, setPreviewHtml] = useState(''); + const [videoUrl, setVideoUrl] = useState(''); + const [error, setError] = useState(''); + const htmlAccumRef = useRef(''); + + const generate = useCallback(async (t: string) => { + if (!t.trim()) return; + setError(''); + setState('generating'); + htmlAccumRef.current = ''; + + try { + const res = await fetch('/api/generate', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ topic: t }), + }); + + if (!res.ok) throw new Error('生成失败'); + const reader = res.body!.getReader(); + const decoder = new TextDecoder(); + + while (true) { + const { done, value } = await reader.read(); + if (done) break; + htmlAccumRef.current += decoder.decode(value, { stream: true }); + } + + setPreviewHtml(htmlAccumRef.current); + setState('preview'); + } catch (e) { + setError(String(e)); + setState('input'); + } + }, []); + + const renderVideo = useCallback(async () => { + setState('rendering'); + setError(''); + try { + const res = await fetch('/api/render', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ topic, previewHtml }), + }); + + if (!res.ok) { + const { error: msg } = await res.json(); + throw new Error(msg || '渲染失败'); + } + + const blob = await res.blob(); + setVideoUrl(URL.createObjectURL(blob)); + setState('done'); + } catch (e) { + setError(String(e)); + setState('preview'); + } + }, [topic, previewHtml]); + + const reset = () => { + setState('input'); + setPreviewHtml(''); + setVideoUrl(''); + setError(''); + setTopic(''); + }; + + return ( +
+ {/* Nav */} + + +
+ {/* INPUT STATE */} + {(state === 'input' || state === 'generating') && ( +
+
+

+ 输入主题，生成{' '} + + 3D 教学视频 + +

+

物理 · 化学 · 生物 · 数学 · 天文 · 编程

+
+ +
+ setTopic(e.target.value)} + onKeyDown={e => e.key === 'Enter' && generate(topic)} + placeholder="例：牛顿第二定律、光合作用、三角函数..." + disabled={state === 'generating'} + className="w-full bg-white/5 border border-white/15 rounded-xl px-5 py-4 text-lg text-white placeholder-slate-500 outline-none focus:border-cyan-500/50 transition-colors disabled:opacity-50" + /> + + +
+ {EXAMPLE_TOPICS.map(t => ( + + ))} +
+
+ + {error &&

{error}

} +
+ )} + + {/* PREVIEW STATE */} + {(state === 'preview' || state === 'rendering') && ( +
+ {/* Toolbar */} +
+
+ + {topic} + 交互预览 +
+
+ 满意后渲染为 3-4 分钟视频（约需 8-12 分钟） + +
+
+ + {/* Preview iframe */} +
+