oasis7 docs

Viewer Manual

oasis7 Viewer 使用手册

当前仓库仅保留 `viewer` 作为正式 Viewer Web 入口；`software_safe` 只作兼容 alias；本页覆盖启动、闭环验证与常见排查。

本地真实 LLM 游戏测试

./scripts/run-local-letai-game-test.sh --local-world-playtest

本地真实 LetAI provider-backed 游戏试玩统一从该 preset 启动。它会处理 token config、provider bridge、launcher/runtime/viewer/local-standalone-chain 启动与日常试玩端口 48420/48421/48422；它不连接 formal/public testnet。脚本输出的 GAME_URL 是手工试玩和 agent-browser 留证入口。

不要把裸 run-viewer-web.sh 当作本地真实 provider-backed gameplay 启动方式；它只属于下方 Viewer/debug 闭环。

底层 Viewer Debug 快速开始

1) 启动 live server

env -u RUSTC_WRAPPER cargo run -p oasis7 --bin oasis7_viewer_live -- llm_bootstrap --llm --bind 127.0.0.1:5023 --web-bind 127.0.0.1:5011

该路径仅用于 Viewer/debug；若显式改用 --no-llm，只允许 observer/debug。

2) 启动 Web Viewer

env -u NO_COLOR ./scripts/run-viewer-web.sh --address 127.0.0.1 --port 4173

访问：http://127.0.0.1:4173/?ws=ws://127.0.0.1:5011

当前只保留 viewer 单一正式入口；software_safe 只保留兼容别名，不再维护其他 Viewer surface 或旧本地 Viewer 入口。

Web 闭环

推荐直接使用 repo 内置脚本：

若要手工采样，可执行：

command -v agent-browser >/dev/null || { echo "missing agent-browser" >&2; exit 1; }
mkdir -p output/playwright/viewer
agent-browser close-all || true
agent-browser --headed open "http://127.0.0.1:4173/?ws=ws://127.0.0.1:5011&render_mode=viewer&test_api=1"
agent-browser wait --load networkidle
agent-browser snapshot -i
agent-browser eval "JSON.stringify(window.__AW_TEST__?.getState?.() ?? null)"
agent-browser console | tee output/playwright/viewer/console.log
agent-browser screenshot output/playwright/viewer/viewer-web.png
agent-browser close

最小通过标准：页面加载成功、__AW_TEST__ 可用、renderMode=viewer（或兼容 alias software_safe）、并产出截图与日志。

当前能力边界

常见问题排查