规范标准查询返回下载链接（Standard Doc Finder）
> 目录中文名：规范标准查询返回下载链接/
> 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}} \n\n**下载链接**：{{output7}} {{output9}}\n\n{{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"，按顺序执行：
- 调用
WebSearch，查询模板：
-"{用户输入}" PDF 下载 filetype:pdf
-"{用户输入}" 标准 下载 site:mohurd.gov.cn OR site:std.samr.gov.cn - 从搜索结果中筛选可访问的 PDF 直链（避开付费/广告页）
- 用同款 Markdown 模板输出，但
netdisk_url段改为：
**网盘下载**：本地未收录，已通过联网搜索补充
**在线下载**：<抓到的 PDF 直链>
- 若联网仍未找到可信链接，给出标准失败提示：
> 未找到"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在用户复制链接后需提示一并输入 - 始终同时给出网盘+官方两个渠道，避免单一来源失效
