agent/apps/web_v1/README.md

# 森林AI Web 客户端

森林AI 当前主 Web 客户端，使用 React、TypeScript、Vite 和 Arco Design，目录为 `apps/web_v1`。

开发服务器默认运行在 `http://localhost:5173`，登录页默认连接 `http://localhost:9150` 的 API；两者都可按私有部署环境调整。

## 开发与验证

```bash
npm ci
npm run dev
node --test scripts/api-client.test.mjs scripts/workspace-refresh-gate.test.mjs
node scripts/structure-check.mjs
node scripts/visual-check.mjs
npm run build
npm run lint
```

视觉检查使用临时 Vite 服务，默认端口为 `4175`；可通过 `VISUAL_CHECK_PORT` 覆盖。`dist/` 与 `test-results/` 都是本地产物，不应提交。