# 飞书项目URL构造速查

> 编辑时间: 2026-07-09

## 项目信息

| 项目 | project_key | simple_name |
|------|------------|-------------|
| 销售管理 | `6593cd71471290e3cc6be6e6` | `xsguanli` |
| 客户项目管理 | `658bb60520ea78a2125f1b99` | `csrw` |
| 售后管理 | `658288abfb8bd616b17025f1` | `br-shgl` |

## 工作项详情URL

```
https://project.feishu.cn/{simple_name}/{work_item_type}/detail/{work_item_id}
```

### ⚠️ 关键陷阱

- 导出模板URL使用 `sj` 作为商机类型，但前端实际路由使用 `story`
- **错误的**: `xsguanli/sj/detail/xxx` → 显示"无对应工作项"
- **正确的**: `xsguanli/story/detail/xxx`
- 工作项类型key从 `list_workitem_types` 或 `get_workitem_brief.work_item_type.key` 获取
- 使用 `meegle url decode <url>` 验证URL格式

### 生成代码

```python
url = f"https://project.feishu.cn/{simple_name}/{work_item_type_key}/detail/{work_item_id}"
```

## 业务线分类规则

- 工作项名称含「课题组」→ 生命科学销售部（PI实验室）
- 其余 → 诊断原料销售部（IVD企业）

## MQL 可用字段（已确认）

| 字段名 | 用途 | 状态 |
|--------|------|:--:|
| name / `名称` | 工作项名称 | ✅ |
| description | 描述 | ✅ |
| `创建时间` | 创建日期 | ✅ |
| `创建者` / owner | 创建人 | ✅ |
| work_item_id / `工作项id` | 唯一ID | ✅ |
| `活动关联客户` | 客户关系字段 | ❌ MQL不暴露 |
| `活动对应销售订单` | 订单关系字段 | ❌ MQL不暴露 |

## MQL 语法速查

```
SELECT name, description, `创建时间`, `创建者`, work_item_id
FROM `销售管理`.`story`
ORDER BY `创建时间` DESC
LIMIT 50 OFFSET 0
```

- `project_key` 是独立参数，不在MQL字符串内
- 不支持 `SELECT *`
- 中文字段名必须反引号包裹
- 分页用 `LIMIT OFFSET`（非 session_id 循环）