mirror of
https://github.com/jxxghp/MoviePilot-Plugins.git
synced 2026-05-31 07:26:47 +00:00
110 lines
3.6 KiB
Markdown
110 lines
3.6 KiB
Markdown
# FeishuCommandBridgeLong
|
||
|
||
MoviePilot 的飞书长连接桥接插件。当前定位是兼容/备份入口；新用户更推荐直接使用 `Agent影视助手` 内置的飞书入口。
|
||
|
||
## 这版的定位
|
||
|
||
- 保留旧飞书桥接的轻量远程操作体验
|
||
- 作为迁移期兼容插件继续可用
|
||
- 新功能优先进入 `Agent影视助手`，避免飞书入口和资源执行逻辑继续分叉
|
||
- 如果只想装一个插件完成云盘资源整合 + 飞书入口，优先安装并开启 `Agent影视助手` 的内置飞书入口
|
||
|
||
## 当前能力
|
||
|
||
- 飞书长连接接收 `im.message.receive_v1`
|
||
- 智能单入口：自动识别片名、115 链接、夸克链接、盘搜搜索
|
||
- 影巢两段式搜索：先选影片，再看资源
|
||
- `详情` / `审查` / `n 下一页` 会话续接
|
||
- MoviePilot 原生搜索、下载、订阅、订阅搜索
|
||
- `P115StrmHelper` 的手动整理、增量 STRM、全量 STRM
|
||
- 115 扫码登录与状态查询
|
||
- 待继续 115 任务查看、继续、取消
|
||
|
||
## 执行后端
|
||
|
||
- `旧桥接直连`
|
||
适合保持现有飞书操作习惯，速度快。
|
||
- `自动优先新主线，失败回落旧桥接`
|
||
优先委托 `Agent影视助手`，失败再退回旧桥接。
|
||
- `仅走 Agent影视助手 新主线`
|
||
调试和后续统一主干时更合适。
|
||
|
||
日常老环境可以继续用 `旧桥接直连`。新环境建议改用 `Agent影视助手` 内置飞书入口；如果暂时仍使用本插件，建议切到 `仅走 Agent影视助手 新主线`，让资源动作统一落到 Agent影视助手。
|
||
|
||
## 新推荐入口
|
||
|
||
`Agent影视助手` 已内置可选 `Feishu Channel`，开启后可以直接接收飞书长连接消息，并复用同一套 `assistant/route`、`assistant/pick`、115 扫码和待任务续跑能力。
|
||
|
||
迁移建议：
|
||
|
||
1. 在本插件里先关闭 `启用插件`。
|
||
2. 到 `Agent影视助手` 中打开 `启用内置飞书入口`。
|
||
3. 迁移同一组飞书 `App ID / App Secret / Verification Token / 白名单`。
|
||
4. 确认 `GET /api/v1/plugin/AgentResourceOfficer/feishu/health` 显示运行正常。
|
||
|
||
## 常用飞书命令
|
||
|
||
```txt
|
||
处理 流浪地球2
|
||
影巢搜索 流浪地球2
|
||
yc流浪地球2
|
||
2流浪地球2
|
||
|
||
盘搜搜索 流浪地球2
|
||
ps流浪地球2
|
||
1流浪地球2
|
||
|
||
链接 https://115cdn.com/s/xxxx path=/待整理
|
||
链接 https://pan.quark.cn/s/xxxx path=/飞书
|
||
|
||
选择 1
|
||
选择 1 path=/最新动画
|
||
|
||
详情
|
||
审查
|
||
n 下一页
|
||
```
|
||
|
||
## 115 相关命令
|
||
|
||
```txt
|
||
115登录
|
||
115扫码
|
||
检查115登录
|
||
115登录状态
|
||
115状态
|
||
115帮助
|
||
115任务
|
||
继续115任务
|
||
取消115任务
|
||
```
|
||
|
||
- 当飞书桥接走 `Agent影视助手` 新主线时，`115登录` 会直接拉起扫码登录流程
|
||
- 如果飞书回复里带了二维码图片，直接用 115 App 扫码即可
|
||
- 某次 115 转存因为登录或会话问题失败后，可直接回复 `115任务` 查看当前待处理任务
|
||
- 登录成功后回复 `检查115登录`，会自动尝试继续上一次待处理的 115 任务
|
||
|
||
## 智能单入口说明
|
||
|
||
- 发片名：进入影巢或盘搜搜索流程
|
||
- 发 115 / 夸克链接：自动识别并转存，其中 115 链接会优先委托 `Agent影视助手`，确保失败后的待任务、扫码续跑和取消任务都在同一条会话链里
|
||
- `path=/目录`、`位置=目录` 都支持
|
||
- 裸链接也支持，不一定要带 `处理` 或 `链接` 前缀
|
||
|
||
## 智能体 API
|
||
|
||
插件提供两条更适合外部智能体调用的入口：
|
||
|
||
```txt
|
||
POST /api/v1/plugin/FeishuCommandBridgeLong/assistant/route
|
||
POST /api/v1/plugin/FeishuCommandBridgeLong/assistant/pick
|
||
```
|
||
|
||
`route` 负责分流，`pick` 负责继续选择。飞书消息入口和这两条 API 用的是同一套会话逻辑。
|
||
|
||
## 依赖
|
||
|
||
```txt
|
||
lark-oapi==1.5.3
|
||
```
|