Raven-1/docs/showcase.md
Dizhan Xue 9b3ca145b6
docs: refresh bilingual readme showcases (#795)
## Summary

The README showcase now highlights three complete projects: THRESHOLD,
Raven RSI, and Raven's product launch kit. Each project pairs a concise
description with hosted videos, posters, presentations, and website or
README previews.

- Polish the English and Chinese titles, descriptions, and media labels.
- Preserve the previous 11 examples in `docs/showcase.md` and
`docs/showcase.zh-CN.md`, with links from both READMEs and the
documentation index.
- Keep all media hosted externally; this change contains five Markdown
files.

## Type

- [ ] Fix
- [ ] Feature
- [x] Docs
- [ ] CI / tooling
- [ ] Refactor
- [ ] Other

## Verification

- [x] Relevant tests pass locally
- [x] Relevant lint / type checks pass locally
- [x] User-facing docs or screenshots are updated when needed

Commands run after rebasing onto the current target:

- `rtk proxy uv run --no-sync --all-extras pytest
tests/test_living_docs.py tests/test_docs_site.py
tests/test_docker_runtime.py
tests/test_cli_onboard_commands.py::test_readme_quickstart_matches_the_installer
-q` - 28 passed.
- `rtk proxy uv run --no-sync pre-commit run --from-ref origin/main
--to-ref HEAD` - all applicable hooks passed, including private-key
detection.
- `rtk proxy env UV_NO_SYNC=1 make check-large-files
check-source-language COMMIT_RANGE=origin/main..HEAD` - passed.
- `rtk proxy env PYTHONPATH=. uv run --no-sync python
scripts/check_commit_messages.py origin/main..HEAD` - passed.
- `rtk proxy git diff --check origin/main...HEAD` - passed.

The migrated showcase bodies match their originals byte for byte. GitHub
Markdown rendering produces three project headings, three tables, 11
images, and two video players per README, with no unrendered bold
markers. Relative links and domain terminology were checked.

All five project website links returned HTTP 200. Requests to the 19
GitHub attachment URLs returned HTTP 403 or timed out; a direct GET
retry also timed out, so media payload delivery could not be revalidated
from this environment.

Validation is scoped to documentation. Type checking is not applicable
to these Markdown-only changes. The full application and integration
suites were not run, and the showcase experiments were not rerun.

## Risk

- [x] Security impact considered
- [x] Backward compatibility considered
- [x] Rollback path is clear for risky changes

This changes the README presentation and adds navigation to the full
galleries. Runtime behavior, configuration, and dependencies are
unchanged. Media remains dependent on its external hosting. Revert this
documentation change to restore the previous layout.

## Related Issues

N/A
2026-09-26 01:18:48 +08:00

9.7 KiB

Raven Showcase

Back to README · 中文

Real runs, each captured from Raven's task graph. The graph shows the orchestration Raven generates for the task; below it is what the run produced.

An FPS boss arena game built in Godot 4 (~4 days of autonomous operation)

Task graph: three Raven-Code nodes running in sequence across 42 game rounds

https://github.com/user-attachments/assets/44724e3e-6564-467a-b422-473aa8f474bd

A presentation about Song-dynasty domestic aesthetics (costs ~$0.80)

A presentation about how ancient Greece was whitewashed (costs ~$0.80)

Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node

Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node

Cover, slides and closing slide of the Song-dynasty aesthetics deck

Cover, slides and closing slide of the Greek polychromy deck

A presentation about how pop music is manufactured (costs ~$0.80)

A presentation about a century of abstract art (costs ~$0.80)

Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node

Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node

Cover, slides and closing slide of the pop music deck

Cover, slides and closing slide of the abstract art deck

A poster about how six agent-orchestration frameworks compare

Data analysis on a parameter sweep

Task graph: two Raven-Research nodes running in parallel into one Raven-Design node

Task graph: Raven-Code into Raven-Oncall into Raven-Design, run in sequence

Comparison board: six orchestration frameworks against four dimensions, each tagged explicit graph or canvas, declared task flow, or dynamic at runtime

Retrieval sweep dashboard: recall@k is set by top_k alone and latency stays broadly flat, with a sixteen-cell grid of measured recall and latency and the best cell ringed at top_k 10, chunk_size 1024

A poster about how light pollution steals wildlife sleep

A website about why GPS needs a fourth satellite

Task graph: three Raven-Research nodes in parallel into a Raven-Code node; that node and a Raven-Design plate node running alongside them both feed the final Raven-Design node

Task graph: two Raven-Code nodes in parallel into a Raven-Oncall cross-check; that node and a Raven-Design plate node running alongside them both feed the final Raven-Design node

Key visual plus the derived series: street poster, data panel, social square and wide banner

GPS trilateration explainer: the live page, and the fix at two, three and four satellites

A simulation that finds a beam's limit load by bisection

A dam-break simulation, tuned until the water stays bounded

Task graph: Raven-Research into Raven-Code into Raven-Oncall, run in sequence for a CalculiX cantilever plastic limit chain, 3 of 3 done in 5m21s, 1m28s and 4m11s

Task graph: Raven-Research into Raven-Code into Raven-Oncall, run in sequence for a dam-break chain, 3 of 3 done in 11m48s, 1m16s and 3m58s

Limit-load search: a cantilever beam under rising load colored by von Mises stress, with the bisection bracket narrowing from 1800-2000 kN down to 3.125 kN over eight rounds

Dam-break solve: a collapsing water column resolved to fine free-surface structure, with the out-of-bounds water fraction falling from 1e0 to 1.36e-10 over seven rounds