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:
90
README.md
90
README.md
@@ -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_HOST,init 自动创建 送标/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,构建前端
|
||||
# 编辑 .env:AS_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`
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user