AgentSkillsCN

deployment

协助将OSD软件包部署至sych.local。适用于讨论部署、热更新、前端更新或图库更新时使用。

SKILL.md
--- frontmatter
name: deployment
description: Helps with deploying OSD packages to sych.local. Use when discussing deployment, hot-reload, frontend updates, or gallery updates.
allowed-tools: Read, Bash, Glob, Grep

Deployment

Assists with deploying OSD packages to the sych.local server.

Deployment Targets

Use make from anywhere (host or container):

Full Deploy (Frontend + Gallery)

bash
# Dev builds (recommended for development)
make deploy

# Production builds (optimized)
make deploy-prod

Selective Deploy

bash
make deploy-frontend   # Live variants only (live_day + live_thermal)
make deploy-gallery    # Recording variant only (recording_day)

What Gets Deployed

Location: sych.local:/home/archer/web/osd/

FilePurpose
live_day.tarFrontend live day stream
live_thermal.tarFrontend live thermal stream
default.tarGallery (recording_day)
pip_override.jsonPiP view config overrides

Hot-Reload Workflow

  1. Make changes to OSD source
  2. Run make deploy (or ./tools/devcontainer-build.sh deploy)
  3. Frontend auto-detects package changes via ETag
  4. Worker reloads within ~1 second

Configuration

Environment variables in .env:

bash
DEPLOY_HOST=sych.local
DEPLOY_USER=archer

PiP Override

The resources/pip_override.json disables all widgets except crosshair for Picture-in-Picture views:

json
{
  "variant_info": { "enabled": false },
  "speed_indicators": { "enabled": false },
  "timestamp": { "enabled": false },
  "navball": { "enabled": false },
  "celestial_indicators": { "enabled": false }
}

Package Sizes

ModeWASMPackage
Production~640KB~900KB
Dev~2.9MB~3MB

Dev packages include debug symbols for easier troubleshooting.