Metadata-Version: 2.5
Name: nonebot-plugin-zhihu-parser
Version: 0.1.0
Summary: 知乎链接解析与图文转发的 NoneBot2 插件
Project-URL: Homepage, https://github.com/devil233-ui/nonebot-plugin-zhihu-parser
Project-URL: Repository, https://github.com/devil233-ui/nonebot-plugin-zhihu-parser
Project-URL: Issues, https://github.com/devil233-ui/nonebot-plugin-zhihu-parser/issues
Author-email: devil233 <1250226509@qq.com>
License: MIT
License-File: LICENSE
Keywords: nonebot2,zhihu,知乎,链接解析
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.10
Requires-Dist: aiofiles>=23.1.0
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: apilmoji<=0.3.1
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: curl-cffi>=0.7.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: msgspec>=0.18.0
Requires-Dist: nonebot-adapter-onebot>=2.4.0
Requires-Dist: nonebot-plugin-apscheduler>=0.4.0
Requires-Dist: nonebot2>=2.3.0
Requires-Dist: pillow>=9.5.0
Requires-Dist: tqdm>=4.67.3
Requires-Dist: typing-extensions>=4.1.0
Description-Content-Type: text/markdown

# nonebot-plugin-zhihu-parser

知乎链接解析插件（从 AstrBot 移植）：自动解析群聊里的知乎链接，发送预览卡片并转发图文内容。

## 功能

- 支持解析「问题 / 回答 / 专栏文章 / 想法（pin）」链接
- 解析结果发送预览卡片，正文按批次合并转发，超量自动截断并提示原链接
- 引用一条含知乎链接的消息回复「解析」可重新解析
- 登录信息（Cookie）自动保活，连续失败自动提醒管理员
- 过期缓存自动清理（默认 7 天）

## 安装

推荐使用 nb-cli 安装：

```bash
nb plugin install nonebot-plugin-zhihu-parser
```

也可以使用 pip 安装：

```bash
pip install nonebot-plugin-zhihu-parser
```

未配置知乎登录信息时，部分内容会被知乎要求登录（HTTP 403），建议首次使用
时先按下文「登录保活与失败提醒」配置 Cookie。

## 使用方法

- 直接发送知乎链接（`www.zhihu.com/question/...`、`zhuanlan.zhihu.com/p/...`、`www.zhihu.com/pin/...`）即可自动解析
- 引用含知乎链接的消息，回复「解析」「提取」「解析知乎」触发解析
- 管理员发送「知乎保活」（或「刷新知乎ck」「知乎刷新」）手动刷新登录信息，机器人直接回复成功或失败原因

## 配置项

在 `.env.*` 中按需配置（以下为插件默认值）：

```dotenv
# 单次解析最多输出的图片/视频总量阈值
ZHIHU_MAX_IMAGES=50
# 合并转发的单批次图片最大数量
ZHIHU_BATCH_SIZE=10
# 同一个链接的冷却时间（单位：秒。86400秒 = 24小时）
ZHIHU_DEBOUNCE_TIME=86400
# 自动清理多久以前的缓存文件（单位：秒。604800秒 = 7天）
ZHIHU_CACHE_MAX_AGE=604800
# 知乎登录 Cookie（推荐留空，改用下方的 CK 文件管理）
ZHIHU_COOKIE=""
```

## 登录保活与失败提醒

登录信息文件位于机器人工作目录 `config/nonebot_plugin_zhihu_parser/zhihu_cookies.txt`，
单行 `k=v; k=v` 格式，需包含 `z_c0`、`d_c0`、`_xsrf`、`SESSIONID` 四个键；
替换文件后无需重启即可生效。

- 自动保活沿用固定的日期安排，按机器人配置的时区在凌晨4点后随机延迟最多15分钟，
  不再每次都卡在整点执行。这是错峰措施，不保证避免平台风控。
- 连续两次保活失败后发送提醒，同一次故障只提醒一次；成功后重新开始计数。
  计数和送达状态保存在插件数据目录，重启不会清零。
- 通知未送达时保留待发状态，在机器人重新连接或下次保活时补发；
  已送达的接收人不会重复收到同一故障的提醒。
- 未指定接收群时，默认私聊现有的机器人管理员，不会向所有群广播。
  指定群后只通知配置的目标；同时配置私聊账号时，两类目标都会收到提醒。
- 管理员可发送“知乎保活”手动刷新，直接看到成功或失败原因；
  非管理员不能触发登录信息刷新。登录失效需要重新登录，保活不能替代登录。

可选配置（与现有配置放在一起，修改后重启机器人生效）：

```dotenv
# 提醒接收群；留空不发送群提醒
ZHIHU_REFRESH_ALERT_GROUPS = []
# 可选：指定私聊接收账号，显式设为空列表可关闭默认管理员私聊
# ZHIHU_REFRESH_ALERT_USERS = []
# 随机延迟上限，单位秒；默认900，允许0到3600
ZHIHU_REFRESH_JITTER_SECONDS = 900
```

解析和保活共用同一份浏览器身份；保活请求设有超时限制。
刷新失败不会写回响应中的空登录信息，刷新期间手动更新的登录信息也不会被覆盖。
不要将Cookie、刷新令牌或完整响应内容发送到群聊、日志或提交到仓库。

## 已知问题

目前测试所谓任意风控部分均可通过单独发送解决，其实并不能确定是风控引起的；又，最初测试过一个批次输出50张图都能顺利，可以排除体积原因。

这个奇妙风控在原项目同样存在（但没有备用方案），所以总之目前本项目只能通过独立发送解决这个问题，希望有高人指点。

## 致谢

 原项目：[astrbot_plugin_parser](https://github.com/Zhalslar/astrbot_plugin_parser) 高性能低耦合的万能链接解析器。支持的类型：视频、图集、音频。 支持的平台：A站、B站、抖音、tiktok、微博、小红书、快手、油管、推特...
