oasis7 docs

Viewer Manual

oasis7 Viewer 使用手册

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

快速开始

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

正式 gameplay 需要可用的 LLM provider；若显式改用 --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 或 native 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）、并产出截图与日志。

当前能力边界

常见问题排查