环境搭建
克隆仓库、Rust 工具链、Docker Postgres，跑通本地开发环境
前置要求
系统要求
推荐 Linux（Ubuntu 22.04+）或 macOS。需安装 Rust（见 rust-toolchain.toml）、Docker（Postgres）、Node.js（web-ui / website）、以及本机可执行的 cargo。
克隆与构建
git clone <your-sharpside-remote> sharpside
cd sharpside
cargo build
Cargo workspace 含 crates/*、services/*、部分 apps/*（含 sharpside-daemon、sharpside-tg-bot 等）。前端在 apps/web-ui、apps/admin-ui、website/（不进 Cargo）。公开 daemon 树在 opensource/sharpside-daemon。
基础设施
环境变量模板：infra/.env.example（复制为仓库根 .env 或按脚本约定使用，勿提交密钥）。
仅起 Postgres（联调 / e2e 常用）：
docker compose -f infra/docker-compose.yml up -d postgres
完整本机栈（业务镜像）须 宿主机先 cargo 编译再打 prebuilt 镜像，up 不要加 --build：
# 见仓库 .cursor/rules 与 infra/scripts/lib/prebuilt-images.sh
export ROOT="$(pwd)"
export CARGO_TARGET_DIR="${ROOT}/target"
# cargo_build_bins → stage_prebuilt_bins → docker_build_prebuilt_images
docker compose -f infra/docker-compose.yml --env-file .env -p infra up -d
前端（用户端）
cd apps/web-ui
npm ci
npm run dev # 默认 :3001；经 gateway 反代时见 TESTING.md
运营台：apps/admin-ui。知识库站：website/ → npm run dev → http://localhost:3000/docs。
一键 E2E
bash infra/e2e.sh
会拉起 account / follow / copier / admin / signer 占位等，断言双通道 dry_run 闭环与 admin 冒烟。注意：跟随默认未启动，脚本内会 start follow；通道 B 需本机 daemon 二进制。
完整四门门禁见仓库 docs/TESTING.md。
AI Trader（本机验收）
AI 执行面本机脚本（勿在远程业务机 / 签名机跑）：
bash infra/e2e_ai_trader_sim.sh
# 另有 e2e_ai_trader_live.sh / e2e_ai_trader_hybrid.sh 等，见 docs/TESTING.md §AI
产品操作手册：能做什么 · AI Trader。架构摘要：AI Trader 架构。