环境搭建

前置要求

克隆与构建

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 冒烟。跟随默认未启动，脚本内会把跟随恢复为 active。完整四门门禁见仓库 docs/TESTING.md。

已下架能力的测试不要当成当前产品验收。见 已下架的能力。

产品操作：能做什么。执行链路：跟单执行。