Chengfang Lu
e72bc061c5
Major changes: - New frontend (platform/web/): Vite + React 18 + TypeScript + Tailwind - 4-module navigation: 数据送标 / 模型管理 / 车队管理 / 系统管理 - Data catalog with charts (DMS/ADAS/Lane 3-tab view) - Quality review workflow (标注质检): Good/Fine/Bad scoring with auto-advance - Audit enhancements: batch operations, rejection categories, Feishu notifications - Operation audit log (操作日志) - World model simulation studio (仿真工坊) - Dataset version management with snapshots and diff - ADAS 7-class dataset integration (138K images organized + compressed) - User management with Feishu integration and pagination - CRUD/search/filter on all pages, card layout redesign - PIL-optimized image overlay rendering - Auto-snapshot on build, in_review workflow stage - Removed embedded algorithm code (now in workspace)
64 lines
2.4 KiB
Markdown
64 lines
2.4 KiB
Markdown
# 飞书多维表格 → HSAP 开发交接单
|
||
|
||
运维/协调员填好后交给开发写入 `HSAP/manifests/feishu.env`（勿提交含密钥的 feishu.env 到 git）。
|
||
|
||
## 从 URL 截取（最快）
|
||
|
||
在电脑浏览器打开 **「HSAP数据批次台账」** 多维表格，看地址栏，形态类似：
|
||
|
||
```text
|
||
https://xxx.feishu.cn/base/Bascnxxxxxxxxxxxxxxxx?table=tblxxxxxxxxxxxx&view=vewxxxxxxxx
|
||
└─ APP_TOKEN ─┘ └─ TABLE_ID ─┘
|
||
```
|
||
|
||
- **APP_TOKEN** → 填 `FEISHU_BITABLE_APP_TOKEN`（`/base/` 后面、`?` 前面整段，常以大写 `Basc` 开头）
|
||
- **TABLE_ID** → 填 `FEISHU_BITABLE_TABLE_ID`（`table=` 后面、`&` 前面，以 `tbl` 开头）
|
||
|
||
**表只在知识库（wiki）里、没有 `/base/` 链接时：**
|
||
|
||
- **WIKI 节点** → 填 `FEISHU_BITABLE_WIKI_NODE_TOKEN`（`/wiki/` 后面、`?` 前面，如 `SFvfwCqskiWM0Jk0VfPcdtkun9c`）
|
||
- `FEISHU_BITABLE_APP_TOKEN` 留空；HSAP 会用 wiki API 解析出真正的 Basc `obj_token`
|
||
- 开放平台须开通 **wiki:node:read**（或 wiki:wiki:readonly）+ **bitable:app**，并给表格 **企业应用可管理**
|
||
|
||
## 必填
|
||
|
||
| 变量 | 值 | 获取方式 |
|
||
|------|-----|----------|
|
||
| `FEISHU_BITABLE_APP_TOKEN` | | 浏览器打开台账，地址栏 `/base/` 与 `?table=` 之间整段（见下文「从 URL 截取」） |
|
||
| `FEISHU_BITABLE_TABLE_ID` | | 地址栏 `table=` 后、`&` 前，形如 `tblXXXXXXXX`；或配好 APP_TOKEN 后跑 `feishu_bitable_verify.sh` 列出 |
|
||
|
||
## 已有（登录应用）
|
||
|
||
| 变量 | 值 |
|
||
|------|-----|
|
||
| `FEISHU_APP_ID` | |
|
||
| `FEISHU_APP_SECRET` | |
|
||
|
||
## 建议
|
||
|
||
| 变量 | 值 |
|
||
|------|-----|
|
||
| `AS_FRONTEND_URL` | 内网 HSAP 根 URL，如 `http://192.168.x.x:8787` |
|
||
| `FEISHU_BITABLE_SYNC_ENABLED` | `1` |
|
||
| `FEISHU_BITABLE_SYNC_INTERVAL_SEC` | `120` |
|
||
| `FEISHU_BITABLE_AUTO_INGEST` | `0`（内网 Phase A 保持 0） |
|
||
|
||
## 可选
|
||
|
||
| 变量 | 值 |
|
||
|------|-----|
|
||
| `FEISHU_LABELING_CHAT_ID` | 协作群 chat_id（群机器人通知） |
|
||
|
||
## 表格列名
|
||
|
||
默认与 [FEISHU_BITABLE_OPS.md](./FEISHU_BITABLE_OPS.md) 中文列名一致；若飞书表改了列名，在 `feishu.env` 用 `FEISHU_BITABLE_FIELD_*` 覆盖（见 `feishu.env.example`）。
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
cd HSAP
|
||
# 确保 manifests/feishu.env 已填 BITABLE_*
|
||
bash scripts/feishu_bitable_verify.sh
|
||
curl -sS -H "Authorization: Bearer $TOKEN" http://127.0.0.1:8787/api/v1/integrations/feishu/bitable/status
|
||
```
|