# 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.4.0
```
