元典法条与案例检索。本技能应在需要查询中国法律法规条文、检索相关案例、为法律分析提供数据支撑时使用。
通过元典 API 检索中国法律法规条文和案例，支持法条语义/关键词/详情检索和案例关键词/向量语义检索共 5 种模式。
每次使用本技能前，必须先执行以下检测流程，确认 API Key 已就绪：
.env 文件：检查 scripts/.env 是否存在YD_API_KEY 的值，确认非空且不是占位符 your-api-key-here⚠️ 元典 API Key 未配置。请按以下步骤获取并配置：
1. 注册/登录：访问 https://passport.legalmind.cn/ ，使用手机号注册
2. 创建 API Key：登录后访问 https://passport.legalmind.cn/apiKey/manage ，点击「创建 Key」
3. 配置密钥：将 Key 填入以下文件
scripts/.env
─────────────
YD_API_KEY=sk-你的密钥
─────────────
API 覆盖范围：法条检索（语义/关键词/详情）+ 案例检索（关键词/向量语义），共 5 个端点，共用同一个 Key。
配置完成后重新发起检索即可。
# 检测 .env 文件和 API Key
if [ -f "scripts/.env" ]; then
KEY=$(grep '^YD_API_KEY=' scripts/.env | cut -d'=' -f2)
if [ -n "$KEY" ] && [ "$KEY" != "your-api-key-here" ]; then
echo "API Key 已就绪"
else
echo "API Key 未配置"
fi
else
echo ".env 文件不存在"
fi
用自然语言提问，找到最相关的法条。
python3 scripts/yd_search.py search "正当防卫的限度" --sxx 现行有效
用精确关键词检索法条，支持日期范围和效力级别筛选。
python3 scripts/yd_search.py keyword "人工智能 监管" \
--effect1 法律 --sxx 现行有效 \
--fbrq-start 2022-01-01 --fbrq-end 2026-03-01
按法规名称 + 条号精确获取某一条法条全文。
python3 scripts/yd_search.py detail "民法典" --ft-name "第十五条"
用关键词检索案例，支持案由、法院、省份等多维过滤。
python3 scripts/yd_search.py case "买卖合同纠纷" --province 广西 --authority-only
用自然语言描述查找相似案例。
python3 scripts/yd_search.py case-semantic "正当防卫的限度" --jarq-start 2020-01-01
| 参数 | 说明 | 可选值 |
|---|---|---|
--effect1 | 效力级别（可多次指定） | 宪法、法律、司法解释、行政法规、部门规章、地方性法规 等 |
--sxx | 时效性（可多次指定） | 现行有效、失效、已被修改、部分失效、尚未生效 |
| 参数 | 说明 |
|---|---|
--authority-only | 仅检索权威/典型案例 |
--province | 省份筛选 |
--jarq-start / --jarq-end | 结案日期范围 |
完整参数说明见 references/api-spec.md。
脚本输出 Markdown 格式，包含法条全文、法规名称、发布机关、时效性等元信息，以及原文链接。可直接用于法律文书引用或 AI 分析。
使用 raw 子命令查看原始 JSON 响应：
python3 scripts/yd_search.py raw /search "正当防卫" --extra '{"sxx":["现行有效"]}'