PineAgents Web

Static site (Vite + React) for the PineAgents product — the public web display port (PineAgentsWeb) for the PineAgents OPC 超级个体平台. Built output is served with a minimal Node server that supports SPA fallback (e.g. direct access to /docs/channels).

项目身份：pineagents-web。页面内视觉/文案仍沿用既有 QwenPaw 素材，未做品牌改造。

Prerequisites

• Node.js 18+
• pnpm (recommended) or npm

Install

pnpm install
# or
npm install

Development

pnpm run dev
# or
npm run dev

Dev server runs at http://localhost:5173 (or the next free port).

Build

pnpm run build
# or
npm run build

Output is in dist/.

Preview (local only)

• Vite preview (quick local check): pnpm run preview

• Production-style server (same as prod, no PM2): pnpm run preview:prod Serves dist/ at http://localhost:8088 with SPA fallback.

Production with PM2

Use PM2 to run the preview server in production: auto-restart on crash, logs, and easy start/stop.

1. Install PM2 globally (one-time)

npm install -g pm2

If the script runs without global PM2, it will try to install it automatically.

2. Build and start

cd website
pnpm run build
pm2 start ecosystem.config.cjs

Or from repo root (install + build + PM2 start/reload):

bash scripts/website_build.sh

Or use the helper script (installs PM2 if missing, then starts):

bash scripts/start.sh

Default port: 8088. Override with PORT=3000 pm2 start ecosystem.config.cjs or by editing ecosystem.config.cjs.

3. PM2 commands

Command	Description
pm2 status	List apps and status
pm2 logs pineagents-web	Stream stdout/stderr logs
pm2 restart pineagents-web	Restart the app
pm2 reload ecosystem.config.cjs --update-env	Reload with latest config (zero-downtime)
pm2 stop pineagents-web	Stop the app
pm2 delete pineagents-web	Remove from PM2 (stop + delete)

4. After code/build changes

Rebuild then reload so PM2 serves the new dist/:

pnpm run build
pm2 reload ecosystem.config.cjs --update-env

Or from repo root:

bash scripts/website_build.sh

Config

• Port: Set in ecosystem.config.cjs (env.PORT / args) or env PORT. Default 8088.
• App name: pineagents-web in ecosystem.config.cjs (used in pm2 logs/restart).