Private
Public Access
1
0

新增: SFTP直连+网站预览+OSS区域嗅探+热键+BGM播放

This commit is contained in:
2026-05-12 11:06:28 +08:00
parent 545d7a864d
commit 2a363fd729
62 changed files with 6687 additions and 660 deletions

View File

@@ -0,0 +1,106 @@
# 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 以内**。