docs: 部署交接文档、lake_example 自动植入与 CLAUDE 快速部署指南

新增 seed_lake_example.sh 并在 init_after_clone 中调用;更新 README/CLAUDE/DEPLOY
使接手人 clone 后即可走通送标样例流程。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-06-16 17:36:37 +08:00
parent 5f9addb9bf
commit 2d450715ff
7 changed files with 236 additions and 50 deletions

View File

@@ -4,7 +4,51 @@
克隆本仓库即可运行;**算法源码与数据集脚手架已内嵌**。大文件(图像、训练权重)通过外部 `workspace`**送标数据湖** 挂载,不进入 Git。
**新机器部署请直接看 → [docs/DEPLOY.md](docs/DEPLOY.md)**
**新机器 3 步部署 → 见下方 [快速部署到其他机器](#快速部署到其他机器)** · 详细文档 [docs/DEPLOY.md](docs/DEPLOY.md)
---
## 快速部署到其他机器
在目标 Linux 机器上执行(需 Docker + Node 18+
```bash
# 1. 克隆HTTPS 需 Gitea 用户名 + Access Token 作密码;或配置 SSH 公钥)
git clone https://git.sanyele.com/ChengFang.LU/HSAP.git
cd HSAP
# 2. 初始化:.env、feishu.env、前端构建、lake_example 样例植入
bash scripts/init_after_clone.sh
# 3. 启动平台 + CVAT
bash scripts/dev_up.sh
```
浏览器打开 http://127.0.0.1:8787 → 开发登录 → **批次台账 → 扫描数据湖 → 登记 → 送标工作台开标**(样例已自动就位)。
| 检查项 | 命令 / 地址 |
|--------|-------------|
| 平台健康 | `make health` |
| 容器状态 | `docker compose ps` |
| 样例批次 | `lake/lake_example/datasets/manifest.yaml` |
| 局域网访问 | 改 `.env``AS_FRONTEND_URL``CVAT_PUBLIC_URL``http://<IP>:8787` / `:8080` |
**目录布局(推荐与仓库平级):**
```text
/opt/DATA/
├── HSAP/ ← git clone
└── data/ ← AS_DATA_LAKE_HOSTinit 自动创建 送标/adas/inbox
```
`AS_WORKSPACE_ROOT`DMS 训练大图)**验收送标流程不必配置**;有外部 workspace 时再在 `.env` 填写。
**推送代码到远端:**
```bash
git push origin main
# 用户名 Chengfang.LU密码填 Gitea Access Token设置 → 应用 → 生成令牌)
```
---
@@ -55,12 +99,11 @@ HSAP/
git clone https://git.sanyele.com/ChengFang.LU/HSAP.git
cd HSAP
bash scripts/init_after_clone.sh # 生成 .env / feishu.env构建前端
# 编辑 .envAS_WORKSPACE_ROOT、AS_DATA_LAKE_HOST、AS_FRONTEND_URL
bash scripts/init_after_clone.sh # .env / feishu.env构建前端、植入 lake_example 样例
bash scripts/dev_up.sh # 或: make up
```
`make up` / `dev_up.sh` 一次启动 **HSAP 平台 + 内置 CVAT**(无需单独部署 CVAT无需 CVAT 账号登录)
按上面两步即可 **启动平台**`init_after_clone.sh` 会自动把 [`lake/lake_example`](lake/lake_example/) 里的示例送标批次复制到数据湖 inbox接手人无需再手动拷文件
| 服务 | 地址 | 说明 |
|------|------|------|
@@ -79,7 +122,42 @@ make health # API 健康检查
**改前端后:**`bash scripts/build_web.sh``docker compose restart platform`
**部署到他人电脑 / 局域网:** 修改 `.env``AS_FRONTEND_URL``CVAT_PUBLIC_URL``FEISHU_REDIRECT_URI` 为实际访问地址,详见 [docs/DEPLOY.md](docs/DEPLOY.md)。
**局域网部署** 修改 `.env``AS_FRONTEND_URL``CVAT_PUBLIC_URL`,详见 [docs/DEPLOY.md](docs/DEPLOY.md)。
---
## 接手走通送标流程lake_example
仓库内 [`lake/lake_example/`](lake/lake_example/) 含 **DMS / ADAS 2D / ADAS 3D / Lane** 各一条样例批次(含少量图片),用于验收全流程。
### 一键植入(部署时自动执行)
```bash
bash scripts/init_after_clone.sh # 已包含 seed
# 或单独执行:
bash scripts/seed_lake_example.sh
```
样例落盘位置:
| 业务 | 路径 | 样例批次 |
|------|------|----------|
| ADAS 2D | `data/送标/adas/inbox/det_7cls/` | `20260616_adas2d_pilot` |
| ADAS 3D | `data/送标/adas/inbox/cuboid_7cls/` | `20260616_3d_pilot` |
| DMS | `datasets/dms/inbox/addw/` 等 | `20260616_addw_pilot` 等 |
| Lane | `datasets/lane/inbox/` | `20260616_lane_pilot` |
默认 `AS_DATA_LAKE_HOST=../data`(与 HSAP 仓库平级)。完整清单见 [`lake/lake_example/datasets/manifest.yaml`](lake/lake_example/datasets/manifest.yaml)。
### UI 操作顺序
1. 打开 http://127.0.0.1:8787 → 开发登录
2. **批次台账****扫描数据湖** → 勾选样例批次 → **登记到台账**
3. **送标工作台** → 选批次(建议先试 `adas / det_7cls / 20260616_adas2d_pilot`)→ **开标**
4. **标注进度****分配任务** → 标注员进入 **我的标注** → CVAT 画框保存
5. 协调员 **提交批次** → 审核员 **审核队列** 通过 → 导出入库
清空标注记录重来:`bash scripts/reset_labeling.sh`(不删 inbox 文件,可再次扫描登记)。
---
@@ -127,6 +205,8 @@ ADAS 7 类:`car`, `pedestrian`, `truck`, `bus`, `motorcycle`, `tricycle`, `tra
批次目录示例见 `lake/lake_example/`。登记:**批次台账 → 扫描数据湖 → 登记**。
部署时执行 `bash scripts/seed_lake_example.sh`(已包含在 `init_after_clone.sh`)可自动植入样例批次。
清空送标/标注 DB保留账号`bash scripts/reset_labeling.sh`
---