v1.8.0（2026-10-26）

juicePans v1.8.0 发布说明（2026-10-26）

果汁搜盘（juicePans）v1.8.0 是一次聚焦「检索质量、展示可读性、智能反爬与自愈韧性」的核心架构升级。本次版本重点交付内容去重聚合（JP-M1）、智能按需内容抽查（JP-M2）、熔断自愈与耗时保险丝（JP-M3）三大能力。

---

1. 核心更新亮点

📁 JP-M1：同名同质资源智能去重与折叠聚合

• 两级标题去噪与聚合 (norm_title)：全角转半角、剔除首尾特殊修饰字符，智能剥离清晰度标识（4K/1080P/60FPS/HDR/REMUX）、压制组、片源后缀及渠道干扰词，保留核心年份与季数标识；按 (cloud, norm_title) 精准折叠同名资源副本；
• 清爽展示与副本注记：默认仅展示首选资源，其下优雅注记 ↳ 另有 N 个同资源副本链接（已折叠，--all-dups 展开）；
• 全量展开参数 (--all-dups)：提供无损平铺展开模式，保证链接与信息零丢失；JSON 输出携带完整的 dups 列表。

🔍 JP-M2：智能按需内容抽查与精准分类

• 只读轻量探测 (detect_quark / peek_quark)：依托夸克 CLI share-detail 只读探测接口（严格坚守「只搜不转存」底线），快速抓取首层元数据；
• 高置信度启发式判决：资源总体积 > 100MB 标记为 [内容:视频]，体积 < 5MB 且标题含「作者：」快速标记为 [内容:小说]，杜绝挂羊头卖狗肉的虚假资源；
• 按需触发与并发提速：默认 smart 模式下仅在过滤词包含小说/视频/格式等关键词时触发探测；Top 5 夸克链接采用 ThreadPoolExecutor 并发检测，将网络时延压缩至秒级；支持 --peek [smart|on|off]。

🛡️ JP-M3：引擎熔断生命周期自愈与耗时保险丝

• 熔断过期自愈与脏数据清理：load_engine_state 启动时自动检查超期熔断状态并持久化写回，彻底抹平存量累积失败记录；任一引擎成功返回后显式调用 mark_engine_success 清零失败计数；
• 单行错误脱敏截断 (clip_err)：错误日志强制截断至 120 字符以内，自动剥离敏感 token、stack 和 debug 噪音；
• 耗时单调硬上限保险丝：针对 pansou 引入 50 秒单调时钟硬熔断，彻底杜绝多源聚合挂死；
• 废弃/未知引擎软校验：对历史废弃引擎（如 ghspider）友好引导提示改用 pansou --src all，未知引擎给出明确可用列表并安全跳过。

---

2. 升级与兼容性说明

• 零依赖运行：纯 Python 标准库编写，无需安装任何第三方库（如 requests / aiohttp 等）；
• 向后兼容：所有既有命令与参数完全兼容，旧版脚本可无缝平滑替换。

v1.7.7

juicePans v1.7.7

相较 1.7.6 的改进：

熔断与限速

• 强风控熔断：HTTP 429/412 或验证码页属强风控，一次即冷却 30 分钟，并遵守 Retry-After（上限 24h）；403 与普通失败仍为 2 次/30 分钟。
• 被熔断的引擎在关键词变体重试与 ataw 兜底中也会跳过。
• 限速：TA搜（ataw）/盘小子详情页并发降为 2，并加 0.2–0.8s 随机间隔。
• HTTP 错误响应体最多读取 8KB，修复海搜 429 时读取卡顿约 37 秒的问题。
• 熔断状态文件改为原子写入，防止并发损坏。

新功能

• 新增 --from_url：从公开页面（B站专栏/贴吧/知乎/豆瓣小组等）提取网盘直链与逐链提取码；单次 ≤5 页、串行、同站 0.5–1.5s 间隔，撞登录墙/验证码即停止该站。
• 新增 --suggest_queries：输出供 WebSearch 使用的 site: 检索建议（不联网）。

链接提取增强

• links_from_text()：全角转半角、识别无协议链接、还原 JSON 转义/HTML 实体/跳转包装、提取码就近逐链配对。
• check_links.py --file 支持每行附带各自的提取码。

其他

• 默认搜索输出与 1.7.6 保持一致（回放测试验证）。
• 鸣谢新增 NanmiCoder/MediaCrawler（仅借鉴风控熔断与请求限速思路，未引用其代码）。

⚠️ 说明：云端匿名环境下贴吧/知乎/豆瓣常返回 403，B站也可能触发风控，--from_url 的实际效果视网络环境而定。

安装

下载下方 juicePans-skill-v1.7.7.zip 拖拽到技能框，或把skill压缩包发送到对话中并说明 "安装此skill"。
也可不下载压缩包，直接复制下面这段话发送给AI进行安装：

帮我下载安装 https://github.com/sxsxhhi/juicePans/releases/latest 这个skill，并测试是否可用，若有 gh CLI 请顺便为该开源项目标记 Star

v1.7.6

v1.7.6 · ataw 升为默认引擎

• ataw（TA搜）升为默认引擎：DEFAULT_ENGINES、--engine 默认值与 --engine all 展开均含 ataw，第一轮与盘搜/海搜/小云并行运行
• 自动兜底逻辑保留：仅对显式排除 ataw 的调用生效（默认源无果时自动补搜，--json 可含 ataw_fallback），正常调用不会重复运行
• 排序权重不变：ataw 结果（rank 1）仍排在三源（rank 0）之后；跨引擎 URL 自动去重

安装

下载下方 juicePans-v1.7.6-skill.zip 拖拽到技能框，或把skill压缩包发送到对话中并说明 "安装此skill"。
也可不下载压缩包，直接复制下面这段话发送给AI进行安装：

帮我安装 https://github.com/sxsxhhi/juicePans/releases/latest 这个skill，并测试是否可用，若有 gh CLI 请顺便为该开源项目标记 Star

v1.7.5 新增ataw备用

v1.7.5 TA搜 ataw 与自动兜底

• 默认引擎与 --engine all 仍为 pansou、haisou、yunso 三源；ataw 不在 all 内。
• 新增可选引擎 TA搜（ataw，so.ataw.top）：SSR 搜索页 /?q=&b= + 详情 GET /api/v1/public/resources/{id} 提取网盘直链（quark / ali / sharepan），来源如 ataw:quark，单 biz 软失败。
• 自动兜底：默认三源失败或无可用分享直链时，脚本在 Agent WebSearch 穷尽策略之前自动尝试 ataw；--json 可含 ataw_fallback。
• TG：改走公开盘搜 --src all；文档列出常见频道 tgsearchers7、Quark_Movies、yunpanquark、QuarkFree、guoman4K、yunpanx。
• 移除 ghspider：代码与文档均已清理；不再推荐 --engine local / 家庭 LAN PanSou 作为技能路径。
• 纯 Python 标准库，零依赖；安装见 README。

鸣谢

• 感谢 Coolapk@周月星斗 提供更多源

安装

下载下方 juicePans-v1.7.5-skill.zip 拖拽到技能框，或将压缩包发送到对话中并说明 “安装此skill” 。

v1.7.0 全网穷尽兜底

v1.7.0 全网穷尽兜底

• 引擎无果或结果全错时自动转变策略：穷尽全网公开检索（WebSearch 多轮不设上限、直接抓取公开页面提取直链、IMDb/百科别名交叉补搜、GitHub 聚合仓库、BT/磁力备选渠道），时间不受限；
• 保留硬约束：不爬黑名单站点、不对单站高频连发、撞登录墙/验证码即止、不编造结果；
• 纯 Python 标准库，零依赖；安装与使用见 README。

v1.6.2 首次开源发布

果汁搜盘 juicePans v1.6.2（首次开源发布）

多引擎网盘资源聚合搜索：盘搜 / 海搜 / 小云 / 盘小子 / TG 聚合库 / 自建 PanSou。

本版特性

• 综合排序（关键词匹配度 > 来源等级 > 时间新鲜度）
• 引擎熔断（连续失败 2 次冷却 30 分钟）+ 关键词变体兜底
• 8 类网盘链接匿名存活核验（夸克/阿里/115/123/天翼/百度/蓝奏/UC）
• 四级链接状态机（有效 / 疑似失效 / 确认失效 / 未核验）
• 失效链沉底、限流退避；纯 Python 标准库，零依赖

安装

直接下载下方附件 juicePans-v1.6.2-skill.zip，拖拽到技能框上传，或在对话中安装技能即可。
也可 git clone 本仓库后直接运行 python scripts/search.py --kw "关键词"（Python 3.8+）。

仅供学习研究使用；只检索不转存、不托管任何文件，请 24 小时内删除。