# U-Desk 生态链接 — 开放平台接入方案总览

> 最后更新：2026-05-08 | 状态：调研完成，待实施

---

## 什么是"生态链接"

U-Desk 作为 Wails v3 桌面文件管理器，除了核心的文件管理能力外，通过接入第三方开放平台的 **合规 API/SDK**，为用户提供一站式的 **音乐 / 视频 / 广播 / 课程 / 生活服务** 入口。

**核心理念**：文件管理是主场景，生态服务是增强层 — 不喧宾夺主，而是让用户在管理文件的过程中顺手获得其他服务。

## 文档结构

```
docs/04-功能迭代/生态链接/
├── README.md              ← 本文件（总览）
├── 01-音乐平台.md          ← QQ音乐/网易云/酷狗/Spotify/Apple Music
├── 02-视频平台.md          ← B站/腾讯视频/YouTube/Vimeo
├── 03-广播电台.md          ← Radio Browser/iTunes播客/喜马拉雅/CCTV
├── 04-课程专栏.md          ← 喜马拉雅/得到/豆瓣/知乎/国际MOOC
└── 05-生活服务.md          ← 天气/快递/地图/翻译/钉钉/RSS新闻
```

## 各模块推荐方案速查

| 模块 | P0 首选（国内） | P0 首选（国际） | P1 备选 | MVP 工作量 |
|------|---------------|---------------|---------|-----------|
| **音乐** | ~~QQ音乐~~ (❌ Win不支持) → **Spotify Web API** | **Spotify** | 网易云(实验性) | 3-5天 |
| **视频** | **抖音开放 SDK** ✅ | YouTube IFrame | ~~B站~~ (⚠️ API仓库被律师函关停) | 2-3天 |
| **广播/播客** | Radio Browser API | iTunes Podcast | 喜马拉雅 Web | 4-6天 |
| **课程/知识** | 喜马拉雅 JS SDK | iTunes Search API | ~~豆瓣API~~ (❌仓库404+官方库2014归档) | 2-3天 |
| **生活服务** | **高德 / 百度地图**(二选一) | - | 快递100+和风天气+钉钉 | 3-5天 |

> * 音乐模块含 QQ 音乐桌面端确认的前置依赖，若不支持需切换方案

## 合规底线

1. **全部使用官方 API/SDK**，禁止爬虫/逆向/解密
2. **必须用户授权登录**，借用用户自身会员权益
3. **如实上报播放/调用流水**
4. **标注内容版权归原平台及版权方所有**
5. **优先采用 iframe/H5 嵌入** 方案（视频/音频），而非自建播放器解析流

## 技术适配原则

| 原则 | 说明 |
|------|------|
| WebView2 兼容 | 所有 Web/JS 方案均可在 Wails WebView2 中运行 |
| Go 后端代理 | 敏感操作（API Key 管理/速率控制）通过 Go 后端代理 |
| 渐进式加载 | 生态模块按需加载，不影响文件管理器启动速度 |
| 统一 UI 风格 | 即使嵌入第三方内容，也用 U-Desk 统一外壳包裹 |

## 国内平台调研状态总览

| 平台 | 调研深度 | 状态 | 主要发现 |
|------|---------|------|---------|
| **抖音开放平台** | ✅ 官网完整抓取 | **可接入** | SDK完善，免费，分享/投稿/授权/支付全链路 |
| **高德地图** | ✅ 官网完整抓取 | **可接入** | 44种产品，MCP/CLI 新能力，HarmonyOS 支持 |
| **百度地图** | ✅ 官网完整抓取 | **可接入** | AI 向导检索，HarmonyOS 全覆盖，与高德同级 |
| **腾讯位置服务** | ✅ 开放平台确认 | **可接入** | 街景特色，微信生态协同 |
| **喜马拉雅** | ✅ 官网完整抓取 | **需商务审批** | JS SDK 可用，内容极全（有声书+课程+播客） |
| **QQ音乐** | ✅ 代理深度报告 | **⚠️ 待确认** | Windows 桌面端未在支持列表，需邮件确认 |
| **得到** | ✅ 官网完整抓取 | **❌ 无 API** | 封闭生态：6400万用户/390门课/10万本电子书均不开放 |
| **B站开放平台** | ⚠️ 官网持续不可达（connection refused） | **❌ 已确认不可用** | 非官方API文档已于2026-01-28被律师函关停（SocialSisterYi/bilibili-API-collect） |
| **快递100** | ✅ 官网完整抓取 | **可接入** | 2200+ 快递公司，15年经验，企业级方案 |
| **和风天气** | ✅ 官网完整抓取 | **可接入** | 全球部署，按量计费，有免费层 |
| **钉钉开放平台** | ✅ 官网完整抓取 | **可接入** | 4000+ 接口，全代码/低代码/AI 开发 |

> **跨模块注意**：喜马拉雅同时覆盖「广播电台」和「课程专栏」两个模块，接入一次即可服务双场景。

## 实施路线图

### Phase 0 — 技术验证（1周）
- [ ] 发邮件至 QQ 音乐确认 Windows 桌面端支持
- [ ] Radio Browser API 对接验证（Go 调用 → Vue 展示 → 播放）
- [ ] YouTube IFrame API 嵌入验证
- [ ] 高德地图 JS API 嵌入验证

### Phase 1 — MVP 上线（2-3周）
- [ ] 广播电台模块（Radio Browser + iTunes 播客）
- [ ] 视频嵌入模块（YouTube + B站）
- [ ] 天气小组件（和风天气 / 高德天气）
- [ ] 快递追踪面板（快递100）

### Phase 2 — 深度集成（3-4周）
- [ ] 音乐模块（QQ 音乐或 Spotify）
- [ ] 地图能力（高德完整 LBS）
- [ ] 课程/知识入口（喜马拉雅 + 豆瓣元数据）
- [ ] RSS 新闻聚合

### Phase 3 — 生态完善（持续迭代）
- [ ] 钉钉/飞书效率工具联动
- [ ] 翻译服务集成
- [ ] 更多平台按需接入

## 成本预估

| 阶段 | 月成本 | 说明 |
|------|--------|------|
| Phase 0 | ¥0 | 全部使用免费额度验证 |
| Phase 1 | ¥0 ~ ¥100 | 天气+快递少量调用 |
| Phase 2 | ¥50 ~ ¥300 | 根据用户量增长 |
| Phase 3 | ¥100 ~ ¥500+ | 多平台叠加 |

> 个人使用场景下，**MVP 阶段月成本可控制在 ¥100 以内**。
