feat: add skills and workspace files
- Add complete skill set including feishu, github, ci-gen, etc. - Add workspace documentation (AGENTS.md, SOUL.md, etc.) - Add memory system and project context
This commit is contained in:
@@ -0,0 +1,128 @@
|
||||
# B站插件调研 - Phase 1.2 第三方方案调研(bili-auth)
|
||||
|
||||
**调研时间**: 2026-02-06
|
||||
**调研人**: 阿里巴巴助手
|
||||
|
||||
---
|
||||
|
||||
## 1. bili-auth 项目概览
|
||||
|
||||
### 项目信息
|
||||
- **GitHub**: https://github.com/icyux/bili-auth
|
||||
- **描述**: 第三方哔哩哔哩 OAuth 2.0 API,基于私信鉴权
|
||||
- **核心卖点**: 无需官方开发者申请,任何用户都可使用
|
||||
|
||||
### 技术栈
|
||||
- 后端: Python + Flask
|
||||
- 协议: OAuth 2.0 标准流程
|
||||
- 鉴权方式: B站私信(普通用户API)
|
||||
|
||||
---
|
||||
|
||||
## 2. 实现原理
|
||||
|
||||
### 核心流程
|
||||
```
|
||||
用户访问第三方应用
|
||||
↓
|
||||
应用重定向到 bili-auth 授权页
|
||||
↓
|
||||
用户按指引发送一条特定私信给机器人账号
|
||||
↓
|
||||
机器人验证私信内容,完成鉴权
|
||||
↓
|
||||
返回 OAuth 2.0 标准授权码
|
||||
↓
|
||||
应用用授权码换取 access_token
|
||||
```
|
||||
|
||||
### 私信鉴权机制
|
||||
- 用户需要向指定的B站账号发送一条私信
|
||||
- 私信内容包含临时验证码或特定指令
|
||||
- 机器人账号读取私信,确认用户身份
|
||||
- 整个过程模拟正常用户行为
|
||||
|
||||
### 部署方式
|
||||
- 提供 Docker 镜像一键部署
|
||||
- 只需一个能收发私信的B站账号作为"机器人"
|
||||
- 支持自定义 OAuth 应用管理
|
||||
|
||||
---
|
||||
|
||||
## 3. 与官方方案对比
|
||||
|
||||
| 维度 | bili-auth (第三方) | B站官方开放平台 |
|
||||
|------|-------------------|----------------|
|
||||
| **准入门槛** | ✅ 极低,有B站号即可 | ❌ 仅企业开发者 |
|
||||
| **开发成本** | ✅ 低,标准OAuth 2.0 | ⚠️ 中,需申请审核 |
|
||||
| **用户体验** | ⚠️ 需发私信,多一步操作 | ✅ 标准授权页 |
|
||||
| **功能范围** | ⚠️ 仅限普通用户API | ✅ 全量官方API |
|
||||
| **稳定性** | ❌ 非官方,接口可能变动 | ✅ 官方保障 |
|
||||
| **合规风险** | ❌ 灰色地带 | ✅ 完全合规 |
|
||||
| **账号安全** | ❌ 有被封风险 | ✅ 官方支持 |
|
||||
|
||||
---
|
||||
|
||||
## 4. 风险评估
|
||||
|
||||
### 4.1 账号封禁风险
|
||||
|
||||
#### 风险来源
|
||||
- 机器人账号频繁收发私信,触发风控
|
||||
- 短时间内大量鉴权请求,被判定为异常行为
|
||||
- B站更新私信API,导致功能失效
|
||||
|
||||
#### 风险等级
|
||||
| 场景 | 风险等级 | 说明 |
|
||||
|------|----------|------|
|
||||
| 个人自用(<10次/天) | 🟡 低 | 行为接近正常用户 |
|
||||
| 小范围使用(<100次/天) | 🟠 中 | 可能触发轻度风控 |
|
||||
| 大规模部署(>1000次/天) | 🔴 高 | 极易被封号/封私信 |
|
||||
|
||||
#### 缓解策略
|
||||
- 使用小号作为机器人,避免主号风险
|
||||
- 控制鉴权频率,模拟真人操作间隔
|
||||
- 实现优雅降级,接口失效时提醒用户
|
||||
- 准备备用账号,主号被封可快速切换
|
||||
|
||||
### 4.2 API 限制
|
||||
|
||||
#### 数据获取能力
|
||||
- ✅ 可获取:用户基础信息、关注列表、视频信息、搜索
|
||||
- ❌ 无法获取:敏感数据(如私信内容、手机号)、官方限制接口
|
||||
|
||||
#### 频率限制
|
||||
- 依赖B站普通用户的API限制
|
||||
- 未登录/低等级账号限制更严格
|
||||
- 建议实现本地缓存,减少API调用
|
||||
|
||||
### 4.3 长期维护风险
|
||||
|
||||
- 项目作者可能停止维护
|
||||
- B站可能调整私信API
|
||||
- 法律合规性存疑
|
||||
|
||||
---
|
||||
|
||||
## 5. 结论
|
||||
|
||||
### 可行性评估
|
||||
- **短期(个人使用)**: ✅ **可行**
|
||||
- **中期(小范围分享)**: 🟡 **有条件可行**
|
||||
- **长期(大规模部署)**: ❌ **不推荐**
|
||||
|
||||
### 推荐方案
|
||||
对于 OpenClaw 技能开发:
|
||||
1. **采用 bili-auth 方案** 作为个人用户的临时解决方案
|
||||
2. **明确风险提示**,让用户知晓账号封禁可能性
|
||||
3. **设计降级方案**,接口失效时不影响核心功能
|
||||
4. **持续关注** 官方开放平台动态,如有个人开发者通道,及时迁移
|
||||
|
||||
### 下一步建议
|
||||
进入 Phase 2 - 数据获取能力调研,验证 bili-auth 能获取到哪些具体数据。
|
||||
|
||||
---
|
||||
|
||||
## 参考资料
|
||||
- bili-auth GitHub: https://github.com/icyux/bili-auth
|
||||
- bili-auth 作者博客: https://blog.icyu.me/post/1626001
|
||||
Reference in New Issue
Block a user