From 4092854b0bea9e1fc02f29222c6f7cd876e565a5 Mon Sep 17 00:00:00 2001
From: shuishen <1109946754@qq.com>
Date: Mon, 17 Aug 2026 09:43:20 +0800
Subject: [PATCH] feat:项目基础整理

---
 apps/workbench-console/README.md |   29 +++++++++++++++++++++++++----
 1 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/apps/workbench-console/README.md b/apps/workbench-console/README.md
index dd0d4ad..552bcfd 100644
--- a/apps/workbench-console/README.md
+++ b/apps/workbench-console/README.md
@@ -1,8 +1,9 @@
 # GeoAI Workbench 本地实验控制台
 
 这是一个完全独立于无人机产品的本地只读控制台。它只展示本工作区已有能力的
-输入说明、运行元数据和结果工件,不上传数据、不调用外部 API,也不提供删除、
-覆盖或启动算法的操作。
+输入说明、运行元数据和结果工件,不上传数据,也不提供删除、覆盖或启动算法的
+操作。地图会直接请求公开 ArcGIS 影像切片;配置天地图 token 后还会直接请求
+天地图影像和注记切片。
 
 ## 启动
 
@@ -37,6 +38,18 @@
 
 Vite 开发服务固定使用 `http://127.0.0.1:6174/apps/workbench-console/`,会通过本机代理读取 `6173` 的结果工件。
 
+## 地图底图
+
+Cesium 默认加载公开 ArcGIS World Imagery 底图。要叠加天地图影像和注记,在
+`apps/workbench-console/.env.local` 中填写下列值后重新执行 `npm run build`:
+
+```text
+VITE_TIANDITU_TOKEN=<your-token>
+```
+
+可先参考同目录的 `.env.example`。`VITE_` 变量会被打包进本地浏览器代码,因此
+只应填入适合客户端使用的天地图访问 token,不要填入其他服务密钥。
+
 ## 目录职责
 
 - `apps/workbench-console/src/`:Vue 3 组件、路由、Pinia 状态与能力适配层。
@@ -44,5 +57,13 @@
 - `scripts/serve_workbench_console.py`:只读本地文件服务;仅暴露构建后的控制台、已有输出和目标检测原图,不暴露仓库其余文件。
 - `shared/outputs/`:能力原始输出;控制台不复制、不修改这些文件。
 
-首版已接入 `01-object-detection` 和 `15-trajectory-analysis`。其他能力保留目录和
-边界状态,待其首个 Demo 产出可检查工件后再接入。
+首版已接入 `01-object-detection` 和 `15-trajectory-analysis`。田墩实飞案例会显示
+实飞轨迹、计划航线、禁飞区与适飞区,并提供轨迹和区域范围的聚焦按钮。其他能力
+保留目录和边界状态,待其首个 Demo 产出可检查工件后再接入。
+## 本地运行工作台
+
+控制台现支持可操作的本地实验运行,并保持与无人机产品完全独立。能力页面提供新建运行入口和可搜索扩展的案例库,案例由本地服务从运行目录自动发现,不再依赖前端硬编码 Tabs。
+
+- 轨迹分析上传 `XLSX`、`KMZ`、禁飞区 `GeoJSON` 和可选适飞区 `Gzip`,原始、处理和输出分别归档在 `shared/data/raw`、`shared/data/processed`、`shared/outputs`。
+- 目标检测上传最多 12 张 `JPG/JPEG/PNG`,原图和标注图默认并列对比,每次生成独立运行编号。
+- 本地 API 为 `GET/POST /api/trajectory/runs` 和 `GET/POST /api/object-detection/runs`,仅监听回环地址,端口必须是 `6xxx`;服务只调用固定虚拟环境和能力脚本,不接受任意命令或任意路径。

--
Gitblit v1.9.3