OpenClaw Agent
7e0acef4f9
- Add complete skill set including feishu, github, ci-gen, etc. - Add workspace documentation (AGENTS.md, SOUL.md, etc.) - Add memory system and project context
141 lines
3.7 KiB
Markdown
141 lines
3.7 KiB
Markdown
# B站插件调研 - Phase 1.3 授权方案对比与推荐
|
||
|
||
**调研时间**: 2026-02-06
|
||
**调研人**: 阿里巴巴助手
|
||
|
||
---
|
||
|
||
## 方案对比总表
|
||
|
||
| 评估维度 | B站官方开放平台 | bili-auth 第三方方案 |
|
||
|----------|----------------|---------------------|
|
||
| **准入门槛** | ❌ 仅企业开发者 | ✅ 任何B站用户 |
|
||
| **申请流程** | 复杂（注册→认证→审核→开发）| 简单（部署即用）|
|
||
| **授权体验** | ✅ 标准OAuth页面 | ⚠️ 需发送私信 |
|
||
| **功能完整性** | ✅ 全量API | ⚠️ 普通用户API |
|
||
| **稳定性** | ✅ 官方保障 | ❌ 依赖非公开接口 |
|
||
| **合规性** | ✅ 100%合规 | ❌ 灰色地带 |
|
||
| **账号风险** | ✅ 无风险 | 🟡 有小号风险 |
|
||
| **开发成本** | 高（需企业资质）| 低（Docker一键部署）|
|
||
| **维护成本** | 低（官方维护）| 中（需关注接口变动）|
|
||
| **扩展性** | 强 | 弱 |
|
||
|
||
---
|
||
|
||
## 决策矩阵
|
||
|
||
### 场景分析
|
||
|
||
| 使用场景 | 推荐方案 | 理由 |
|
||
|----------|----------|------|
|
||
| 企业/机构项目 | **官方开放平台** | 合规、稳定、功能完整 |
|
||
| 个人学习/实验 | **bili-auth** | 门槛低，快速验证想法 |
|
||
| 小团队内部工具 | **bili-auth** | 成本可控，风险可接受 |
|
||
| 商业产品/大规模 | **官方开放平台** | 合规要求，长期稳定 |
|
||
| OpenClaw 技能 | **bili-auth** | 用户即开即用，无需企业资质 |
|
||
|
||
---
|
||
|
||
## 推荐方案（OpenClaw 技能）
|
||
|
||
### 主方案: bili-auth 私信鉴权
|
||
|
||
**推荐理由:**
|
||
1. ✅ **零门槛**：用户无需申请开发者资质
|
||
2. ✅ **快速可用**：部署后即可使用
|
||
3. ✅ **标准协议**：OAuth 2.0，与官方体验接近
|
||
4. ✅ **成本可控**：只需一个小号作为机器人
|
||
|
||
**风险控制:**
|
||
1. ⚠️ **小号策略**：明确告知用户使用小号，避免主号风险
|
||
2. ⚠️ **频率限制**：技能内建限流，避免触发风控
|
||
3. ⚠️ **降级设计**：接口失效时优雅降级，不崩溃
|
||
4. ⚠️ **免责声明**：明确说明非官方方案，用户自担风险
|
||
|
||
### 备选方案: 手动Cookie模式
|
||
|
||
**适用场景:**
|
||
- bili-auth 不可用时
|
||
- 用户不愿授权第三方服务
|
||
|
||
**实现方式:**
|
||
- 用户从浏览器复制Cookie
|
||
- 技能直接调用B站API
|
||
- 无需机器人账号
|
||
|
||
**风险:**
|
||
- Cookie泄露风险
|
||
- 有效期短，需频繁更新
|
||
- 同样存在封号风险
|
||
|
||
---
|
||
|
||
## 技术架构建议
|
||
|
||
### 推荐架构
|
||
|
||
```
|
||
用户 → OpenClaw 技能
|
||
↓
|
||
[授权模块]
|
||
↓
|
||
├─→ bili-auth 服务（自建或公共）
|
||
│ ↓
|
||
│ B站私信鉴权
|
||
│ ↓
|
||
└─← access_token
|
||
↓
|
||
[数据获取模块]
|
||
↓
|
||
B站公开API调用
|
||
↓
|
||
返回数据给OpenClaw
|
||
```
|
||
|
||
### MVP 功能范围（bili-auth 方案）
|
||
|
||
**Phase 1 - 基础功能**
|
||
- [ ] 用户授权（bili-auth 集成）
|
||
- [ ] 获取关注列表
|
||
- [ ] 获取UP主动态
|
||
- [ ] 视频搜索
|
||
|
||
**Phase 2 - 扩展功能**
|
||
- [ ] 视频详情获取
|
||
- [ ] 播放历史（如有权限）
|
||
- [ ] 收藏列表（如有权限）
|
||
|
||
**Phase 3 - 高级功能**
|
||
- [ ] 自动追更提醒
|
||
- [ ] 数据分析
|
||
|
||
---
|
||
|
||
## Go / No-Go 决策
|
||
|
||
### 结论: ✅ Go
|
||
|
||
**理由:**
|
||
1. bili-auth 方案技术可行
|
||
2. 风险可控（小号策略+频率限制）
|
||
3. 能满足核心需求（获取关注列表、追更）
|
||
4. 用户价值明确（解决无法官方API的问题）
|
||
|
||
**前提条件:**
|
||
1. 明确告知用户风险
|
||
2. 使用小号作为机器人
|
||
3. 实现频率限制
|
||
4. 准备降级方案
|
||
|
||
---
|
||
|
||
## 下一步行动
|
||
|
||
进入 **Phase 2 - 数据获取能力调研**，验证以下API是否可用：
|
||
- 用户信息获取
|
||
- 关注列表获取
|
||
- 视频搜索
|
||
- 视频详情
|
||
|
||
同时开始 **Phase 5 - 原型开发** 的准备工作。
|