107 lines
5.4 KiB
Markdown
107 lines
5.4 KiB
Markdown
# 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 以内**。
|