init: mipu-open 对外开放项目统一管理仓库

- 添加 mipu-api 作为 git submodule (Claude Code Skill)
- 迁移 API 文档源文件到 docs/ 目录统一维护
- 添加 Gitea Actions 工作流：tag推送自动打包docs并发布Release
- Skill 运行时自动从 mipu-open Release 下载最新文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/07-01_flight-segment-request.md

@@ -0,0 +1,23 @@
+<!-- mipuyun-api-doc: flight-segment-request -->
+# FlightSegmentRequest
+
+# FlightSegmentRequest对象定义
+
+Segment 对象用于描述单段航班的核心信息（告知我们定位到具体的行程），定义如下：
+
+| **字段名** | **数据类型** | **示例值** | **说明** |
+| --- | --- | --- | --- |
+| carrier | String | "VJ" | 承运航司 IATA 二字码（如 VJ = 越南航空），**与 flightNumber 前缀的航司码一致**（示例中 flightNumber="VJ884"，carrier="VJ" 符合规则） |
+| flightNumber | String | "VJ884" | 航班号，格式为 "航司二字码 + 数字"： |
+| originAirport | String | "BOM" / "SGN" | 出发机场 IATA 三字码（如 BOM = 孟买贾特拉帕蒂・希瓦吉国际机场，SGN = 胡志明市新山一国际机场） |
+| destinationAirport | String | "SGN" / "SYD" | 到达机场 IATA 三字码（如 SYD = 悉尼金斯福德・史密斯机场） |
+| stopCities | String | "CDG/MAD" | 经停地城市三字码，多个城市用 `/` 分隔（可选字段，用于支持包含经停点的航班查询） |
+| departureDate | String | "20251027" | 起飞日期日期，固定格式 `YYYYMMDD`（20251027表示 2025 年 10 月 27 日） |
+
+# 备注
+
+1. **请求体内的旅行时间是departureDate，不同于响应体的departureTime**：原因是航司会出现出发时间的调整，为了保障成功率，请求只需要告知日期即可。
+1. 本实体兼容FlightSegmentResponse, 你可以把shopping/search中获得实体直接引用。
+1. 如入参为departureTime，我们会抛弃时间，只采用日期。
+1. **stopCities 为可选字段**，仅在航班包含经停点时需要填写。格式为多个城市三字码用 `/` 分隔，例如 "CDG/MAD" 表示经停巴黎和马德里。
+