30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
|
# HSAP 飞书集成（内网开发说明）
|
|||
|
|
|
|||
|
|
操作手册：[FEISHU_BITABLE_OPS.md](./FEISHU_BITABLE_OPS.md)
|
|||
|
|
|
|||
|
|
## 架构
|
|||
|
|
|
|||
|
|
- **入站**：无 Webhook（飞书云访问不到内网）
|
|||
|
|
- **出站**：`tenant_access_token` 调用 Bitable API 回写记录
|
|||
|
|
- **轮询**：`FEISHU_BITABLE_SYNC_INTERVAL_SEC`（默认 120s）或 `POST /api/v1/integrations/feishu/bitable/sync`
|
|||
|
|
|
|||
|
|
## 模块
|
|||
|
|
|
|||
|
|
| 路径 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `platform/as_platform/integrations/feishu_bitable.py` | API 客户端、列映射 |
|
|||
|
|
| `platform/as_platform/integrations/feishu_bitable_sync.py` | HSAP→表同步 |
|
|||
|
|
| `platform/as_platform/integrations/feishu_bitable_ingest.py` | 待落盘→analyze→promote |
|
|||
|
|
| `platform/as_platform/integrations/feishu_notify.py` | 群文本通知（可选） |
|
|||
|
|
| `platform/as_platform/jobs/feishu_bitable_sync.py` | `run_sync_cycle()` 后台轮询 |
|
|||
|
|
| `platform/as_platform/api/feishu_routes.py` | status / sync / ingest / backfill-hints |
|
|||
|
|
|
|||
|
|
## 权限
|
|||
|
|
|
|||
|
|
- `POST .../sync`、`GET .../backfill-hints`：需 `write:labeling_assign` 或 `*`
|
|||
|
|
|
|||
|
|
## Phase
|
|||
|
|
|
|||
|
|
- **A**（默认）：回写 Inbox路径、HSAP进度、活动ID、状态、链接
|
|||
|
|
- **B**：`FEISHU_BITABLE_AUTO_INGEST=1` 时轮询「待落盘」→ analyze → promote；或 `POST .../bitable/ingest`
|