规范标准查询返回下载链接

概述

目录中文名：规范标准查询返回下载链接/

WorkBuddy 内部 ID：standard-doc-finder（受 WorkBuddy 命名规范硬性限制，必须小写连字符）

用户在对话中说"规范标准查询返回下载链接"或"按标准号/名称找下载链接"均会触发本技能。

Overview

本技能实现 Workflow-guifanchaxun-draft-2820 的完整语义：用户输入标准号（含/不含年份）或名称关键字 → 先查本地规范数据库（精确→标准号→无年份标准号自助推断→名称模糊）→ 本地网盘链接为占位值/缺失时，调用盘搜VIP（https://panso.vip/）补充真实网盘链接 → 未命中则 WebSearch 联网兜底 → 输出一份排版好的"标准名 + 网盘链接 + 官方下载链接"清单。

When to Use

• 用户给出 规范标准号（如 GB 50068-2018、GB50292、JGJ 125-2016）想拿下载链接
• 用户给出 标准名称关键字（如"民用建筑可靠性鉴定标准"、"混凝土加固"、"抗规"）想找网盘资源
• 用户希望一次拿到 网盘链接 + 官方下载链接 两种渠道
• 命中/未命中都要给出明确反馈

Workflow Decision Tree

按原工作流 100001 → 149277 → 163054 → 选择器 → 106406 → 选择器_1 → 156967 → 900001 的回退顺序实现，并扩展了无年份标准号自助年号推断节点：

用户输入
  │
  ▼
[Step 1] 规范化关键字
  │   去全/半角空格、统一破折号、判断是否为标准号格式（含/不含年份）
  │
  ▼
[Step 2] 本地检索（≈ search_standard + getStandardByName 节点）
  │   调用 scripts/lookup.py 四级回退：
  │     a) 标准号全等         → mode: "exact"
  │     b) 标准号去横线/年份   → mode: "standard_no"
  │     c) 无年份标准号前缀   → mode: "year_inferred"  (新增)
  │        例: "GB 50292" → "GB 50292-2015"
  │        多版本时按年份倒序展示,默认取最新
  │     d) 名称+别名模糊       → mode: "fuzzy"
  │
  ├── 命中 ──→ [Step 3a] 整理网盘+官方双链接
  │              │
  │              └─→ [Step 3a-2] 盘搜VIP补充真实网盘链接（scripts/panso_search.py）
  │                   本地 netdisk_url 为占位值/缺失时执行；生成盘搜VIP搜索链接，
  │                   尽最大努力尝试 API；真实链接需浏览器打开搜索页获取。
  │              │
  │              └─→ 输出（结束）
  │
  └── 未命中 ──→ [Step 3b] 联网搜索兜底
                │  调用 WebSearch: "<关键字> PDF 下载 site:gov.cn OR site:mohurd.gov.cn"
                │  解析结果中的可访问 PDF 链接
                ▼
                [Step 3c] 整理输出（结束）

Step 1 — 规范化输入

将用户原文中的全角符号、空格差异、破折号统一为半角，再判定其是否形如标准号。这一步直接交给 scripts/lookup.py 的 normalize() 完成。

示例：

• "GB　50068-2018"（全角空格）→ "GB 50068-2018"
• "GB50068—2018"（长破折号）→ "GB 50068-2018"
• "民用建筑可靠性鉴定" → 保留

Step 2 — 本地检索

直接执行 scripts/lookup.py "<用户输入>" 即可。脚本返回 JSON：

精确/标准号/名称命中：

{
  "query": "民用建筑可靠性鉴定",
  "mode": "fuzzy",
  "matched_count": 1,
  "results": [{
    "standard_no": "GB 50292-2015",
    "standard_name": "民用建筑可靠性鉴定标准",
    "netdisk_url": "https://pan.baidu.com/s/...",
    "netdisk_code": "rel2",
    "official_url": "http://www.mohurd.gov.cn/...",
    "category": "国家标准-鉴定",
    "issued_date": "2015-12-03"
  }]
}

无年份标准号自助年号推断（关键能力）：

{
  "query": "GB 50292",
  "mode": "year_inferred",
  "matched_count": 1,
  "results": [{
    "standard_no": "GB 50292-2015",
    "standard_name": "民用建筑可靠性鉴定标准",
    ...
  }],
  "inferred_from": "GB 50292 → GB 50292-2015",
  "hint": "已根据标准号前缀 GB 50292 自动匹配到最新版本 GB 50292-2015。"
}

执行命令（用 managed Python；脚本路径以本技能实际安装目录为准）：

"C:/Users/47577/.workbuddy/binaries/python/versions/3.13.12/python.exe" 
  "<技能安装目录>/scripts/lookup.py" 
  "<用户输入>"

实际安装目录示例：C:/Users/47577/.workbuddy/skills/standard-file-finder__skillhub/

（SkillHub 安装时会加 __skillhub 后缀，与本技能的中文显示名 规范标准查询返回下载链接 不同，勿硬编码中文目录名。）

Windows 下若需读取脚本输出，建议重定向到文件再用 Read 读取，避免终端编码把中文显示为乱码。

Step 2.5 — 无年份标准号推断的"取最新"逻辑

scripts/lookup.py 内部处理：

• 提取标准号前缀（如 GB 50292 → GB50292）
• 扫描数据库，找出所有以该前缀开头的标准号
• 按年份倒序排序，默认取最新版本
• 单版本：返回 mode: "year_inferred"，附 inferred_from 字段说明推断过程
• 多版本：返回 mode: "year_inferred_multi"，全部展示，最新置顶，并在 hint 提示"如需其他版本请明确指定完整标准号"

Step 3a — 命中：整理双链接输出

按以下 Markdown 模板渲染（对齐原工作流 End 节点的 **规范标准名**：{{output8}} nn**下载链接**：{{output7}} {{output9}}nn{{output10}} 结构）：

**规范标准名**：{standard_name}（{standard_no}）

**网盘下载**：[{netdisk_url}]({netdisk_url})　提取码：`{netdisk_code}`

**盘搜VIP**：[{standard_no} 网盘资源搜索](https://panso.vip/search?q={urlencoded_standard_no})

**官方下载**：[{standard_no} 标准文本]({official_url})

— 分类：{category}　发布日期：{issued_date}

多条命中时（mode=fuzzy 且 matched_count > 1），用同样模板逐条列出，并按相似度从高到低排序。

如果 mode 是 year_inferred 或 year_inferred_multi，在输出顶部加一行小字说明推断来源：

> 💡 您输入的"GB 50292"未带年份，已自动匹配到最新版"GB 50292-2015"。

Step 3a-2 — 盘搜VIP补充真实网盘链接（关键新增能力）

本地数据库的 netdisk_url 可能仍是占位示例值（形如 https://pan.baidu.com/s/1gb50292-2015-rel，非真实链接）。此时调用 scripts/panso_search.py 从盘搜VIP（https://panso.vip/）补充真实网盘链接：

"C:/Users/47577/.workbuddy/binaries/python/versions/3.13.12/python.exe" 
  "<技能安装目录>/scripts/panso_search.py" 
  --json '{"standard_no":"GB 50292-2015","standard_name":"民用建筑可靠性鉴定标准"}'

脚本返回 JSON，含：

• search_urls：可直接在浏览器打开的盘搜VIP搜索链接（标准号 + 名称多条候选）
• api：尽最大努力的一次 API 尝试结果（/v1/search/disk）

执行要点与诚实边界：

1. 盘搜VIP 搜索接口有反爬：依赖浏览器设备指纹 + 滑块/拼图验证码（/v1/captcha/gen → check → exchange_ticket 换取 search_ticket）。纯脚本无法自动通过验证码，直接调接口通常返回 403 / {"code":412,"系统过载"}。
2. 因此真实网盘链接需在浏览器打开 search_urls 后获取。两种落地方式：
   • 直接把 search_urls 链接交给用户，用户点开、过滑块验证、复制网盘链接；
   • 用 WorkBuddy 浏览器自动化（agent-browser）打开搜索页，配合用户完成验证码后抓取结果列表里的网盘链接/提取码。
3. 抓到的真实链接格式示例：https://pan.baidu.com/s/1xxxx?pwd=yyyy、https://pan.quark.cn/s/xxxx、https://www.aliyundrive.com/s/xxxx 等，按 link-7SQSv8gS.js 中的规则可识别网盘类型。
4. 拿到真实链接后，应回写 references/standards-db.json 对应条目的 netdisk_url / netdisk_code，把占位值替换为真实值（长期沉淀）。

Step 3b/3c — 未命中：联网兜底

如果 mode == "none"，按顺序执行：

1. 调用 WebSearch，查询模板：
   • "{用户输入}" PDF 下载 filetype:pdf
   • "{用户输入}" 标准 下载 site:mohurd.gov.cn OR site:std.samr.gov.cn
2. 从搜索结果中筛选可访问的 PDF 直链（避开付费/广告页）
3. 用同款 Markdown 模板输出，但 netdisk_url 段改为：

**网盘下载**：本地未收录，已通过联网搜索补充
**在线下载**：<抓到的 PDF 直链>

1. 若联网仍未找到可信链接，给出标准失败提示：

未找到"XXX"对应的规范标准文档。请核实输入是否为规范标准名称/编号；如确认无误，可能是该标准尚未收录到本知识库中。可前往住房和城乡建设部官网（mohurd.gov.cn）或全国标准信息公共服务平台（std.samr.gov.cn）手动检索。

Resources

scripts/

• lookup.py — 标准号/名称关键字的四级匹配脚本，对应原工作流 search_standard + getStandardByName 两个插件节点的本地实现，并扩展了无年份标准号的自助年号推断能力。可被 WorkBuddy 直接通过 execute_command 调用，也可被未来其他 skill 复用。
• panso_search.py — 盘搜VIP（https://panso.vip/）网盘链接补充脚本。输入标准号/名称，生成可直接在浏览器打开的盘搜VIP搜索链接，并尽最大努力尝试一次 /v1/search/disk 接口（失败时优雅降级）。因盘搜VIP有滑块验证码+设备指纹反爬，真实链接需浏览器配合人工/浏览器自动化获取。

references/

• standards-db.json — 本地规范标准数据库（key 为标准号）。覆盖国标 GB / 行标 JGJ / 推荐性国标 GB/T 等常见工程类标准。
  • 字段：standard_name / aliases / netdisk_url / netdisk_code / official_url / category / issued_date
  • 扩展方式：按现有结构直接追加新条目即可，无需改脚本

Maintenance

• 新增标准：编辑 references/standards-db.json，按现有 schema 追加一条记录
• 调整匹配阈值：修改 scripts/lookup.py 中的 FUZZY_THRESHOLD（默认 0.55）
• 新增前缀支持：往 STANDARD_PREFIXES 集合里加（如 "T/CECS"、"DB"）

Quality Notes

• ⚠️ netdisk_url 目前为占位示例值（形如 https://pan.baidu.com/s/1gb50292-2015-rel，不是真实可访问的分享链接）。向用户输出前必须核实：若为占位值，先走 Step 3a-2 用盘搜VIP补充；补不到就如实说明"网盘链接待补充"，不得把占位链接当作真实链接交付。
• ⚠️ 盘搜VIP 无法全自动抓取：有滑块验证码 + 设备指纹反爬，脚本只能生成搜索链接，真实链接需浏览器（人工或 agent-browser 配合）获取。不要向用户承诺"自动抓取盘搜VIP链接"。
• ⚠️ official_url 需定期核验。住建部官网已改版，旧格式 www.mohurd.gov.cn/gongkai/zhengce/zhengcefilelib/YYYYMM/YYYYMMDD_<id>.html 多数已 404，新格式为 https://www.mohurd.gov.cn/gongkai/zc/wjk/art/<年>/art_17339_<id>.html。输出前用 WebFetch 抽查；404 时用 WebSearch 找现行公告页替换入库。
• 本地数据库覆盖常见工程国标/行标；冷门标准、英文 ISO、地方标准需走联网兜底
• 提取码 netdisk_code 在用户复制链接后需提示一并输入
• 始终同时给出网盘+官方两个渠道，避免单一来源失效