国家法律法规查询

要解决什么问题

合规、法务或研究场景里，法规名称往往来自旧清单、合同附件或 Excel，你需要确认是否仍有效、属于哪一类、原文链接在哪。国家数据分散在 国家法律法规数据库 与 国家规章库，检索口径和字段也不一致；手工两站切换、逐条核对，批量任务很容易漏项或把「已修改/已废止」当成现行。

技能如何工作

本技能提供统一查询入口：默认先查 flk.npc.gov.cn，未命中再 fallback 到规章库 API，结果字段尽量对齐，便于 Agent 或脚本消费。

• 检索：unified_search() 关键词搜索；unified_new_since() / new_since_to_excel() 按公布日期筛新法。
• 批量核对：unified_batch_check() 对名称列表做两库联查；batch_check_to_excel() 从 Excel 读入清单并写回带状态的 Excel，可用 progress_file 断点续查。
• 全文：batch_download_from_check() 在检查结果上批量下载；flk 侧走官方 docx/pdf 签名 URL（内部用 playwright-cli 绕过 JS 反爬），规章库侧抓取详情页 HTML 再经 pandoc 转 docx。

统一输出里常见字段包括 title、type/flxz、date/gbrq、status/sxx_text、org、source、url，便于和既有台账字段映射。

边界与注意点

• 规章库 API 依赖动态 athenaappkey（约 1 小时过期）；gov_api.py 会尝试自动刷新并验证，失败时需按文档手动刷新；若返回 0 条但应有数据，先怀疑 key 无效而非「确实没有」。
• 通知、意见、指引等规范性文件，以及部分国资委「指引/工作规则」等，两库可能都不收录，结果会标为未找到，需另寻渠道。
• 规章库侧通常只收录现行有效规章；flk 批量下载可能间歇超时，建议查询/下载间隔 0.5～1 秒，用断点文件重跑即可跳过已完成项。
• 不要自写名称匹配逻辑：批量核对应直接用 unified_batch_check()；下载组合用 batch_download_from_check()。