nonebot-plugin-zhihu-parser 0.1.0__tar.gz

nonebot_plugin_zhihu_parser-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,44 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Store distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distribution packages
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

nonebot_plugin_zhihu_parser-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+__pycache__/
+*.py[cod]
+!.gitignore

nonebot_plugin_zhihu_parser-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 devil233
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nonebot_plugin_zhihu_parser-0.1.0/PKG-INFO

@@ -0,0 +1,128 @@
+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、微博、小红书、快手、油管、推特...

nonebot_plugin_zhihu_parser-0.1.0/README.md

@@ -0,0 +1,93 @@
+# 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、微博、小红书、快手、油管、推特...

nonebot_plugin_zhihu_parser-0.1.0/nonebot_plugin_zhihu_parser/__init__.py

@@ -0,0 +1,331 @@
+import re
+from nonebot import on_message, on_command, get_bots
+from nonebot.permission import SUPERUSER
+from nonebot.adapters.onebot.v11 import Message, MessageSegment, MessageEvent, Bot, GroupMessageEvent, PrivateMessageEvent
+from nonebot.log import logger
+from nonebot import get_driver
+from nonebot.rule import Rule
+from nonebot.typing import T_State
+
+from nonebot.plugin import PluginMetadata
+from nonebot_plugin_zhihu_parser.config import PluginConfig
+from .core.parsers.zhihu.parser import ZhihuParser
+from .core.download import Downloader
+from .core.render import Renderer
+from .core.debounce import Debouncer
+from .core.clean import CacheCleaner
+from .core.exception import ParseException
+
+# 洗血专用依赖
+from nonebot import require
+require("nonebot_plugin_apscheduler")
+from nonebot_plugin_apscheduler import scheduler
+from nonebot import on_command
+from .core.parsers.zhihu.refresher import do_refresh_token
+from .core.parsers.zhihu.maintenance import (
+    RefreshMonitor, format_refresh_result, refresh_alert_targets, refresh_job_options,
+)
+
+global_config = get_driver().config
+# 从 .env 读取配置，如果没有则提供默认值（分批阈值默认10，防抖默认86400秒）
+ZHIHU_BATCH_SIZE = getattr(global_config, "zhihu_batch_size", 10)
+ZHIHU_DEBOUNCE_TIME = getattr(global_config, "zhihu_debounce_time", 86400)
+ZHIHU_CACHE_MAX_AGE = getattr(global_config, "zhihu_cache_max_age", 86400 * 7)
+ZHIHU_MAX_IMAGES = getattr(global_config, "zhihu_max_images", 50)
+
+cfg = PluginConfig()
+refresh_monitor = RefreshMonitor(
+    cfg.data_dir / "zhihu_refresh_state.json",
+    refresh_alert_targets(global_config),
+    do_refresh_token,
+    lambda: [bot for bot in get_bots().values() if isinstance(bot, Bot)],
+)
+zhihu_parser = None
+zhihu_renderer = None
+# 将配置好的防抖时间传给防抖器
+zhihu_debouncer = Debouncer(ttl_seconds=ZHIHU_DEBOUNCE_TIME)
+
+__plugin_meta__ = PluginMetadata(
+    name="知乎解析",
+    description="解析知乎问题、回答、专栏文章与想法链接，生成预览卡片并转发图文内容",
+    usage="直接发送知乎链接即可自动解析；引用含知乎链接的消息回复「解析」可重新解析；管理员发送「知乎保活」可手动刷新登录信息",
+    type="application",
+    homepage="https://github.com/devil233-ui/nonebot-plugin-zhihu-parser",
+    supported_adapters={"~onebot.v11"},
+)
+
+@get_driver().on_startup
+async def init_parser():
+    global zhihu_parser, zhihu_renderer
+    downloader = Downloader(cfg)
+    zhihu_parser = ZhihuParser(cfg, downloader)
+    Renderer.load_resources()
+    zhihu_renderer = Renderer(cfg)
+    max_age = int(ZHIHU_CACHE_MAX_AGE)
+    zhihu_cleaner = CacheCleaner(temp_dir=cfg.cache_dir, max_age_seconds=max_age)
+    zhihu_cleaner.start()
+    
+    days = max_age / 86400
+    logger.info(f"知乎解析插件：{days:g}天缓存自动清理任务已挂载启动！")
+    
+    scheduler.add_job(
+        auto_refresh_zhihu_cookie,
+        **refresh_job_options(
+            scheduler.timezone,
+            getattr(global_config, "zhihu_refresh_jitter_seconds", 900),
+        ),
+    )
+
+
+async def auto_refresh_zhihu_cookie():
+    logger.info("[知乎保活] 开始自动保活")
+    result = await refresh_monitor.run(cfg)
+    if result.ok:
+        logger.info(format_refresh_result(result))
+    else:
+        logger.warning(format_refresh_result(result))
+
+
+@get_driver().on_bot_connect
+async def resume_refresh_alerts(bot):
+    if isinstance(bot, Bot):
+        await refresh_monitor.notify_pending()
+
+def check_zhihu_url():
+    async def _check(bot: Bot, event: MessageEvent, state: T_State) -> bool:
+        raw_msg = str(event.get_message()).replace("\\/", "/")
+        pat = re.compile(r"(https?://(?:www\.)?zhihu\.com/[^\s\"\'\\]+|https?://zhuanlan\.zhihu\.com/[^\s\"\'\\]+)")
+        
+        # 1. 正常情况：直接检测消息里有没有知乎链接
+        match = pat.search(raw_msg)
+        if match:
+            state['zhihu_match'] = match
+            state['zhihu_raw'] = raw_msg
+            return True
+            
+        # 2. 引用解析情况：检查是不是发了“解析”并且带了引用(reply)
+        # 兼容这几个词：解析、提取、解析知乎
+        if raw_msg.strip() in ["解析", "提取", "解析知乎"] and event.reply:
+            # 提取被引用原消息（哪怕是小程序 JSON 卡片，这里也会变成字符串）
+            reply_msg = str(event.reply.message).replace("\\/", "/")
+            reply_match = pat.search(reply_msg)
+            if reply_match:
+                # 狸猫换太子：把引用里的链接和文本存进 state，骗过后面的程序
+                state['zhihu_match'] = reply_match
+                state['zhihu_raw'] = reply_msg 
+                return True
+                
+        return False
+    return Rule(_check)
+
+zhihu_matcher = on_message(rule=check_zhihu_url(), priority=10, block=False)
+
+# 【新增】手动强制换血指令，方便你随时补充存活期
+refresh_cmd = on_command(
+    "刷新知乎ck", aliases={"知乎保活", "知乎刷新"},
+    permission=SUPERUSER, priority=5, block=True,
+)
+
+@refresh_cmd.handle()
+async def force_refresh(bot: Bot, event: MessageEvent):
+    await refresh_cmd.send("正在刷新知乎登录信息，请稍候。")
+    result = await refresh_monitor.run(cfg)
+    await refresh_cmd.send(format_refresh_result(result))
+
+@zhihu_matcher.handle()
+async def handle_zhihu(bot: Bot, event: MessageEvent, state: T_State):
+    if not zhihu_parser or not zhihu_renderer:
+        logger.warning("知乎解析器仍在初始化中，请稍后再试")
+        return
+        
+    await zhihu_matcher.send("识别到知乎链接，开始解析")
+    
+    text = state['zhihu_raw']
+    base_match = state['zhihu_match']
+    
+    # 原始提取的 URL
+    raw_url = base_match.group(0).replace("&", "&")
+    # [新增清洗] 暴力剔除 URL 尾部可能因为引用而粘连的中文和特殊标点
+    import re
+    url = re.sub(r'[\u4e00-\u9fa5\u3000-\u303f\uff00-\uffef\]\}）】”"。，！？]+$', '', raw_url)
+    
+    text = text.replace("&", "&")
+    session_id = event.get_session_id()
+    
+    if zhihu_debouncer.hit_url(session_id, url):
+        logger.info(f"[{session_id}] 链接 {url} 在防抖时间内，已跳过重复解析")
+        await zhihu_matcher.send("24小时内有人水果了，端下去罢")
+        return
+        
+    handlers = getattr(zhihu_parser, "_handlers", {})
+    final_keyword = None
+    final_match_obj = None
+
+    for kw, func in handlers.items():
+        pat = getattr(func, "__parser_pattern__", None)
+        if pat:
+            if isinstance(pat, str): pat = re.compile(pat)
+            match = pat.search(text)
+            if match:
+                final_keyword = kw
+                final_match_obj = match
+                break
+
+    if not final_match_obj:
+        KNOWN_PATTERNS = [
+            ("/answer/", re.compile(r"zhihu\.com/question/(?P<question_id>\d+)/answer/(?P<answer_id>\d+)")),
+            ("www.zhihu.com/question/", re.compile(r"zhihu\.com/question/(?P<question_id>\d+)")),
+            ("zhuanlan.zhihu.com/p/", re.compile(r"zhuanlan\.zhihu\.com/p/(?P<article_id>\d+)")),
+            ("www.zhihu.com/pin/", re.compile(r"zhihu\.com/pin/(?P<pin_id>\d+)")),
+        ]
+        for exact_kw, pat in KNOWN_PATTERNS:
+            match = pat.search(text)
+            if match and exact_kw in handlers:
+                final_keyword = exact_kw
+                final_match_obj = match
+                break
+                
+    if not final_keyword or not final_match_obj:
+        return
+
+    logger.warning(f"🔍 [X光机] 开始解析！命中规则: {final_keyword}, 提取参数: {final_match_obj.group(0)}")
+
+    try:
+        parse_res = await zhihu_parser.parse(final_keyword, final_match_obj)
+        if not parse_res: return
+            
+        # A. 发送预览卡片
+        card_path = await zhihu_renderer.render_card(parse_res)
+        if card_path and card_path.exists():
+            await zhihu_matcher.send(MessageSegment.image(card_path))
+
+        # B. 分批次合并转发逻辑
+        bot_id = int(bot.self_id)
+        img_counter = 0
+        batch_num = 1
+        current_combined_msg = Message()
+        total_img_counter = 0
+        limit_reached = False
+        
+        # 初始添加标题
+        if getattr(parse_res, "title", None):
+            current_combined_msg += MessageSegment.text(f"【{parse_res.title}】\n\n")
+
+        async def send_current_batch(msg: Message, is_last: bool = False):
+            if not msg: return
+            prefix = f"(第{batch_num}部分) " if not (batch_num == 1 and is_last) else ""
+            node = [MessageSegment.node_custom(user_id=bot_id, nickname=f"知乎解析 {prefix}", content=msg)]
+            try:
+                if isinstance(event, GroupMessageEvent):
+                    await bot.call_api("send_group_forward_msg", group_id=event.group_id, messages=node)
+                else:
+                    await bot.call_api("send_private_forward_msg", user_id=event.user_id, messages=node)
+            except Exception as e:
+                logger.error(f"发送第 {batch_num} 部分转发失败: {e}")
+                
+                # [恢复] 降级单发机制：因为现在有总量限制，可以放心拆包单发了
+                await zhihu_matcher.send(f"⚠️ 第 {batch_num} 部分触发风控拦截，正在自动拆分单独发送...")
+                
+                # [新增] 专门处理长文本折叠的内部助手函数
+                async def safe_send_text(text_msg: Message):
+                    t_str = str(text_msg).strip()
+                    if not t_str: return
+                    
+                    # 纯文字装进合并转发里“折叠”起来
+                    if len(t_str): 
+                        t_node = [MessageSegment.node_custom(user_id=bot_id, nickname="风控部分纯文字折叠", content=Message(t_str))]
+                        try:
+                            if isinstance(event, GroupMessageEvent):
+                                await bot.call_api("send_group_forward_msg", group_id=event.group_id, messages=t_node)
+                            else:
+                                await bot.call_api("send_private_forward_msg", user_id=event.user_id, messages=t_node)
+                        except Exception:
+                            # 终极兜底：万一纯文本转发都失败，截断只发前500字
+                            await zhihu_matcher.send(t_str[:500] + "\n...[字数过多已截断]")
+                    else:
+                        # 不满 150 字的短句（比如图注、小标题）直接发，不影响阅读连贯性
+                        await zhihu_matcher.send(text_msg)
+
+                fallback_msg = Message()
+                for seg in msg:
+                    if seg.type == 'text':
+                        fallback_msg += seg
+                    else:
+                        # 先发送之前攒着的文字（带折叠判定）
+                        try: await safe_send_text(fallback_msg)
+                        except Exception: pass
+                        fallback_msg = Message()
+                        
+                        # 单发媒体
+                        try: await zhihu_matcher.send(Message(seg))
+                        except Exception as sub_e: 
+                            logger.error(f"单发媒体失败（严重风控死锁）: {sub_e}")
+                            await zhihu_matcher.send("🚫 [一张图片/视频因触发腾讯极其严格的审核被无情抹杀]")
+                            
+                # 收尾剩余文字
+                try: await safe_send_text(fallback_msg)
+                except Exception: pass
+
+        # 遍历正文内容
+        if hasattr(parse_res, "contents") and parse_res.contents:
+            for content in parse_res.contents:
+                # 1. 处理文字
+                if hasattr(content, "text") and content.text:
+                    current_combined_msg += MessageSegment.text(str(content.text) + "\n")
+                
+                # 2. 处理图片/媒体（增加精准异常捕获）
+                if hasattr(content, "get_path"):
+                    try:
+                        file_path = await content.get_path()
+                        if file_path and getattr(file_path, "exists", lambda: False)():
+                            # 换完后上一行是：
+                            ext = file_path.suffix.lower()
+                            if ext in [".jpg", ".jpeg", ".png", ".gif", ".webp"]:
+                                current_combined_msg += MessageSegment.image(file_path)
+                                current_combined_msg += MessageSegment.text("\n")
+                                img_counter += 1
+                                total_img_counter += 1  # [新增] 累加总数
+                            elif ext in [".mp4", ".mov", ".avi"]:
+                                current_combined_msg += MessageSegment.video(file_path)
+                                current_combined_msg += MessageSegment.text("\n")
+                                img_counter += 2 
+                                total_img_counter += 2  # [新增] 累加总数
+                    except RuntimeError:
+                        pass
+                    except Exception as e:
+                        logger.debug(f"读取媒体失败: {e}")
+
+                # [修改] 达到单批次阈值 或 达到总量限制 时触发发包
+                if img_counter >= ZHIHU_BATCH_SIZE or total_img_counter >= ZHIHU_MAX_IMAGES:
+                    await send_current_batch(current_combined_msg)
+                    current_combined_msg = Message() 
+                    img_counter = 0
+                    batch_num += 1
+                    
+                # [新增] 总量阻断：超过设定总量直接掐断循环
+                if total_img_counter >= ZHIHU_MAX_IMAGES:
+                    limit_reached = True
+                    break
+
+        # [修改] 如果没有被提前阻断，才发送收尾段落
+        if current_combined_msg and not limit_reached:
+            await send_current_batch(current_combined_msg, is_last=True)
+            
+        # [新增] 触发了截断则发送文案提示
+        if limit_reached:
+            await zhihu_matcher.send("不刷屏了，剩下的请点击原链接跳转阅读")
+
+    except ParseException as e:
+        err_msg = str(e)
+        logger.warning(f"知乎抓取被阻断: {err_msg}")
+        if e.__cause__:
+            logger.error(f"💥 [X光机] 底层致命报错: {e.__cause__}")
+        
+        # 触发回滚！把毒数据从防抖池踢出去
+        zhihu_debouncer.rollback_url(session_id, url)
+        
+        await zhihu_matcher.send(f"⚠️ 解析失败: {err_msg}")
+            
+    except Exception as e:
+        logger.exception("解析知乎链接时发生严重错误")
+        zhihu_debouncer.rollback_url(session_id, url)