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,263 @@
# 音乐开放平台接入方案备忘录
> 最后更新2026-05-08 | 用途U-Desk 生态链接 — 音乐模块可行性评估
---
## 一、平台总览对比
| 维度 | QQ音乐 | 网易云音乐 | 酷狗音乐 | Spotify | Apple Music |
|------|--------|-----------|----------|---------|-------------|
| **官网** | [developer.y.qq.com](https://developer.y.qq.com/) | [developer.music.163.com](https://developer.music.163.com/) | [open.kugou.com](https://open.kugou.com/) | [developer.spotify.com](https://developer.spotify.com/documentation/web-api/) | [Apple MusicKit](https://developer.apple.com/documentation/musickit) |
| **官方性质** | 官方 | 非官方(社区逆向) | 官方 | 官方 | 官方 |
| **曲库规模** | 海量正版(业内估计亿级,待文档中心登录确认) | 数亿首 | 4000万+ | 1亿+ | 1亿+ |
| **费用** | 未公开(需商务) | 免费(非商用) | 按千次播放计费 | 免费额度/按量 | 免费(Apple Developer) |
| **Windows桌面支持** | **❌ 确认不支持2026-05-08 核实)** | HTTP调用可用 | ❌ 仅Android/iOS | Web Playback SDK | MusicKit JS |
| **中文歌曲覆盖** | 极全 | 极全(含小众) | 全 | 中等 | 中等 |
| **中国区可用性** | 原生 | 原生 | 原生 | 需翻墙 | 受限 |
| **推荐评级** | ⭐⭐⭐ 待确认 | ⭐⭐ 灰色地带 | ⭐ 不适配 | ⭐⭐⭐ 技术可行 | ⭐⭐ 有限 |
---
## 二、QQ音乐开发者平台首选候选
### 基本信息
- **官网**https://developer.y.qq.com/
- **文档中心**https://developer.y.qq.com/docs/openapi
- **联系邮箱**qmopen@tencent.com
- **版权归属**:腾讯公司
### 核心能力(三大服务模块)
#### 1. 登录授权 (Login Auth)
- 基于腾讯社交账号体系(微信/QQ/QQ音乐APP
- QPlay Auth 授权方式
- 授权后可获取音乐流、播放控制、在线音乐服务、个人权益
#### 2. OpenAPI
- 在线听歌、排行榜、热门歌曲
- OpenId 用户标识
- 歌词、MV/视频("音视听资源"
- 文档子分类登录鉴权、SDK、OpenAPI、APP互联、QPlay
#### 3. QPlay 协议
- QPlay Auth授权认证
- QPlay Cloud云端服务
- QPlay Lan局域网协议
- QPlay IPC进程间通信
### 支持终端类型6类
| 终端 | 支持 |
|------|------|
| 移动应用 (iOS/Android) | ✅ |
| 网站/小程序 | ✅ |
| 智能硬件 | ✅ |
| 车载应用 | ✅ |
| 公播盒子 | ✅ |
| **Windows桌面EXE** | **❓ 未明确列出** |
### 行业解决方案
社交行业、直播行业、TV/大屏、智能车载、公播行业 — 均有定制方案
### 费用模式
- **未公开透明**,需商务对接获取报价
- 通常为按调用量计费或预付授权金模式
### 关键风险2026-05-08 深入核实后更新)
> **Windows桌面端确认不支持**。官网明确列出 6 类终端(移动应用/网站小程序/智能硬件/车载应用/公播盒子/大屏解决方案),**无一可映射到 Windows 桌面端 EXE**。QPlay 协议描述的"软件应用"在终端列表中被具体化为"移动应用"和"网站/小程序",无 Windows 入口。
### 评估结论:**可能性低(接近零)**
- QQ 音乐开发者平台面向腾讯生态内典型场景移动App/小程序/IoT/车载)
- Windows 桌面端不在目标覆盖范围
- 申请接入时很可能被拒绝或无法通过审核
- **但仍建议发邮件 `qmopen@tencent.com` 正式询问**(预期负面,但留档备查)
### 备选方案优先级调整
由于 QQ 音乐 Windows 桌面端支持概率极低:
1. **第一优先级应调整为 Spotify Web API**Web Playback SDK 可在 Wails WebView2 运行)
2. QQ 音乐降为"长期跟进"(定期重试官网看是否新增 Windows 支持)
3. 网易云音乐保持"实验性/个人版"定位不变
---
## 三、网易云音乐(技术可行但灰色地带)
### 基本信息
- **官网**https://developer.music.163.com/
- **实际可用API**[NeteaseCloudMusicApi](https://binaryify.github.io/NeteaseCloudMusicApi/)社区维护GitHub Star 30k+
### 核心能力150+ 接口)
| 模块 | 主要接口 |
|------|---------|
| 登录鉴权 | 登录/刷新/手机验证码/注册/退出 |
| 用户信息 | 用户详情/歌单/关注/粉丝/动态/播放记录 |
| 搜索 | 搜单曲/专辑/歌手/歌单/MV/歌词/电台/用户 |
| 歌曲 | 详情/歌词/评论/相似/喜欢/打卡 |
| 歌单 | 精品歌单/详情/分类/推荐/每日推荐 |
| 专辑 | 内容/评论/新碟上架/最新 |
| 歌手 | 热门/单曲/MV/专辑/描述/相似/榜单 |
| MV/视频 | 最新/推荐/排行/播放/相似/收藏/评论 |
| 排行榜 | 所有榜单及内容摘要 |
| 电台/DJ | 推荐/分类/订阅/详情/节目 |
| 个性化 | 私人FM/每日推荐/推荐新音乐/独家放送 |
| 社交互动 | 评论/动态/转发/分享/关注 |
| 云盘 | 上传/详情/删除 |
### 优势
- API 能力极其丰富,几乎覆盖所有功能
- 社区活跃多语言客户端Python/Java/Go
- 免费使用,无需预充值
- 曲库规模大,独立音乐人内容丰富
- 个性化推荐算法优秀
### 劣势(致命问题)
- **非官方逆向工程 API**,存在法律合规风险
- 无官方 SLA 保障,接口随时可能变更失效
- 需要用户账号 Cookie/Token 登录
- 存在频率限制,过频请求会被临时封禁
- **不适合正式商业产品发布**
### 适用场景
个人工具 / 内部使用 / 原型验证 — **不可作为正式功能上线**
---
## 四、酷狗音乐(不推荐)
### 基本信息
- **官网**https://open.kugou.com/
- **曲库开放计划**https://open.kugou.com/docs/open-player/
### 两条产品线
| 产品线 | 说明 |
|--------|------|
| 曲库开放组件SDK | 千万级正版曲库,仅在线流媒体播放 |
| 酷狗小程序 | 4000万曲库仅在酷狗APP内运行 |
### 费用模式
- **按千次有效播放计费**
- **预充值模式**,随充随用
- 小程序免费但只能在酷狗APP内
### 致命缺陷
- **SDK 仅支持 Android + iOS**,无 Windows 版本
- 无 H5/Web 版本
- 无自定义 UI纯后台播放组件
- 必须标注"酷狗提供技术支持"
- 需要企业资质申请
### 结论:**完全不适用于 U-Desk**
---
## 五、Spotify Web API国际备选
### 基本信息
- **文档**https://developer.spotify.com/documentation/web-api/
- **基础地址**https://api.spotify.com
- **认证方式**OAuth 2.0Spotify Accounts Service
### 核心能力
- 搜索艺术家/专辑/曲目/播放列表
- 获取曲目元数据(名称、时长、封面、音频特性)
- 用户相关数据(播放列表、已保存音乐)
- 分页查询、条件请求缓存ETag
### 费用
- **免费层级**:有速率限制
- 应用审核后可获得更高配额
### U-Desk 适配分析
- **Web Playback SDK** 可在浏览器环境运行 → Wails WebView2 兼容
- RESTful JSON API → Go 后端可直接调用
- **但中国区需要翻墙**,且中文曲库覆盖一般
### 推荐作为:英文/国际化音乐的补充方案(非主力)
---
## 六、Apple MusicKit
### 基本信息
- **文档**https://developer.apple.com/documentation/musickit
- **MusicKit JS**:可在网页中嵌入 Apple Music 播放器
### 能力
- 搜索/浏览 Apple Music 曲库
- 播放控制(需用户 Apple Music 订阅)
- 元数据获取(封面、歌词等)
### 限制
- 需要 Apple Developer 账号($99/年)
- 中国区 Apple Music 曲库受限
- 用户需要有有效的 Apple Music 订阅才能播放完整曲目
### 结论:**不纳入本次实施范围**(成本高 $99/年 + 中国区曲库受限)
---
## 七、合规硬性规则
| 规则 | 说明 |
|------|------|
| 禁止爬虫 | 不得通过爬虫抓取音频文件 |
| 禁止解密 | 不得解密 DRM 保护的内容 |
| 禁止本地缓存 | 不得将音乐文件缓存在本地 |
| 用户授权 | 必须使用用户自己的账号登录,借用其会员权益播放 |
| 如实上报 | 必须按接口要求上报播放流水(用于平台与版权方结算) |
| 版权标注 | 必须标注版权归对应平台及版权方所有 |
---
## 八、最终推荐方案2026-05-08 更新)
### 第一优先级Spotify Web API调整为首选
- **理由**:免费 + 文档完善 + **Web Playback SDK 可在 Wails WebView2 运行**QQ音乐 Windows 支持概率极低)
- **用途**:主力音乐接入(国际+通过代理可访问中文内容)
- **限制**:需翻墙、中文曲库有限
### 第二优先级QQ音乐开放平台降为"长期跟进"
- **理由**:正版授权 + 曲库全 + 腾讯生态 — **但 Windows 桌面端确认不支持**
- **状态**:定期(月度)重试官网看是否新增 Windows 终端类型
- **前置条件**:发邮件 `qmopen@tencent.com` 获得书面回复确认后才可启动开发
- **风险评估**:高(大概率被拒或无回复)
### 第三优先级:网易云音乐(实验性不变)
- **理由**:功能最丰富、开发最快
- **用途**:个人版/内测版本验证产品形态
- **红线**:正式版必须替换为官方合规方案
### 明确舍弃
- ~~酷狗音乐~~ — 不支持桌面端
- ~~Apple MusicKit~~ — 成本高、中国区差
- ~~QQ 音乐(作为 MVP 首选)~~ — Windows 桌面端不支持,从 P0 降为长期跟进
---
## 九、快速上手清单(待确认后补充)
> 以下步骤依赖 QQ 音乐平台的 Windows 桌面端支持确认结果:
1. [ ] 发送咨询邮件至 qmopen@tencent.com
2. [ ] 注册 QQ 音乐开发者账号
3. [ ] 创建应用,获取 AppID/AppKey
4. [ ] 选择接入方式OpenAPI 或 SDK
5. [ ] 配置回调域名/URL Scheme
6. [ ] 集成登录授权流程
7. [ ] 对接核心 API搜索/播放/歌词)
8. [ ] 提交应用审核
9. [ ] 接入播放流水上报
10. [ ] 上线发布
---
*Sources:*
- *QQ音乐开发者平台: https://developer.y.qq.com/*
- *NeteaseCloudMusicApi: https://binaryify.github.io/NeteaseCloudMusicApi/*
- *酷狗开放平台: https://open.kugou.com/*
- *Spotify Web API: https://developer.spotify.com/documentation/web-api/*
- *Apple MusicKit: https://developer.apple.com/documentation/musickit*

View File

@@ -0,0 +1,335 @@
# 视频平台开放API接入方案备忘录
> 最后更新2026-05-08 | 用途U-Desk 生态链接 — 视频模块可行性评估
---
## 一、平台总览对比
| 维度 | 哔哩哔哩 | **抖音开放平台** | 腾讯视频 | 爱奇艺 | 优酷 | YouTube IFrame |
|------|---------|------------|---------|--------|------|----------------|
| **官网** | [developer.bilibili.com](https://developer.bilibili.com/) | [open.douyin.com](https://open.douyin.com/) | [open.tencent.com](https://open.tencent.com/) | 开放程度有限 | 开放程度有限 | [developers.google.com/youtube](https://developers.google.com/youtube) |
| **官方开放平台** | ✅ 有 | ✅ **有(完善)** | ✅ 有 | ⚠️ 有限 | ⚠️ 有限 | ✅ IFrame API |
| **核心能力** | 搜索/播放/弹幕/投屏 | **分享/授权/小程序/支付/数据** | 播放SDK | 嵌入播放 | 嵌入播放 | 嵌入播放/数据API |
| **费用** | 需申请确认 | **免费** | 商务合作 | 不明 | 不明 | 免费 |
| **Windows桌面适配** | 待确认(官网500) | **SDK / H5** | SDK/H5 | H5嵌入 | H5嵌入 | WebView2完美 |
| **中文内容** | 极全 | **极全日活8亿+** | 极全 | 全 | 全 | 中等 |
| **推荐评级** | ⭐⭐⭐ 待确认 | **⭐⭐⭐ 国内首选** | ⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐⭐ 技术可行 |
---
## 二、抖音开放平台(国内首选 ⭐⭐⭐)
### 基本信息
- **官网**https://open.douyin.com/
- **归属**:字节跳动 / 抖音
- **资质**:增值电信业务经营许可证 川B2-20220549
- **客服电话**400-140-2108
- **状态****活跃维护中2026年3月仍有更新日志**
### 开放形态5种载体
| 载体 | 说明 | U-Desk 适配 |
|------|------|-------------|
| **抖音开放能力 SDK** | 分享/授权/投稿/名片/数据能力 | ✅ **核心接入方式** |
| **抖音小程序** | 在抖音内运行的小程序 | 可选(需抖音内分发) |
| **抖音小游戏** | 游戏类小程序 | 不适用 |
| **直播小玩法** | 直播互动工具 | 不适用 |
| **网站应用** | H5 网页应用 | 备选 |
### 核心能力SDK 详细)
#### 分享能力
| 能力 | 说明 |
|------|------|
| **分享到私信** | 从第三方 App 指定链接分享至抖音 IM含私聊/群聊),生成消息卡片 |
| **分享到朋友日常** | 转发非本人创作内容至"朋友"Tab 社交分发 |
| **投稿到抖音** | 从第三方 App 直接发布视频到抖音 |
#### 授权与身份
| 能力 | 说明 |
|------|------|
| **抖音授权** | OAuth 式用户授权登录 |
| **抖音名片** | 展示用户在抖音的身份信息 |
#### 数据能力
| 能力 | 说明 |
|------|------|
| **数据 API** | 获取分享数据、播放量等统计 |
| **搜索服务直达** | 从抖音搜索直达第三方服务 |
### 行业解决方案
| 方向 | 核心能力 |
|------|---------|
| **通用行业** | 搜索直达 / 短视频达人推广 / 短视频挂载 / 直播挂载 |
| **生活服务** | 餐饮团购 / 酒店景区 / 到综服务(线上购买+线下履约) |
| **交易能力** | 线上支付 / 结算分账 |
### 接入流程
```
01 注册/入驻 → 02 选择业务生态 → 03 开发调试 → 04 经营业务
```
### 费用模式
- **免费接入**(基础 SDK 能力)
- 交易场景涉及支付结算时按规则分成
- 无月费/年费
### U-Desk 集成方案
```
U-Desk + 抖音 SDK
├── 视频分享 → 选中视频文件 → 一键分享到抖音
├── 投稿发布 → 编辑好的视频 → 直接发布到抖音
├── 用户授权 → OAuth 登录(可选,用于同步抖音身份)
└── 数据回流 → 抖音播放/互动数据回传 U-Desk 统计
```
### 为什么是"国内首选"
1. **日活 8 亿+** — 国内最大短视频平台,远超 B站
2. **完善的开放平台** — 官网活跃、文档齐全、SDK 成熟
3. **免费接入** — 无门槛,个人开发者友好
4. **Windows 桌面支持** — SDK 支持 H5/网站应用形态
5. **生态完整** — 分享/投稿/授权/支付/数据全链路
6. **与文件管理器天然契合** — 视频文件管理 → 分享/投稿一键触达
### 与 YouTube IFrame 的分工
| 场景 | 选抖音 | 选 YouTube |
|------|--------|-----------|
| 分享视频到社交平台 | ✅ 抖音国内8亿用户 | ❌ |
| 发布/投稿视频 | ✅ 抖音(直接发布) | ❌ |
| 在 U-Desk 内播放视频 | ❌ | ✅ YouTubeIFrame 嵌入) |
| 国际内容消费 | ❌ | ✅ YouTube |
| 搜索国际视频元数据 | ❌ | ✅ YouTube Data API |
---
## 三、哔哩哔哩开放平台(⚠️ 已确认不可用)
### 基本信息
- **官网**https://developer.bilibili.com/
- **状态****❌ 持续不可达**2026-05-08 多次验证connection refused
- **法律状态****⚠️ 非官方 API 文档已被律师函强制关停**(见下方证据)
### ⚠️ 法律风险升级2026-05-08 核实)
> **B站最大 GitHub API 文档仓库 `SocialSisterYi/bilibili-API-collect` 已于 2026-01-28 收到 B 委托律师事务所发律师函警告邮件,维护者随即停止维护并删除相关文档及源代码。**
这意味着:
- 文档中此前列出的"已知能力"搜索API/视频播放/弹幕/用户信息/投屏/数据统计等)**全部来自已被法律关停的非官方逆向工程**
- **无法作为合法接入依据**
- 使用此类 API 的商用产品面临法律风险
### 可行方案(仅限轻量场景)
| 方案 | 可行性 | 风险 |
|------|--------|------|
| iframe 嵌入 B站视频播放页 | ✅ 技术可行 | 低(官方分享嵌入通常允许) |
| 非官方 API自部署 NeteaseCloudMusicApi | ✅ 技术可行 | **高(法律风险,已发生律师函先例)** |
| 官方 OpenAPI | ❌ | 平台不可达 + 无公开文档 |
### 最终评估
- **作为 API 数据源**:❌ **不可用**(平台不可达 + 非官方文档已关停)
- **作为 iframe 嵌入**:⭐ 可行但功能有限(仅播放,无搜索/推荐/个性化)
- **推荐评级从 "待确认" 降为 D不可用**
- **搜索API**:搜视频/番剧/影视/直播/用户
- **视频播放**支持嵌入播放器iframe
- **弹幕系统**:发送/获取弹幕
- **用户信息**:关注/粉丝/动态
- **投屏协议**DLNA/Cast
- **数据统计**:播放量/点赞/投币/收藏
### 接入方式(推测)
| 方式 | 说明 |
|------|------|
| iframe 嵌入 | 最简单,直接嵌入视频播放页 |
| OpenAPI | RESTful 接口,需申请 AppKey |
| SDK | 可能有桌面端 SDK待确认 |
### U-Desk 适配路径
1. **轻量方案**WebView2 iframe 嵌入 B站视频 → 最快实现
2. **深度方案**:对接 OpenAPI → 搜索+自定义播放器UI
### 费用
- 个人开发者通常有免费额度
- 商用需联系商务
### 下一步
- 等 B站开发者平台恢复后查看完整文档
- 备选:直接使用 iframe 嵌入方案无需API
---
## 四、腾讯视频开放平台(⚠️ 需区分两条路径)
### 基本信息
- **C端产品**https://v.qq.com/ (腾讯视频消费者端)
- **B端云服务**https://cloud.tencent.com/product/vod (腾讯云点播 VOD
- **开放平台**https://open.tencent.com/ (存在,主要覆盖应用宝/微信/QQ
### ⚠️ 关键区分2026-05-08 核实)
| 路径 | 说明 | U-Desk 适配 |
|------|------|-------------|
| **A. 腾讯云点播 VOD** | B端云服务上传/管理/播放**自己的视频内容** | 如果 U-Desk 要做"用户上传视频→云端转码→分发播放",可用此 API |
| **B. 腾讯视频内容接入** | 在 U-Desk 中嵌入播放腾讯视频的**自有内容** | ❌ **无官方 API**。v.qq.com 无开发者页面返回404 |
### 腾讯云 VOD 能力(路径 A如需要
- 完整的媒资上传/转码/处理/分发 API
- 控制台 + SDK但主要是移动端/服务器端)
- 计费:按存储量 + 转码时长 + CDN 流量
### 结论
- 文档此前写的"可能通过腾讯云点播 VOD"是**方向正确但场景需澄清**
- **如果目标是"在 U-Desk 里看腾讯视频"**:只能 H5 嵌入(无官方 API
- **如果目标是"U-Desk 做视频托管平台"**:腾讯云 VOD 有完善 API 可用
- 对 U-Desk 当前定位(文件管理器 + 生态入口),**腾讯视频价值有限**,优先级低于抖音和 YouTube
---
## 五、爱奇艺 / 优酷
### 共同特点
- 开放程度有限,主要以 **H5 嵌入****合作接入** 为主
- 无完善的公开开发者 API 文档
- 更倾向于大客户商务合作模式
### 可行方案
- **iframe 嵌入**:直接在 WebView2 中加载视频页面
- 作为"快捷链接"功能而非深度集成
- 合规风险较低(官方提供的分享嵌入代码)
---
## 六、YouTube IFrame API国际内容补充
### 基本信息
- **文档**https://developers.google.com/youtube/iframe_api_reference
- **Player API**:完整的播放控制 JavaScript API
- **Data API v3**:搜索/获取视频元数据(需要 API Key
### 核心能力
```javascript
// IFrame API 示例 — 完美兼容 Wails WebView2
var player;
function onYouTubeIframeAPIReady() {
player = new YT.Player('player', {
height: '360',
width: '640',
videoId: 'M7lc1UVf-VE',
events: {
'onReady': onPlayerReady,
'onStateChange': onPlayerStateChange
}
});
}
```
- 播放/暂停/停止/音量/seek
- 播放状态事件监听
- 播放列表/队列管理
- 全屏控制
### 费用
- **IFrame Player API**:完全免费,无需 API Key
- **Data API v3**:免费额度 10,000 units/day
### U-Desk 适配
- **完美适配**:纯前端 JS APIWebView2 原生运行
- Go 后端可选调用 Data API 补充搜索能力
- 中国区需翻墙
### 推荐用途
- 国际视频内容补充
- 技术验证的首选平台(零成本、文档完善)
---
## 七、Vimeo Player API
### 基本信息
- **文档**https://developer.vimeo.com/api/reference
- **嵌入式播放器**:高度可定制
### 能力
- 嵌入式播放器(类似 YouTube
- Player JS API播放控制
- Upload API上传视频
- Data API视频信息获取
### 费用
- 免费层级可用(有播放限制)
- Pro 版本 ($7/月) 解锁高级功能
### 特点
- 无广告、画质高
- 设计感强,适合高端场景
- 中文内容较少
---
## 八、合规要点
| 规则 | 说明 |
|------|------|
| 嵌入播放 | 使用平台官方提供的嵌入代码/播放器,不自行解析视频流 |
| 广告保留 | 不得去除原平台的广告或会员提示 |
| 内容审核 | 平台对内容负责,但需注意嵌入内容的合规性 |
| 版权标注 | 视频版权归创作者及平台所有 |
| 流量上报 | 如有要求,按规范上报播放数据 |
> **关键原则**:视频模块优先采用 **H5/iframe 嵌入** 方案,而非自建播放器解析流地址。这样既合规又简单。
---
## 九、最终推荐方案
### MVP 阶段(快速上线)
| 优先级 | 方案 | 工作量 | 说明 |
|--------|------|--------|------|
| P0 | **抖音开放 SDK** | 1-2天 | 国内首选:分享/投稿/授权 |
| P0 | **YouTube IFrame API** | 0.5天 | 国际视频 + 嵌入播放 |
| P1 | **B站 iframe 嵌入** | 0.5天 | 国内二次元/长视频社区 |
### 迭代阶段(深度集成)
| 优先级 | 方案 | 工作量 | 说明 |
|--------|------|--------|------|
| P1 | B站 OpenAPI 对接 | 3-5天 | 搜索/推荐/个性化(需等官网恢复) |
| P1 | 抖音数据能力对接 | 2-3天 | 播放量/互动数据回传统计 |
| P2 | 腾讯视频 H5 嵌入 | 0.5天 | 补充国内长视频 |
| P2 | Vimeo API | 2-3天 | 高端无广告体验 |
### 明确舍弃
- ~~爱奇艺/优酷深度API~~ — 开放程度不足
- ~~自建视频流解析~~ — 合规风险极高
---
## 十、U-Desk 视频模块架构建议
```
U-Desk 生态链接 - 视频模块
├── VideoPlayer (Vue Component)
│ ├── YouTubePlayer.vue → YT.Iframe API
│ ├── BilibiliEmbed.vue → iframe embed
│ ├── TencentVideo.vue → H5 embed
│ └── GenericPlayer.vue → 统一播放器外壳
├── VideoService (Go)
│ ├── SearchYouTube() → YouTube Data API (可选)
│ ├── SearchBilibili() → B站 OpenAPI (后续)
│ └── SearchLocal() → 本地视频文件索引
└── VideoPanel.vue → 主面板 (搜索 + 列表 + 播放)
```
### 与文件管理器的融合点
- 在文件浏览时识别视频文件 → 提供在线搜索相似内容
- 右键菜单:"在线搜索相关视频"
- 底部栏迷你播放器(浏览文件时同时看视频)
- 收藏夹同步(收藏的视频与文件收藏统一管理)
---
*Sources:*
- *B站开放平台: https://developer.bilibili.com/*
- *YouTube IFrame API: https://developers.google.com/youtube/iframe_api_reference*
- *Vimeo Developer: https://developer.vimeo.com/api/reference*

View File

@@ -0,0 +1,335 @@
# 广播电台 / 电视 / 播客 开放平台接入方案备忘录
> 最后更新2026-05-08 | 用途U-Desk 生态链接 — 音频流媒体模块可行性评估
---
## 一、平台总览对比
| 平台 | 类型 | 费用 | 中文内容 | 桌面端适配 | 合规性 | 接入难度 | 评级 |
|------|------|------|----------|------------|--------|----------|------|
| **Radio Browser API** | 国际电台 | 免费 | 中 | 极高(RESTful) | 高 | 极低 | **A** |
| **Apple iTunes Search API** | 播客索引 | 免费 | 高 | 极高(HTTP) | 高 | 低 | **A-** |
| **喜马拉雅开放平台** | 国内音频 | 商务合作 | 极高 | 中低(Web嵌入) | 高 | 高 | B- |
| **蜻蜓FM开放平台** | 国内音频 | 商务合作 | 极高 | 低 | 高 | 高 | C+ |
| **CCTV 嵌入** | 电视 | 不定 | 极高 | 中 | 中风险 | 中 | C- |
| **TuneIn API** | 国际电台 | 不开放 | 低 | 无 | - | - | D |
| **荔枝FM / 云听** | 国内音频 | 无API | 高 | 无 | - | - | D |
| **IPTV/电视直播** | 电视 | 无合法方案 | 极高 | 无 | - | - | D |
---
## 二、Radio Browser API强烈推荐 ⭐⭐⭐)
### 基本信息
- **官网**https://www.radio-browser.info
- **API 地址**https://api.radio-browser.info
- **协议**开源项目GitLab可自由用于免费和商业软件
- **版本**v0.7.442026-05-08 验证API 在线,`/json/stats` 端点可能已迁移,但核心 station 接口正常)
- **当前规模**27,000+ 可用电台 / 80+ 国家 / 59+ 语言
- **验证状态**:✅ **已验证在线**`de1.api.radio-browser.info/json/stations/topclick` 返回实时数据2026-05-08 15:26 UTC
### 核心能力
#### 列表类接口
| 接口 | 说明 |
|------|------|
| `/json/countries` | 按国家列出电台 |
| `/json/codecs` | 编码格式列表 (MP3/AAC+/OGG) |
| `/json/states` | 按州/省列出 |
| `/json/languages` | 语言列表 (含 ISO 639 代码) |
| `/json/tags` | 标签/流派列表 (jazz/pop/rock/news) |
| `/json/stations` | 全部电台列表 |
#### 搜索类接口
| 接口 | 说明 |
|------|------|
| `/json/stations/search` | **高级搜索**name/country/language/tag/codec/bitrate/geo 多维度组合查询 |
| `/json/stations/byname/{term}` | 按名称搜索 |
| `/json/stations/bycountry/{code}` | 按国家搜索 (`CN`=中国) |
| `/json/stations/bylanguage/{lang}` | 按语言搜索 (`chinese`) |
| `/json/stations/bytag/{tag}` | 按标签搜索 |
#### 排行类接口
| 接口 | 说明 |
|------|------|
| `/json/stations/topclick` | 最热门电台 |
| `/json/stations/topvote` | 最高评分电台 |
| `/json/stations/lastclick` | 最近被点击的 |
#### 交互类接口
| 接口 | 说明 |
|------|------|
| `/json/url/{uuid}` | 点击计数 + 获取播放 URL |
| `/json/vote/{uuid}` | 为电台投票 |
| `/json/add` | 添加新电台到数据库 |
#### 运维类接口
| 接口 | 说明 |
|------|------|
| `/json/stats` | 服务器统计 |
| `/json/servers` | 镜像服务器列表(可自建) |
| `/json/config` | 服务器配置 |
### 数据结构关键字段
```json
{
"stationuuid": "唯一ID",
"name": "电台名称",
"url": "原始流地址",
"url_resolved": "已解析的直接播放URL ← 核心字段",
"homepage": "电台主页",
"favicon": "图标",
"tags": ["标签"],
"countrycode": "CN",
"language": "chinese",
"codec": "MP3",
"bitrate": 128,
"lastcheckok": true,
"clickcount": 24
}
```
### 输出格式
JSON / XML / CSV / M3U / PLS / XSPF / TTL7种
### U-Desk 集成方式
```
Go 后端 → HTTP GET radio-browser API → JSON → Vue 展示电台列表
↓ 点击播放
url_resolved 字段 = 直接可播放的 MP3/AAC 流
```
- **Go 有现成库**`goradios`
- **零成本、零审核、零依赖**
- 工作量估算2-3天含 UI
### 特别优势
- 支持按 `countrycode=CN` 筛选中文电台
- 用户可添加自定义电台(`/json/add`
- 可自建镜像服务器(完全自主可控)
- 支持 M3U/PLS 导出(兼容各类播放器)
---
## 三、Apple iTunes Search API — 播客发现(推荐 ⭐⭐⭐)
### 基本信息
- **文档**https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api/ (⚠️ 国内访问可能超时需翻墙API 端点本身通常可达)
- **API 端点**`https://itunes.apple.com/search``https://itunes.apple.com/lookup`
- **费用**:免费(速率限制约 20次/分钟)
### 核心能力
#### 搜索参数
| 参数 | 说明 | 示例 |
|------|------|------|
| `term` | 搜索关键词 | `news`, `故事`, `科技` |
| `media` | 媒体类型 | `podcast` |
| `entity` | 实体类型 | `podcast`, `podcastAuthor` |
| `country` | 国家代码 | `cn` |
| `limit` | 返回数量 | 25 |
#### 使用示例
```
# 搜索中文新闻播客
GET https://itunes.apple.com/search?term=news&country=cn&media=podcast&limit=25
# 搜索特定作者
GET https://itunes.apple.com/search?term=故事&entity=podcastAuthor&country=cn
```
#### 返回数据关键字段
```json
{
"collectionName": "播客名称",
"artistName": "作者",
"feedUrl": "RSS订阅地址 ← 核心:获取音频的入口",
"artworkUrl60": "小封面",
"artworkUrl100": "大封面",
"releaseDate": "发布日期",
"primaryGenreName": "分类"
}
```
### 播放流程
```
iTunes Search API → 获取 feedUrl (RSS)
解析 RSS XML → 提取 episode 列表
enclosure URL → 音频播放
```
### U-Desk 集成方式
1. Go 后端调用 Search API → 获取播客列表和 RSS 地址
2. 解析 RSS XML 提取 episode 音频 URL
3. 前端播放器播放音频流
4. 实现 20次/分钟速率限制的客户端缓存
### 中文播客覆盖
- iTunes Podcast 目录包含大量中文播客(大陆/台湾/香港创作者)
- 覆盖新闻/故事/科技/商业/教育等各领域
### 工作量估算3-4天含 RSS 解析逻辑)
---
## 四、喜马拉雅开放平台(备选 ⭐⭐)
### 基本信息
- **官网**https://open.ximalaya.com/
- **定位**:国内最大音频分享平台(纽交所上市)
- **商务热线**(021)50179077-8806 / -8803
### 核心能力
- 音频内容分发 SDK/API
- 支持移动应用、智能硬件、车载、网页/小程序接入
- 内容类型:有声书、课程、播客、相声评书、新闻资讯、亲子儿童、景点导览
- AI 制作专区
### 接入方式
| 方式 | 说明 |
|------|------|
| 移动应用 SDK | Android/iOS/Flutter |
| 智能硬件 SDK | IoT 设备 |
| **网页/小程序 JS SDK** | ← U-Desk 的可行路径 |
### 费用模式
- **商务合作模式**,需"立即入驻"申请后商谈
- 通常为分成或流量付费模式
- 有运营中心(内容中心/数据中心/活动中心)
### U-Desk 适配路径
通过 Wails WebView 加载喜马拉雅 H5/JS SDK 播放器
- 技术层面工作量1-2天
- 商务层面周期不确定(需审批)
### 注意事项
- 开发者文档页面部分返回 404生态维护程度一般
- 但"网页/小程序"接入通道确实存在
---
## 五、蜻蜓FM开放平台低优先级
### 基本信息
- **官网**https://open.qingting.fm
- 能力SDK/API/H5嵌入式播放器
- 内容:直播流、点播、有声书、相声评书、全国电台
### 问题
- 主要面向 B 端大客户(车企、智能硬件厂商)
- 对独立桌面应用开发者门槛较高
- 文档需入驻后才可查看完整内容
- Windows 桌面端无原生支持
### 结论:优先级低于喜马拉雅
---
## 六、电视/IPTV当前不可行
### CCTV 央视网
- **无公开开发者 API**
- 可能存在 iframe 嵌入方案(灰色地带)
- 版权严格管控,合规风险高
- 评级C-(仅作为外部链接实验)
### 各省市 IPTV
- 三大运营商分别运营,无统一 API
- 专有传输协议IGMP/RTP/RTSP需专用机顶盒
- **完全不存在合法的桌面端接入途径**
- 评级D
### EPG 数据源(国际参考)
- [epg-guide.com](https://epg-guide.com):免费 EPG 数据XMLTV 格式
- 仅覆盖欧洲(意大利为主),不支持中文电视台
- 技术成熟但无中文内容,参考价值有限
### 结论:**电视模块暂不纳入 MVP**
---
## 七、荔枝FM / 云听
| 平台 | 状态 | 原因 |
|------|------|------|
| 荔枝FM (lizhi.fm) | ❌ 无公开 API | 官网无 developer/open 入口 |
| 云听 (yunting.fm) | ❌ 服务不稳定 | 访问时 500 错误,且无 API |
---
## 八、最终推荐组合方案
### 第一优先级MVP 即可上线)
| 平台 | 用途 | 工作量 | 成本 |
|------|------|--------|------|
| **Radio Browser API** | 全球网络电台收听 | 2-3天 | 免费 |
| **iTunes Search API** | 播客发现与播放 | 3-4天 | 免费 |
### 第二优先级(后续迭代)
| 平台 | 用途 | 工作量 | 前置条件 |
|------|------|--------|----------|
| **喜马拉雅 Web 嵌入** | 国内有声书/课程 | 1-2天技术 + 商务周期 | 商务合作审批 |
| **央视网链接** | 电视直播快捷入口 | 0.5天 | 关注版权政策 |
### 不推荐
- ~~TuneIn~~ — 不开放第三方 API
- ~~IPTV/电视直播~~ — 无合法接入途径
- ~~荔枝FM/云听~~ — 无可用 API
---
## 九、U-Desk 广播/播客模块架构建议
```
U-Desk 生态链接 - 音频流媒体模块
├── RadioService (Go)
│ ├── StationSearch() → Radio Browser /stations/search
│ ├── TopStations() → /stations/topclick
│ ├── StationsByCountry() → /stations/bycountry/CN
│ ├── StationsByTag() → /stations/bytag/{tag}
│ └── PlayStation() → /json/url/{uuid} → url_resolved 直播流
├── PodcastService (Go)
│ ├── SearchPodcasts() → iTunes Search API (media=podcast)
│ ├── GetPodcastDetail() → iTunes Lookup API
│ ├── ParseFeed() → RSS XML → episode 列表
│ └── PlayEpisode() → enclosure URL → 音频播放
├── AudioPlayer (Vue Component)
│ ├── RadioPanel.vue → 电台浏览/搜索/播放/收藏
│ ├── PodcastPanel.vue → 播客发现/订阅/播放/下载
│ └── MiniPlayer.vue -> 底部栏迷你播放器
└── QuickLinks (Vue)
└── LinkCard.vue → 央视网/喜马拉雅等外部链接卡片
```
### 与文件管理器的融合点
- 浏览文件时底部迷你播放器持续播放电台/播客
- 收藏夹统一管理(收藏的电台/播客/文件混合展示)
- 右键菜单:"搜索相关播客内容"
---
## 十、合规要点总结
| 平台 | 合规要求 |
|------|---------|
| Radio Browser | 开源协议友好,商用无限制,仅需合理 User-Agent |
| iTunes API | 遵守 Apple 使用条款(速率限制 + 展示要求) |
| 喜马拉雅 | 必须走正式商务流程,签订合作协议 |
| 央视网 | 以外部链接方式最安全,避免深度集成 |
---
*Sources:*
- *Radio Browser: https://www.radio-browser.info / https://api.radio-browser.info*
- *iTunes Search API: https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api/*
- *喜马拉雅开放平台: https://open.ximalaya.com/*
- *蜻蜓FM开放平台: https://open.qingting.fm*
- *EPG Guide: https://epg-guide.com*

View File

@@ -0,0 +1,295 @@
# 课程专栏 / 知识付费 开放平台接入方案备忘录
> 最后更新2026-05-08 | 用途U-Desk 生态链接 — 知识学习模块可行性评估
---
## 一、平台总览对比
| 平台 | 类型 | 官方API | 费用 | 桌面端适配 | 中文内容 | 推荐评级 |
|------|------|---------|------|------------|----------|---------|
| **喜马拉雅** | 有声书/课程 | ✅ SDK+API | 商务合作 | Web嵌入 | 极全 | **A-** |
| **得到 (Dedao)** | 知识付费 | ❌ 已确认无API | - | 仅WebView嵌入 | 全 | **C+** |
| **知乎 / 盐选** | 问答/专栏 | ⚠️ 有限 | 部分免费 | Web抓取 | 全 | **B** |
| **豆瓣** | 读书/影视数据 | ⚠️ 非官方(社区维护) | 免费 | HTTP调用 | 高 | **B+** |
| **微信读书** | 电子书阅读 | ❌ 无公开API | - | - | 极全 | C |
| **Apple Books / iTunes** | 电子书/播客 | ✅ Search API | 免费 | HTTP调用 | 中 | **B+** |
| **Udemy** | 在线课程 | ✅ REST API | 免费(aff) | HTTP调用 | 低(英文) | B |
| **Coursera** | 在线课程 | ✅ API | 免费 | HTTP调用 | 低(英文) | B |
| **中国大学MOOC** | 高等教育 | ⚠️ 有限 | 免费 | Web | 高 | B- |
| **即刻时间** | 知识碎片 | ❌ 无公开API | - | - | 中 | D |
| **知识星球** | 社群/知识 | ❌ 无公开API | - | - | 中 | D |
---
## 二、喜马拉雅(首选 ⭐⭐⭐)
### 基本信息
- **开放平台**https://open.ximalaya.com/
- **定位**国内最大音频分享平台纽交所上市XIMA
- **商务热线**(021)50179077 转 8806 或 8803
### 核心能力(与 U-Desk 课程场景高度匹配)
| 内容类型 | 说明 |
|---------|------|
| **有声书** | 出版物音频化,海量书籍资源 |
| **课程/专栏** | 知识付费核心品类 |
| **播客** | UGC/PUGC 音频内容 |
| **新闻资讯** | 实时资讯音频版 |
| **亲子儿童** | 儿童故事/教育内容 |
| **相声评书** | 传统曲艺内容 |
| **景点导览** | 旅游场景音频导览 |
### 接入方式
| 方式 | 平台支持 | U-Desk 可行性 |
|------|---------|---------------|
| 移动应用 SDK | Android/iOS/Flutter | ❌ 不适用 |
| 智能硬件 SDK | IoT 设备 | ❌ 不适用 |
| **网页/小程序 JS SDK** | H5/Web 环境 | ✅ **Wails WebView2 可用** |
### 费用模式
- **商务合作**,需申请入驻后商谈
- 通常为分成模式或流量采购
- 有完整的运营中心(内容中心/数据中心/活动中心)
### U-Desk 集成路径
```
喜马拉雅 JS SDK → Wails WebView2 加载 → 课程浏览/搜索/播放
```
- 技术工作量1-2天
- 商务周期不确定,需提前启动
### 与广播电台模块的协同
- 喜马拉雅同时覆盖"课程"和"广播"两个模块
- 可作为统一音频内容入口
---
## 三、得到 Dedao已确认无开放API ❌)
### 基本信息
- **官网**https://www.dedao.cn/
- **定位**:高端知识服务平台(罗辑思维团队)
- **内容品质**:国内顶尖,每门课程均经过严格品控
### 平台规模2026年实测数据
| 维度 | 数据 |
|------|------|
| 平台用户 | **6400 万+** |
| 精品课程 | **390 门**(覆盖 20+ 领域) |
| 电子书 | **10 万+ 本**(含 1300+ 经典套系、800+ 期刊杂志) |
| 得到听书 | **3400+ 本**,每天上新 1 本 |
| 线下学习中心 | **10 个**(北京/上海/杭州/广州/深圳/成都/西安/昆明/武汉/郑州) |
| 2024 用户学习时长 | **18 亿小时+** |
| 2024 用户笔记 | **60 亿字+** |
| 企业客户 | 上千家企业 |
### 核心产品矩阵
| 产品 | 说明 |
|------|------|
| **精品课** | 系统化课程如薛兆丰经济学课、吴军科技史纲60讲 |
| **每天听本书** | 专业解读3400+ 本书 |
| **得到听书** | 名家讲书 / 精品听书 / 章鱼书场 等 |
| **电子书** | 10万本支持全文搜索 + 多设备同步 |
| **免费专区** | 得到头条 / 文明之旅 / 长谈 / 得到精选等 |
| **得到新商学** | 创业者社区12场线下大课/年 |
| **直播** | 定期直播(改稿/对谈/颁奖等) |
### 热门讲师(部分)
薛兆丰(经济学)、香帅(金融学)、吴军(计算机科学)、万维钢(科学)、刘擎(哲学)、刘润(商业)、吴伯凡(商业思想)、尹烨(健康)、蔡钰(批判性思维)、马江博(政经)...
### 开放平台/API 状态:**❌ 无任何公开 API**
- 官网无 developer/open/api 入口
- 无 SDK / 无文档 / 无开发者计划
- **结论:得到是封闭生态,不对外开放数据或能力**
### 可行的接入路径(有限)
| 方案 | 可行性 | 说明 |
|------|--------|------|
| WebView2 嵌入 Web 版 | ⭐⭐ 技术可行 | 可加载得到网页版,但无法获取结构化数据 |
| RSS / 内容抓取 | ⭐ 合规风险 | 违反服务条款,不可商用 |
| 商务合作 | ⭐⭐ 待洽谈 | 面向企业客户的定制化解决方案B端培训集成 |
### 最终评估
- **作为 API 数据源**:❌ 不可行(无开放接口)
- **作为 WebView 嵌入**:⭐⭐ 可行但价值有限(不如直接用 App
- **作为竞品参考**:⭐⭐⭐ 极有价值(产品设计/内容分类/用户体验值得学习)
- **推荐评级从 B+ 降为 C+**(无 API = 无法深度集成)
> **替代建议**:如果需要高品质中文课程内容,优先选择 **喜马拉雅**(有 JS SDK 可接入)或 **iTunes Search API**(免费播客/有声书元数据)。得到的优质内容建议引导用户通过 App 使用。
---
## 四、豆瓣(⚠️ 已确认无可用 API降级为嵌入方案
### 基本信息
- **原豆瓣 API v2 社区仓库**https://github.com/douban/douban-api-v2 → **❌ 404仓库已删除/改名)**
- **豆瓣官方客户端库**https://github.com/douban/douban-client → **❌ 已归档Archived最后更新 2014-06-22**
- **官方状态****豆瓣已完全停止公开 API 服务**。官方 OAuth 客户端库于 2014 年归档,社区维护的 v2 兼容接口仓库也已下线
### 核心能力(历史参考 — 当前均不可用)
| 接口 | 说明 | 状态 |
|------|------|------|
| 图书搜索/详情 | ISBN/书名/作者搜索,含评分/简介/封面 | ❌ 接口已失效 |
| 电影搜索/详情 | 影片信息/评分/演员/导演 | ❌ 接口已失效 |
| 读书笔记 | 用户的读书标记和短评 | ❌ 接口已失效 |
| 书单/豆列 | 用户创建的书籍列表 | ❌ 接口已失效 |
### U-Desk 可行方案(降级后)
- **WebView2 嵌入**加载豆瓣网页版book.douban.com / movie.douban.com用户手动浏览
- **右键快捷方式**:选中 PDF/电子书文件 → 右键"在豆瓣搜索" → 打开豆瓣网页搜索该 ISBN/书名
- **元数据层**:❌ 不可行(无可用 API 获取结构化数据)
### 费用N/A无可用的 API 服务)
### 评级调整:从 B+ 降至 **C+**
> **理由**:作为结构化数据源已完全不可用。仅能作为 WebView 嵌入/外部链接的跳板,价值大幅降低。
---
## 五、知乎 / 知乎盐选
### 基本信息
- **官网**https://www.zhihu.com/
- **盐选会员**https://www.zhihu.com/xuan
### 能力评估
- **无完善的公开开发者 API**
- 存在一些非官方的爬虫式接口(不推荐商用)
- 网页版可在 WebView2 中加载
### 可行方案
- **轻量集成**WebView2 嵌入知乎专栏页面
- 作为"快捷链接"而非深度集成
- 合规风险较低(官方提供的分享链接)
### 内容价值
- 国内最优质的问答/专栏内容库
- 盐选付费内容涵盖大量系统化课程
- 与"课程专栏"模块定位契合
---
## 六、微信读书(✅ 已确认完全封闭)
### 基本信息
- **官网**https://weread.qq.com/
- **定位**:腾讯旗下电子书阅读平台
- **内容规模**:极全(出版书籍 + 网文 + 漫画)
- **状态****✅ 已确认完全封闭,无任何公开开发者入口**
### 封闭证据2026-05-08 核实)
| 路径 | 响应 | 含义 |
|------|------|------|
| `weread.qq.com/api` | 404 | 无公开 API 入口 |
| `weread.qq.com/developer` | 404 | 无开发者平台 |
| `weread.qq.com/open` | 404 | 无开放入口 |
| **`i.weread.qq.com/`** | **401 Unauthorized** | ⚠️ **证实内部 API 存在但需认证,不对外开放** |
### 结论
- 公开 API**无**
- 开放平台:**无**
- 内部接口:存在(`i.weread.qq.com` 返回 401 = 需登录态认证)→ **确认不对外**
- 唯一可行方案WebView2 嵌入 Web 版或外部快捷链接
- **评级维持 C合理** — 与得到一致,都是腾讯系封闭内容生态
---
## 七、国际平台补充
### Apple iTunes Search API已在上篇详述
- 搜索 Audiobooks / Podcasts / 教育类内容
- 免费使用20次/分钟限制
- 返回 RSS Feed URL 用于内容获取
### Udemy
- **Developer API**https://www.udemy.com/developers/affiliate/
- **类型**Affiliate API联盟营销
- 能力:课程搜索/详情/分类
- 费用:免费(通过推广获得佣金)
- 限制:主要英文内容,中文课程有限
### Coursera
- **API**https://build.coursera.org/
- 能力:课程目录/详情/学习者进度
- 主要面向机构合作
- 个人开发者可获取基础课程数据
### 中国大学 MOOCicourse163
- **官网**https://www.icourse163.org/
- 国内最大的高等教育在线课程平台
- 无公开 API可通过 Web 抓取部分数据
- 内容质量高(来自北大/清华等名校)
---
## 八、明确不可行的平台
| 平台 | 原因 |
|------|------|
| 即刻时间 | 无公开 API产品形态偏碎片化 |
| 知识星球 | 无公开 API定位为私密社群 |
| 荔枝微课 | 未找到稳定的开放接口 |
| 千聊 | 主要面向知识创作者工具端 |
---
## 九、最终推荐方案
### MVP 阶段
| 优先级 | 平台 | 用途 | 工作量 |
|--------|------|------|--------|
| P0 | **喜马拉雅 JS SDK** | 有声书 + 课程 + 播客一体化 | 1-2天技术 + 商务周期 |
| P1 | **iTunes Search API** | 国际有声书/播客补充 | 1天 |
| P2 | **豆瓣 WebView 嵌入** (⚠已无API) | 右键跳转豆瓣网页搜索 | 0.5天(极轻量) |
### 迭代阶段
| 优先级 | 平台 | 用途 | 前置条件 |
|--------|------|------|----------|
| P1 | **知乎嵌入** | 专栏/问答快捷入口 | 无 |
| P2 | **Udemy Affiliate** | 英文课程补充 | 申请联盟账号 |
### 明确舍弃
- ~~得到~~ — **已确认无任何开放 API**封闭生态6400万用户/390门课/10万本电子书均无法通过 API 获取)
---
## 十、U-Desk 课程/知识模块架构建议
```
U-Desk 生态链接 - 知识学习模块
├── KnowledgeService (Go)
│ ├── SearchBooks() → 豆瓣 API (ISBN/书名)
│ ├── GetBookDetail() → 豆瓣 API (评分/简介/封面)
│ ├── SearchAudiobooks() → iTunes API (media=audiobook)
│ └── SearchCourses() → 喜马拉雅 SDK / 得到(后续)
├── KnowledgePanel (Vue)
│ ├── Bookshelf.vue → 正在听的书籍/课程
│ ├── CourseBrowser.vue → 浏览/搜索课程
│ ├── DailyBook.vue → "每天一本书"推荐卡片
│ └── FileBookLink.vue → 文件 ↔ 关联书籍信息
└── XimalayaPlayer (Vue/WebView)
└── XimalayaEmbed.vue → 喜马拉雅内容嵌入式播放
```
### 与文件管理器的融合点(核心差异化)
1. **PDF/电子书增强**:浏览电子书文件时,侧栏显示豆瓣评分和简介
2. **"边管边听"**:底部迷你播放器持续播放有声书/课程
3. **智能推荐**:根据当前文件夹内容类型(如代码/设计稿),推荐相关课程
4. **收藏联动**:收藏的书籍/课程与文件收藏夹统一视图
5. **专注模式**:一键隐藏文件管理器面板,仅保留课程播放界面
---
*Sources:*
- *喜马拉雅开放平台: https://open.ximalaya.com/*
- *得到: https://www.dedao.cn/*
- *豆瓣 API: https://github.com/douban/douban-api-v2*
- *知乎: https://www.zhihu.com/*
- *Udemy Affiliate: https://www.udemy.com/developers/affiliate/*
- *Coursera API: https://build.coursera.org/*
- *中国大学MOOC: https://www.icourse163.org/*

View File

@@ -0,0 +1,494 @@
# 生活服务 开放平台接入方案备忘录
> 最后更新2026-05-08 | 用途U-Desk 生态链接 — 生活服务入口模块可行性评估
---
## 一、平台总览对比
### 天气服务
| 平台 | 官网 | 费用 | 数据质量 | 推荐评级 |
|------|------|------|---------|---------|
| **和风天气 (QWeather)** | [dev.qweather.com](https://dev.qweather.com/) | 按量付费(有免费层) | 极高 | **A** |
| 高德天气 API | [lbs.amap.com](https://lbs.amap.com/) | 免费(含配额) | 高 | **A** |
| 中国气象局公开数据 | 无统一API | 免费 | 官方权威 | B+ |
| OpenWeatherMap | [openweathermap.org](https://openweathermap.org/) | 免费/付费 | 国际 | B |
### 快递物流
| 平台 | 官网 | 费用 | 覆盖范围 | 推荐评级 |
|------|------|------|---------|---------|
| **快递100** | [kuaidi100.com/openapi](https://www.kuaidi100.com/openapi/) | 按量付费(有免费) | 2200+ 家快递公司 | **A** |
| 快递鸟 | 不详 | 商务合作 | 主要快递 | B |
| 各快递官方API | 分散 | 需单独申请 | 单家 | C |
### 地图导航
| 平台 | 官网 | 费用 | 能力 | 推荐评级 |
|------|------|------|------|---------|
| **高德开放平台** | [lbs.amap.com](https://lbs.amap.com/) | 免费额度 + 按量 | 全能LBS平台 | **A** |
| **百度地图开放平台** | [lbsyun.baidu.com](https://lbsyun.baidu.com/) | 免费额度 + 按量 | 全能LBS + AI增强 | **A** |
| **腾讯位置服务** | [lbs.qq.com](https://lbs.qq.com/) | 免费额度 + 按量 | 全能LBS + 街景 | **A-** |
### 翻译服务
| 平台 | 费用 | 免费额度 | 推荐评级 |
|------|------|---------|---------|
| **百度翻译 API** | 按量 | **⚠️ 服务器500 审计中** | **待验证** |
| 有道翻译 API | 按量 | 有免费层级 | A- |
| 腾讯翻译君 API | 按量 | 有免费层级 | B+ |
| Google Translate API | 按量(较贵) | 50万字符/月免费 | B |
### 日历/效率
| 平台 | 能力 | 推荐评级 |
|------|------|---------|
| **钉钉开放平台** | 4000+ API日历/待办/文档 | **A** |
| **飞书开放平台** | 日历/文档/多维表格 | **A** |
| 微软 Graph API (Outlook) | Calendar/To Do/Mail | A- |
### 新闻资讯
| 平台 | 方式 | 推荐评级 |
|------|------|---------|
| **RSS 聚合(自建)** | 开源方案,完全自主可控 | **A** |
| 今日头条开放平台 | 内容分发(面向创作者) | B |
| 各新闻客户端API | 通常不开放第三方 | C |
---
## 二、和风天气 QWeather推荐 ⭐⭐⭐)
### 基本信息
- **官网**https://dev.qweather.com/
- **定位**:专业气象数据服务商
### 核心能力
- **实时天气**:温度/湿度/气压/风速/能见度
- **天气预报**未来3-7天逐小时/逐日预报
- **灾害预警**:气象灾害预警信息
- **空气质量**AQI / PM2.5 / PM10 / 主要污染物
- **历史天气**:历史气象数据查询
- **地理天气**:目标区域当前及未来天气
- **全球部署**:全球范围数据覆盖
### 技术特点
- 标准 RESTful API + 多语言 SDK
- 全球部署(无需面对各国本地化问题)
- **按量计费**:用多少付多少,无需预付,无隐藏费用
- 注册后创建项目和 KEY 即可使用
### 免费额度
- 基础订阅包含一定的免费调用次数
- 个人开发者/小应用通常够用
### U-Desk 使用场景
- 任务栏/状态栏显示实时天气
- 文件管理器侧栏天气小组件
- 出行前快速查看目的地天气
---
## 三、高德地图开放平台(推荐 ⭐⭐⭐)
### 基本信息
- **官网**https://lbs.amap.com/
- **归属**:阿里巴巴集团
- **定位**:国内最完善的 LBS基于位置的服务开放平台
### 核心能力矩阵
#### 搜索定位类
| 产品 | 说明 | 形态 |
|------|------|------|
| **搜索** | 位置/周边/行政区/POI ID 查询 | API / JS / Android / iOS |
| **定位** | 基于 LBS 的定位服务 | API / Android / iOS |
| **地理/逆地理编码** | 经纬度 ↔ 地址转换 | API / JS / Android / iOS |
| **地理围栏** | 虚拟空间围栏服务 | API / Android / iOS |
| **天气查询** | 目标区域当前/未来天气 | API |
| **智能硬件定位** | 基站/WiFi 定位 | SDK |
#### 路线导航类
| 产品 | 说明 | 形态 |
|------|------|------|
| **导航** | 专业导航能力 | Android / iOS |
| **路线规划** | 步行/驾车等路径规划 | API / JS / Android / iOS |
| **猎鹰服务** | 专业轨迹管理 | API / Android / iOS |
| **货车路径规划** | 专业货运路径规划 | API |
| **公交信息查询** | 公交线路/站点查询 | API |
| **交通路况查询** | 实时交通态势 | API |
#### 地图产品类
| 产品 | 说明 | 形态 |
|------|------|------|
| **动态地图** | 2D 地图展示与配置 | API / JS / Android / iOS |
| **3D 地图** | 3D 渲染地图视图 | JS / Android / iOS |
| **静态地图** | 将地图嵌入网页 | 图片 |
| **地铁图** | 地铁线路图 | JS / Android / iOS |
| **3D 地形图** | 卫星地形图 | JS |
#### 高级工具
| 产品 | 说明 |
|------|------|
| **世界地图** | 全球 LBS 服务 |
| **LOCA 数据可视化** | 百万级数据可视化渲染 |
| **GeoHUB 地图数据中心** | 数据管理/编辑/发布/分析 |
| **MCP Server** | 12项核心功能 SSE 快速集成 ← 新! |
| **CLI 工具** | 命令行调用高德能力 ← 新! |
### 规模数据
- 日均处理近 **1000亿次** 定位及路线规划请求
- 覆盖超过 **7000万** POI 数据点
- 覆盖超过 **3500万** 地址库数据
- 地级市实时路况准确率 **95%**
- 服务可用性 **99.9%**
- 平均响应时长 **≤300ms**
### 费用模式
- **Web 服务 API**:免费额度(基础调用),超出按量计费
- **JS API**:大部分免费(商业授权需认证)
- 定价页面https://lbs.amap.com/ 定价
### U-Desk 使用场景
1. **文件位置展示**:文件带有 GPS 信息时在地图上标记
2. **地址解析**:将文本地址转为经纬度坐标
3. **路线规划**:查看两个地点间的路线
4. **周边搜索**:查找文件所在位置周边的 POI
5. **天气集成**:高德自带天气查询 API可替代独立天气服务
---
## 四、快递100 API推荐 ⭐⭐⭐)
### 基本信息
- **官网**https://www.kuaidi100.com/openapi/
- **定位**:企业级快递物流信息集成解决方案
- **规模**15年经验、250万+企业客户、日均查询突破 **4亿** 次、吞吐量近 **40万/秒**
### 核心能力
#### 查询类
| API | 说明 |
|-----|------|
| **实时快递查询 API** | 主动查询物流状态,即时返回最新信息 |
| **快递查询地图轨迹 API** | 返回包裹地图轨迹 + 预估时效 |
| **智能单号识别 API** | 自动判断单号归属的快递公司 |
#### 订阅推送类
| API | 说明 |
|-----|------|
| **地图轨迹推送服务 API** | 定时监控并推送地图轨迹 + 预估送达时间 |
#### 电子面单类
| API | 说明 |
|-----|------|
| **电子面单 API** | 支持 50+ 快递公司面单获取、云打印、本地打印 |
| **自定义打印 API** | 自定义内容(商品清单/发票/发货单) |
| **电商平台打单** | 同步多平台订单,统一发货打单 |
#### 物流服务类
| API | 说明 |
|-----|------|
| **商家寄件 API** | 下单至快递公司,上门取件,线上结算 |
| **同城配送 API** | 多家同城配送公司支持 |
| **物流全链路监控** | 15+ 电商平台发货规则同步,履约时效监控 |
#### 跨境服务类
| API | 说明 |
|-----|------|
| **国际物流查询 API** | 2200+ 全球运输商,支持简/繁/英 |
| **国际地址解析 API** | 国际地址标准化输出 |
| **国际电子面单 API** | 国际面单获取与绑定 |
| **跨境发货助手** | 一站式跨境发货 |
#### 增值服务
| API | 说明 |
|-----|------|
| 智能地址解析 | 提取姓名/电话/地址并结构化 |
| 快递时效查询 | 预测到达时间 |
| 拦截改址 | 运输中快件拦截处理 |
| 短信提醒发送 | 物流节点通知 |
| 快递面单 OCR | 面单识别提取信息 |
| Excel 批量查询 | 非技术用户批量查询 |
| 快递预估价格 | 不同快递成本估算 |
| 快递可用性查询 | 线路是否支持寄送 |
### 覆盖范围
- **2200+** 全球运输商物流轨迹查询
- **50+** 快递公司面单打印
- **10+** 快递公司寄件下单
- 支持国内外主流快递
### U-Desk 使用场景
1. **快递追踪面板**:输入单号一键查询物流状态
2. **文件关联**:收到快递单号截图/PDF 时自动识别单号
3. **批量查询**Excel 表格批量导入单号查询
4. **桌面小组件**:常驻快递列表,状态更新提醒
---
## 五、钉钉开放平台(效率工具 ⭐⭐⭐)
### 基本信息
- **官网**https://open.dingtalk.com/
- **归属**:阿里巴巴 / 钉钉科技有限公司
- **定位**:企业数字化一站式开发平台
### 核心数据
- **4000+** 开放接口
- 应用类型:网页应用 / 小程序 / 机器人 / 酷应用 / AI助理 / AI工作流
### 核心能力
| 能力域 | 说明 |
|--------|------|
| **通讯录** | 用户/部门/角色信息读取 |
| **消息** | 发送工作通知/群消息/卡片消息 |
| **日历** | 日程/会议/空闲忙查询 |
| **待办事项** | 创建/查询/更新待办 |
| **审批** | 发起/审批流程实例 |
| **考勤** | 打卡记录/排班/请假 |
| **文档** | 在线文档读写 |
| **机器人** | 群机器人 @ 触发回复 |
| **AI 工作流** | AI 驱动的自动化流程 |
| **酷应用** | 深度嵌入钉钉的富交互应用 |
### 开发方式
- **全代码开发**:完整 API 控制
- **低代码开发**:宜搭平台快速搭建
- **AI 开发**AI 辅助开发
- **硬件开发**:智能硬件接入
### U-Desk 使用场景
1. **日历联动**U-Desk 显示钉钉日程/待办
2. **文件快捷分享**:选中文件一键发送到钉钉会话
3. **审批关联**:文件作为审批附件
4. **消息通知**U-Desk 事件推送到钉钉
> 注意:钉钉主要面向企业场景。个人版 U-Desk 可选接入。
---
## 六、百度地图开放平台(与高德同级 ⭐⭐⭐)
### 基本信息
- **官网**https://lbsyun.baidu.com/
- **归属**:百度
- **定位**:百万开发者首选的地图服务商
### 核心能力矩阵
#### 热门产品
| 产品 | 说明 |
|------|------|
| **地点检索 3.0** | 多维检索 + AI 向导 |
| **北斗定位** | 优先北斗卫星定位 |
| **鹰眼轨迹** | 专业轨迹管理服务 |
| **货车导航** | 专业的货运路径规划 |
| **地址服务** | 智能地址解析与标准化 |
| **地图可视化** | 数据可视化渲染引擎 |
| **专网地图** | 私有化部署地图服务 |
#### 开发形态(三档接入)
| 接入方式 | 适用场景 |
|----------|---------|
| **简单接口服务**3步接入 | 注册 → 获取密钥(AK) → 集成 API/SDK — 个人开发者/小应用 |
| **复杂定制服务** | 需要更多能力或定制化的中大型应用 |
| **行业解决方案** | 物流/文旅/交通/汽车/金融等千行百业 |
#### SDK / API 覆盖
| 平台 | 产品 |
|------|------|
| Web | JS API GL / Three.js 数据可视化 / 微信小程序 / 地铁图 |
| Android | 地图 SDK / 定位 SDK / 鹰眼轨迹 SDK / 导航 SDK / 全景 SDK / 司乘同显 SDK |
| iOS | 同 Android 全套 |
| **HarmonyOS** | NEXT 版地图/定位/鹰眼/步骑行导航/驾车导航/司乘同显 ← **华为生态全覆盖** |
#### 特色能力(区别于高德)
| 能力 | 说明 |
|------|------|
| **AI 向导** | 检索结果 AI 增强,智能推荐 |
| **境内英文地图** | 行业首家,支持全流程英文出行 |
| **全球位置服务** | 2B2C 一体,助力政企出海 |
| **超视距巡航** | 3D 地图高级浏览 |
| **红绿灯倒计时** | 路线规划含实时信号灯信息 |
| **定位防作弊** | 虚假位置检测 |
| **离线定位** | 无网络环境下的定位能力 |
### 接入流程(个人开发者)
1. 注册/登录百度账号
2. 创建应用,获取密钥 (AK)
3. 集成服务 API / SDK
### 费用模式
- **Web 服务 API**:免费额度(基础调用),超出按量计费
- **JS API**:大部分免费
- 定价页面可查看详细阶梯
### U-Desk 使用场景(与高德互补)
- 百度地图在 **AI 检索增强****HarmonyOS 支持** 方面有特色
- 如果 U-Desk 未来考虑鸿蒙端,百度有现成 HarmonyOS NEXT SDK
- 建议与高德 **二选一或同时接入**(切换成本低,都是标准 RESTful API
---
## 七、腾讯位置服务(备选 ⭐⭐⭐)
### 基本信息
- **官网**https://lbs.qq.com/
- **归属**:腾讯
- **定位**:立足生态,连接未来
### 核心能力
- **JavaScript API**Web 端地图开发
- **移动端 Native SDK**Android / iOS
- **WebService 接口**:服务端调用
- **街景 API**:腾讯特色的街景视图(高德/百度无此能力)
- **路线规划**:驾车/步行/公交/骑行
- **地理编码/逆地理编码**:地址 ↔ 经纬度
- **地点搜索**POI 关键词检索
### 特色优势
| 能力 | 说明 |
|------|------|
| **街景服务** | 腾讯独有360° 街景全景图 |
| **微信生态整合** | 与微信小程序/公众号天然打通 |
| **腾讯系协同** | 与 QQ 音乐、腾讯视频等同一生态 |
### 费用模式
- 免费额度 + 按量计费(与高德/百度类似)
### U-Desk 适配评估
- 技术层面完全可行(标准 JS API / RESTful
- **如果 U-Desk 已接入 QQ 音乐/腾讯视频**,腾讯地图可作为统一腾讯生态补充
- 街景能力是差异化亮点(如展示文件拍摄地点的街景)
---
## 八、其他生活服务速查
### 翻译服务(三选一即可)
| 服务 | 免费额度 | 特点 |
|------|---------|------|
| 百度翻译 API | 标准版免费 5万字符/月 | 中文优化好 |
| 有道翻译 API | 免费额度 | 学术文献翻译强 |
| 腾讯翻译君 API | 免费额度 | 多语种支持广 |
**建议**:选百度翻译(免费额度大 + 中文优化)
### 新闻资讯 — RSS 自建方案(强烈推荐)
- 完全自主可控,无第三方依赖
- 推荐框架:`rss-parser` (Node.js) 或 `feedparser` (Go)
- 可订阅源36氪/虎嗅/少数派/V2EX/Hacker News 等
- U-Desk 实现Go 后端定时抓取 → Vue 展示新闻列表
### 12306 / 航旅
- **12306**:无公开 API极其严格
- **航旅纵横**:无公开开发者接口
- **各航空公司**:部分有开放 API如东航/南航)
- 结论:暂不可行,以外部链接方式提供
### 外卖(美团/饿了么)
- 主要面向商家端 API
- 无消费者端的开放接口
- 结论:暂不可行
### 支付宝/微信支付
- 面向商户的支付能力开放
- 与 U-Desk 场景关联度低
- 如需"打赏"等功能可后续考虑
---
## 九、最终推荐组合方案
### 第一优先级MVP 必选)
| 服务 | 平台 | 用途 | 工作量 | 成本 |
|------|------|------|--------|------|
| 天气 | 和风天气 / 高德天气 | 状态栏/侧栏天气显示 | 0.5天 | 免费~少量 |
| 地图 | 高德开放平台 | 文件位置/地址解析/路线 | 1-2天 | 免费 |
| 快递 | 快递100 API | 物流追踪面板 | 1-2天 | 免费~少量 |
### 第二优先级(体验增强)
| 服务 | 平台 | 用途 | 工作量 |
|------|------|------|--------|
| 翻译 | 百度翻译 API | 文件内容/界面翻译 | 0.5天 |
| 新闻 | RSS 自建聚合 | 信息流/资讯面板 | 1天 |
| 效率 | 钉钉开放平台 | 日历/待办/文件分享 | 2-3天 |
### 第三优先级(锦上添花)
| 服务 | 平台 | 用途 |
|------|------|------|
| 日历 | 微软 Graph API | Outlook 日历同步 |
| AI 助手 | 对接已有 AI 工作台 | 自然语言操作文件 |
---
## 十、U-Desk 生活服务模块架构建议
```
U-Desk 生态链接 - 生活服务模块
├── WeatherService (Go)
│ ├── GetCurrentWeather() → QWeather / 高德天气 API
│ ├── GetForecast() → 未来3-7天预报
│ └── GetAirQuality() → 空气质量指数
├── MapService (Go)
│ ├── Geocode() → 地址 → 经纬度 (高德)
│ ├── ReverseGeocode() → 经纬度 → 地址
│ ├── SearchPOI() → 周边 POI 搜索
│ └── RoutePlan() → 路线规划
├── ExpressService (Go)
│ ├── TrackPackage() → 快递100 查询
│ ├── AutoDetectCarrier() → 单号自动识别
│ └── BatchTrack() → 批量查询
├── TranslateService (Go)
│ └── Translate() → 百度翻译 API
├── NewsService (Go)
│ ├── FetchFeeds() → RSS 抓取聚合
│ └── ParseFeed() → 解析/去重/分类
├── LifePanel (Vue Components)
│ ├── WeatherWidget.vue → 天气小组件
│ ├── ExpressTracker.vue → 快递追踪面板
│ ├── MapViewer.vue → 地图查看器
│ ├── NewsFeed.vue → 新闻资讯流
│ └── QuickTools.vue → 翻译/计算器/汇率等
└── DingTalkBridge (Go)
├── SyncCalendar() → 日历同步
├── ShareToFile() → 文件分享到钉钉
└── PushNotification() → 事件通知
```
### 与文件管理器的融合点(核心价值)
1. **天气**:任务栏图标 hover 显示天气,不影响主界面
2. **快递**:收到快递单号图片/PDF → 右键"查询物流"
3. **地图**GPS 照片/日志文件 → 自动在地图标注位置
4. **翻译**:选中文件名或文本 → 右键"翻译"
5. **新闻**:文件管理间隙浏览资讯(不打断工作流)
6. **钉钉**:文件右键一键分享到钉钉聊天/文档
---
## 九、成本预估汇总
| 服务 | 月成本(个人版预估) | 备注 |
|------|---------------------|------|
| 和风天气 | ¥0 ~ ¥50 | 免费层够个人使用 |
| 高德地图 | ¥0 ~ ¥100 | Web API 免费额度较大 |
| 快递100 | ¥0 ~ ¥50 | 有免费试用额度 |
| 百度翻译 | ¥0 | 标准版 5万字符/月免费 |
| RSS 新闻 | ¥0 | 完全自建,无成本 |
| 钉钉 | ¥0 | 企业版可能收费 |
| **合计** | **¥0 ~ ¥200/月** | MVP 阶段接近零成本 |
---
*Sources:*
- *和风天气: https://dev.qweather.com/*
- *高德开放平台: https://lbs.amap.com/*
- *快递100: https://www.kuaidi100.com/openapi/*
- *钉钉开放平台: https://open.dingtalk.com/*
- *百度翻译 API: https://fanyi-api.baidu.com/*
- *OpenWeatherMap: https://openweathermap.org/api*

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 以内**。