{"id":"413297e3-c39a-448d-b864-2b6f068a37b0","entityType":"agent","slug":"clawhub-j-levee-global-biblio-base","name":"global-biblio-base","canonicalUrl":"https://www.xpersona.co/agent/clawhub-j-levee-global-biblio-base","canonicalPath":"/agent/clawhub-j-levee-global-biblio-base","generatedAt":"2026-10-10T03:00:58.033Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T23:30:13.017Z","emptyReason":null},"description":"全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。 能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。 触发：用户表达\"查论文\"\"找文献\"\"检索学术\"\"搜期刊\"\"查专利\"\"找标准\"\"下论文\"\"写文献综述\"\"找参考文献\"\"查 SCI/EI\"等意图时启用；也适用\"帮我找关于 XX 的论文\"\"写文献综述\"\"找几篇引用支撑论点\"。英文：\"find papers\" \"search literature\" \"write literature review\" \"find supporting citations\"。 调用前必须先用 /consume 获取 consume_token，再凭 token 调 /search（每次计费接口调用都需一次 /consume）。 Skill: global-biblio-base Owner: j-levee Summary: 全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。 能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s179kz7zy88fw5x9nrsb2mh68x86jwtk:global-biblio-base","sourceUrl":"https://clawhub.ai/j-levee/global-biblio-base","homepage":"https://clawhub.ai/j-levee/skills/global-biblio-base","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/j-levee/global-biblio-base","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/j-levee/skills/global-biblio-base","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":66,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。 "},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:30:13.017Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:30:13.017Z","emptyReason":null},"stars":null,"forks":null,"downloads":1888,"packageName":null,"latestVersion":"3.10.2","tractionLabel":"1.9K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:30:13.016Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T23:30:13.017Z","lastCrawledAt":"2026-10-09T23:30:13.016Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T23:30:13.016Z","lastVerifiedAt":null,"highlights":[{"version":"3.10.2","createdAt":"2026-08-30T03:27:21.064Z","changelog":"v3.10.2: 安全整改——通知引用展示；付款页移除远程脚本与自动轮询；下单披露邮箱用途","fileCount":9,"zipByteSize":39925},{"version":"3.10.1","createdAt":"2026-08-30T00:30:03.646Z","changelog":"v3.10.1: 付款页规范化（新增标准付款页样例）；修正付款码有效期 30 分钟；文档清理与精简；移除内部版本号","fileCount":9,"zipByteSize":39957},{"version":"3.10.0","createdAt":"2026-08-29T14:56:34.261Z","changelog":"v3.10.0: 对话内支付引导切换为支付宝（老用户微信路径保留，网关双通道）","fileCount":8,"zipByteSize":39191},{"version":"3.9.7","createdAt":"2026-08-27T16:05:44.253Z","changelog":"配置文件结构优化：恢复并保留邮箱字段（默认空值），确保首次使用初始化更稳定","fileCount":8,"zipByteSize":39362},{"version":"3.9.6","createdAt":"2026-08-27T15:26:46.938Z","changelog":"配置净化：移除配置文件中的个人邮箱与非必要冗余字段，隐私更清爽","fileCount":8,"zipByteSize":39141},{"version":"3.9.5","createdAt":"2026-08-27T14:25:20.692Z","changelog":"支付失败时不再给出无法支付的订单号，改为清晰的重试指引；修复了部分情况下支付必报金额错误的隐患","fileCount":8,"zipByteSize":39160},{"version":"3.9.4","createdAt":"2026-08-07T08:33:46.689Z","changelog":"description精简至<=1024字符(修复Claude/豆包上传zip报description超限);新增AI执行摘要层;功能与计费逻辑不变","fileCount":8,"zipByteSize":37707},{"version":"3.9.3","createdAt":"2026-07-22T09:55:23.687Z","changelog":"v3.9.3：FAQ 新增 3 条实战提示（consume_token 仅单次且约 60s 过期；Windows curl 中文名 PDF 失败改 urllib；中文关键词命中低→中英双检/上位词/字段渐进）；新增「检索召回优化提示」小节","fileCount":8,"zipByteSize":37892}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s179kz7zy88fw5x9nrsb2mh68x86jwtk:global-biblio-base","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T03:00:58.029Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-j-levee-global-biblio-base/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T23:30:13.017Z","emptyReason":null},"readme":"Skill: global-biblio-base\n\nOwner: j-levee\n\nSummary: 全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。 能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。 触发：用户表达\"查论文\"\"找文献\"\"检索学术\"\"搜期刊\"\"查专利\"\"找标准\"\"下论文\"\"写文献综述\"\"找参考文献\"\"查 SCI/EI\"等意图时启用；也适用\"帮我找关于 XX 的论文\"\"写文献综述\"\"找几篇引用支撑论点\"。英文：\"find papers\" \"search literature\" \"write literature review\" \"find supporting citations\"。 调用前必须先用 /consume 获取 consume_token，再凭 token 调 /search（每次计费接口调用都需一次 /consume）。\n\nTags: latest:3.10.2\n\nVersion history:\n\nv3.10.2 | 2026-08-30T03:27:21.064Z | user\n\nv3.10.2: 安全整改——通知引用展示；付款页移除远程脚本与自动轮询；下单披露邮箱用途\n\nv3.10.1 | 2026-08-30T00:30:03.646Z | user\n\nv3.10.1: 付款页规范化（新增标准付款页样例）；修正付款码有效期 30 分钟；文档清理与精简；移除内部版本号\n\nv3.10.0 | 2026-08-29T14:56:34.261Z | user\n\nv3.10.0: 对话内支付引导切换为支付宝（老用户微信路径保留，网关双通道）\n\nv3.9.7 | 2026-08-27T16:05:44.253Z | user\n\n配置文件结构优化：恢复并保留邮箱字段（默认空值），确保首次使用初始化更稳定\n\nv3.9.6 | 2026-08-27T15:26:46.938Z | user\n\n配置净化：移除配置文件中的个人邮箱与非必要冗余字段，隐私更清爽\n\nv3.9.5 | 2026-08-27T14:25:20.692Z | user\n\n支付失败时不再给出无法支付的订单号，改为清晰的重试指引；修复了部分情况下支付必报金额错误的隐患\n\nv3.9.4 | 2026-08-07T08:33:46.689Z | user\n\ndescription精简至<=1024字符(修复Claude/豆包上传zip报description超限);新增AI执行摘要层;功能与计费逻辑不变\n\nv3.9.3 | 2026-07-22T09:55:23.687Z | user\n\nv3.9.3：FAQ 新增 3 条实战提示（consume_token 仅单次且约 60s 过期；Windows curl 中文名 PDF 失败改 urllib；中文关键词命中低→中英双检/上位词/字段渐进）；新增「检索召回优化提示」小节\n\nv3.9.2 | 2026-07-22T02:21:54.963Z | auto\n\n- Updated description to clarify paid package information and how to trigger package selection when quota is low.\n- Description now points users to the new in-doc \"💰 套餐与额度\"/\"💰 Plans & Quota\" section for plan details, instead of a separate file.\n- Instructions under quota warnings and handling now prompt users about plan/package options and how to request upgrades within the chat.\n- Removed the file skill-card.md.\n\nv3.9.1 | 2026-07-21T12:34:55.048Z | auto\n\nglobal-biblio-base 3.9.1\n\n- Added: references/account.md with details of new paid plans and upgrade options.\n- Removed: Deprecated skill-card.md file.\n- Updated: Description and documentation to announce paid plans (体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包) are now open, with price and quota info referenced in account.md.\n- Improved: Quota warnings and upgrade prompts now suggest the user say \"我要升级\" to view available packages.\n- Minor: API quota fields expanded (including download quota keys) and relevant documentation updated.\n\nv3.8.1 | 2026-07-19T12:31:37.813Z | auto\n\n- Removed metadata and skill card files (_meta.json, skill-card.md) to simplify skill structure.\n- Updated config.json and config.example.json; check for changes in configuration or environment setup.\n- No change to core functionality or user-facing features.\n\nv3.8.0 | 2026-07-16T10:15:25.576Z | auto\n\n- Updated to free trial model: all users now receive 100 searches + 10 full-text downloads per month automatically; paid plans are temporarily paused.\n- Removed recharge/payment functionality and related UI; when quota runs out, users are prompted to contact support for higher access.\n- Adjusted prompts and quota warnings to reflect trial mode and contact information.\n- Updated documentation and configuration samples to match the new trial-only usage restrictions.\n- Removed the separate skill-card.md file (no longer needed).\n\nv3.6.2 | 2026-07-15T08:13:43.045Z | auto\n\n- Added _meta.json file for enhanced metadata support.\n- Updated SKILL.md with version bump to 3.6.2; no major content changes identified.\n- Removed obsolete skill-card.md file.\n\nv3.6.1 | 2026-06-30T06:21:34.798Z | user\n\n修复安装后 config.json 含个人邮箱问题；现发布时自动净化（保留 Gateway 凭据，清空 EMAIL）\n\nv3.6.0 | 2026-06-22T03:42:31.966Z | user\n\nv3.6: Automated publish from gateway deployment\n\nv3.5.0 | 2026-06-22T03:25:25.442Z | user\n\nv3.5: Automated publish from gateway deployment\n\nv3.4.0 | 2026-06-18T06:48:47.388Z | user\n\nv3.4.0: 统一slug为global-biblio-base，与SkillHub对齐。覆盖12.28亿全球文献元数据+8000万中文期刊全文可下载。三级检索策略，全程AI对话驱动。\n\nArchive index:\n\nArchive v3.10.2: 9 files, 39925 bytes\n\nFiles: config.example.json (139b), config.json (204b), PIPELINE.md (12131b), README.md (3140b), references/account.md (5654b), references/pay_page_template.html (9314b), skill-card.md (3028b), SKILL.md (61063b), _meta.json (138b)\n\nFile v3.10.2:SKILL.md\n\n---\r\nslug: global-biblio-base\r\nname: global-biblio-base\r\ndisplayName: 全球12亿文献知识库（8千万中文期刊可下载）\r\nversion: 3.10.2\r\ndescription: |\r\n  全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。\r\n\r\n  能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。\r\n\r\n  配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。\r\n\r\n  触发：用户表达\"查论文\"\"找文献\"\"检索学术\"\"搜期刊\"\"查专利\"\"找标准\"\"下论文\"\"写文献综述\"\"找参考文献\"\"查 SCI/EI\"等意图时启用；也适用\"帮我找关于 XX 的论文\"\"写文献综述\"\"找几篇引用支撑论点\"。英文：\"find papers\" \"search literature\" \"write literature review\" \"find supporting citations\"。\r\n\r\n  调用前必须先用 /consume 获取 consume_token，再凭 token 调 /search（每次计费接口调用都需一次 /consume）。\r\nagent_created: true\r\n---\r\n\r\n## 🤖 AI 执行摘要（先读这段）\r\n\r\n- **何时触发**：用户要查 / 找 / 下载中外文学术文献（论文、期刊、专利、标准、学位论文），或要写文献综述、找引用支撑、做课题查新。\r\n- **不触发（转其他技能）**：引用核查 / \"这篇是真的吗\" → `smartlib-citation-checker`；论文写作辅助、非文献类查询。\r\n- **两个前置硬规则**：① 动手前必须先向用户索取邮箱（禁止用 config 预填邮箱、禁止臆造邮箱）；② 每次计费接口调用前先 `/consume` 取 `consume_token`，再带 token 调 `/search`（token 单次使用、约 60s 有效，过期/已用需重新 `/consume`）。\r\n- **输入**：用户自然语言检索意图 + 邮箱。\r\n- **产出**：检索结果列表（含核心收录标注、原始数据库来源链接）、文献详情、PDF 下载链接（中文期刊直下 / 外文 OA 多渠道探测）。\r\n- **配额模型**：免费 100 次检索 + 10 次下载 / 月；耗尽时 Gateway 返回 429，技能自动弹出套餐卡片（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），用户也可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。\r\n- **红线**：不改功能；不臆造邮箱；不在对话中泄露 `SMARTLIB_GATEWAY_SECRET`；付费墙内外文文献无法获取全文。\r\n- **凭证来源**：`config.json` → `SMARTLIB_GATEWAY_URL` / `SMARTLIB_GATEWAY_SECRET`（SMARTLIB_EMAIL 运行后由注册写入，勿预填）。\r\n\r\n# 全球12亿文献知识库（8千万中文期刊可下载）\r\n\r\n\r\n通过 SmartLib 开放平台 API 提供中外文学术文献检索能力。\r\n\r\n\r\n---\r\n\r\n## ⚡ 启动前必须执行/ Pre-flight Checklist\r\n\r\n### Step A：凭证自动检测 & 注册/ Auto Credential Check & Registration\r\n\r\n> ## ⚠️ 强制规则 — 必须先询问邮箱\r\n> 1. **执行任何操作前，必须先询问用户邮箱地址**\r\n> 2. 禁止使用 config.json 中预填的邮箱（即使存在且非 null）\r\n> 3. 禁止自动生成邮箱（如 `user@example.com`、`auto@xxx.com` 等）\r\n> 4. 用户未提供邮箱 → 停止执行，回复：\r\n>    \"请提供您的邮箱地址以注册 SmartLib 文献检索服务（新用户免费 100 次/月）\"\r\n> 5. 只有用户明确输入邮箱后，才能调用 /register 或 /quota\r\n>\r\n> ## 邮箱识别自动化\r\n> 当用户消息中出现以下模式时，自动提取邮箱 → 无需再次询问：\r\n> - 明确的邮箱地址（包含 @ 符号的完整地址，如 `xxx@xxx.xxx`）\r\n> - \"我的邮箱是 xxx\" / \"email: xxx\" / \"用 xxx 注册\" / \"邮箱 xxx\"\r\n\r\n每次执行本技能时，按以下流程处理凭证（从 config.json 读取）：\r\n\r\n```\r\n读取技能目录下的 config.json\r\n检查 SMARTLIB_EMAIL 是否已配置\r\n  ├── 已配置 → 进入 Step B (配额检查)\r\n  │\r\n  └── 未配置 → 自动注册流程:\r\n        ├── ① 展示检索计划 + 询问邮箱（一句话）:\r\n        │      \"📋 我将用中英文关键词检索... 首次使用需绑定邮箱（免费 100 次/月，仅用于配额管理），请输入邮箱即可开始:\"\r\n        │      用户输入 → 写入 config.json\r\n        │\r\n        ├── ② 调智能网关注册（无需验证码，极速注册）:\r\n        │     POST {SMARTLIB_GATEWAY_URL}/register\r\n        │     Headers: {\"Authorization\": \"Bearer {SMARTLIB_GATEWAY_SECRET}\"}\r\n        │     Body: {\"email\": \"{用户邮箱}\"}\r\n        │\r\n        ├── 成功 (201/200) → Gateway 返回配额信息\r\n        │     提示: \"✅ 注册成功！本月免费 100 次，可立即使用。确认邮件已发送（邮箱验证仅充值时需要，现在不验证也能用）。\"\r\n        │     追加引导: \"请告诉我您想检索什么主题，现在就可以开始——\"\r\n        │     → 继续 Step B 配额检查 → 检索\r\n        │\r\n        └── 失败 → 提示原因 (服务暂不可用 / 网络错误等) → 终止\r\n```\r\n\r\n> **注意**：注册无需验证码，极速完成。**注册后即可立即使用全部功能**，确认邮件为可选项（仅充值时需验证邮箱；验证码 15 分钟内有效，过期可重发）。\r\n> \r\n\r\n### Step B：配额检查/ Quota Check\r\n\r\n```\r\n凭证就绪后, 调网关查询配额:\r\n  GET <SMARTLIB_GATEWAY_URL>/quota?email=<SMARTLIB_EMAIL>\r\n  Headers: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\n\r\n  返回字段: total_remain, email_verified, plan, download_quota_free, download_reset_at, download_paid_remain, download_remain\r\n  （完整返回: user_id, email, plan, trial_total, trial_used, trial_remain, paid_total, paid_used, paid_remain, paid_expires_at, total_remain, email_verified, download_quota_free, download_reset_at, download_paid_remain, download_remain）\r\n  \r\n  如果返回 404 \"not_registered\" → 用户可能已被重置/删除\r\n    → 提示: \"检测到您的账户需要重新绑定，正在自动重新注册...\"\r\n    → 跳回 Step A ②（调 /register 重新注册，使用同一邮箱）\r\n    → 注册成功后继续配额检查\r\n  \r\n  total_remain > 20 → 静默进入检索\r\n  total_remain 5-20 → 尾部轻提示: \"📊 本月剩余 {n} 次\"\r\n  total_remain 1-5  → 警告: \"⚠️ 接近用尽（剩余 {n} 次），已为你列出可用套餐（见下方💰章节），需要更高额度随时说「升级」\"\r\n  total_remain 0    → 配额耗尽处理（见配额耗尽章节）\r\n\r\n  额外检查:\r\n```\r\n\r\n### Step C：按接口调用次数消耗配额/ Per-API-Call Quota Consumption\r\n\r\n本技能的配额按**实际 API 接口调用次数**计费，不是按对话会话计费。\r\n\r\n共涉及 **5 个接口**（分3类），每次调用其中任意一个接口计 **1 次**配额。\r\n\r\n> Quota is consumed **per API call**, not per conversation session. **5 interfaces** in 3 categories, each call = 1 quota.\r\n\r\n**计费接口清单（5个）/ Billable Interfaces (5 total):**\r\n\r\n| 类别 | 接口 | API 端点 | 计费 |\r\n|------|------|---------|------|\r\n| **检索** | 中文期刊检索 | API 1 `Articlesearch` | 每次调用 **1 次** |\r\n| **检索** | 全球文献检索 | API 4 `Articlesearch` | 每次调用 **1 次** |\r\n| **详情** | 中文期刊详情 | API 1/5 `Articledetail` | 每次调用 **1 次** |\r\n| **详情** | 全球文献详情 | API 4/5 `Articledetail` | 每次调用 **1 次** |\r\n| **下载** | 中文期刊全文下载 | API 3 `GetArticleFile` | 每次调用 **1 次** |\r\n\r\n> 注：全球文献（API 4）无全文下载接口，仅返回元数据。\r\n\r\n**计次示例**\r\n\r\n```\r\n示例1：用户请求\"查10篇工业母机论文，下载5篇中文PDF\"\r\n  → 检索接口：中文1次 + 英文1次         = 2 次\r\n  → 详情接口：查5篇详情                   = 5 次\r\n  → 下载接口：下载5篇PDF                  = 5 次\r\n  → 合计消耗: 12 次配额\r\n```\r\n\r\n```\r\n示例2：用户请求\"帮我看看这篇论文的详情\"（1篇）\r\n  → 详情接口：1次                         = 1 次\r\n  → 合计消耗: 1 次配额\r\n```\r\n\r\n```\r\n示例3：用户仅请求\"检索人工智能论文\"（不查看详情、不下载）\r\n  → 检索接口：1次（或2次，若中英文并行） = 1-2 次\r\n  → 合计消耗: 1-2 次配额\r\n```\r\n\r\n**扣减方式**\r\n\r\n**⚠️ 强制执行规则：每次调用计费接口前，必须先调 `/consume` 获取 token，再用 token 调 `/search`。**\r\n\r\n每次调用计费接口的流程：\r\n\r\n```\r\n① POST <SMARTLIB_GATEWAY_URL>/consume\r\n   Headers: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\n   Body: {\"email\": \"<SMARTLIB_EMAIL>\", \"skill_source\": \"global-biblio-base\"}\r\n\r\n   返回 200 → 获取 consume_token，继续\r\n   返回 429 → 配额已用完，终止后续调用，按 §配额耗尽处理 自动弹出套餐选择\r\n\r\n② POST <SMARTLIB_GATEWAY_URL>/search\r\n   Headers: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\n   Body: {\r\n       \"email\": \"<SMARTLIB_EMAIL>\",\r\n       \"consume_token\": \"<上一步返回的token>\",\r\n       \"skill_source\": \"global-biblio-base\",\r\n       \"api_path\": \"/openapi/t/data0012/doccenter/Articlesearch\",\r\n       \"api_body\": {<检索请求体>}\r\n   }\r\n\r\n   返回 200 → 检索成功\r\n   返回 401 → token 无效/过期/已用，需重新 /consume\r\n```\r\n\r\n> **MANDATORY**: Call `/consume` → `/search` for **EACH** billable API call. Token is single-use, expires in 60s. If 401 on /search, re-consume.\r\n\r\n**🛡️ Token 绑定调用链**\r\n\r\n> **强制安全机制 — 不可绕过：**\r\n> 每次调用计费接口前，必须通过 `/consume` 获取 `consume_token`，然后将 token 传给 `/search` 代理端点。\r\n> Gateway 验证 token 签名 + 有效期 + 防重放后才转发检索请求。\r\n> Token 由 GATEWAY_SECRET 签名，AI 无法伪造。无有效 token 则 /search 直接 401。\r\n>\r\n> **调用流程**\r\n> ```\r\n> 1. POST /consume {\"email\":\"...\", \"skill_source\":\"global-biblio-base\"} → 返回 consume_token\r\n> 2. POST /search {\"email\":\"...\", \"consume_token\":\"...\", \"skill_source\":\"global-biblio-base\", \"endpoint\":\"/search/cn\", \"rule\":\"...\"}\r\n>    → Gateway 验证 token → 代理转发到检索 API → 返回检索结果\r\n> ```\r\n>\r\n> **注意**：每个 consume_token 只能使用一次（防重放），有效期 60 秒。每次检索 API 调用前都需要先 /consume 获取新 token。\r\n\r\n**🆕 仅成功调用消耗配额**\r\n\r\n> `/consume` 仅验证配额可用性 + 签发 token，**不预扣配额**。配额在实际调用 SmartLib API 且返回成功后，由 Gateway 自动扣除。\r\n> **失败的 API 调用不消耗配额**（如参数错误导致 400、网络错误导致 500 等）。\r\n> `/consume` 返回的 `total_remain, email_verified, plan` 反映的是当前已成功调用的次数，非预扣后的值。\r\n\r\n**不计费的操作**\r\n\r\n| 操作| 说明|\r\n|------|------|\r\n| /consume 配额消费 | Gateway 验证，不计费 |\r\n| 联网关键词扩展 | Web search，不计费 |\r\n| 结果排序/格式化展示 | 本地处理，不计费 |\r\n| 多级 OA PDF 探测 | 外部免费 API（ArXiv/Unpaywall/CORE/OpenAlex等），**不消耗 SmartLib 配额** |\r\n| 原始来源链接展示 | Source 字段随详情接口返回，不计额外费用 |\r\n\r\n\r\n---\r\n\r\n## 💰 套餐与额度/ Plans & Quota\r\n\r\n- 计费与升级由 SmartLib **统一钱包**管理，所有文献检索技能**统一定价、配额共享**。\r\n- **配额不足时自动弹套餐**：检索或下载配额接近用尽 / 已耗尽时，技能直接在对话中弹出下方套餐选择卡片，无需用户说任何口令；用户也可主动说「升级 / 充值 / 购买 / 我要升级」唤起同一卡片。\r\n- 企业 / 机构定制（API 接入、私有化部署）请联系 vipsmart@vipslib.com。\r\n\r\n### 当前套餐\r\n\r\n| 套餐 | plan key | 价格 | 检索次数 | 下载次数 | 有效期 | 限购 | 适用 |\r\n|------|----------|------|---------|---------|--------|------|------|\r\n| 体验卡 | `trial_card` | ¥9.9 | 1000 | 20 | 7天 | 每用户1次 | 尝鲜/临时 |\r\n| 个人版月 | `personal_month` | ¥39 | 1000 | 50 | 30天 | — | 个人常规 |\r\n| 专业版月 | `pro_month` | ¥99 | 2000 | 200 | 30天 | — | 重度/小团队 |\r\n| 单篇下载 | `single_download` | ¥2.5 | 0 | 1 | 不限 | — | 只差几篇下载 |\r\n| 下载包 | `download_pack` | ¥20 | 0 | 10 | 30天 | — | 批量下载 |\r\n| 企业/机构 | `enterprise` | 暂停 | — | — | — | — | 联系我们 |\r\n\r\n> 下载耗尽时优先推荐「单篇下载 / 下载包」；检索耗尽时优先推荐「体验卡 / 个人版月 / 专业版月」。\r\n\r\n### 支付流程（对话内完成，用户回复数字即可）\r\n\r\n```\r\n检测到配额信号（/quota 返回 quota_low / quota_exhausted，或 /consume 返回 429，或 download_remain==0）\r\n   ↓\r\n① 渲染套餐卡片（数字①②③④⑤标注，如上表），并提示\"回复数字选择，扫码即付\"\r\n   用户回复数字 → 映射 plan key（如 \"3\" → pro_month）\r\n   ↓\r\n② 创建订单（支付宝）:\r\n   下单前向用户披露：「下单需将您的注册邮箱发送至 SmartLib 支付端点，仅用于支付到账绑定与权益发放」\r\n   POST {SMARTLIB_GATEWAY_URL}/api/pay/alipay/create\r\n   Headers: 无需认证（网关仅校验邮箱已注册，不要求 Authorization；严禁在对话/前端暴露任何密钥）\r\n   Body: {\"plan\": \"<plan_key>\", \"email\": \"<已注册用户邮箱>\", \"amount\": <套餐价格，单位「元」，须与上表「价格」列完全一致>}\r\n   ⚠️ email 必须是当前已注册用户邮箱（来自注册/配额上下文），严禁使用 config 里的 SMARTLIB_EMAIL（其值为 null）。\r\n   ⚠️ amount **必填且必须精确等于上方套餐表的「价格」**（网关会校验，偏差 >0.01 元直接 400 amount_mismatch）。取值：trial_card=9.9 / personal_month=39 / pro_month=99 / single_download=2.5 / download_pack=20。严禁留空、严禁写 0、**严禁用「分」**（如 990 会被判成 ¥990 而失败）。\r\n   返回: {\"qr_code\", \"out_trade_no\", \"amount\", \"plan\", \"quota\", \"channel\":\"alipay\"}\r\n   ↓\r\n③ 生成支付宝付款码 HTML：**严格按 `references/pay_page_template.html` 标准样例输出，仅替换其中的 {{占位符}}（订单号/二维码 base64/金额/套餐/脱敏邮箱/生成时间/过期时间），不得改变页面风格与文案，不得加载远程 JS/CDN**（样式：支付宝蓝渐变头部+订单卡片+倒计时；有效期文案：**二维码 30 分钟内有效**——网关 `timeout_express=\"30m\"` 强制，勿写成 5 分钟或 2 小时；邮箱只允许脱敏显示 `p•••@domain.com`，禁止完整邮箱；二维码必须用 base64 内嵌 PNG）\r\n   ↓\r\n④ 轮询支付状态（AI 侧，付款页不做自动轮询）:\r\n   GET {SMARTLIB_GATEWAY_URL}/api/pay/alipay/status?out_trade_no=<out_trade_no>\r\n   （付款码 30 分钟有效；AI 侧每 5s 轮询一次，约 60s 内未支付则提示\"付款码仍有效，请扫码后等待到账，或回复「查状态」\"；付款页为纯静态展示，付款后引导用户回到对话由 AI 确认到账）\r\n   支付成功返回 {\"status\":\"paid\",\"out_trade_no\":...} → 对话通知\"✅ 支付成功，已到账 N 次\" + 自动重试上次中断的检索\r\n```\r\n\r\n### ⚠️ 半成功态（支付宝创单失败 / 502）处理\r\n\r\n`/api/pay/alipay/create` 在「订单创建请求已受理、但支付宝侧暂忙/异常」时会返回 **502**，响应体形如 `{\"error\":\"alipay_error\",\"message\":\"支付宝创单失败: ...\"}`——**注意：该失败响应不含 `out_trade_no`**，请勿编造或展示任何订单号。\r\n\r\n正确处理方式（务必遵守）：\r\n\r\n1. **绝不展示任何你自行推断/拼接/记忆的订单号。** 502 失败响应里没有可用单号。\r\n2. 直接告知用户支付码暂未生成，引导稍后重试：\r\n   > 支付宝支付通道暂时繁忙，订单尚未生成。请 1~2 分钟后回复「重试」，我会重新发起并生成新的付款码。此过程未产生任何扣款。\r\n3. 说明：**每次「重试」都会由网关新建一笔订单**，旧 pending 订单自动失效、无害，用户无需做任何清理。\r\n4. **不要说「复用此订单重试」**——网关不支持复用 pending 单重新发起支付，重试一定是新单。\r\n\r\n> 对比：若返回 **200** 且 body 含 `qr_code` + `out_trade_no`，才是真正下单成功，此时才渲染二维码并展示真实订单号（见上方 ③）。\r\n\r\n### 安全机制\r\n- `out_trade_no` UNIQUE 防重复充值；二维码 **30 分钟**有效（网关 `timeout_express=\"30m\"`，勿写 5 分钟/2 小时）\r\n- `/api/pay/alipay/status` 为公开端点（无需 Bearer），可直接轮询\r\n- `SMARTLIB_GATEWAY_SECRET` 仅后端调用，不在对话中输出\r\n- 生成的支付页面**禁止显示用户邮箱**\r\n\r\n---\r\n\r\n## 🔒 配额耗尽处理/ Quota Exhaustion\r\n\r\n配额耗尽后，**暂停新的检索请求**，不再展示任何部分结果，并**自动弹出套餐选择卡片**（见上方💰章节），不再要求用户说「我要升级」。\r\n\r\n| 状态 | 行为 |\r\n|------|------|\r\n| **配额充足** (>0) | 正常执行检索，完整展示所有结果（含详情查看、全文下载、智能排序） |\r\n| **配额偏低** (≤10 且无付费余额) | 尾部轻提示 + 自动弹出套餐卡片（软引导） |\r\n| **配额耗尽** (=0) | Gateway 返回 429，拒绝服务，**自动弹出套餐卡片**（硬引导）；企业 / 机构定制仍联系我们 |\r\n\r\n配额耗尽时的引导格式：\r\n\r\n```\r\n⚠️ 您的 SmartLib 配额已用尽，已为您列出可用套餐：\r\n\r\n① 体验卡 ¥9.9 — 1000 检索 + 20 下载 / 7天\r\n② 个人版月 ¥39 — 1000 检索 + 50 下载 / 30天\r\n③ 专业版月 ¥99 — 2000 检索 + 200 下载 / 30天\r\n④ 单篇下载 ¥2.5 — 1 次下载\r\n⑤ 下载包 ¥20 — 10 次下载 / 30天\r\n\r\n回复数字选择，或说「升级 / 充值」重新唤起。\r\n企业 / 机构批量定制、API 接入或私有化部署请联系：\r\n📧 vipsmart@vipslib.com  ☎️ 023-63016015  🌐 https://www.vipslib.com/\r\n```\r\n\r\n**重要规则**：\r\n- 配额耗尽后，所有检索请求一律拒绝，不展示任何结果\r\n- 不再要求用户说「我要升级」——配额信号会自动唤起套餐卡片\r\n- 企业 / 机构定制仍联系我们\r\n\r\n\r\n## 输出规范/ Output Standards\r\n\r\n**每次检索结果末尾必须展示配额状态：**\r\n\r\n```\r\n📊 本次消耗 3 次 | 剩余 82 次 (共 100 次/月)\r\n```\r\n或接近耗尽时：\r\n```\r\n⚠️ 剩余 3 次 (共 100 次/月)，已为你列出可用套餐（回复数字即可购买，或说「升级」唤起）\r\n```\r\n\r\n```\r\n```\r\n\r\n## 核心能力/ Core Capabilities\r\n\r\n| 能力| 说明|\r\n|------|------|\r\n| **中文期刊检索**| 8000万篇授权中文期刊文献，支持全文下载|\r\n| **全球文献检索**| 10亿篇中外文文献元数据（含中英文论文、专利、标准、学位论文等）/ 1B global literature metadata (papers, patents, standards, theses) |\r\n| **文献详情**| 查看摘要、DOI、基金资助、核心收录等完整信息|\r\n| **全文下载**| 授权中文期刊支持 PDF 全文下载|\r\n| **原始来源链接**| 每篇文献提供多个原始数据库详情链接（覆盖300+数据库，如Scopus/WoS/EI/PubMed等），覆盖率100%，平均4.75个/篇，可直接验证文献真实性|\r\n| **OA文献免费下载**| 十级多渠道自动探测OA文献PDF（ArXiv/Unpaywall/CORE/OpenAlex等），Gold/Hybrid/Bronze/Green OA免费获取，**不消耗SmartLib配额**|\r\n| **智能关键词扩展**| 联网检索中英文同义词/近义词，自动扩展检索词，提升召回率|\r\n| **核心期刊优先排序**| 联网查询核心收录情况（SCI/EI/北大核心/CSSCI等），优先展示高水平文献|\r\n| **相关性智能排序**| 基于题名、关键词、摘要语义分析，对检索结果进行二次相关性排序|\r\n| **少结果智能扩展**| 结果过少时自动推荐上位词、相关机构、学科分类号等多种扩展策略|\r\n\r\n## 能力边界/ Capability Boundaries\r\n\r\n### 支持的功能/ Supported\r\n\r\n- 中文期刊论文检索、详情、全文下载（8000 万篇授权文献）\r\n- 全球文献元数据检索（10 亿篇，含论文/专利/标准/学位论文等）\r\n- 关键词智能扩展、核心期刊优先排序、少结果自动扩展\r\n- 自然语言输入，无需学习检索语法\r\n\r\n### 不支持的功能/ Not Supported\r\n\r\n- **付费墙内英文文献全文下载**：通过 SmartLib API 4 查到的全球文献仅返回元数据。本技能已集成十级多渠道下载策略（ArXiv/Unpaywall/CORE/OpenAlex/Semantic Scholar/Crossref/DOI.org/Europe PMC/bioRxiv/medRxiv + CDP浏览器），可免费获取 OA 版本（Gold/Hybrid/Bronze/Green OA），**OA 下载不消耗 SmartLib 配额**。但付费墙内（closed access）文献无法获取全文\r\n- **付费墙内文献**：不提供需单独购买的文献全文\r\n- **批量导出**：不提供 EndNote/BibTeX 等格式的批量导出功能\r\n- **文献查重/查新**：不具备论文查重或科技查新功能\r\n\r\n### 使用限制/ Limitations\r\n\r\n| 限制项| 说明|\r\n|------|------|\r\n| **单次查询条数**| PageSize 20-1000，建议 ≤100 以保证速度|\r\n| **翻页上限**| 无硬限制，但建议不超过 50 页（共 1000 条）/ No hard limit, but ≤50 pages recommended |\r\n| **请求频率**| 有频率限制（未公开数值），触发 429 时自动等待重试|\r\n| **Token 有效期**| Access Token 30 秒，Refresh Token 2 小时（以下游 API 返回为准）。系统自动管理刷新|\r\n| **下载链接有效期**| 约 10 分钟（以下游返回为准），过期需重新调用下载接口|\r\n| **依赖**| 完全依赖 SmartLib API 和网络连接，离线不可用|\r\n\r\n### 触发意图区分/ Trigger Intent Differentiation\r\n\r\n| 用户表达| 系统行为| 区分逻辑|\r\n|------|------|------|\r\n| \"查论文\"、\"找文献\"、\"检索XX\" / \"Search XX papers\" | **触发本 Skill**，精准检索，默认平衡策略 | 明确的检索意图 |\r\n| \"写文献综述\"、\"帮我写综述\" / \"Write a literature review\" | **触发本 Skill**，切换为综述模式：宽检索策略、去重合并、按主题聚类 | 综述需更全的覆盖范围和聚类分析 |\r\n| \"帮我写论文开头/引言\" / \"Write paper intro, need citations\" | **触发本 Skill**，窄检索策略：找 3-5 篇最相关引用，核心期刊优先 | 写作引用需要精准而非全面 |\r\n| \"这段论述有文献支撑吗\"、\"找几篇引用\" / \"Find supporting citations\" | **触发本 Skill**，窄检索 + 核心期刊优先，提供可引用的高质量文献 | 文献支撑场景需要高可信度来源 |\r\n| \"这篇论文是真的吗\"、\"核查引用\" / \"Verify this citation\" | **不触发本 Skill**，应转至 smartlib-citation-checker | 引用核查是独立能力 |\r\n| \"帮我写论文\"、\"写作辅助\" / \"Help me write\" | **不触发本 Skill** | 论文写作不是文献检索功能 |\r\n| \"下载这篇论文的 PDF\" / \"Download this paper's PDF\" | **触发本 Skill**（若有中文期刊 ID） | 下载是检索的延伸功能 |\r\n\r\n## 数据范围/ Data Coverage\r\n\r\n平台累计汇聚各类资源元数据总量达 **12.28 亿条**。\r\n\r\n> The platform aggregates **1.228 billion** metadata records.\r\n\r\n### 核心文献类型存量规模/ Core Literature Type Inventory\r\n\r\n| 文献类型| 存量规模| 说明|\r\n|------|------|------|\r\n| **期刊文献**| **7.19 亿条**| 平台核心资源|\r\n| **专利资源**| **2.15 亿条**| 第二大品类|\r\n| **会议论文**| **7155 万条**| — |\r\n| **学位论文**| **2473 万条**| — |\r\n| **标准资源**| **268 万条**| — |\r\n\r\n### 可检索数据集/ Searchable via API\r\n\r\n- **中文期刊数据集**：8000 万篇授权中文期刊文献，支持全文下载\r\n- **全球文献数据集**：覆盖全平台 12.28 亿条元数据\r\n\r\n## 环境配置/ Environment Configuration\r\n\r\n配置存储于技能目录下的 `config.json`：\r\n\r\n> Config persisted at skill-level config.json:\r\n\r\n```json\r\n{\r\n  \"SMARTLIB_GATEWAY_URL\": \"https://<your-gateway>.ap-shanghai.tencentscf.com\",\r\n  \"SMARTLIB_GATEWAY_SECRET\": \"<your-gateway-secret>\",\r\n  \"SMARTLIB_EMAIL\": null\r\n}\r\n```\r\n\r\nGateway 自动管理 SmartLib 凭证, 你不需要 APPID/APPSECRET。用户的 EMAIL 在首次注册后自动写入。运行前先读取 config.json 获取网关地址和密钥。\r\n\r\n## Token 管理/ Token Management\r\n\r\nSmartLib 的 OAuth Token 由 Gateway 全权管理。你无需获取或缓存 Token。\r\n\r\nGateway 支持两种检索调用模式：\r\n\r\n### 推荐：语义化端点（更简洁）\r\n\r\n```\r\nPOST /search\r\nHeaders: {\"Authorization\": \"Bearer <SECRET>\"}\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<token>\",\r\n  \"skill_source\": \"global-biblio-base\",\r\n  \"endpoint\": \"/search/cn\",     // 或 /search/global, /detail/cn, /detail/global\r\n  \"rule\": \"K=人工智能\",          // 检索表达式\r\n  \"page_index\": 1,\r\n  \"page_size\": 20,\r\n  \"sort\": 1                     // 可选\r\n}\r\n```\r\n\r\n支持的 endpoint：`/search/cn` `/detail/cn` `/download/cn` `/search/global` `/detail/global`\r\n\r\n### 兼容：全代理模式（旧版，仍可用）\r\n\r\n```\r\nPOST /search\r\nBody: {\r\n  \"email\": \"...\",\r\n  \"consume_token\": \"...\",\r\n  \"skill_source\": \"global-biblio-base\",\r\n  \"api_path\": \"/openapi/t/data0012/doccenter/Articlesearch\",\r\n  \"api_body\": {\"Rule\": \"...\", \"PageIndex\": 1, \"PageSize\": 20}\r\n}\r\n```\r\n\r\n## 检索接口选择策略/ Search Interface Selection\r\n\r\n| 用户需求特征| 推荐接口| 原因|\r\n|-------------|---------|------|\r\n| 查中文论文/需要全文| 接口1（中文期刊检索）/ API 1 | 支持全文下载|\r\n| 查英文论文/国际期刊| 接口4（全球文献检索）/ API 4 | 覆盖范围更广|\r\n| 需要专利/标准/学位论文| 接口4（全球文献检索）/ API 4 | 支持多种文献类型|\r\n| 不确定/跨语言检索| 优先接口4，再补充接口1| 互为补充|\r\n| 明确指定中文来源| 接口1（中文期刊检索）/ API 1 | 数据更精准|\r\n\r\n## 检索策略分级体系/ Search Strategy Hierarchy\r\n\r\n### 策略选择决策表/ Strategy Selection Matrix\r\n\r\n| 检索场景| 推荐策略| 目标|\r\n|------|------|------|\r\n| 开题报告、文献综述、查新| **宽检索**| 查全优先|\r\n| 精准溯源、单篇确认、引用支撑| **窄检索**| 查准优先|\r\n| 常规文献调研、一般检索| **平衡策略**| 查全查准兼顾|\r\n\r\n### 策略切换信号/ Strategy Switch Signals\r\n\r\n执行检索后，系统根据结果自动评估是否需要切换策略：\r\n\r\n- 结果 > 500 条且前 10 条相关性差 → 提示切换为**窄检索**\r\n- 结果 < 5 条 → 提示切换为**宽检索**（执行「结果数量自适应策略」）\r\n- 结果方向偏（前 10 条均不相关）→ 提示**更换关键词或字段**\r\n\r\n---\r\n\r\n## 可用接口/ Available Interfaces\r\n\r\n### 1. 中文期刊文献检索\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/data0012/doccenter/Articlesearch\",\r\n  \"api_body\": {\r\n    \"Rule\": \"<检索表达式>\",\r\n    \"PageIndex\": 1,\r\n    \"PageSize\": 20,\r\n    \"Sort\": 1,\r\n    \"FilterRule\": \"<可选：过滤表达式>\"\r\n  }\r\n}\r\n```\r\n\r\n**检索表达式规则（Rule，必填）：**\r\n- 字段代码：`T`=题名，`A`=作者，`K`=主题词，`P`=出版物名称，`O`=机构，`U`=全部字段\r\n- 逻辑运算符（必须大写，两边空格）：`AND` `OR` `NOT`\r\n- 示例：`(K=人工智能 OR K=机器学习) AND O=清华大学`、`T=深度学习`\r\n\r\n**过滤表达式规则（FilterRule，可选）：**\r\n- 字段代码：`L`=中图分类号，`C`=学科分类号，`Y`=出版年份，`TY`=文献类型，`LA`=语言\r\n- 文献类型 TY：3=期刊文献，4=学位论文，5=标准，7=专利，等\r\n- 示例：`TY=3 AND Y=2024`\r\n\r\n**排序 Sort：** 1=相关度（默认），2=时效性倒序，3=时效性正序\r\n**PageSize 范围：** 20~1000\r\n\r\n### 2. 中文期刊文献详情\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/data0011/doccenter/Articledetail\",\r\n  \"api_body\": {\r\n    \"Identifier\": \"<文献ID>\"\r\n  }\r\n}\r\n```\r\n\r\n返回完整文献详情，包含摘要、DOI、页码、基金资助、核心收录、原始数据库来源链接等。\r\n\r\n### 3. 中文期刊文献下载\r\n\r\n仅限授权中文期刊全文下载。\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/data0013/doccenter/GetArticleFile\",\r\n  \"api_body\": {\r\n    \"Identifier\": \"<文献ID>\"\r\n  }\r\n}\r\n```\r\n\r\n返回：`{\"Data\": {\"Url\": \"<下载链接>\", \"Identifier\": \"<文献ID>\"}}`\r\n\r\n---\r\n\r\n### 3b. 全球文献全文多渠道下载/ Multi-channel Full-text Download\r\n\r\nSmartLib API 3 仅覆盖中文期刊全文。对于 API 4（全球文献检索）查到但有 DOI 的国际论文，本技能提供多级多渠道下载策略，最大化免费获取成功率。\r\n\r\n#### ⚡ 执行触发条件/ Execution Trigger\r\n\r\n**仅在用户主动请求全文下载时才执行外文文献下载流程。** 检索结果展示后，默认只展示元数据；用户说\"下载全文\"/\"获取PDF\"/\"帮我下载\"时才触发。\r\n\r\n> Full-text download is **user-triggered only**. After search results are displayed, only metadata is shown. Execute download only when the user explicitly requests full-text (e.g., \"下载全文\", \"获取PDF\", \"帮我下载\").\r\n\r\n**触发关键词**\r\n- 中文：「下载全文」「获取PDF」「帮我下载」「我要看全文」「下载这篇/这些」\r\n- 英文：`download full-text` / `get PDF` / `download this paper`\r\n\r\n**执行规则**\r\n\r\n```\r\n用户请求下载全文:\r\n  ├── 中文期刊文献 → 调 API 3 下载 PDF（直接）\r\n  └── 外文文献（API 4，有 DOI）\r\n       ├── 按渠道优先级 1→10 自动逐级尝试\r\n       ├── 任一渠道成功 → 停止后续渠道，标记结果\r\n       ├── 全部失败 → 按失败分类标记\r\n       └── 每篇文献独立执行，并行处理（最多 10 篇并发）\r\n```\r\n\r\n**结果标记规范**\r\n\r\n每篇外文文献下载完成后，必须在结果列表中标记获取状态。标记使用明确的图标+文字：\r\n\r\n| 标记| 含义| 触发条件 |\r\n|------|------|------|\r\n| `[全文:已获取 ✓]` | PDF 已成功下载 | 任一渠道成功获取 PDF 文件 |\r\n| `[全文:在线 📖]` | 可在线阅读但无法自动下载 | Bronze OA / 出版商防盗链 |\r\n| `[全文:付费 💰]` | 付费墙内，需机构订阅或购买 | Closed access / 所有渠道均返回 403 |\r\n| `[全文:手动 🔍]` | 所有渠道均失败，需用户手动获取 | 无 OA 版本 / 网络错误 / 无 DOI |\r\n| `[全文:未尝试 -]` | 无 DOI 或未触发下载流程 | 文献无 DOI 或 API 4 未返回 DOI |\r\n\r\n**结果展示格式**\r\n\r\n检索结果列表中，每篇外文文献末尾追加标记：\r\n\r\n```\r\n1. [SCI一区] Attention Is All You Need\r\n   Vaswani A, Shazeer N, Parmar N, et al.\r\n   Advances in Neural Information Processing Systems, 2017\r\n   摘要: The dominant sequence transduction models are based on...\r\n   DOI: 10.5555/3295222.3295349\r\n   [全文:已获取 ✓] → papers/attention_is_all_you_need.pdf\r\n```\r\n\r\n**渠道执行报告**\r\n\r\n所有文献下载完成后，在结果末尾输出汇总表：\r\n\r\n```\r\n## 📥 外文文献全文获取报告/ Full-text Retrieval Report\r\n\r\n| # | 文献标题 | DOI | 成功渠道 | 状态 | 备注 |\r\n|---|---------|-----|---------|------|------|\r\n| 1 | Attention Is All You Need | 10.5555/xxx | ArXiv (渠道1) | [全文:已获取 ✓] | — |\r\n| 2 | BERT: Pre-training of... | 10.18653/v1/xxx | Unpaywall (渠道2) | [全文:已获取 ✓] | — |\r\n| 3 | Closed-access paper | 10.1000/xxx | — | [全文:付费 💰] | Elsevier 付费墙 |\r\n| 4 | Bronze OA paper | 10.1093/xxx | DOI.org (渠道7) | [全文:在线 📖] | OUP Bronze OA，需手动保存 |\r\n| 5 | No DOI paper | — | — | [全文:手动 🔍] | 无 DOI，建议联系作者 |\r\n\r\n> ✅ 成功 2/5 篇 | 📖 需在线阅读 1 篇 | 💰 付费墙 1 篇 | 🔍 需手动获取 1 篇\r\n```\r\n\r\n#### 渠道优先级/ Channel Priority\r\n\r\n| 优先级 | 渠道 | 适用条件 | 可靠性 | 费用 |\r\n|:--:|------|------|:--:|------|\r\n| **1** | **ArXiv 直链** | 论文有 arxiv ID | ★★★★★ | 免费 |\r\n| **2** | **Unpaywall OA 探测** | 有 DOI + 邮箱 | ★★★★☆ | 免费 |\r\n| **3** | **CORE OA 聚合器** | 有 DOI + API Key | ★★★★☆ | 免费 |\r\n| **4** | **OpenAlex 存档 PDF** | 有 DOI + API Key | ★★★★☆ | 免费 $1/天 |\r\n| **5** | **Semantic Scholar PDF** | 有 API Key | ★★★☆☆ | 免费 |\r\n| **6** | **Crossref 链接提取** | 有 DOI | ★★★☆☆ | 免费 |\r\n| **7** | **DOI.org 重定向** | 有 DOI | ★★☆☆☆ | 免费 |\r\n| **8** | **Europe PMC + PMC** | 生命科学/医学 DOI | ★★★☆☆ | 免费 |\r\n| **9** | **bioRxiv/medRxiv** | 生命科学预印本 | ★★★★☆ | 免费 |\r\n| **10** | **真实浏览器 CDP** | Bronze/Green OA | ★★★★☆ | 需服务器 |\r\n\r\n#### 下载决策树/ Download Decision Tree\r\n\r\n```\r\n用户请求下载某篇论文\r\n  ├─ 文献来自 API 1（中文期刊）→ 调 API 3（中文期刊下载）\r\n  └─ 文献来自 API 4（全球文献）或仅有 DOI\r\n       ├─ 有 ArXiv ID？ → 渠道 1：ArXiv 直链\r\n       ├─ 获取 DOI → 渠道 2：Unpaywall OA状态探测\r\n       ├─ 渠道 3：CORE 全球OA聚合器\r\n       ├─ 渠道 4：OpenAlex 存档PDF\r\n       ├─ 渠道 5：Semantic Scholar PDF\r\n       ├─ 渠道 6：Crossref PDF 链接提取\r\n       ├─ 渠道 7：DOI.org 内容协商重定向\r\n       ├─ 渠道 8：Europe PMC + PMC\r\n       ├─ 生物医学 → 渠道 9：bioRxiv/medRxiv 预印本\r\n       └─ 全部失败 + Bronze/Green OA？ → 渠道 10：真实浏览器 CDP\r\n```\r\n\r\n#### 出版商排障表/ Publisher Troubleshooting\r\n\r\n| 出版商 | 常见错误 | 原因 | 应对方案 |\r\n|------|------|------|------|\r\n| **OUP (Oxford)** | 403 Forbidden | Bronze OA，不开放自动化下载 | 渠道 10 CDP 模拟人工点击 |\r\n| **IEEE** | 403| 需机构订阅 IP | CC-BY 论文可直接下；其余需机构权限 |\r\n| **Elsevier** | 403 | 付费墙 | 查 Green OA 版本 |\r\n| **Springer Nature** | 403| 付费墙 + 机器人检测 | 查 ArXiv 预印本 |\r\n| **Nature**| 403 | 几乎无免费 PDF | 查作者自存档 |\r\n| **Wiley** | 403 | 付费墙 | 同 Elsevier |\r\n\r\n#### 失败分类与用户引导/ Failure Classification\r\n\r\n| 失败原因 | 用户提示 |\r\n|------|------|\r\n| **Bronze OA（出版商防盗链）** | 该论文为 Bronze OA——出版商允许免费阅读但禁止自动化下载。建议：[点击在线阅读]({url}) 手动保存 |\r\n| **Closed（付费墙）** | 该论文在付费墙内。建议：1) 通过机构图书馆访问 2) 搜索 ArXiv/bioRxiv 预印本 3) 通过科研通求助 |\r\n| **所有渠道均失败** | 所有下载渠道均未获取到全文。建议：[在线阅读]({url}) 或联系通讯作者请求 PDF |\r\n\r\n---\r\n\r\n### 4. 全球文献检索/ Global Literature Search\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/skrs2/doccenter/Articlesearch\",\r\n  \"api_body\": {\r\n    \"Rule\": \"<检索表达式>\",\r\n    \"PageIndex\": 1,\r\n    \"PageSize\": 20,\r\n    \"Sort\": 1,\r\n    \"FilterRule\": \"<可选：过滤表达式>\"\r\n  }\r\n}\r\n```\r\n\r\n检索表达式和过滤规则与中文期刊检索完全相同。网关统一返回结构：`{\"data\": {\"list\": [...], \"total\": N}, \"notifications\": [...]}`，**结果列表字段为 `data.list`（全小写）**；若个别旧接口回传 PascalCase（`Data.List`），请回退查找该键。\r\n\r\n### 5. 全球文献详情/ Global Literature Detail\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/skrs1/doccenter/Articledetail\",\r\n  \"api_body\": {\r\n    \"Identifier\": \"<文献ID>\"\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## 使用指南/ Usage Guide\r\n\r\n### 完整工作流/ Complete Workflow\r\n\r\n```\r\n                    ┌──────────────────────────────────┐\r\n                    │ 1. 理解需求/ Understand Intent    │\r\n                    └───────────────┬──────────────────┘\r\n                                    ↓\r\n                    ┌──────────────────────────────────┐\r\n                    │ 2. 选定检索策略 │ ← 宽检索/窄检索/平衡\r\n                    └───────────────┬──────────────────┘\r\n                                    ↓\r\n              ┌─────────────────────────────────────────┐\r\n              │ 3. 关键词智能扩展/ Keyword Expansion     │\r\n              │ 4. 构建检索式/ Build Expression          │\r\n              │ 5. 选择接口/ Select API                  │\r\n              │ 6. 执行检索/ Execute Search              │\r\n              │ 7. 结果智能排序/ Smart Ranking           │\r\n              └─────────────────────┬───────────────────┘\r\n                                    ↓\r\n                    ┌──────────────────────────────────┐\r\n                    │ 8. 结果评估/ Evaluate Results     │\r\n                    └───────────────┬──────────────────┘\r\n                          ┌─────────┴─────────┐\r\n                          ↓                   ↓\r\n              ┌───────────────────┐  ┌───────────────────┐\r\n              │ 结果满意   │  │ 结果需调整 │\r\n              │ → 步骤9          │  │ Adjustment         │\r\n              └───────┬───────────┘  └─────────┬─────────┘\r\n                      ↓                        ↓\r\n              ┌───────────────┐    ┌──────────────────────┐\r\n              │ 9. 展示结果   │    │ 9a. 策略调整          │\r\n              │ 10. 深入查看  │    │ 过多→窄化 / 过少→宽化 │\r\n              │ 11. 全文下载  │    │ 方向偏→换关键词       │\r\n              │  (中文直接下) │    └──────────┬───────────┘\r\n              │  (外文自动走) │\r\n              │  (十级渠道)   │\r\n              └───────────────┘\r\n                                              ↓\r\n                                    ┌──────────────────────┐\r\n                                    │ 9b. 二次检索         │\r\n                                    │ 回到步骤3-7          │\r\n                                    └──────────────────────┘\r\n```\r\n\r\n检索→评估→调整→再检索是核心工作流。首次检索后自动评估结果质量，必要时调整策略重新检索。\r\n\r\n**Step 11 全文下载（用户触发）：** 仅当用户主动请求时才执行全文下载：\r\n- **中文期刊**：直接调 API 3 下载 PDF\r\n- **外文文献**：走十级多渠道 OA PDF 探测（见 3b 章节），每篇独立并行执行\r\n- 下载结果以标记形式追加到结果列表中，并在末尾输出「全文获取报告」汇总表\r\n- **未触发下载时**：仅展示元数据，不执行任何下载操作\r\n\r\n### 关键词智能扩展\r\n\r\n> ⚠️ **核心原则**：SmartLib API 后端分词器（类似 IK Analyzer / mmseg4j）对中文复合词的索引已较完善。**召回不足的首要原因不是分词颗粒度问题，而是缩写/别名缺失、跨语言鸿沟和字段策略不当。**\r\n\r\n每次检索前，按以下 4 层策略扩展关键词：\r\n\r\n**第1层：缩写/别名扩展（优先级最高，实测 +122% 召回）**\r\n\r\n内置高频学术术语映射表（无需联网，即时可用）：\r\n\r\n| 用户常用词 | 必须扩展的别名/缩写 | 扩展后召回提升 |\r\n|-----------|-------------------|---------------|\r\n| 大语言模型 | LLM, 大模型, large language model | +122% |\r\n| 人工智能 | AI, artificial intelligence | +18% |\r\n| 自然语言处理 | NLP, natural language processing | — |\r\n| 深度学习 | deep learning, DNN, 深度神经网络 | — |\r\n| 机器学习 | machine learning, ML | +22% |\r\n| 计算机视觉 | CV, computer vision, 机器视觉 | — |\r\n| 知识图谱 | knowledge graph, KG | — |\r\n| 推荐系统 | recommender system, 个性化推荐 | — |\r\n| 强化学习 | reinforcement learning, RL | — |\r\n| 联邦学习 | federated learning, FL | — |\r\n| 区块链 | blockchain, 分布式账本 | — |\r\n| 物联网 | IoT, Internet of Things | — |\r\n| 数字孪生 | digital twin | — |\r\n| 元宇宙 | metaverse | — |\r\n| 碳中和 | carbon neutrality, 碳达峰 | — |\r\n| 文献检索 | 信息检索, information retrieval, 文献搜索 | — |\r\n| 分词 | 中文分词, word segmentation, tokenization, 切词 | — |\r\n| BERT | bidirectional encoder representations | — |\r\n| GPT | generative pre-trained transformer | — |\r\n| CNN | convolutional neural network, 卷积神经网络 | — |\r\n| RNN | recurrent neural network, 循环神经网络 | — |\r\n| GAN | generative adversarial network, 生成对抗网络 | — |\r\n\r\n> **规则**：只要用户关键词命中上表左列，必须自动添加右列的扩展词。**AI 还应自行推理**——遇到表外术语时，联网搜索其标准缩写和英文对应词（如\"Swin Transformer\" → \"Swin Transformer, Swin-T\"）。\r\n\r\n**第2层：中英互译扩展**\r\n\r\n- 中文关键词 → 必须补英文对应词（通过联网搜索确认学术通用译名）\r\n- 英文关键词 → 必须补中文对应词\r\n- 示例：`知识图谱` → 扩展 `knowledge graph`；`segmentation` → 扩展 `分割, 语义分割`\r\n\r\n**第3层：上下位词扩展（按需，联网搜索）**\r\n\r\n- 结果 < 10 条时执行：用上位词扩大范围，或用下位词增加相关结果\r\n- 示例：`深度学习` 结果少 → 上位词 `机器学习`；`自然语言处理` 结果少 → 下位词 `文本分类, 命名实体识别`\r\n\r\n**第4层：同义词/近义词扩展（联网搜索）**\r\n\r\n- 通过联网查询学术语境下的等价表述\r\n- 示例：`文献检索` → 补充 `文献发现, 文献获取, 资源发现`\r\n\r\n**检索表达式构建规则：**\r\n\r\n1. 同义词组内用 `OR` 连接，不同概念组间用 `AND` 连接\r\n2. 每组扩展词控制在 3-8 个，**缩写词优先**（收益最大）\r\n3. **重要**：中文和英文扩展词必须在同一个 OR 组内，而非分开\r\n   - ✅ `(K=大语言模型 OR K=大模型 OR K=LLM OR K=large language model)`\r\n   - ❌ `(K=大语言模型 OR K=大模型) AND (K=LLM OR K=large language model)`\r\n4. 默认字段使用 `K=`（关键词字段，精度和召回最均衡）\r\n5. **中文复合词不拆解**（API 后端分词已处理。实测：拆解为单字/n-gram 对召回增益 <15% 但噪声激增）\r\n   - ✅ `K=自然语言处理`\r\n   - ❌ `K=自然 AND K=语言 AND K=处理`（噪声大，不推荐）\r\n\r\n### 结果智能排序/ Smart Result Ranking\r\n\r\n检索结果需进行二次智能排序，综合考虑以下因素（优先级从高到低）：\r\n\r\n1. **核心收录权重**：SCI/SSCI > EI > CSSCI > 北大核心 > CSCD > 普通期刊\r\n2. **内容相关性权重**：题名匹配 > 题名+关键词 > 摘要相关 > 仅关键词命中\r\n3. **时效性权重**：近 3 年文献给予适当加分\r\n\r\n### 结果数量自适应策略/ Adaptive Result Strategy\r\n\r\n**结果过少（< 5 篇）— 宽化扩展：**\r\n\r\n1. 上位词扩展：联网搜索更泛化的术语\r\n2. 字段放宽：`T=` → `K=` → `U=`\r\n3. 相关机构检索：查找领域代表性机构\r\n4. 学科分类号检索：使用中图分类号或教育部分类号\r\n5. 放宽过滤条件：去掉时间/语言/文献类型限制\r\n6. 关键词拆分/重组\r\n\r\n**结果过多（> 500 条或相关性差）— 窄化收缩：**\r\n\r\n1. 字段收窄：`U=` → `K=` → `T=`\r\n2. 增加 AND 限定\r\n3. 核心词精简\r\n4. 强化过滤条件（限定文献类型/语言/年份）\r\n5. 排序优化\r\n\r\n### 自然语言转检索表达式示例/ NL-to-Query Examples\r\n\r\n> **字段默认使用 `K=`（关键词），而非 `U=`（全字段）。`K=` 精度高、噪声少，是学术检索的标准字段。**\r\n\r\n| 用户需求 | 扩展后的 Rule | FilterRule | 接口 |\r\n|---------|------|-----------|------|\r\n| 找关于深度学习的论文 | `(K=深度学习 OR K=deep learning OR K=DNN OR K=深度神经网络)` | - | 接口1+4 |\r\n| 清华大学发表的人工智能相关论文 | `(K=人工智能 OR K=AI OR K=artificial intelligence) AND O=清华大学` | `TY=3` | 接口1 |\r\n| 2024年中文期刊上关于大模型的文章 | `(K=大语言模型 OR K=大模型 OR K=LLM OR K=large language model)` | `TY=3 AND Y=2024 AND LA=ZH` | 接口1 |\r\n| Nature 期刊上的量子计算论文 | `(K=quantum computing OR K=量子计算) AND P=Nature` | - | 接口4 |\r\n| 查找计算机领域的专利 | `(K=计算机 OR K=computer)` | `TY=7` | 接口4 |\r\n| 2023-2025年的深度学习综述 | `(T=深度学习 OR T=deep learning) AND (T=综述 OR T=review OR T=survey)` | `Y=2023 OR Y=2024 OR Y=2025` | 接口1+4 |\r\n| 找关于知识图谱的论文 | `(K=知识图谱 OR K=knowledge graph OR K=KG)` | - | 接口1+4 |\r\n| NLP领域最新研究 | `(K=NLP OR K=自然语言处理 OR K=natural language processing)` | `Y=2024 OR Y=2025` | 接口1+4 |\r\n\r\n### 高级检索技巧/ Advanced Search Techniques\r\n\r\n#### 引文追溯策略/ Citation Tracing\r\n\r\n| 追溯方向 | 操作方式 | 适用场景 |\r\n|------|------|------|\r\n| **作者追踪** | `A=作者名` | 追踪核心研究者团队全部成果 |\r\n| **期刊溯源** | `P=期刊名 AND K=相关主题词` | 锁定高水平期刊中该领域全部论文 |\r\n| **机构扩展** | `O=机构名` | 了解机构在相关领域的研究布局 |\r\n| **参考文献反向查** | 提取参考文献标题，用 `T=` 逐一检索验证 | 确认引用文献是否在数据库中 |\r\n| **引用链追踪** | `L=分类号 OR C=分类号` | 在相同分类号下发现更多相关文献 |\r\n\r\n#### 分类号体系利用/ Classification-based Search\r\n\r\n利用中图分类号（`L=`）和教育部学科分类号（`C=`）检索可绕过关键词歧义。常用分类号：`TP18`=人工智能，`TP391.1`=自然语言处理，`O413`=量子论，`0812`=计算机科学与技术。\r\n\r\n#### 字段选择策略矩阵/ Field Selection Matrix\r\n\r\n> **默认使用 `K=`（关键词字段）**。这是学术检索的标准做法——知网的\"主题\"检索、维普的人工标引关键词、WoS 的 Topic Search 均以关键词/主题词为核心检索入口。\r\n\r\n| 字段 | 精度 | 覆盖 | 最佳场景 |\r\n|------|------|------|------|\r\n| `K=` 关键词 | 中 | 高 | **常规检索（默认）** — 对标知网\"主题\"检索 |\r\n| `T=` 题名 | 最高 | 低 | 精准匹配、引用确认 — 对标 WoS \"Title\" 检索 |\r\n| `U=` 全部字段 | 低 | 最高 | 查全兜底（仅当 K= 和 T= 结果 < 10 条时使用） |\r\n| `A=` 作者 | 高 | 低 | 追踪特定研究者 |\r\n| `O=` 机构 | 中 | 中 | 了解机构研究布局 |\r\n| `P=` 出版物 | 高 | 中 | 限定高质量期刊 |\r\n\r\n**字段分级检索流程**\r\n\r\n```\r\n默认（平衡策略）：\r\n  第1轮：K=检索（关键词字段，平衡精度和召回）\r\n    ├─ 结果 ≥ 10 → 完成 ✅\r\n    └─ 结果 < 10 → 第2轮\r\n    \r\n  第2轮：T=检索（放宽到题名，提高召回）\r\n    ├─ 结果 ≥ 5 → 合并去重，展示 ✅\r\n    └─ 结果 < 5 → 第3轮\r\n    \r\n  第3轮：U=检索（全部字段，最大召回）\r\n    → 合并去重（U= 结果可能噪声大，需标注\"全字段检索结果\"）\r\n\r\n宽检索（综述/查全）：\r\n  同时用 K= + U= 两路并行，取并集去重\r\n\r\n窄检索（精准/引用）：\r\n  优先 T= 精确匹配，K= 辅助补充\r\n```\r\n\r\n### 结果展示规范/ Result Display Standards\r\n\r\n**检索结果列表**以编号列表形式展示，每篇文献包含：序号、核心收录标注、标题、作者、来源出版物、出版日期、摘要（截取前200字）、文献ID。\r\n\r\n**文献详情**额外展示：DOI、核心收录、原始数据库链接、SmartLib 详情页、基金资助、页码。\r\n\r\n结果按「结果智能排序」策略排列。展示后主动提示用户：\r\n- \"输入文献编号可查看详情\"\r\n- \"中文期刊文献支持全文下载\"\r\n- \"如需更多结果，可以说'下一页'\"\r\n\r\n### 检索结果质量判断/ Result Quality Assessment\r\n\r\n#### 核心收录标注解读\r\n\r\n| 标注 | 含义 | 权重 |\r\n|------|------|------|\r\n| `[SCI一区]` | 国际顶级期刊（影响因子前 25%） | 最高 |\r\n| `[SCI二区]` | 国际高水平期刊 | 高 |\r\n| `[SSCI]` | 社会科学国际核心期刊 | 最高 |\r\n| `[EI]` | 工程领域国际核心收录 | 高 |\r\n| `[CSSCI]` | 中文社会科学引文索引（南大核心） | 高 |\r\n| `[CSCD]` | 中国科学引文数据库 | 中高 |\r\n| `[北大核心]` | 北京大学核心期刊目录 | 中 |\r\n| `[CCF-A]` | 中国计算机学会 A 类会议/期刊 | 最高 |\r\n\r\n#### 用户自检清单/ User Quality Checklist\r\n\r\n在引用或深入阅读文献前，建议用户快速核对：\r\n- [ ] **来源**：发表在什么期刊/会议上？是否为核心收录？\r\n- [ ] **时效**：出版年份是什么？对当前领域是否足够新？\r\n- [ ] **作者**：作者是否是该领域的活跃研究者？\r\n- [ ] **相关性**：标题和摘要是否与我的研究问题直接相关？\r\n- [ ] **可获取性**：是中文期刊（可下载全文）还是全球文献（仅元数据）？\r\n\r\n---\r\n\r\n### 错误处理/ Error Handling\r\n\r\n错误处理必须给出具体可操作的解决方案。网络波动时自动重试（最多 3 次，指数退避 1s→2s→4s）。\r\n\r\n#### 错误码处理表/ Error Code Handling\r\n\r\n| 状态码 | 含义 | 具体处理步骤 |\r\n|------|------|------|\r\n| **401** | Token 无效或过期 | Gateway 自动管理 Token 刷新, 无需处理。若持续 401，请检查 consume_token 是否有效 |\r\n| **403** | 权限不足 | 提示\"当前凭证无此接口权限，请确认 API 套餐是否已开通此接口\" |\r\n| **429** | 请求频率超限 | 等待 5 秒后自动重试 |\r\n| **499** | 参数错误 | 检查 Rule 语法（运算符大写、有空格）、FilterRule 字段代码、PageSize 范围 |\r\n| **502（alipay_error / 支付宝通道繁忙）** | 支付宝支付通道暂忙（订单未生成） | **不视为服务端故障、不要自动重试 3 次**（重试会加重节流）。按「半成功态」话术告知用户稍后重试；响应**不含** `out_trade_no`，切勿编造 |\r\n| **500/503** | 网关服务端错误 | 自动重试 3 次（指数退避 1s→2s→4s）→ 全部失败后提示\"SmartLib 服务暂时不可用，通常 5 分钟内恢复\" |\r\n| **网络超时** | 请求无响应 | 自动重试 3 次 → 提示\"请检查网络是否可访问 data.smart.vipslib.com\" |\r\n| **无结果** | API 返回空列表 | 按「结果数量自适应策略」自动提供扩展建议 |\r\n| **凭证缺失** | 环境变量未设置 | 自动触发 Pre-flight 注册流程 |\r\n\r\n---\r\n\r\n### 常见问题（FAQ）\r\n\r\n| 问题 | 答案 |\r\n|------|------|\r\n| **检索不到想要的论文怎么办？** | 1. 去掉过滤条件扩大范围 2. 尝试上位词 3. 用英文关键词在接口4再试 4. 用 `U=` 替代 `T=` |\r\n| **全文下载失败怎么办？** | 仅中文期刊支持全文下载。下载 URL 约 10 分钟有效（以下游返回为准），过期需重新调用。英文文献自动走多渠道下载策略获取 OA 版本。 |\r\n| **Token 多久过期？** | Access Token 约 30 秒，Refresh Token 约 2 小时（以 API 返回为准）。系统自动管理刷新，用户无感知。 |\r\n| **英文文献能不能下全文？** | 本技能集成十级多渠道下载策略（ArXiv → Unpaywall → CORE → OpenAlex 等），Gold/Green/Hybrid OA 论文成功率 >85%。付费墙内论文无法获取。 |\r\n| **配额耗尽后还能用吗？** | 不能。试用额度耗尽后 Gateway 返回 429 拒绝所有检索请求，并自动弹出套餐选择；如需更高额度，回复套餐数字或说「升级 / 充值」即可（企业 / 机构定制联系 vipsmart@vipslib.com）。 |\r\n| **计费 token（consume_token）是一次性的吗？** | **是的，务必注意。** 每次 `/consume` 返回的 `consume_token` **仅能使用一次**且 **约 60 秒过期**。获取后要立刻调用 `/search` 或 `/download`，不要缓存或复用；过期/已用需重新 `/consume`。这与 SmartLib 云端 Access/Refresh Token（约 30s/2h，以 API 返回为准，系统自动刷新）是两回事。 |\r\n| **Windows 下用 curl 下载 PDF 失败？** | 返回链接若含中文文件名，Git Bash 的 `curl` 常因 URL 编码失败而下载到空文件/报错。改用 **Python `urllib.request`** 直接拉取（自动处理编码），或直接用浏览器打开链接下载。 |\r\n| **中文关键词搜不到 / 命中少怎么办？** | 下游检索（维普系）对中文复合词与缩写别名的索引有限，纯中文窄词常召回不足。建议：① 补英文关键词（接口1+接口4 双检）② 用上位词/同义词扩检 ③ 用 `U=` 替代 `T=` ④ 去掉过滤条件扩大范围。详见下方「检索召回优化提示」。 |\r\n\r\n---\r\n\r\n### 检索召回优化提示（中文关键词命中低时必读）\r\n\r\n下游检索（维普系）的分词与别名索引对中文复合词、缩写、中英鸿沟支持有限，**召回不足的首要原因通常不是分词颗粒度，而是缩写/别名缺失、跨语言鸿沟和字段策略不当**。实操清单：\r\n\r\n- **中英双检**：同一概念同时用中文（接口1）和英文（接口4）各检一次，覆盖率显著提升。\r\n- **上位词 / 同义词扩检**：如「深度学习」补「神经网络 / 机器学习」；「新冠」补「COVID-19/ SARS-CoV-2」。\r\n- **字段渐进**：默认 `K=`（关键词），召回差时改用 `T=`（题名）精准定位，或 `U=`（任意字段）扩检。\r\n- **去掉过滤条件**：先广后窄，去掉 `TY=`/`LA=` 等过滤扩大范围，再人工筛选。\r\n- **缩写展开**：机构缩写（如「中科院」→「中国科学院」）、期刊缩写（如「JACS」→「Journal of the American Chemical Society」）务必展开。\r\n\r\n---\r\n\r\n### API 调用注意事项/ API Call Notes\r\n\r\n- **检索结果数据路径**：列表字段为 **`data.list`（全小写）**；解析优先级：`data.list` → `Data.List` → `List`。总条数在 `data.total` / `Data.Total`。\r\n- **Source 字段需详情接口获取**：检索列表中 `Source` 为空数组，原始数据库链接需调用详情接口。Source 数组元素结构为 `{\"Source_DbId\": \"scopusjournal\", \"Source_DbTitle\": \"Scopus\", \"Source_Link\": \"https://...\"}`，字段说明：`Source_DbId`=数据库标识符，`Source_DbTitle`=数据库中文名称，`Source_Link`=原始数据库详情页链接。平台覆盖300+数据库，100篇样本实测平均每篇4.75个链接，覆盖率100%。\r\n\r\n---\r\n\r\n## 注意事项/ Notes\r\n\r\n- 检索策略遵循三级分级体系：默认平衡策略，综述自动切换宽检索，引用自动切换窄检索\r\n- 检索→评估→调整→再检索是核心工作流\r\n- Access Token 有效期约 30 秒，Refresh Token 约 2 小时（以 API 返回为准），系统自动管理刷新\r\n- 全球文献检索（接口4）仅提供元数据，部分无全文\r\n- 中文期刊（接口1-3）支持全文下载，是核心优势，应优先推荐\r\n- PageSize 建议不超过 100\r\n- 检索表达式中的运算符必须大写且两边有空格\r\n- 英文关键词建议同时检索接口1和接口4以提高覆盖率\r\n- 展示文献详情时，务必从详情接口取 `Source` 字段并展示原始数据库链接（`Source_DbTitle` + `Source_Link`）\r\n- 引文追溯是提升检索质量的捷径：从一篇确认的高质量文献出发追踪\r\n- 分类号检索（`L=` / `C=`）可绕过关键词歧义\r\n\r\n---\r\n\r\n## 版本历史\r\n| 版本 | 日期 | 核心变更 |\r\n|------|------|---------|\r\n| v3.0 | 2026-06 | 注册流程简化，新用户开通更快捷，无需验证码 |\r\n| v3.3 | 2026-06 | 全球文献库扩充至12.28亿条；中文期刊8000万篇可下载 |\r\n| v3.9.0 | 2026-07 | 恢复付费套餐：新增体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包多档选择；计费与升级统一由 references/account.md（smartlib-account）管理，所有文献检索技能统一定价、配额共享 |\r\n| v3.10.0 | 2026-08-29 | 支付渠道切换为支付宝：对话内支付改用 `/api/pay/alipay/create` 生成支付宝付款码、轮询 `/api/pay/alipay/status`；后端双通道并存，老用户（未更新技能）支付通道不受影响 |\r\n| v3.10.1 | 2026-08-30 | 付款页规范化：新增 `references/pay_page_template.html` 标准付款页样例，对话中生成付款 HTML 必须严格按样例输出（仅替换占位符），统一支付宝蓝风格；修正付款码有效期文案为 **30 分钟**（对齐网关 `timeout_express=30m`，原先错误写成 5 分钟）；轮询策略与 30 分钟有效期对齐；文档事实一致性小修（套餐表标注与网关当前版本同步、Access/Refresh Token 与下载 URL 有效期标注\"以 API/下游返回为准\"、补充邮箱验证码 15 分钟有效）；文档全面清理（移除中英双语对照、只保留中文；版本历史精简为关键里程碑） |\r\n| v3.10.2 | 2026-08-30 | 安全整改（云顶实验室）：常驻通知改为「系统通知」引用展示、不引导点击；付款页模板移除远程 JS/CDN（二维码统一 base64 内嵌）与自动状态轮询（状态改由 AI 对话确认）；支付下单前向用户披露邮箱用途 |\r\n---\r\n\r\n## 常驻通知转述\r\n\r\n若任意 SmartLib 网关响应（`/search` 或 `/quota`）的 `notifications` 数组非空：将其内容作为**「系统通知」引用展示**给用户（保持原文、不改写措辞、不合并多条）；其中的 `url` 以**纯文字形式**呈现（如：系统通知：xxx，如有需要可访问对应链接），**不渲染为强引导点击、不夸大其重要性**。若通知文本本身含「点击」引导语，转述时仅作内容引用，由用户自行判断。\r\n\r\n## 📌 企业 / 机构合作\r\n\r\n如需机构 / 企业批量定制、API 接入或私有化部署，请联系我们：\r\n\r\n- 📧 邮箱：vipsmart@vipslib.com\r\n- ☎️ 电话：023-63016015\r\n- 🌐 官网：https://www.vipslib.com/\r\n\r\n个人用户的套餐与升级：配额不足时会自动弹出套餐选择，也可主动说「升级 / 充值 / 购买」唤起（见上方💰章节）。\n\nFile v3.10.2:README.md\n\n# SmartLib 学术文献检索 Skill v3.10.1\n\n用自然语言查论文、找文献、下载全文 —— 覆盖 8000 万篇中文期刊 + 12.28 亿条全球文献。**全自动**：首次使用自动注册开通（免费 100 次/月），配额自动消耗，用尽引导支付宝扫码支付。\n\n---\n\n## 这是什么\n\n一个让 AI 助手具备学术文献检索能力的 Skill。安装后，用日常语言说出需求，AI 自动帮你检索、筛选、展示文献，还能下载中文期刊全文 + 英文 OA 论文。\n\n### 核心亮点\n\n- **中文期刊全文下载**：8000 万篇授权中文期刊，一键获取 PDF\n- **英文 OA 多渠道下载**：十一级下载策略，Gold/Hybrid/Green OA 成功率 >85%\n- **全球文献覆盖**：12.28 亿条元数据（期刊/专利/会议/学位/标准等）\n- **全自动变现**：零配置启动，配额耗尽后扫码支付即恢复\n- **自然语言交互**：不需要学检索语法\n\n---\n\n## 🔒 免费体验与受限展示\n\n| 状态 | 展示规则 |\n|------|---------|\n| **配额充足** | 完整展示所有检索结果（含详情、下载、智能排序） |\n| **配额耗尽** | Gateway 返回 429，**拒绝服务**，直接提示充值 |\n\n配额耗尽后回复「充值」，展示数字选套餐卡片（①-④），回复数字即可获取带套餐信息的支付宝付款码。\n\n---\n\n## 快速开始\n\n### 1. 安装\n\n在 WorkBuddy 中搜索 \"smartlib\" 安装。\n\n### 2. 零配置启动\n\n**无需手动申请 API 密钥。** 首次使用自动检测凭证，未配置则自动通过智能网关注册开通（免费 100 次/月）。\n\n### 3. 开始使用\n\n```\n帮我找一些关于大语言模型的最新论文\n下载第 3 篇\n```\n\n---\n\n## 使用示例\n\n**查找中文论文并下载：** `帮我找几篇关于知识图谱的中文论文` → AI 自动检索、展示结果、输入编号即可下载 PDF。\n\n**查找英文论文并获取 OA 全文：** `找 transformer architecture 相关的论文` → AI 自动通过 ArXiv / Unpaywall / CORE 等渠道获取 OA 版本。\n\n**配额耗尽 → 对话支付：** 在对话中说「充值」→ 展示 ①-④ 数字套餐卡片 → 回复数字选择 → 直接出带订单信息的支付宝付款码 → 扫码支付 → 即时恢复。\n\n---\n\n## 常见问题\n\n**Q: 免费吗？** 首次使用自动注册，免费 100 次/月。超出后付费，¥9.90 体验卡（1000 次）起。\n\n**Q: 英文文献能下全文吗？** 可以。十一级多渠道下载策略，Gold/Hybrid/Green OA 成功率 >85%。付费墙内（Closed）论文无法获取。\n\n**Q: 配额耗尽后怎么办？** 在对话中说「充值」，展示数字选套餐卡片，回复数字直接获取支付宝付款码，扫码后即时恢复。\n\n---\n\n## 依赖\n\n- SmartLib API（自动通过网关注册）\n- SmartLib Gateway（腾讯云 SCF 上海）\n- Alipay（支付宝当面付扫码支付）\n\n---\n\n## 相关文档\n\n- **SKILL.md** — 完整技能规范（API 接口、检索策略、变现流程）\n- **PIPELINE.md** — 全链路优化指南\n\n---\n\n## 作者\n\n**张亚东** — 重庆维普智图 · GitHub: [J-levee](https://github.com/J-levee)\n\nFile v3.10.2:_meta.json\n\n{\n  \"ownerId\": \"kn71136czyc1f1bmx5rt1tjtes86jsve\",\n  \"slug\": \"global-biblio-base\",\n  \"version\": \"3.10.2\",\n  \"publishedAt\": 1788060441064\n}\n\nFile v3.10.2:references/account.md\n\n# SmartLib 账户与计费（smartlib-account）\r\n\r\n> 本文档是 SmartLib 所有文献检索类技能的**计费与升级唯一真相源**。\r\n> 所有调用文献检索能力的技能（global-biblio-base / citation-checker / academic-knowledge-base / keji-skill-showcase 等）**统一定价、配额共享**，走同一个「统一钱包」。\r\n> 各技能 SKILL.md 不重复价格表，仅在需要时点此文档或引导用户对话中说「我要升级」。\r\n> 本文件按需加载，不进 SKILL.md，避免多处复制导致漂移。\r\n\r\n---\r\n\r\n## 一、注册（首次使用，极简 1 步）\r\n\r\n- 首次在某文献技能发起检索 → 检测到未关联 SmartLib 账户 → **仅需提供邮箱**即可注册（无需验证码）。\r\n- 注册成功**立即可用**：免费 **100 次检索 + 10 次全文下载 / 月**，全程对话驱动。\r\n- 邮箱验证：注册后确认邮件为可选项；**未验证也能正常付费与使用**（降低摩擦，已确认）。\r\n\r\n---\r\n\r\n## 二、套餐与价格\r\n\r\n> 阶段 0 仅开放「单付」；连续包月（¥29 / ¥79）为**后续版本**，当前前端不展示连包入口与连包价。\r\n> 「下载价格」为包内含下载的**单篇均价**（透明参考，非额外计费）；下载额度随套餐一并给定，不单独叠加收费。\r\n\r\n| 档位 | 周期 | 检索与详情 | 下载 | 价格 | 下载价格 | 定位 |\r\n|------|------|-----------|------|------|---------|------|\r\n| 免费体验 | 月 | 100 | 10 | ¥0 | — | 获客入口 |\r\n| 体验卡 | 一次性·7天 | 1000 | 20 | ¥9.9 | ¥0.5 | 首付费转化·仅新用户 1 张 |\r\n| 个人版月 ★ | 月 | 1000 | 50 | ¥39（连包 ¥29 后续） | ¥0.6 / ¥0.8 | 性价比最高·推荐 |\r\n| 专业版月 | 月 | 2000 | 200 | ¥99（连包 ¥79 后续） | ¥0.4 / ¥0.5 | 高价锚点 |\r\n| 单篇下载 | 即时 | — | 1 | ¥2.5 | ¥2.5 | 按需·对齐维普零售价 |\r\n| 下载包 | 月 | — | 10 | ¥20 | ¥2 | 超额低成本（当前唯一下载包） |\r\n| 企业/机构 | 议价 | 自定义 | 自定义 | 按量 / API | 自定义 | >2000 次 或团队出口 |\r\n\r\n**规则要点：**\r\n- 下载配额每个档位**显式给定**（不再用「总额度 10%」隐式规则）。\r\n- 体验卡：**仅新用户 + 终身限 1 张**；用过 / 过期 / 退款均不可重买。\r\n- 免费档与付费档**可并行使用**：付费期内免费额度**不冻结**，客户可持续享用每月免费检索 / 下载额度（先用免费、后动付费），降低早期使用门槛。\r\n- 企业 / 机构档保持「联系我们」，不开放自助购买。\r\n\r\n---\r\n\r\n## 三、价格表展示与推荐逻辑\r\n\r\n- **未购体验卡用户**：优先高亮推荐 **体验卡 ¥9.9**。\r\n- **体验卡已购 / 已用 / 已过期**：体验卡从价格表**消失**，此时优先推荐 **个人版月 ¥39**。\r\n- 升级入口：对话中说「我要升级」，或在任一文献技能查看本文件。\r\n\r\n---\r\n\r\n## 四、下载权益、72 小时重下窗与配额提醒（每次全文下载强制）\r\n\r\n**下载权益（统一钱包）：**\r\n- 免费档每月含 **10 次全文下载**，随日历月重置（`/quota` 返回的 `download_reset_at` 字段标明重置日）。\r\n- 付费档在对应周期内额外给定下载次数（见第二节价格表）；**付费期内免费额度不冻结**，可同时享用免费 + 付费下载额度。\r\n- **单篇下载 ¥2.5 / 下载包 ¥20（10 次）** 为独立购买的超额方案，购买后写入「下载授权」（含有效期，见下）。\r\n- 下载授权消耗优先级：**先消耗即将过期的付费授权 → 再消耗免费月度额度**，避免浪费。\r\n\r\n**72 小时同篇重下窗（不重复计费）：**\r\n- 同一用户、同一篇文献，在 **72 小时内** 重复下载，**不扣减下载配额、也不重复收费**（含单篇付费用户）。\r\n- 系统按 `email + 文献ID` 记录下载历史；命中 72h 窗口内已有记录时直接复用，不再扣减。\r\n- 超出 72 小时后再次下载，按正常配额 / 付费流程计费。\r\n\r\n**每次下载的对话 UX（强制）：**\r\n1. **下载前提醒**：「您当前剩余下载配额 **N 次**，本次将消耗 **1 次**」。\r\n2. **确认文献**：向用户确认要下载的具体文献（标题 / ID）后再执行，**不静默扣减**。\r\n3. **耗尽转向**：下载额度耗尽后，引导转向 **单篇下载 ¥2.5** 与 **下载包 ¥20（10 次）**。\r\n\r\n---\r\n\r\n## 五、企业 / 机构合作\r\n\r\n机构 / 企业批量定制、API 接入、私有化部署：\r\n- 📧 vipsmart@vipslib.com  ☎️ 023-63016015  🌐 https://www.vipslib.com/\r\n\r\n---\r\n\r\n## 六、常见问题 FAQ\r\n\r\n- **Q：配额多久重置？** A：免费档每月重置；付费档按购买周期（月 / 7 天）计算。\r\n- **Q：不同技能的配额互通吗？** A：互通。所有文献检索技能共享同一统一钱包配额。\r\n- **Q：邮箱没验证能用吗？** A：能。验证仅在特定操作时需要，不影响正常使用与付费。\r\n- **Q：体验卡能重复买吗？** A：不能，终身仅 1 张，限新用户。\r\n- **Q：下载会额外扣钱吗？** A：不会。下载额度随套餐给定，仅消耗额度；单篇下载 / 下载包为独立购买的超额方案。\r\n- **Q：同一篇文献反复下载会重复扣费吗？** A：不会。同一用户在 72 小时内重复下载同一篇文献，系统直接复用、不扣配额也不重复收费；超过 72 小时后再下载才正常计费。\r\n\r\n---\r\n\r\n*本文件为 SmartLib 统一计费钱包的说明文档（smartlib-account），由各文献技能按需引用，数字以本文为准。*\n\nFile v3.10.2:PIPELINE.md\n\n# SmartLib 全链路检索下载管线优化指南\r\n\r\n本文件记录 SmartLib 文献检索技能中\"检索→详情→下载\"全链路的架构设计、性能优化策略和实战基准数据。面向技能调用者（AI Agent）和开发者，提供最优执行路径参考。\r\n\r\n> This document covers the architecture, optimization strategies, and real-world benchmarks for the SmartLib literature search → detail → download pipeline. Designed for skill invokers (AI Agents) and developers as the authoritative execution reference.\r\n\r\n---\r\n\r\n## 1. 管线架构\r\n\r\n```\r\n用户请求\r\n    │\r\n    ▼\r\n┌─────────────────────────────────────────────────────┐\r\n│  PHASE 1: 并行检索│\r\n│  ├─ CN: API 1 (中文期刊) ─── 独立 Token，并行发起   │\r\n│  └─ EN: API 4 (全球文献) ─── 独立 Token，并行发起   │\r\n│  预计耗时: 1-3s (5 并发检索)                         │\r\n└──────────────────┬──────────────────────────────────┘\r\n                   ▼\r\n┌─────────────────────────────────────────────────────┐\r\n│  PHASE 2: 批量获取详情│\r\n│  ├─ CN: 无需此步（API 3 直接用 Identifier 下载）     │\r\n│  └─ EN: API 5 (文章详情) ─── 8 并发获取 DOI + 元数据 │\r\n│  预计耗时: 0.3-2s (50 篇以内)                        │\r\n│  关键优化: Token 缓存复用，无需每次重新认证           │\r\n└──────────────────┬──────────────────────────────────┘\r\n                   ▼\r\n┌─────────────────────────────────────────────────────┐\r\n│  PHASE 3: 并行下载│\r\n│  ├─ CN: API 3 (GetArticleFile) ─── 10 并发下载       │\r\n│  └─ EN: 多渠决策树 ─── 10 并发，每篇独立路由         │\r\n│       ├─ ArXiv (最快)                                │\r\n│       ├─ Unpaywall OA 探测 (最全面)                   │\r\n│       ├─ SpringerOpen / PLOS / PMC (出版商专用)       │\r\n│       └─ DOI 重定向 (兜底)                            │\r\n│  预计耗时: 5-15s (10 篇) / 20-40s (50 篇)            │\r\n└──────────────────┬──────────────────────────────────┘\r\n                   ▼\r\n              📊 汇总报告\r\n```\r\n\r\n**设计原则**\r\n- **分阶段并行**: 每阶段内部并行，阶段间串行（依赖数据传递）\r\n- **独立无锁**: 每篇论文的下载互不依赖，无共享状态\r\n- **失败隔离**: 单篇失败不影响其他论文\r\n- **Gateway 代理**: 所有 API 调用通过 Gateway /consume → /search 代理，Token 由 Gateway 管理\r\n\r\n---\r\n\r\n## 2. 核心优化技术\r\n\r\n### 2.1 Gateway 统一管理 Token\r\n\r\n**问题**: 每次 API 调用前走 OAuth 两步认证 (code→token)，耗时 ~0.8s。50 篇论文=50 次认证=40s 浪费。\r\n\r\n**优化**: SmartLib OAuth Token 由 Gateway 全权管理，技能无需获取或缓存 Token。\r\n\r\n**架构**\r\n```\r\n技能 (Skill) → Gateway (/consume → /search) → SmartLib API\r\n                    ↑\r\n              Token 缓存 + 自动刷新 + 分布式同步\r\n```\r\n\r\n- Gateway 维护 OAuth 凭证（APPID + APPSECRET）\r\n- 技能通过 config.json 中的 GATEWAY_SECRET 调用 Gateway API\r\n- 技能**无需持有** APPID/APPSECRET\r\n- Gateway 自动处理 Token 刷新与缓存（含跨实例分布式同步）\r\n\r\n### 2.2 提前终止\r\n\r\n**问题**: 传统策略是对所有渠道逐一尝试，但 closed-access 论文注定失败。\r\n\r\n**优化**: Unpaywall 探测后立即判断：\r\n\r\n| OA 状态 | 策略 | 原因 |\r\n|------|------|------|\r\n| `gold` | 全渠道重试 | 几乎必定能下 |\r\n| `hybrid` | 先试 Unpaywall PDF URL | 大概率能下 |\r\n| `green` | 试 ArXiv + Unpaywall + 机构库 | 作者自存档版本 |\r\n| `bronze` | 尝试一次后 curl 兜底 | ⚠️ 大概率被防盗链拦截 |\r\n| `closed` | **立即终止**，不浪费后续尝试 | 100% 付费墙内 |\r\n\r\n**效果**: closed-access 论文从 ~8s (7个渠道轮询) 降至 ~1s (仅一次 Unpaywall 查询)。\r\n\r\n### 2.3 智能渠道路由\r\n\r\n**问题**: 不同出版商的 PDF 获取方式差异大，统一策略效率低。\r\n\r\n**优化**: 根据出版商名称路由到最优渠道：\r\n\r\n```python\r\nPUBLISHER_ROUTES = {\r\n    \"springer\":  [\"springer\", \"unpaywall\", \"arxiv\"],   # SpringerOpen 直链最快\r\n    \"elsevier\":  [\"unpaywall\", \"arxiv\", \"green\"],       # Elsevier 大概率付费墙\r\n    \"mdpi\":      [\"unpaywall\", \"direct\"],                # MDPI 几乎全 OA\r\n    \"frontiers\": [\"unpaywall\", \"direct\"],                # Frontiers 全 OA\r\n    \"plos\":      [\"plos\", \"unpaywall\"],                  # PLOS 专用 API\r\n    \"biomed\":    [\"springer\", \"unpaywall\", \"pmc\"],       # BMC = Springer 子品牌\r\n}\r\n```\r\n\r\n**效果**: SpringerOpen/BMC 论文直接从 `link.springer.com/content/pdf/` 拿 PDF，跳过 Unpaywall，节省 1-2s/篇。\r\n\r\n### 2.4 HTTP 连接复用\r\n\r\n**问题**: 每次 `urllib.request.urlopen()` 创建新 TCP 连接 + TLS 握手，开销 ~200ms。\r\n\r\n**优化**: \r\n- 使用 `build_opener()` + `Connection: keep-alive` header\r\n- 同 host 的连续请求复用底层 TCP 连接\r\n\r\n**效果**: 50 篇同 host 下载可节省 ~5s。\r\n\r\n### 2.5 curl 兜底\r\n\r\n**问题**: Python `urllib` 对某些服务器（OUP Bronze OA）返回 `IncompleteRead` 或截断 PDF。\r\n\r\n**优化**: 下载失败时自动切换为 `curl` subprocess 重试。\r\n\r\n```python\r\n# curl 对 HTTP chunked encoding 和 unstable connections 处理更鲁棒\r\nresult = subprocess.run([\"curl\", \"-sL\", \"--max-time\", \"25\", \"-o\", \"-\", url], ...)\r\n```\r\n\r\n**效果**: 将 Bronze OA 论文成功率从 ~20% 提升至 ~60%。\r\n\r\n---\r\n\r\n## 3. 下载渠道路由决策树\r\n\r\n```\r\n论文有 Identifier + 来源 = API 1 (中文期刊)?\r\n  ├─ YES → API 3 (GetArticleFile) → 获取 PDF URL → 下载\r\n  │        成功率: >95%  |  耗时: ~1s/篇\r\n  │\r\n  └─ NO (全球文献)\r\n       ├─ 标题含 arXiv ID? → https://arxiv.org/pdf/{id}\r\n       │   成功率: >99%  |  耗时: ~2s/篇\r\n       │\r\n       ├─ 获取 DOI (API 5) → Unpaywall 探测\r\n       │   ├─ is_oa = false\r\n       │   │   → ⛔ 立即终止，标记 \"paywall_closed\"\r\n       │   │\r\n       │   ├─ oa_status = \"gold\" → 全渠道并发尝试\r\n       │   │   1. Unpaywall best_oa_location.url_for_pdf\r\n       │   │   2. DOI redirect (Accept: application/pdf)\r\n       │   │   3. 出版商专用路由 (SpringerOpen/PLOS/MDPI)\r\n       │   │   成功率: >90%\r\n       │   │\r\n       │   ├─ oa_status = \"hybrid\" → Unpaywall PDF URL 优先\r\n       │   │   成功率: ~80%\r\n       │   │\r\n       │   ├─ oa_status = \"green\" → ArXiv + Unpaywall + DOI redirect\r\n       │   │   成功率: >85%\r\n       │   │\r\n       │   └─ oa_status = \"bronze\" → ⚠️ 高风险\r\n       │       1. Unpaywall PDF URL (常规)\r\n       │       2. curl 兜底 (绕过 urllib 限制)\r\n       │       3. 出版商专用路由\r\n       │       成功率: ~40-60% (出版商防盗链)\r\n       │\r\n       └─ 无 DOI → 标记 \"no_doi\"，仅展示元数据\r\n```\r\n\r\n---\r\n\r\n## 4. 性能基准\r\n\r\n### 4.1 实测数据\r\n\r\n测试环境: Windows 10, Python 3.14, 中国网络环境 (GFW)\r\n\r\n#### 完整 5 领域多渠测试 (multi_channel_test.py)\r\n\r\n| 领域| 检索| 下载成功| 成功率| 主要渠道|\r\n|------|:--:|:--:|:--:|------|\r\n| 化学催化**10** | 100% | Unpaywall Gold OA (MDPI/Frontiers) |\r\n| AI/深度学习**10** | 100% | ArXiv + Unpaywall Gold |\r\n| 生物技术 CRISPR\r\n| 环境/气候\r\n| 制药/mRNA**0** | 0% | 全部付费墙 (Elsevier/Nature/Wiley) |\r\n\r\n**总计**\r\n\r\n#### 优化管线 Demo 测试\r\n\r\n| 指标| 值|\r\n|------|------|\r\n| 检索\r\n| 详情| 5 EN in 0.3s (Token 缓存) |\r\n| CN 下载| 5 in 4.4s (0.88s/篇) |\r\n| EN 下载| 5 in 5.7s (1.14s/篇) |\r\n| **总计** | **10 in 11.7s (1.17s/篇)** |\r\n| 成功率\r\n\r\n### 4.2 速度对比\r\n\r\n| 阶段| 优化前| 优化后| 提升|\r\n|------|:--:|:--:|:--:|\r\n| Token 获取 (50篇) | ~40s (每次重新认证) | ~2s (缓存复用) | **20x** |\r\n| EN 详情获取 (50篇) | ~40s (串行) | ~2s (8并发+Token复用) | **20x** |\r\n| CN 下载 (10篇) | ~30s (串行) | ~8s (10并发) | **3.75x** |\r\n| EN 下载 (10篇) | ~60s (全渠道串行轮询) | ~12s (路由+提前终止) | **5x** |\r\n| closed 论文判定 | ~8s (7渠道失败) | ~1s (立刻终止) | **8x** |\r\n\r\n### 4.3 渠道贡献分析\r\n\r\n基于 50 篇 5 领域实测 + 10 篇优化管线测试 = 60 篇总样本:\r\n\r\n| 渠道| 成功数| 占比| 平均耗时|\r\n|------|:--:|:--:|:--:|\r\n| API 3 (中文期刊) | 5 | 14% | ~0.9s |\r\n| ArXiv | 5 | 14% | ~2s |\r\n| Unpaywall Gold OA | 22 | 60% | ~3s |\r\n| Unpaywall Hybrid OA | 1 | 3% | ~4s |\r\n| Unpaywall Green OA | 2 | 5% | ~5s |\r\n| SpringerOpen Direct | 1 | 3% | ~2s |\r\n\r\n---\r\n\r\n## 5. 使用指南\r\n\r\n### 5.1 快速启动\r\n\r\n```bash\r\n# Demo 模式: 1 个 CN + 1 个 EN 检索，各 5 篇\r\npython optimized_pipeline.py --preset demo --pagesize 5\r\n\r\n# 完整测试: 5 个领域 EN 检索，各 10 篇\r\npython optimized_pipeline.py --preset test --pagesize 10\r\n\r\n# 自定义检索\r\npython optimized_pipeline.py \\\r\n  --cn \"深度学习::K=深度学习 AND TY=3\" \\\r\n  --en \"CRISPR::(K=CRISPR OR K=gene editing) AND TY=3\" \\\r\n  --pagesize 10 \\\r\n  --out ./my_downloads\r\n```\r\n\r\n### 5.2 编程调用\r\n\r\n```python\r\nfrom optimized_pipeline import PipelineOrchestrator\r\n\r\norch = PipelineOrchestrator(out_dir=\"./papers\")\r\n\r\nresult = orch.run(\r\n    cn_queries=[{\"name\": \"AI_CN\", \"rule\": \"K=人工智能 AND TY=3\"}],\r\n    en_queries=[{\"name\": \"LLM_EN\", \"rule\": \"(K=transformer) AND (K=large language model)\"}],\r\n    page_size=10\r\n)\r\n\r\nprint(f\"Downloaded: {result['totals']['downloaded']}\")\r\nprint(f\"Time: {result['timing']['total']}s\")\r\nprint(f\"Channels: {result['stats']}\")\r\n```\r\n\r\n### 5.3 AI Agent 调用建议\r\n\r\n当 AI 助手调用本技能进行文献下载时，建议遵循以下执行路径：\r\n\r\n1. **检索阶段**: 中文用 API 1，英文用 API 4，并行发起（同一批 Token）\r\n2. **详情阶段**: 仅对 EN 文献调 API 5 获取 DOI（CN 可直接下载）\r\n3. **下载阶段**: CN 和 EN 并行下载；EN 内部 10 并发\r\n4. **失败处理**: closed-access 标记后直接跳过，bronze OA 用 curl 兜底\r\n\r\n**关键**: 绝对不要逐篇串行下载 N 篇论文！必须并行。\r\n\r\n---\r\n\r\n## 6. 排障指南\r\n\r\n| 现象| 原因| 解决|\r\n|------|------|------|\r\n| 所有 EN 论文下载失败 | Token 未正确缓存 | 检查 `TokenManager._expires_at` 是否正确设置 |\r\n| Unpaywall 返回空 | 邮箱未提供或格式错误 | 确认 `email=` 参数正确 |\r\n| 下载的 PDF 无法打开 (几 KB) | 服务器返回 HTML 错误页而非 PDF | 开启 curl 兜底；检查 `%PDF` magic bytes 验证 |\r\n| Bronze OA 全部 403 | 出版商防盗链 (OUP/IEEE) | 启用 curl 兜底；长期方案：部署 Chromium CDP |\r\n| 中文期刊 PDF URL 过期 | URL 有效期 ~10min | 重新调用 API 3 获取新 URL |\r\n| `failed_no_doi` 比例高 | API 5 返回的元数据不含 DOI | 该论文确实无 DOI，建议用户通过标题在 Google Scholar 手动搜索 |\r\n\r\n---\r\n\r\n## 7. 依赖\r\n\r\n- Python 3.8+\r\n- `urllib` (标准库)\r\n- `curl` (系统工具，用于 PDF 兜底下载)\r\n- SmartLib Gateway (腾讯云 SCF，管理 OAuth 凭证与 Token 缓存)\r\n- Unpaywall API (免费，需提供邮箱)\r\n\r\n---\r\n\r\n## 8. 版本\r\n\r\n| 版本 | 日期 | 变更 |\r\n|------|------|------|\r\n| 1.0 | 2026-05-27 | 初始发布。基于 5 领域 50 篇多渠测试 + 优化管线 Demo 10 篇实战数据。 |\n\nFile v3.10.2:skill-card.md\n\n## Description:\n\nglobal-biblio-base provides SmartLib-powered academic literature search, literature-detail lookup, and available PDF retrieval for Chinese journals and global open-access literature.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[j-levee](https://clawhub.ai/user/j-levee)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and research-focused agents use this skill to search academic literature, review bibliographic metadata, find supporting citations, and retrieve available PDF links while managing SmartLib quota and payment flows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill asks users for an email address, stores local email state, and sends research queries to SmartLib and related open-access services.\n\nMitigation: Use only with user consent, disclose the data sharing clearly, and avoid submitting sensitive research queries unless the user accepts that exposure.\n\nRisk: The skill includes quota consumption and Alipay payment flows that can affect user cost or account state.\n\nMitigation: Require explicit user confirmation before registration, download, and payment actions; use only server-returned order data and keep email addresses masked in payment pages.\n\nRisk: The release evidence reports a committed plaintext gateway bearer secret.\n\nMitigation: The publisher should remove and rotate the secret and keep credentials outside distributable skill artifacts before production deployment.\n\nRisk: Remote notifications could influence users if presented as strong calls to action.\n\nMitigation: Present gateway notifications neutrally as system notices and avoid amplifying links or instructions beyond the source text.\n\nRisk: External PDF download links may point to untrusted or unavailable files.\n\nMitigation: Bound external downloads, preserve source attribution, and have users review downloaded files before opening or relying on them.\n\n## Reference(s):\n\n- [Skill specification](SKILL.md)\n- [Pipeline guide](PIPELINE.md)\n- [SmartLib account and billing reference](references/account.md)\n- [Payment page template](references/pay_page_template.html)\n- [ClawHub skill release](https://clawhub.ai/j-levee/skills/global-biblio-base)\n- [Publisher profile](https://clawhub.ai/user/j-levee)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, HTML, Links, Guidance]\n\n**Output Format:** [Markdown search results with links, quota status, and occasional static HTML payment pages]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include literature metadata, source links, PDF download links, quota notices, and masked-email payment pages.]\n\n## Skill Version(s):\n\n3.10.2 (source: frontmatter and release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v3.10.2:config.example.json\n\n{\n  \"SMARTLIB_GATEWAY_URL\": \"https://<your-gateway-id>.ap-shanghai.tencentscf.com\",\n  \"SMARTLIB_GATEWAY_SECRET\": \"<your-gateway-secret>\"\n}\n\nFile v3.10.2:config.json\n\n{\n  \"SMARTLIB_GATEWAY_URL\": \"https://1318491188-jvmi3wist0.ap-shanghai.tencentscf.com\",\n  \"SMARTLIB_GATEWAY_SECRET\": \"sk-O9vHwWzMg0Jf7khvhKQ0xxpdGIOROcw5RyQnROrNuZj9x6hOeHmi2\",\n  \"SMARTLIB_EMAIL\": null\n}\n\nArchive v3.10.1: 9 files, 39957 bytes\n\nFiles: config.example.json (139b), config.json (204b), PIPELINE.md (12131b), README.md (3140b), references/account.md (5654b), references/pay_page_template.html (10312b), skill-card.md (2892b), SKILL.md (60274b), _meta.json (138b)\n\nFile v3.10.1:SKILL.md\n\n---\r\nslug: global-biblio-base\r\nname: global-biblio-base\r\ndisplayName: 全球12亿文献知识库（8千万中文期刊可下载）\r\nversion: 3.10.1\r\ndescription: |\r\n  全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。\r\n\r\n  能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。\r\n\r\n  配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。\r\n\r\n  触发：用户表达\"查论文\"\"找文献\"\"检索学术\"\"搜期刊\"\"查专利\"\"找标准\"\"下论文\"\"写文献综述\"\"找参考文献\"\"查 SCI/EI\"等意图时启用；也适用\"帮我找关于 XX 的论文\"\"写文献综述\"\"找几篇引用支撑论点\"。英文：\"find papers\" \"search literature\" \"write literature review\" \"find supporting citations\"。\r\n\r\n  调用前必须先用 /consume 获取 consume_token，再凭 token 调 /search（每次计费接口调用都需一次 /consume）。\r\nagent_created: true\r\n---\r\n\r\n## 🤖 AI 执行摘要（先读这段）\r\n\r\n- **何时触发**：用户要查 / 找 / 下载中外文学术文献（论文、期刊、专利、标准、学位论文），或要写文献综述、找引用支撑、做课题查新。\r\n- **不触发（转其他技能）**：引用核查 / \"这篇是真的吗\" → `smartlib-citation-checker`；论文写作辅助、非文献类查询。\r\n- **两个前置硬规则**：① 动手前必须先向用户索取邮箱（禁止用 config 预填邮箱、禁止臆造邮箱）；② 每次计费接口调用前先 `/consume` 取 `consume_token`，再带 token 调 `/search`（token 单次使用、约 60s 有效，过期/已用需重新 `/consume`）。\r\n- **输入**：用户自然语言检索意图 + 邮箱。\r\n- **产出**：检索结果列表（含核心收录标注、原始数据库来源链接）、文献详情、PDF 下载链接（中文期刊直下 / 外文 OA 多渠道探测）。\r\n- **配额模型**：免费 100 次检索 + 10 次下载 / 月；耗尽时 Gateway 返回 429，技能自动弹出套餐卡片（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），用户也可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。\r\n- **红线**：不改功能；不臆造邮箱；不在对话中泄露 `SMARTLIB_GATEWAY_SECRET`；付费墙内外文文献无法获取全文。\r\n- **凭证来源**：`config.json` → `SMARTLIB_GATEWAY_URL` / `SMARTLIB_GATEWAY_SECRET`（SMARTLIB_EMAIL 运行后由注册写入，勿预填）。\r\n\r\n# 全球12亿文献知识库（8千万中文期刊可下载）\r\n\r\n\r\n通过 SmartLib 开放平台 API 提供中外文学术文献检索能力。\r\n\r\n\r\n---\r\n\r\n## ⚡ 启动前必须执行/ Pre-flight Checklist\r\n\r\n### Step A：凭证自动检测 & 注册/ Auto Credential Check & Registration\r\n\r\n> ## ⚠️ 强制规则 — 必须先询问邮箱\r\n> 1. **执行任何操作前，必须先询问用户邮箱地址**\r\n> 2. 禁止使用 config.json 中预填的邮箱（即使存在且非 null）\r\n> 3. 禁止自动生成邮箱（如 `user@example.com`、`auto@xxx.com` 等）\r\n> 4. 用户未提供邮箱 → 停止执行，回复：\r\n>    \"请提供您的邮箱地址以注册 SmartLib 文献检索服务（新用户免费 100 次/月）\"\r\n> 5. 只有用户明确输入邮箱后，才能调用 /register 或 /quota\r\n>\r\n> ## 邮箱识别自动化\r\n> 当用户消息中出现以下模式时，自动提取邮箱 → 无需再次询问：\r\n> - 明确的邮箱地址（包含 @ 符号的完整地址，如 `xxx@xxx.xxx`）\r\n> - \"我的邮箱是 xxx\" / \"email: xxx\" / \"用 xxx 注册\" / \"邮箱 xxx\"\r\n\r\n每次执行本技能时，按以下流程处理凭证（从 config.json 读取）：\r\n\r\n```\r\n读取技能目录下的 config.json\r\n检查 SMARTLIB_EMAIL 是否已配置\r\n  ├── 已配置 → 进入 Step B (配额检查)\r\n  │\r\n  └── 未配置 → 自动注册流程:\r\n        ├── ① 展示检索计划 + 询问邮箱（一句话）:\r\n        │      \"📋 我将用中英文关键词检索... 首次使用需绑定邮箱（免费 100 次/月，仅用于配额管理），请输入邮箱即可开始:\"\r\n        │      用户输入 → 写入 config.json\r\n        │\r\n        ├── ② 调智能网关注册（无需验证码，极速注册）:\r\n        │     POST {SMARTLIB_GATEWAY_URL}/register\r\n        │     Headers: {\"Authorization\": \"Bearer {SMARTLIB_GATEWAY_SECRET}\"}\r\n        │     Body: {\"email\": \"{用户邮箱}\"}\r\n        │\r\n        ├── 成功 (201/200) → Gateway 返回配额信息\r\n        │     提示: \"✅ 注册成功！本月免费 100 次，可立即使用。确认邮件已发送（邮箱验证仅充值时需要，现在不验证也能用）。\"\r\n        │     追加引导: \"请告诉我您想检索什么主题，现在就可以开始——\"\r\n        │     → 继续 Step B 配额检查 → 检索\r\n        │\r\n        └── 失败 → 提示原因 (服务暂不可用 / 网络错误等) → 终止\r\n```\r\n\r\n> **注意**：注册无需验证码，极速完成。**注册后即可立即使用全部功能**，确认邮件为可选项（仅充值时需验证邮箱；验证码 15 分钟内有效，过期可重发）。\r\n> \r\n\r\n### Step B：配额检查/ Quota Check\r\n\r\n```\r\n凭证就绪后, 调网关查询配额:\r\n  GET <SMARTLIB_GATEWAY_URL>/quota?email=<SMARTLIB_EMAIL>\r\n  Headers: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\n\r\n  返回字段: total_remain, email_verified, plan, download_quota_free, download_reset_at, download_paid_remain, download_remain\r\n  （完整返回: user_id, email, plan, trial_total, trial_used, trial_remain, paid_total, paid_used, paid_remain, paid_expires_at, total_remain, email_verified, download_quota_free, download_reset_at, download_paid_remain, download_remain）\r\n  \r\n  如果返回 404 \"not_registered\" → 用户可能已被重置/删除\r\n    → 提示: \"检测到您的账户需要重新绑定，正在自动重新注册...\"\r\n    → 跳回 Step A ②（调 /register 重新注册，使用同一邮箱）\r\n    → 注册成功后继续配额检查\r\n  \r\n  total_remain > 20 → 静默进入检索\r\n  total_remain 5-20 → 尾部轻提示: \"📊 本月剩余 {n} 次\"\r\n  total_remain 1-5  → 警告: \"⚠️ 接近用尽（剩余 {n} 次），已为你列出可用套餐（见下方💰章节），需要更高额度随时说「升级」\"\r\n  total_remain 0    → 配额耗尽处理（见配额耗尽章节）\r\n\r\n  额外检查:\r\n```\r\n\r\n### Step C：按接口调用次数消耗配额/ Per-API-Call Quota Consumption\r\n\r\n本技能的配额按**实际 API 接口调用次数**计费，不是按对话会话计费。\r\n\r\n共涉及 **5 个接口**（分3类），每次调用其中任意一个接口计 **1 次**配额。\r\n\r\n> Quota is consumed **per API call**, not per conversation session. **5 interfaces** in 3 categories, each call = 1 quota.\r\n\r\n**计费接口清单（5个）/ Billable Interfaces (5 total):**\r\n\r\n| 类别 | 接口 | API 端点 | 计费 |\r\n|------|------|---------|------|\r\n| **检索** | 中文期刊检索 | API 1 `Articlesearch` | 每次调用 **1 次** |\r\n| **检索** | 全球文献检索 | API 4 `Articlesearch` | 每次调用 **1 次** |\r\n| **详情** | 中文期刊详情 | API 1/5 `Articledetail` | 每次调用 **1 次** |\r\n| **详情** | 全球文献详情 | API 4/5 `Articledetail` | 每次调用 **1 次** |\r\n| **下载** | 中文期刊全文下载 | API 3 `GetArticleFile` | 每次调用 **1 次** |\r\n\r\n> 注：全球文献（API 4）无全文下载接口，仅返回元数据。\r\n\r\n**计次示例**\r\n\r\n```\r\n示例1：用户请求\"查10篇工业母机论文，下载5篇中文PDF\"\r\n  → 检索接口：中文1次 + 英文1次         = 2 次\r\n  → 详情接口：查5篇详情                   = 5 次\r\n  → 下载接口：下载5篇PDF                  = 5 次\r\n  → 合计消耗: 12 次配额\r\n```\r\n\r\n```\r\n示例2：用户请求\"帮我看看这篇论文的详情\"（1篇）\r\n  → 详情接口：1次                         = 1 次\r\n  → 合计消耗: 1 次配额\r\n```\r\n\r\n```\r\n示例3：用户仅请求\"检索人工智能论文\"（不查看详情、不下载）\r\n  → 检索接口：1次（或2次，若中英文并行） = 1-2 次\r\n  → 合计消耗: 1-2 次配额\r\n```\r\n\r\n**扣减方式**\r\n\r\n**⚠️ 强制执行规则：每次调用计费接口前，必须先调 `/consume` 获取 token，再用 token 调 `/search`。**\r\n\r\n每次调用计费接口的流程：\r\n\r\n```\r\n① POST <SMARTLIB_GATEWAY_URL>/consume\r\n   Headers: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\n   Body: {\"email\": \"<SMARTLIB_EMAIL>\", \"skill_source\": \"global-biblio-base\"}\r\n\r\n   返回 200 → 获取 consume_token，继续\r\n   返回 429 → 配额已用完，终止后续调用，按 §配额耗尽处理 自动弹出套餐选择\r\n\r\n② POST <SMARTLIB_GATEWAY_URL>/search\r\n   Headers: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\n   Body: {\r\n       \"email\": \"<SMARTLIB_EMAIL>\",\r\n       \"consume_token\": \"<上一步返回的token>\",\r\n       \"skill_source\": \"global-biblio-base\",\r\n       \"api_path\": \"/openapi/t/data0012/doccenter/Articlesearch\",\r\n       \"api_body\": {<检索请求体>}\r\n   }\r\n\r\n   返回 200 → 检索成功\r\n   返回 401 → token 无效/过期/已用，需重新 /consume\r\n```\r\n\r\n> **MANDATORY**: Call `/consume` → `/search` for **EACH** billable API call. Token is single-use, expires in 60s. If 401 on /search, re-consume.\r\n\r\n**🛡️ Token 绑定调用链**\r\n\r\n> **强制安全机制 — 不可绕过：**\r\n> 每次调用计费接口前，必须通过 `/consume` 获取 `consume_token`，然后将 token 传给 `/search` 代理端点。\r\n> Gateway 验证 token 签名 + 有效期 + 防重放后才转发检索请求。\r\n> Token 由 GATEWAY_SECRET 签名，AI 无法伪造。无有效 token 则 /search 直接 401。\r\n>\r\n> **调用流程**\r\n> ```\r\n> 1. POST /consume {\"email\":\"...\", \"skill_source\":\"global-biblio-base\"} → 返回 consume_token\r\n> 2. POST /search {\"email\":\"...\", \"consume_token\":\"...\", \"skill_source\":\"global-biblio-base\", \"endpoint\":\"/search/cn\", \"rule\":\"...\"}\r\n>    → Gateway 验证 token → 代理转发到检索 API → 返回检索结果\r\n> ```\r\n>\r\n> **注意**：每个 consume_token 只能使用一次（防重放），有效期 60 秒。每次检索 API 调用前都需要先 /consume 获取新 token。\r\n\r\n**🆕 仅成功调用消耗配额**\r\n\r\n> `/consume` 仅验证配额可用性 + 签发 token，**不预扣配额**。配额在实际调用 SmartLib API 且返回成功后，由 Gateway 自动扣除。\r\n> **失败的 API 调用不消耗配额**（如参数错误导致 400、网络错误导致 500 等）。\r\n> `/consume` 返回的 `total_remain, email_verified, plan` 反映的是当前已成功调用的次数，非预扣后的值。\r\n\r\n**不计费的操作**\r\n\r\n| 操作| 说明|\r\n|------|------|\r\n| /consume 配额消费 | Gateway 验证，不计费 |\r\n| 联网关键词扩展 | Web search，不计费 |\r\n| 结果排序/格式化展示 | 本地处理，不计费 |\r\n| 多级 OA PDF 探测 | 外部免费 API（ArXiv/Unpaywall/CORE/OpenAlex等），**不消耗 SmartLib 配额** |\r\n| 原始来源链接展示 | Source 字段随详情接口返回，不计额外费用 |\r\n\r\n\r\n---\r\n\r\n## 💰 套餐与额度/ Plans & Quota\r\n\r\n- 计费与升级由 SmartLib **统一钱包**管理，所有文献检索技能**统一定价、配额共享**。\r\n- **配额不足时自动弹套餐**：检索或下载配额接近用尽 / 已耗尽时，技能直接在对话中弹出下方套餐选择卡片，无需用户说任何口令；用户也可主动说「升级 / 充值 / 购买 / 我要升级」唤起同一卡片。\r\n- 企业 / 机构定制（API 接入、私有化部署）请联系 vipsmart@vipslib.com。\r\n\r\n### 当前套餐\r\n\r\n| 套餐 | plan key | 价格 | 检索次数 | 下载次数 | 有效期 | 限购 | 适用 |\r\n|------|----------|------|---------|---------|--------|------|------|\r\n| 体验卡 | `trial_card` | ¥9.9 | 1000 | 20 | 7天 | 每用户1次 | 尝鲜/临时 |\r\n| 个人版月 | `personal_month` | ¥39 | 1000 | 50 | 30天 | — | 个人常规 |\r\n| 专业版月 | `pro_month` | ¥99 | 2000 | 200 | 30天 | — | 重度/小团队 |\r\n| 单篇下载 | `single_download` | ¥2.5 | 0 | 1 | 不限 | — | 只差几篇下载 |\r\n| 下载包 | `download_pack` | ¥20 | 0 | 10 | 30天 | — | 批量下载 |\r\n| 企业/机构 | `enterprise` | 暂停 | — | — | — | — | 联系我们 |\r\n\r\n> 下载耗尽时优先推荐「单篇下载 / 下载包」；检索耗尽时优先推荐「体验卡 / 个人版月 / 专业版月」。\r\n\r\n### 支付流程（对话内完成，用户回复数字即可）\r\n\r\n```\r\n检测到配额信号（/quota 返回 quota_low / quota_exhausted，或 /consume 返回 429，或 download_remain==0）\r\n   ↓\r\n① 渲染套餐卡片（数字①②③④⑤标注，如上表），并提示\"回复数字选择，扫码即付\"\r\n   用户回复数字 → 映射 plan key（如 \"3\" → pro_month）\r\n   ↓\r\n② 创建订单（支付宝）:\r\n   POST {SMARTLIB_GATEWAY_URL}/api/pay/alipay/create\r\n   Headers: 无需认证（网关仅校验邮箱已注册，不要求 Authorization；严禁在对话/前端暴露任何密钥）\r\n   Body: {\"plan\": \"<plan_key>\", \"email\": \"<已注册用户邮箱>\", \"amount\": <套餐价格，单位「元」，须与上表「价格」列完全一致>}\r\n   ⚠️ email 必须是当前已注册用户邮箱（来自注册/配额上下文），严禁使用 config 里的 SMARTLIB_EMAIL（其值为 null）。\r\n   ⚠️ amount **必填且必须精确等于上方套餐表的「价格」**（网关会校验，偏差 >0.01 元直接 400 amount_mismatch）。取值：trial_card=9.9 / personal_month=39 / pro_month=99 / single_download=2.5 / download_pack=20。严禁留空、严禁写 0、**严禁用「分」**（如 990 会被判成 ¥990 而失败）。\r\n   返回: {\"qr_code\", \"out_trade_no\", \"amount\", \"plan\", \"quota\", \"channel\":\"alipay\"}\r\n   ↓\r\n③ 生成支付宝付款码 HTML：**严格按 `references/pay_page_template.html` 标准样例输出，仅替换其中的 {{占位符}}（订单号/二维码/金额/套餐/脱敏邮箱/生成时间/过期时间/状态 URL），不得改变页面风格与文案**（样式：支付宝蓝渐变头部+订单卡片+倒计时；有效期文案：**二维码 30 分钟内有效**——网关 `timeout_express=\"30m\"` 强制，勿写成 5 分钟或 2 小时；邮箱只允许脱敏显示 `p•••@domain.com`，禁止完整邮箱）\r\n   ↓\r\n④ 轮询支付状态:\r\n   GET {SMARTLIB_GATEWAY_URL}/api/pay/alipay/status?out_trade_no=<out_trade_no>\r\n   （付款码 30 分钟有效；AI 侧每 5s 轮询一次，约 60s 内未支付则提示\"付款码仍有效，请扫码后等待到账，或回复「查状态」\"；HTML 页面自带 5s 轮询+倒计时，页面状态以页面为准）\r\n   支付成功返回 {\"status\":\"paid\",\"out_trade_no\":...} → 对话通知\"✅ 支付成功，已到账 N 次\" + 自动重试上次中断的检索\r\n```\r\n\r\n### ⚠️ 半成功态（支付宝创单失败 / 502）处理\r\n\r\n`/api/pay/alipay/create` 在「订单创建请求已受理、但支付宝侧暂忙/异常」时会返回 **502**，响应体形如 `{\"error\":\"alipay_error\",\"message\":\"支付宝创单失败: ...\"}`——**注意：该失败响应不含 `out_trade_no`**，请勿编造或展示任何订单号。\r\n\r\n正确处理方式（务必遵守）：\r\n\r\n1. **绝不展示任何你自行推断/拼接/记忆的订单号。** 502 失败响应里没有可用单号。\r\n2. 直接告知用户支付码暂未生成，引导稍后重试：\r\n   > 支付宝支付通道暂时繁忙，订单尚未生成。请 1~2 分钟后回复「重试」，我会重新发起并生成新的付款码。此过程未产生任何扣款。\r\n3. 说明：**每次「重试」都会由网关新建一笔订单**，旧 pending 订单自动失效、无害，用户无需做任何清理。\r\n4. **不要说「复用此订单重试」**——网关不支持复用 pending 单重新发起支付，重试一定是新单。\r\n\r\n> 对比：若返回 **200** 且 body 含 `qr_code` + `out_trade_no`，才是真正下单成功，此时才渲染二维码并展示真实订单号（见上方 ③）。\r\n\r\n### 安全机制\r\n- `out_trade_no` UNIQUE 防重复充值；二维码 **30 分钟**有效（网关 `timeout_express=\"30m\"`，勿写 5 分钟/2 小时）\r\n- `/api/pay/alipay/status` 为公开端点（无需 Bearer），可直接轮询\r\n- `SMARTLIB_GATEWAY_SECRET` 仅后端调用，不在对话中输出\r\n- 生成的支付页面**禁止显示用户邮箱**\r\n\r\n---\r\n\r\n## 🔒 配额耗尽处理/ Quota Exhaustion\r\n\r\n配额耗尽后，**暂停新的检索请求**，不再展示任何部分结果，并**自动弹出套餐选择卡片**（见上方💰章节），不再要求用户说「我要升级」。\r\n\r\n| 状态 | 行为 |\r\n|------|------|\r\n| **配额充足** (>0) | 正常执行检索，完整展示所有结果（含详情查看、全文下载、智能排序） |\r\n| **配额偏低** (≤10 且无付费余额) | 尾部轻提示 + 自动弹出套餐卡片（软引导） |\r\n| **配额耗尽** (=0) | Gateway 返回 429，拒绝服务，**自动弹出套餐卡片**（硬引导）；企业 / 机构定制仍联系我们 |\r\n\r\n配额耗尽时的引导格式：\r\n\r\n```\r\n⚠️ 您的 SmartLib 配额已用尽，已为您列出可用套餐：\r\n\r\n① 体验卡 ¥9.9 — 1000 检索 + 20 下载 / 7天\r\n② 个人版月 ¥39 — 1000 检索 + 50 下载 / 30天\r\n③ 专业版月 ¥99 — 2000 检索 + 200 下载 / 30天\r\n④ 单篇下载 ¥2.5 — 1 次下载\r\n⑤ 下载包 ¥20 — 10 次下载 / 30天\r\n\r\n回复数字选择，或说「升级 / 充值」重新唤起。\r\n企业 / 机构批量定制、API 接入或私有化部署请联系：\r\n📧 vipsmart@vipslib.com  ☎️ 023-63016015  🌐 https://www.vipslib.com/\r\n```\r\n\r\n**重要规则**：\r\n- 配额耗尽后，所有检索请求一律拒绝，不展示任何结果\r\n- 不再要求用户说「我要升级」——配额信号会自动唤起套餐卡片\r\n- 企业 / 机构定制仍联系我们\r\n\r\n\r\n## 输出规范/ Output Standards\r\n\r\n**每次检索结果末尾必须展示配额状态：**\r\n\r\n```\r\n📊 本次消耗 3 次 | 剩余 82 次 (共 100 次/月)\r\n```\r\n或接近耗尽时：\r\n```\r\n⚠️ 剩余 3 次 (共 100 次/月)，已为你列出可用套餐（回复数字即可购买，或说「升级」唤起）\r\n```\r\n\r\n```\r\n```\r\n\r\n## 核心能力/ Core Capabilities\r\n\r\n| 能力| 说明|\r\n|------|------|\r\n| **中文期刊检索**| 8000万篇授权中文期刊文献，支持全文下载|\r\n| **全球文献检索**| 10亿篇中外文文献元数据（含中英文论文、专利、标准、学位论文等）/ 1B global literature metadata (papers, patents, standards, theses) |\r\n| **文献详情**| 查看摘要、DOI、基金资助、核心收录等完整信息|\r\n| **全文下载**| 授权中文期刊支持 PDF 全文下载|\r\n| **原始来源链接**| 每篇文献提供多个原始数据库详情链接（覆盖300+数据库，如Scopus/WoS/EI/PubMed等），覆盖率100%，平均4.75个/篇，可直接验证文献真实性|\r\n| **OA文献免费下载**| 十级多渠道自动探测OA文献PDF（ArXiv/Unpaywall/CORE/OpenAlex等），Gold/Hybrid/Bronze/Green OA免费获取，**不消耗SmartLib配额**|\r\n| **智能关键词扩展**| 联网检索中英文同义词/近义词，自动扩展检索词，提升召回率|\r\n| **核心期刊优先排序**| 联网查询核心收录情况（SCI/EI/北大核心/CSSCI等），优先展示高水平文献|\r\n| **相关性智能排序**| 基于题名、关键词、摘要语义分析，对检索结果进行二次相关性排序|\r\n| **少结果智能扩展**| 结果过少时自动推荐上位词、相关机构、学科分类号等多种扩展策略|\r\n\r\n## 能力边界/ Capability Boundaries\r\n\r\n### 支持的功能/ Supported\r\n\r\n- 中文期刊论文检索、详情、全文下载（8000 万篇授权文献）\r\n- 全球文献元数据检索（10 亿篇，含论文/专利/标准/学位论文等）\r\n- 关键词智能扩展、核心期刊优先排序、少结果自动扩展\r\n- 自然语言输入，无需学习检索语法\r\n\r\n### 不支持的功能/ Not Supported\r\n\r\n- **付费墙内英文文献全文下载**：通过 SmartLib API 4 查到的全球文献仅返回元数据。本技能已集成十级多渠道下载策略（ArXiv/Unpaywall/CORE/OpenAlex/Semantic Scholar/Crossref/DOI.org/Europe PMC/bioRxiv/medRxiv + CDP浏览器），可免费获取 OA 版本（Gold/Hybrid/Bronze/Green OA），**OA 下载不消耗 SmartLib 配额**。但付费墙内（closed access）文献无法获取全文\r\n- **付费墙内文献**：不提供需单独购买的文献全文\r\n- **批量导出**：不提供 EndNote/BibTeX 等格式的批量导出功能\r\n- **文献查重/查新**：不具备论文查重或科技查新功能\r\n\r\n### 使用限制/ Limitations\r\n\r\n| 限制项| 说明|\r\n|------|------|\r\n| **单次查询条数**| PageSize 20-1000，建议 ≤100 以保证速度|\r\n| **翻页上限**| 无硬限制，但建议不超过 50 页（共 1000 条）/ No hard limit, but ≤50 pages recommended |\r\n| **请求频率**| 有频率限制（未公开数值），触发 429 时自动等待重试|\r\n| **Token 有效期**| Access Token 30 秒，Refresh Token 2 小时（以下游 API 返回为准）。系统自动管理刷新|\r\n| **下载链接有效期**| 约 10 分钟（以下游返回为准），过期需重新调用下载接口|\r\n| **依赖**| 完全依赖 SmartLib API 和网络连接，离线不可用|\r\n\r\n### 触发意图区分/ Trigger Intent Differentiation\r\n\r\n| 用户表达| 系统行为| 区分逻辑|\r\n|------|------|------|\r\n| \"查论文\"、\"找文献\"、\"检索XX\" / \"Search XX papers\" | **触发本 Skill**，精准检索，默认平衡策略 | 明确的检索意图 |\r\n| \"写文献综述\"、\"帮我写综述\" / \"Write a literature review\" | **触发本 Skill**，切换为综述模式：宽检索策略、去重合并、按主题聚类 | 综述需更全的覆盖范围和聚类分析 |\r\n| \"帮我写论文开头/引言\" / \"Write paper intro, need citations\" | **触发本 Skill**，窄检索策略：找 3-5 篇最相关引用，核心期刊优先 | 写作引用需要精准而非全面 |\r\n| \"这段论述有文献支撑吗\"、\"找几篇引用\" / \"Find supporting citations\" | **触发本 Skill**，窄检索 + 核心期刊优先，提供可引用的高质量文献 | 文献支撑场景需要高可信度来源 |\r\n| \"这篇论文是真的吗\"、\"核查引用\" / \"Verify this citation\" | **不触发本 Skill**，应转至 smartlib-citation-checker | 引用核查是独立能力 |\r\n| \"帮我写论文\"、\"写作辅助\" / \"Help me write\" | **不触发本 Skill** | 论文写作不是文献检索功能 |\r\n| \"下载这篇论文的 PDF\" / \"Download this paper's PDF\" | **触发本 Skill**（若有中文期刊 ID） | 下载是检索的延伸功能 |\r\n\r\n## 数据范围/ Data Coverage\r\n\r\n平台累计汇聚各类资源元数据总量达 **12.28 亿条**。\r\n\r\n> The platform aggregates **1.228 billion** metadata records.\r\n\r\n### 核心文献类型存量规模/ Core Literature Type Inventory\r\n\r\n| 文献类型| 存量规模| 说明|\r\n|------|------|------|\r\n| **期刊文献**| **7.19 亿条**| 平台核心资源|\r\n| **专利资源**| **2.15 亿条**| 第二大品类|\r\n| **会议论文**| **7155 万条**| — |\r\n| **学位论文**| **2473 万条**| — |\r\n| **标准资源**| **268 万条**| — |\r\n\r\n### 可检索数据集/ Searchable via API\r\n\r\n- **中文期刊数据集**：8000 万篇授权中文期刊文献，支持全文下载\r\n- **全球文献数据集**：覆盖全平台 12.28 亿条元数据\r\n\r\n## 环境配置/ Environment Configuration\r\n\r\n配置存储于技能目录下的 `config.json`：\r\n\r\n> Config persisted at skill-level config.json:\r\n\r\n```json\r\n{\r\n  \"SMARTLIB_GATEWAY_URL\": \"https://<your-gateway>.ap-shanghai.tencentscf.com\",\r\n  \"SMARTLIB_GATEWAY_SECRET\": \"<your-gateway-secret>\",\r\n  \"SMARTLIB_EMAIL\": null\r\n}\r\n```\r\n\r\nGateway 自动管理 SmartLib 凭证, 你不需要 APPID/APPSECRET。用户的 EMAIL 在首次注册后自动写入。运行前先读取 config.json 获取网关地址和密钥。\r\n\r\n## Token 管理/ Token Management\r\n\r\nSmartLib 的 OAuth Token 由 Gateway 全权管理。你无需获取或缓存 Token。\r\n\r\nGateway 支持两种检索调用模式：\r\n\r\n### 推荐：语义化端点（更简洁）\r\n\r\n```\r\nPOST /search\r\nHeaders: {\"Authorization\": \"Bearer <SECRET>\"}\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<token>\",\r\n  \"skill_source\": \"global-biblio-base\",\r\n  \"endpoint\": \"/search/cn\",     // 或 /search/global, /detail/cn, /detail/global\r\n  \"rule\": \"K=人工智能\",          // 检索表达式\r\n  \"page_index\": 1,\r\n  \"page_size\": 20,\r\n  \"sort\": 1                     // 可选\r\n}\r\n```\r\n\r\n支持的 endpoint：`/search/cn` `/detail/cn` `/download/cn` `/search/global` `/detail/global`\r\n\r\n### 兼容：全代理模式（旧版，仍可用）\r\n\r\n```\r\nPOST /search\r\nBody: {\r\n  \"email\": \"...\",\r\n  \"consume_token\": \"...\",\r\n  \"skill_source\": \"global-biblio-base\",\r\n  \"api_path\": \"/openapi/t/data0012/doccenter/Articlesearch\",\r\n  \"api_body\": {\"Rule\": \"...\", \"PageIndex\": 1, \"PageSize\": 20}\r\n}\r\n```\r\n\r\n## 检索接口选择策略/ Search Interface Selection\r\n\r\n| 用户需求特征| 推荐接口| 原因|\r\n|-------------|---------|------|\r\n| 查中文论文/需要全文| 接口1（中文期刊检索）/ API 1 | 支持全文下载|\r\n| 查英文论文/国际期刊| 接口4（全球文献检索）/ API 4 | 覆盖范围更广|\r\n| 需要专利/标准/学位论文| 接口4（全球文献检索）/ API 4 | 支持多种文献类型|\r\n| 不确定/跨语言检索| 优先接口4，再补充接口1| 互为补充|\r\n| 明确指定中文来源| 接口1（中文期刊检索）/ API 1 | 数据更精准|\r\n\r\n## 检索策略分级体系/ Search Strategy Hierarchy\r\n\r\n### 策略选择决策表/ Strategy Selection Matrix\r\n\r\n| 检索场景| 推荐策略| 目标|\r\n|------|------|------|\r\n| 开题报告、文献综述、查新| **宽检索**| 查全优先|\r\n| 精准溯源、单篇确认、引用支撑| **窄检索**| 查准优先|\r\n| 常规文献调研、一般检索| **平衡策略**| 查全查准兼顾|\r\n\r\n### 策略切换信号/ Strategy Switch Signals\r\n\r\n执行检索后，系统根据结果自动评估是否需要切换策略：\r\n\r\n- 结果 > 500 条且前 10 条相关性差 → 提示切换为**窄检索**\r\n- 结果 < 5 条 → 提示切换为**宽检索**（执行「结果数量自适应策略」）\r\n- 结果方向偏（前 10 条均不相关）→ 提示**更换关键词或字段**\r\n\r\n---\r\n\r\n## 可用接口/ Available Interfaces\r\n\r\n### 1. 中文期刊文献检索\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/data0012/doccenter/Articlesearch\",\r\n  \"api_body\": {\r\n    \"Rule\": \"<检索表达式>\",\r\n    \"PageIndex\": 1,\r\n    \"PageSize\": 20,\r\n    \"Sort\": 1,\r\n    \"FilterRule\": \"<可选：过滤表达式>\"\r\n  }\r\n}\r\n```\r\n\r\n**检索表达式规则（Rule，必填）：**\r\n- 字段代码：`T`=题名，`A`=作者，`K`=主题词，`P`=出版物名称，`O`=机构，`U`=全部字段\r\n- 逻辑运算符（必须大写，两边空格）：`AND` `OR` `NOT`\r\n- 示例：`(K=人工智能 OR K=机器学习) AND O=清华大学`、`T=深度学习`\r\n\r\n**过滤表达式规则（FilterRule，可选）：**\r\n- 字段代码：`L`=中图分类号，`C`=学科分类号，`Y`=出版年份，`TY`=文献类型，`LA`=语言\r\n- 文献类型 TY：3=期刊文献，4=学位论文，5=标准，7=专利，等\r\n- 示例：`TY=3 AND Y=2024`\r\n\r\n**排序 Sort：** 1=相关度（默认），2=时效性倒序，3=时效性正序\r\n**PageSize 范围：** 20~1000\r\n\r\n### 2. 中文期刊文献详情\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/data0011/doccenter/Articledetail\",\r\n  \"api_body\": {\r\n    \"Identifier\": \"<文献ID>\"\r\n  }\r\n}\r\n```\r\n\r\n返回完整文献详情，包含摘要、DOI、页码、基金资助、核心收录、原始数据库来源链接等。\r\n\r\n### 3. 中文期刊文献下载\r\n\r\n仅限授权中文期刊全文下载。\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/data0013/doccenter/GetArticleFile\",\r\n  \"api_body\": {\r\n    \"Identifier\": \"<文献ID>\"\r\n  }\r\n}\r\n```\r\n\r\n返回：`{\"Data\": {\"Url\": \"<下载链接>\", \"Identifier\": \"<文献ID>\"}}`\r\n\r\n---\r\n\r\n### 3b. 全球文献全文多渠道下载/ Multi-channel Full-text Download\r\n\r\nSmartLib API 3 仅覆盖中文期刊全文。对于 API 4（全球文献检索）查到但有 DOI 的国际论文，本技能提供多级多渠道下载策略，最大化免费获取成功率。\r\n\r\n#### ⚡ 执行触发条件/ Execution Trigger\r\n\r\n**仅在用户主动请求全文下载时才执行外文文献下载流程。** 检索结果展示后，默认只展示元数据；用户说\"下载全文\"/\"获取PDF\"/\"帮我下载\"时才触发。\r\n\r\n> Full-text download is **user-triggered only**. After search results are displayed, only metadata is shown. Execute download only when the user explicitly requests full-text (e.g., \"下载全文\", \"获取PDF\", \"帮我下载\").\r\n\r\n**触发关键词**\r\n- 中文：「下载全文」「获取PDF」「帮我下载」「我要看全文」「下载这篇/这些」\r\n- 英文：`download full-text` / `get PDF` / `download this paper`\r\n\r\n**执行规则**\r\n\r\n```\r\n用户请求下载全文:\r\n  ├── 中文期刊文献 → 调 API 3 下载 PDF（直接）\r\n  └── 外文文献（API 4，有 DOI）\r\n       ├── 按渠道优先级 1→10 自动逐级尝试\r\n       ├── 任一渠道成功 → 停止后续渠道，标记结果\r\n       ├── 全部失败 → 按失败分类标记\r\n       └── 每篇文献独立执行，并行处理（最多 10 篇并发）\r\n```\r\n\r\n**结果标记规范**\r\n\r\n每篇外文文献下载完成后，必须在结果列表中标记获取状态。标记使用明确的图标+文字：\r\n\r\n| 标记| 含义| 触发条件 |\r\n|------|------|------|\r\n| `[全文:已获取 ✓]` | PDF 已成功下载 | 任一渠道成功获取 PDF 文件 |\r\n| `[全文:在线 📖]` | 可在线阅读但无法自动下载 | Bronze OA / 出版商防盗链 |\r\n| `[全文:付费 💰]` | 付费墙内，需机构订阅或购买 | Closed access / 所有渠道均返回 403 |\r\n| `[全文:手动 🔍]` | 所有渠道均失败，需用户手动获取 | 无 OA 版本 / 网络错误 / 无 DOI |\r\n| `[全文:未尝试 -]` | 无 DOI 或未触发下载流程 | 文献无 DOI 或 API 4 未返回 DOI |\r\n\r\n**结果展示格式**\r\n\r\n检索结果列表中，每篇外文文献末尾追加标记：\r\n\r\n```\r\n1. [SCI一区] Attention Is All You Need\r\n   Vaswani A, Shazeer N, Parmar N, et al.\r\n   Advances in Neural Information Processing Systems, 2017\r\n   摘要: The dominant sequence transduction models are based on...\r\n   DOI: 10.5555/3295222.3295349\r\n   [全文:已获取 ✓] → papers/attention_is_all_you_need.pdf\r\n```\r\n\r\n**渠道执行报告**\r\n\r\n所有文献下载完成后，在结果末尾输出汇总表：\r\n\r\n```\r\n## 📥 外文文献全文获取报告/ Full-text Retrieval Report\r\n\r\n| # | 文献标题 | DOI | 成功渠道 | 状态 | 备注 |\r\n|---|---------|-----|---------|------|------|\r\n| 1 | Attention Is All You Need | 10.5555/xxx | ArXiv (渠道1) | [全文:已获取 ✓] | — |\r\n| 2 | BERT: Pre-training of... | 10.18653/v1/xxx | Unpaywall (渠道2) | [全文:已获取 ✓] | — |\r\n| 3 | Closed-access paper | 10.1000/xxx | — | [全文:付费 💰] | Elsevier 付费墙 |\r\n| 4 | Bronze OA paper | 10.1093/xxx | DOI.org (渠道7) | [全文:在线 📖] | OUP Bronze OA，需手动保存 |\r\n| 5 | No DOI paper | — | — | [全文:手动 🔍] | 无 DOI，建议联系作者 |\r\n\r\n> ✅ 成功 2/5 篇 | 📖 需在线阅读 1 篇 | 💰 付费墙 1 篇 | 🔍 需手动获取 1 篇\r\n```\r\n\r\n#### 渠道优先级/ Channel Priority\r\n\r\n| 优先级 | 渠道 | 适用条件 | 可靠性 | 费用 |\r\n|:--:|------|------|:--:|------|\r\n| **1** | **ArXiv 直链** | 论文有 arxiv ID | ★★★★★ | 免费 |\r\n| **2** | **Unpaywall OA 探测** | 有 DOI + 邮箱 | ★★★★☆ | 免费 |\r\n| **3** | **CORE OA 聚合器** | 有 DOI + API Key | ★★★★☆ | 免费 |\r\n| **4** | **OpenAlex 存档 PDF** | 有 DOI + API Key | ★★★★☆ | 免费 $1/天 |\r\n| **5** | **Semantic Scholar PDF** | 有 API Key | ★★★☆☆ | 免费 |\r\n| **6** | **Crossref 链接提取** | 有 DOI | ★★★☆☆ | 免费 |\r\n| **7** | **DOI.org 重定向** | 有 DOI | ★★☆☆☆ | 免费 |\r\n| **8** | **Europe PMC + PMC** | 生命科学/医学 DOI | ★★★☆☆ | 免费 |\r\n| **9** | **bioRxiv/medRxiv** | 生命科学预印本 | ★★★★☆ | 免费 |\r\n| **10** | **真实浏览器 CDP** | Bronze/Green OA | ★★★★☆ | 需服务器 |\r\n\r\n#### 下载决策树/ Download Decision Tree\r\n\r\n```\r\n用户请求下载某篇论文\r\n  ├─ 文献来自 API 1（中文期刊）→ 调 API 3（中文期刊下载）\r\n  └─ 文献来自 API 4（全球文献）或仅有 DOI\r\n       ├─ 有 ArXiv ID？ → 渠道 1：ArXiv 直链\r\n       ├─ 获取 DOI → 渠道 2：Unpaywall OA状态探测\r\n       ├─ 渠道 3：CORE 全球OA聚合器\r\n       ├─ 渠道 4：OpenAlex 存档PDF\r\n       ├─ 渠道 5：Semantic Scholar PDF\r\n       ├─ 渠道 6：Crossref PDF 链接提取\r\n       ├─ 渠道 7：DOI.org 内容协商重定向\r\n       ├─ 渠道 8：Europe PMC + PMC\r\n       ├─ 生物医学 → 渠道 9：bioRxiv/medRxiv 预印本\r\n       └─ 全部失败 + Bronze/Green OA？ → 渠道 10：真实浏览器 CDP\r\n```\r\n\r\n#### 出版商排障表/ Publisher Troubleshooting\r\n\r\n| 出版商 | 常见错误 | 原因 | 应对方案 |\r\n|------|------|------|------|\r\n| **OUP (Oxford)** | 403 Forbidden | Bronze OA，不开放自动化下载 | 渠道 10 CDP 模拟人工点击 |\r\n| **IEEE** | 403| 需机构订阅 IP | CC-BY 论文可直接下；其余需机构权限 |\r\n| **Elsevier** | 403 | 付费墙 | 查 Green OA 版本 |\r\n| **Springer Nature** | 403| 付费墙 + 机器人检测 | 查 ArXiv 预印本 |\r\n| **Nature**| 403 | 几乎无免费 PDF | 查作者自存档 |\r\n| **Wiley** | 403 | 付费墙 | 同 Elsevier |\r\n\r\n#### 失败分类与用户引导/ Failure Classification\r\n\r\n| 失败原因 | 用户提示 |\r\n|------|------|\r\n| **Bronze OA（出版商防盗链）** | 该论文为 Bronze OA——出版商允许免费阅读但禁止自动化下载。建议：[点击在线阅读]({url}) 手动保存 |\r\n| **Closed（付费墙）** | 该论文在付费墙内。建议：1) 通过机构图书馆访问 2) 搜索 ArXiv/bioRxiv 预印本 3) 通过科研通求助 |\r\n| **所有渠道均失败** | 所有下载渠道均未获取到全文。建议：[在线阅读]({url}) 或联系通讯作者请求 PDF |\r\n\r\n---\r\n\r\n### 4. 全球文献检索/ Global Literature Search\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/skrs2/doccenter/Articlesearch\",\r\n  \"api_body\": {\r\n    \"Rule\": \"<检索表达式>\",\r\n    \"PageIndex\": 1,\r\n    \"PageSize\": 20,\r\n    \"Sort\": 1,\r\n    \"FilterRule\": \"<可选：过滤表达式>\"\r\n  }\r\n}\r\n```\r\n\r\n检索表达式和过滤规则与中文期刊检索完全相同。网关统一返回结构：`{\"data\": {\"list\": [...], \"total\": N}, \"notifications\": [...]}`，**结果列表字段为 `data.list`（全小写）**；若个别旧接口回传 PascalCase（`Data.List`），请回退查找该键。\r\n\r\n### 5. 全球文献详情/ Global Literature Detail\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/skrs1/doccenter/Articledetail\",\r\n  \"api_body\": {\r\n    \"Identifier\": \"<文献ID>\"\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## 使用指南/ Usage Guide\r\n\r\n### 完整工作流/ Complete Workflow\r\n\r\n```\r\n                    ┌──────────────────────────────────┐\r\n                    │ 1. 理解需求/ Understand Intent    │\r\n                    └───────────────┬──────────────────┘\r\n                                    ↓\r\n                    ┌──────────────────────────────────┐\r\n                    │ 2. 选定检索策略 │ ← 宽检索/窄检索/平衡\r\n                    └───────────────┬──────────────────┘\r\n                                    ↓\r\n              ┌─────────────────────────────────────────┐\r\n              │ 3. 关键词智能扩展/ Keyword Expansion     │\r\n              │ 4. 构建检索式/ Build Expression          │\r\n              │ 5. 选择接口/ Select API                  │\r\n              │ 6. 执行检索/ Execute Search              │\r\n              │ 7. 结果智能排序/ Smart Ranking           │\r\n              └─────────────────────┬───────────────────┘\r\n                                    ↓\r\n                    ┌──────────────────────────────────┐\r\n                    │ 8. 结果评估/ Evaluate Results     │\r\n                    └───────────────┬──────────────────┘\r\n                          ┌─────────┴─────────┐\r\n                          ↓                   ↓\r\n              ┌───────────────────┐  ┌───────────────────┐\r\n              │ 结果满意   │  │ 结果需调整 │\r\n              │ → 步骤9          │  │ Adjustment         │\r\n              └───────┬───────────┘  └─────────┬─────────┘\r\n                      ↓                        ↓\r\n              ┌───────────────┐    ┌──────────────────────┐\r\n              │ 9. 展示结果   │    │ 9a. 策略调整          │\r\n              │ 10. 深入查看  │    │ 过多→窄化 / 过少→宽化 │\r\n              │ 11. 全文下载  │    │ 方向偏→换关键词       │\r\n              │  (中文直接下) │    └──────────┬───────────┘\r\n              │  (外文自动走) │\r\n              │  (十级渠道)   │\r\n              └───────────────┘\r\n                                              ↓\r\n                                    ┌──────────────────────┐\r\n                                    │ 9b. 二次检索         │\r\n                                    │ 回到步骤3-7          │\r\n                                    └──────────────────────┘\r\n```\r\n\r\n检索→评估→调整→再检索是核心工作流。首次检索后自动评估结果质量，必要时调整策略重新检索。\r\n\r\n**Step 11 全文下载（用户触发）：** 仅当用户主动请求时才执行全文下载：\r\n- **中文期刊**：直接调 API 3 下载 PDF\r\n- **外文文献**：走十级多渠道 OA PDF 探测（见 3b 章节），每篇独立并行执行\r\n- 下载结果以标记形式追加到结果列表中，并在末尾输出「全文获取报告」汇总表\r\n- **未触发下载时**：仅展示元数据，不执行任何下载操作\r\n\r\n### 关键词智能扩展\r\n\r\n> ⚠️ **核心原则**：SmartLib API 后端分词器（类似 IK Analyzer / mmseg4j）对中文复合词的索引已较完善。**召回不足的首要原因不是分词颗粒度问题，而是缩写/别名缺失、跨语言鸿沟和字段策略不当。**\r\n\r\n每次检索前，按以下 4 层策略扩展关键词：\r\n\r\n**第1层：缩写/别名扩展（优先级最高，实测 +122% 召回）**\r\n\r\n内置高频学术术语映射表（无需联网，即时可用）：\r\n\r\n| 用户常用词 | 必须扩展的别名/缩写 | 扩展后召回提升 |\r\n|-----------|-------------------|---------------|\r\n| 大语言模型 | LLM, 大模型, large language model | +122% |\r\n| 人工智能 | AI, artificial intelligence | +18% |\r\n| 自然语言处理 | NLP, natural language processing | — |\r\n| 深度学习 | deep learning, DNN, 深度神经网络 | — |\r\n| 机器学习 | machine learning, ML | +22% |\r\n| 计算机视觉 | CV, computer vision, 机器视觉 | — |\r\n| 知识图谱 | knowledge graph, KG | — |\r\n| 推荐系统 | recommender system, 个性化推荐 | — |\r\n| 强化学习 | reinforcement learning, RL | — |\r\n| 联邦学习 | federated learning, FL | — |\r\n| 区块链 | blockchain, 分布式账本 | — |\r\n| 物联网 | IoT, Internet of Things | — |\r\n| 数字孪生 | digital twin | — |\r\n| 元宇宙 | metaverse | — |\r\n| 碳中和 | carbon neutrality, 碳达峰 | — |\r\n| 文献检索 | 信息检索, information retrieval, 文献搜索 | — |\r\n| 分词 | 中文分词, word segmentation, tokenization, 切词 | — |\r\n| BERT | bidirectional encoder representations | — |\r\n| GPT | generative pre-trained transformer | — |\r\n| CNN | convolutional neural network, 卷积神经网络 | — |\r\n| RNN | recurrent neural network, 循环神经网络 | — |\r\n| GAN | generative adversarial network, 生成对抗网络 | — |\r\n\r\n> **规则**：只要用户关键词命中上表左列，必须自动添加右列的扩展词。**AI 还应自行推理**——遇到表外术语时，联网搜索其标准缩写和英文对应词（如\"Swin Transformer\" → \"Swin Transformer, Swin-T\"）。\r\n\r\n**第2层：中英互译扩展**\r\n\r\n- 中文关键词 → 必须补英文对应词（通过联网搜索确认学术通用译名）\r\n- 英文关键词 → 必须补中文对应词\r\n- 示例：`知识图谱` → 扩展 `knowledge graph`；`segmentation` → 扩展 `分割, 语义分割`\r\n\r\n**第3层：上下位词扩展（按需，联网搜索）**\r\n\r\n- 结果 < 10 条时执行：用上位词扩大范围，或用下位词增加相关结果\r\n- 示例：`深度学习` 结果少 → 上位词 `机器学习`；`自然语言处理` 结果少 → 下位词 `文本分类, 命名实体识别`\r\n\r\n**第4层：同义词/近义词扩展（联网搜索）**\r\n\r\n- 通过联网查询学术语境下的等价表述\r\n- 示例：`文献检索` → 补充 `文献发现, 文献获取, 资源发现`\r\n\r\n**检索表达式构建规则：**\r\n\r\n1. 同义词组内用 `OR` 连接，不同概念组间用 `AND` 连接\r\n2. 每组扩展词控制在 3-8 个，**缩写词优先**（收益最大）\r\n3. **重要**：中文和英文扩展词必须在同一个 OR 组内，而非分开\r\n   - ✅ `(K=大语言模型 OR K=大模型 OR K=LLM OR K=large language model)`\r\n   - ❌ `(K=大语言模型 OR K=大模型) AND (K=LLM OR K=large language model)`\r\n4. 默认字段使用 `K=`（关键词字段，精度和召回最均衡）\r\n5. **中文复合词不拆解**（API 后端分词已处理。实测：拆解为单字/n-gram 对召回增益 <15% 但噪声激增）\r\n   - ✅ `K=自然语言处理`\r\n   - ❌ `K=自然 AND K=语言 AND K=处理`（噪声大，不推荐）\r\n\r\n### 结果智能排序/ Smart Result Ranking\r\n\r\n检索结果需进行二次智能排序，综合考虑以下因素（优先级从高到低）：\r\n\r\n1. **核心收录权重**：SCI/SSCI > EI > CSSCI > 北大核心 > CSCD > 普通期刊\r\n2. **内容相关性权重**：题名匹配 > 题名+关键词 > 摘要相关 > 仅关键词命中\r\n3. **时效性权重**：近 3 年文献给予适当加分\r\n\r\n### 结果数量自适应策略/ Adaptive Result Strategy\r\n\r\n**结果过少（< 5 篇）— 宽化扩展：**\r\n\r\n1. 上位词扩展：联网搜索更泛化的术语\r\n2. 字段放宽：`T=` → `K=` → `U=`\r\n3. 相关机构检索：查找领域代表性机构\r\n4. 学科分类号检索：使用中图分类号或教育部分类号\r\n5. 放宽过滤条件：去掉时间/语言/文献类型限制\r\n6. 关键词拆分/重组\r\n\r\n**结果过多（> 500 条或相关性差）— 窄化收缩：**\r\n\r\n1. 字段收窄：`U=` → `K=` → `T=`\r\n2. 增加 AND 限定\r\n3. 核心词精简\r\n4. 强化过滤条件（限定文献类型/语言/年份）\r\n5. 排序优化\r\n\r\n### 自然语言转检索表达式示例/ NL-to-Query Examples\r\n\r\n> **字段默认使用 `K=`（关键词），而非 `U=`（全字段）。`K=` 精度高、噪声少，是学术检索的标准字段。**\r\n\r\n| 用户需求 | 扩展后的 Rule | FilterRule | 接口 |\r\n|---------|------|-----------|------|\r\n| 找关于深度学习的论文 | `(K=深度学习 OR K=deep learning OR K=DNN OR K=深度神经网络)` | - | 接口1+4 |\r\n| 清华大学发表的人工智能相关论文 | `(K=人工智能 OR K=AI OR K=artificial intelligence) AND O=清华大学` | `TY=3` | 接口1 |\r\n| 2024年中文期刊上关于大模型的文章 | `(K=大语言模型 OR K=大模型 OR K=LLM OR K=large language model)` | `TY=3 AND Y=2024 AND LA=ZH` | 接口1 |\r\n| Nature 期刊上的量子计算论文 | `(K=quantum computing OR K=量子计算) AND P=Nature` | - | 接口4 |\r\n| 查找计算机领域的专利 | `(K=计算机 OR K=computer)` | `TY=7` | 接口4 |\r\n| 2023-2025年的深度学习综述 | `(T=深度学习 OR T=deep learning) AND (T=综述 OR T=review OR T=survey)` | `Y=2023 OR Y=2024 OR Y=2025` | 接口1+4 |\r\n| 找关于知识图谱的论文 | `(K=知识图谱 OR K=knowledge graph OR K=KG)` | - | 接口1+4 |\r\n| NLP领域最新研究 | `(K=NLP OR K=自然语言处理 OR K=natural language processing)` | `Y=2024 OR Y=2025` | 接口1+4 |\r\n\r\n### 高级检索技巧/ Advanced Search Techniques\r\n\r\n#### 引文追溯策略/ Citation Tracing\r\n\r\n| 追溯方向 | 操作方式 | 适用场景 |\r\n|------|------|------|\r\n| **作者追踪** | `A=作者名` | 追踪核心研究者团队全部成果 |\r\n| **期刊溯源** | `P=期刊名 AND K=相关主题词` | 锁定高水平期刊中该领域全部论文 |\r\n| **机构扩展** | `O=机构名` | 了解机构在相关领域的研究布局 |\r\n| **参考文献反向查** | 提取参考文献标题，用 `T=` 逐一检索验证 | 确认引用文献是否在数据库中 |\r\n| **引用链追踪** | `L=分类号 OR C=分类号` | 在相同分类号下发现更多相关文献 |\r\n\r\n#### 分类号体系利用/ Classification-based Search\r\n\r\n利用中图分类号（`L=`）和教育部学科分类号（`C=`）检索可绕过关键词歧义。常用分类号：`TP18`=人工智能，`TP391.1`=自然语言处理，`O413`=量子论，`0812`=计算机科学与技术。\r\n\r\n#### 字段选择策略矩阵/ Field Selection Matrix\r\n\r\n> **默认使用 `K=`（关键词字段）**。这是学术检索的标准做法——知网的\"主题\"检索、维普的人工标引关键词、WoS 的 Topic Search 均以关键词/主题词为核心检索入口。\r\n\r\n| 字段 | 精度 | 覆盖 | 最佳场景 |\r\n|------|------|------|------|\r\n| `K=` 关键词 | 中 | 高 | **常规检索（默认）** — 对标知网\"主题\"检索 |\r\n| `T=` 题名 | 最高 | 低 | 精准匹配、引用确认 — 对标 WoS \"Title\" 检索 |\r\n| `U=` 全部字段 | 低 | 最高 | 查全兜底（仅当 K= 和 T= 结果 < 10 条时使用） |\r\n| `A=` 作者 | 高 | 低 | 追踪特定研究者 |\r\n| `O=` 机构 | 中 | 中 | 了解机构研究布局 |\r\n| `P=` 出版物 | 高 | 中 | 限定高质量期刊 |\r\n\r\n**字段分级检索流程**\r\n\r\n```\r\n默认（平衡策略）：\r\n  第1轮：K=检索（关键词字段，平衡精度和召回）\r\n    ├─ 结果 ≥ 10 → 完成 ✅\r\n    └─ 结果 < 10 → 第2轮\r\n    \r\n  第2轮：T=检索（放宽到题名，提高召回）\r\n    ├─ 结果 ≥ 5 → 合并去重，展示 ✅\r\n    └─ 结果 < 5 → 第3轮\r\n    \r\n  第3轮：U=检索（全部字段，最大召回）\r\n    → 合并去重（U= 结果可能噪声大，需标注\"全字段检索结果\"）\r\n\r\n宽检索（综述/查全）：\r\n  同时用 K= + U= 两路并行，取并集去重\r\n\r\n窄检索（精准/引用）：\r\n  优先 T= 精确匹配，K= 辅助补充\r\n```\r\n\r\n### 结果展示规范/ Result Display Standards\r\n\r\n**检索结果列表**以编号列表形式展示，每篇文献包含：序号、核心收录标注、标题、作者、来源出版物、出版日期、摘要（截取前200字）、文献ID。\r\n\r\n**文献详情**额外展示：DOI、核心收录、原始数据库链接、SmartLib 详情页、基金资助、页码。\r\n\r\n结果按「结果智能排序」策略排列。展示后主动提示用户：\r\n- \"输入文献编号可查看详情\"\r\n- \"中文期刊文献支持全文下载\"\r\n- \"如需更多结果，可以说'下一页'\"\r\n\r\n### 检索结果质量判断/ Result Quality Assessment\r\n\r\n#### 核心收录标注解读\r\n\r\n| 标注 | 含义 | 权重 |\r\n|------|------|------|\r\n| `[SCI一区]` | 国际顶级期刊（影响因子前 25%） | 最高 |\r\n| `[SCI二区]` | 国际高水平期刊 | 高 |\r\n| `[SSCI]` | 社会科学国际核心期刊 | 最高 |\r\n| `[EI]` | 工程领域国际核心收录 | 高 |\r\n| `[CSSCI]` | 中文社会科学引文索引（南大核心） | 高 |\r\n| `[CSCD]` | 中国科学引文数据库 | 中高 |\r\n| `[北大核心]` | 北京大学核心期刊目录 | 中 |\r\n| `[CCF-A]` | 中国计算机学会 A 类会议/期刊 | 最高 |\r\n\r\n#### 用户自检清单/ User Quality Checklist\r\n\r\n在引用或深入阅读文献前，建议用户快速核对：\r\n- [ ] **来源**：发表在什么期刊/会议上？是否为核心收录？\r\n- [ ] **时效**：出版年份是什么？对当前领域是否足够新？\r\n- [ ] **作者**：作者是否是该领域的活跃研究者？\r\n- [ ] **相关性**：标题和摘要是否与我的研究问题直接相关？\r\n- [ ] **可获取性**：是中文期刊（可下载全文）还是全球文献（仅元数据）？\r\n\r\n---\r\n\r\n### 错误处理/ Error Handling\r\n\r\n错误处理必须给出具体可操作的解决方案。网络波动时自动重试（最多 3 次，指数退避 1s→2s→4s）。\r\n\r\n#### 错误码处理表/ Error Code Handling\r\n\r\n| 状态码 | 含义 | 具体处理步骤 |\r\n|------|------|------|\r\n| **401** | Token 无效或过期 | Gateway 自动管理 Token 刷新, 无需处理。若持续 401，请检查 consume_token 是否有效 |\r\n| **403** | 权限不足 | 提示\"当前凭证无此接口权限，请确认 API 套餐是否已开通此接口\" |\r\n| **429** | 请求频率超限 | 等待 5 秒后自动重试 |\r\n| **499** | 参数错误 | 检查 Rule 语法（运算符大写、有空格）、FilterRule 字段代码、PageSize 范围 |\r\n| **502（alipay_error / 支付宝通道繁忙）** | 支付宝支付通道暂忙（订单未生成） | **不视为服务端故障、不要自动重试 3 次**（重试会加重节流）。按「半成功态」话术告知用户稍后重试；响应**不含** `out_trade_no`，切勿编造 |\r\n| **500/503** | 网关服务端错误 | 自动重试 3 次（指数退避 1s→2s→4s）→ 全部失败后提示\"SmartLib 服务暂时不可用，通常 5 分钟内恢复\" |\r\n| **网络超时** | 请求无响应 | 自动重试 3 次 → 提示\"请检查网络是否可访问 data.smart.vipslib.com\" |\r\n| **无结果** | API 返回空列表 | 按「结果数量自适应策略」自动提供扩展建议 |\r\n| **凭证缺失** | 环境变量未设置 | 自动触发 Pre-flight 注册流程 |\r\n\r\n---\r\n\r\n### 常见问题（FAQ）\r\n\r\n| 问题 | 答案 |\r\n|------|------|\r\n| **检索不到想要的论文怎么办？** | 1. 去掉过滤条件扩大范围 2. 尝试上位词 3. 用英文关键词在接口4再试 4. 用 `U=` 替代 `T=` |\r\n| **全文下载失败怎么办？** | 仅中文期刊支持全文下载。下载 URL 约 10 分钟有效（以下游返回为准），过期需重新调用。英文文献自动走多渠道下载策略获取 OA 版本。 |\r\n| **Token 多久过期？** | Access Token 约 30 秒，Refresh Token 约 2 小时（以 API 返回为准）。系统自动管理刷新，用户无感知。 |\r\n| **英文文献能不能下全文？** | 本技能集成十级多渠道下载策略（ArXiv → Unpaywall → CORE → OpenAlex 等），Gold/Green/Hybrid OA 论文成功率 >85%。付费墙内论文无法获取。 |\r\n| **配额耗尽后还能用吗？** | 不能。试用额度耗尽后 Gateway 返回 429 拒绝所有检索请求，并自动弹出套餐选择；如需更高额度，回复套餐数字或说「升级 / 充值」即可（企业 / 机构定制联系 vipsmart@vipslib.com）。 |\r\n| **计费 token（consume_token）是一次性的吗？** | **是的，务必注意。** 每次 `/consume` 返回的 `consume_token` **仅能使用一次**且 **约 60 秒过期**。获取后要立刻调用 `/search` 或 `/download`，不要缓存或复用；过期/已用需重新 `/consume`。这与 SmartLib 云端 Access/Refresh Token（约 30s/2h，以 API 返回为准，系统自动刷新）是两回事。 |\r\n| **Windows 下用 curl 下载 PDF 失败？** | 返回链接若含中文文件名，Git Bash 的 `curl` 常因 URL 编码失败而下载到空文件/报错。改用 **Python `urllib.request`** 直接拉取（自动处理编码），或直接用浏览器打开链接下载。 |\r\n| **中文关键词搜不到 / 命中少怎么办？** | 下游检索（维普系）对中文复合词与缩写别名的索引有限，纯中文窄词常召回不足。建议：① 补英文关键词（接口1+接口4 双检）② 用上位词/同义词扩检 ③ 用 `U=` 替代 `T=` ④ 去掉过滤条件扩大范围。详见下方「检索召回优化提示」。 |\r\n\r\n---\r\n\r\n### 检索召回优化提示（中文关键词命中低时必读）\r\n\r\n下游检索（维普系）的分词与别名索引对中文复合词、缩写、中英鸿沟支持有限，**召回不足的首要原因通常不是分词颗粒度，而是缩写/别名缺失、跨语言鸿沟和字段策略不当**。实操清单：\r\n\r\n- **中英双检**：同一概念同时用中文（接口1）和英文（接口4）各检一次，覆盖率显著提升。\r\n- **上位词 / 同义词扩检**：如「深度学习」补「神经网络 / 机器学习」；「新冠」补「COVID-19/ SARS-CoV-2」。\r\n- **字段渐进**：默认 `K=`（关键词），召回差时改用 `T=`（题名）精准定位，或 `U=`（任意字段）扩检。\r\n- **去掉过滤条件**：先广后窄，去掉 `TY=`/`LA=` 等过滤扩大范围，再人工筛选。\r\n- **缩写展开**：机构缩写（如「中科院」→「中国科学院」）、期刊缩写（如「JACS」→「Journal of the American Chemical Society」）务必展开。\r\n\r\n---\r\n\r\n### API 调用注意事项/ API Call Notes\r\n\r\n- **检索结果数据路径**：列表字段为 **`data.list`（全小写）**；解析优先级：`data.list` → `Data.List` → `List`。总条数在 `data.total` / `Data.Total`。\r\n- **Source 字段需详情接口获取**：检索列表中 `Source` 为空数组，原始数据库链接需调用详情接口。Source 数组元素结构为 `{\"Source_DbId\": \"scopusjournal\", \"Source_DbTitle\": \"Scopus\", \"Source_Link\": \"https://...\"}`，字段说明：`Source_DbId`=数据库标识符，`Source_DbTitle`=数据库中文名称，`Source_Link`=原始数据库详情页链接。平台覆盖300+数据库，100篇样本实测平均每篇4.75个链接，覆盖率100%。\r\n\r\n---\r\n\r\n## 注意事项/ Notes\r\n\r\n- 检索策略遵循三级分级体系：默认平衡策略，综述自动切换宽检索，引用自动切换窄检索\r\n- 检索→评估→调整→再检索是核心工作流\r\n- Access Token 有效期约 30 秒，Refresh Token 约 2 小时（以 API 返回为准），系统自动管理刷新\r\n- 全球文献检索（接口4）仅提供元数据，部分无全文\r\n- 中文期刊（接口1-3）支持全文下载，是核心优势，应优先推荐\r\n- PageSize 建议不超过 100\r\n- 检索表达式中的运算符必须大写且两边有空格\r\n- 英文关键词建议同时检索接口1和接口4以提高覆盖率\r\n- 展示文献详情时，务必从详情接口取 `Source` 字段并展示原始数据库链接（`Source_DbTitle` + `Source_Link`）\r\n- 引文追溯是提升检索质量的捷径：从一篇确认的高质量文献出发追踪\r\n- 分类号检索（`L=` / `C=`）可绕过关键词歧义\r\n\r\n---\r\n\r\n## 版本历史\r\n| 版本 | 日期 | 核心变更 |\r\n|------|------|---------|\r\n| v3.0 | 2026-06 | 注册流程简化，新用户开通更快捷，无需验证码 |\r\n| v3.3 | 2026-06 | 全球文献库扩充至12.28亿条；中文期刊8000万篇可下载 |\r\n| v3.9.0 | 2026-07 | 恢复付费套餐：新增体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包多档选择；计费与升级统一由 references/account.md（smartlib-account）管理，所有文献检索技能统一定价、配额共享 |\r\n| v3.10.0 | 2026-08-29 | 支付渠道切换为支付宝：对话内支付改用 `/api/pay/alipay/create` 生成支付宝付款码、轮询 `/api/pay/alipay/status`；后端双通道并存，老用户（未更新技能）支付通道不受影响 |\r\n| v3.10.1 | 2026-08-30 | 付款页规范化：新增 `references/pay_page_template.html` 标准付款页样例，对话中生成付款 HTML 必须严格按样例输出（仅替换占位符），统一支付宝蓝风格；修正付款码有效期文案为 **30 分钟**（对齐网关 `timeout_express=30m`，原先错误写成 5 分钟）；轮询策略与 30 分钟有效期对齐；文档事实一致性小修（套餐表标注与网关当前版本同步、Access/Refresh Token 与下载 URL 有效期标注\"以 API/下游返回为准\"、补充邮箱验证码 15 分钟有效）；文档全面清理（移除中英双语对照、只保留中文；版本历史精简为关键里程碑） |\r\n---\r\n\r\n## 常驻通知转述\r\n\r\n若任意 SmartLib 网关响应（`/search` 或 `/quota`）的 `notifications` 数组非空，将其中每条的 `text` **原样转述**给用户（含其中的 `url` 链接，用该 `text` 引导用户点击）。**不要改写措辞**，也不要合并多条。\r\n\r\n## 📌 企业 / 机构合作\r\n\r\n如需机构 / 企业批量定制、API 接入或私有化部署，请联系我们：\r\n\r\n- 📧 邮箱：vipsmart@vipslib.com\r\n- ☎️ 电话：023-63016015\r\n- 🌐 官网：https://www.vipslib.com/\r\n\r\n个人用户的套餐与升级：配额不足时会自动弹出套餐选择，也可主动说「升级 / 充值 / 购买」唤起（见上方💰章节）。\n\nFile v3.10.1:README.md\n\n# SmartLib 学术文献检索 Skill v3.10.1\n\n用自然语言查论文、找文献、下载全文 —— 覆盖 8000 万篇中文期刊 + 12.28 亿条全球文献。**全自动**：首次使用自动注册开通（免费 100 次/月），配额自动消耗，用尽引导支付宝扫码支付。\n\n---\n\n## 这是什么\n\n一个让 AI 助手具备学术文献检索能力的 Skill。安装后，用日常语言说出需求，AI 自动帮你检索、筛选、展示文献，还能下载中文期刊全文 + 英文 OA 论文。\n\n### 核心亮点\n\n- **中文期刊全文下载**：8000 万篇授权中文期刊，一键获取 PDF\n- **英文 OA 多渠道下载**：十一级下载策略，Gold/Hybrid/Green OA 成功率 >85%\n- **全球文献覆盖**：12.28 亿条元数据（期刊/专利/会议/学位/标准等）\n- **全自动变现**：零配置启动，配额耗尽后扫码支付即恢复\n- **自然语言交互**：不需要学检索语法\n\n---\n\n## 🔒 免费体验与受限展示\n\n| 状态 | 展示规则 |\n|------|---------|\n| **配额充足** | 完整展示所有检索结果（含详情、下载、智能排序） |\n| **配额耗尽** | Gateway 返回 429，**拒绝服务**，直接提示充值 |\n\n配额耗尽后回复「充值」，展示数字选套餐卡片（①-④），回复数字即可获取带套餐信息的支付宝付款码。\n\n---\n\n## 快速开始\n\n### 1. 安装\n\n在 WorkBuddy 中搜索 \"smartlib\" 安装。\n\n### 2. 零配置启动\n\n**无需手动申请 API 密钥。** 首次使用自动检测凭证，未配置则自动通过智能网关注册开通（免费 100 次/月）。\n\n### 3. 开始使用\n\n```\n帮我找一些关于大语言模型的最新论文\n下载第 3 篇\n```\n\n---\n\n## 使用示例\n\n**查找中文论文并下载：** `帮我找几篇关于知识图谱的中文论文` → AI 自动检索、展示结果、输入编号即可下载 PDF。\n\n**查找英文论文并获取 OA 全文：** `找 transformer architecture 相关的论文` → AI 自动通过 ArXiv / Unpaywall / CORE 等渠道获取 OA 版本。\n\n**配额耗尽 → 对话支付：** 在对话中说「充值」→ 展示 ①-④ 数字套餐卡片 → 回复数字选择 → 直接出带订单信息的支付宝付款码 → 扫码支付 → 即时恢复。\n\n---\n\n## 常见问题\n\n**Q: 免费吗？** 首次使用自动注册，免费 100 次/月。超出后付费，¥9.90 体验卡（1000 次）起。\n\n**Q: 英文文献能下全文吗？** 可以。十一级多渠道下载策略，Gold/Hybrid/Green OA 成功率 >85%。付费墙内（Closed）论文无法获取。\n\n**Q: 配额耗尽后怎么办？** 在对话中说「充值」，展示数字选套餐卡片，回复数字直接获取支付宝付款码，扫码后即时恢复。\n\n---\n\n## 依赖\n\n- SmartLib API（自动通过网关注册）\n- SmartLib Gateway（腾讯云 SCF 上海）\n- Alipay（支付宝当面付扫码支付）\n\n---\n\n## 相关文档\n\n- **SKILL.md** — 完整技能规范（API 接口、检索策略、变现流程）\n- **PIPELINE.md** — 全链路优化指南\n\n---\n\n## 作者\n\n**张亚东** — 重庆维普智图 · GitHub: [J-levee](https://github.com/J-levee)\n\nFile v3.10.1:_meta.json\n\n{\n  \"ownerId\": \"kn71136czyc1f1bmx5rt1tjtes86jsve\",\n  \"slug\": \"global-biblio-base\",\n  \"version\": \"3.10.1\",\n  \"publishedAt\": 1788049803646\n}\n\nFile v3.10.1:references/account.md\n\n# SmartLib 账户与计费（smartlib-account）\r\n\r\n> 本文档是 SmartLib 所有文献检索类技能的**计费与升级唯一真相源**。\r\n> 所有调用文献检索能力的技能（global-biblio-base / citation-checker / academic-knowledge-base / keji-skill-showcase 等）**统一定价、配额共享**，走同一个「统一钱包」。\r\n> 各技能 SKILL.md 不重复价格表，仅在需要时点此文档或引导用户对话中说「我要升级」。\r\n> 本文件按需加载，不进 SKILL.md，避免多处复制导致漂移。\r\n\r\n---\r\n\r\n## 一、注册（首次使用，极简 1 步）\r\n\r\n- 首次在某文献技能发起检索 → 检测到未关联 SmartLib 账户 → **仅需提供邮箱**即可注册（无需验证码）。\r\n- 注册成功**立即可用**：免费 **100 次检索 + 10 次全文下载 / 月**，全程对话驱动。\r\n- 邮箱验证：注册后确认邮件为可选项；**未验证也能正常付费与使用**（降低摩擦，已确认）。\r\n\r\n---\r\n\r\n## 二、套餐与价格\r\n\r\n> 阶段 0 仅开放「单付」；连续包月（¥29 / ¥79）为**后续版本**，当前前端不展示连包入口与连包价。\r\n> 「下载价格」为包内含下载的**单篇均价**（透明参考，非额外计费）；下载额度随套餐一并给定，不单独叠加收费。\r\n\r\n| 档位 | 周期 | 检索与详情 | 下载 | 价格 | 下载价格 | 定位 |\r\n|------|------|-----------|------|------|---------|------|\r\n| 免费体验 | 月 | 100 | 10 | ¥0 | — | 获客入口 |\r\n| 体验卡 | 一次性·7天 | 1000 | 20 | ¥9.9 | ¥0.5 | 首付费转化·仅新用户 1 张 |\r\n| 个人版月 ★ | 月 | 1000 | 50 | ¥39（连包 ¥29 后续） | ¥0.6 / ¥0.8 | 性价比最高·推荐 |\r\n| 专业版月 | 月 | 2000 | 200 | ¥99（连包 ¥79 后续） | ¥0.4 / ¥0.5 | 高价锚点 |\r\n| 单篇下载 | 即时 | — | 1 | ¥2.5 | ¥2.5 | 按需·对齐维普零售价 |\r\n| 下载包 | 月 | — | 10 | ¥20 | ¥2 | 超额低成本（当前唯一下载包） |\r\n| 企业/机构 | 议价 | 自定义 | 自定义 | 按量 / API | 自定义 | >2000 次 或团队出口 |\r\n\r\n**规则要点：**\r\n- 下载配额每个档位**显式给定**（不再用「总额度 10%」隐式规则）。\r\n- 体验卡：**仅新用户 + 终身限 1 张**；用过 / 过期 / 退款均不可重买。\r\n- 免费档与付费档**可并行使用**：付费期内免费额度**不冻结**，客户可持续享用每月免费检索 / 下载额度（先用免费、后动付费），降低早期使用门槛。\r\n- 企业 / 机构档保持「联系我们」，不开放自助购买。\r\n\r\n---\r\n\r\n## 三、价格表展示与推荐逻辑\r\n\r\n- **未购体验卡用户**：优先高亮推荐 **体验卡 ¥9.9**。\r\n- **体验卡已购 / 已用 / 已过期**：体验卡从价格表**消失**，此时优先推荐 **个人版月 ¥39**。\r\n- 升级入口：对话中说「我要升级」，或在任一文献技能查看本文件。\r\n\r\n---\r\n\r\n## 四、下载权益、72 小时重下窗与配额提醒（每次全文下载强制）\r\n\r\n**下载权益（统一钱包）：**\r\n- 免费档每月含 **10 次全文下载**，随日历月重置（`/quota` 返回的 `download_reset_at` 字段标明重置日）。\r\n- 付费档在对应周期内额外给定下载次数（见第二节价格表）；**付费期内免费额度不冻结**，可同时享用免费 + 付费下载额度。\r\n- **单篇下载 ¥2.5 / 下载包 ¥20（10 次）** 为独立购买的超额方案，购买后写入「下载授权」（含有效期，见下）。\r\n- 下载授权消耗优先级：**先消耗即将过期的付费授权 → 再消耗免费月度额度**，避免浪费。\r\n\r\n**72 小时同篇重下窗（不重复计费）：**\r\n- 同一用户、同一篇文献，在 **72 小时内** 重复下载，**不扣减下载配额、也不重复收费**（含单篇付费用户）。\r\n- 系统按 `email + 文献ID` 记录下载历史；命中 72h 窗口内已有记录时直接复用，不再扣减。\r\n- 超出 72 小时后再次下载，按正常配额 / 付费流程计费。\r\n\r\n**每次下载的对话 UX（强制）：**\r\n1. **下载前提醒**：「您当前剩余下载配额 **N 次**，本次将消耗 **1 次**」。\r\n2. **确认文献**：向用户确认要下载的具体文献（标题 / ID）后再执行，**不静默扣减**。\r\n3. **耗尽转向**：下载额度耗尽后，引导转向 **单篇下载 ¥2.5** 与 **下载包 ¥20（10 次）**。\r\n\r\n---\r\n\r\n## 五、企业 / 机构合作\r\n\r\n机构 / 企业批量定制、API 接入、私有化部署：\r\n- 📧 vipsmart@vipslib.com  ☎️ 023-63016015  🌐 https://www.vipslib.com/\r\n\r\n---\r\n\r\n## 六、常见问题 FAQ\r\n\r\n- **Q：配额多久重置？** A：免费档每月重置；付费档按购买周期（月 / 7 天）计算。\r\n- **Q：不同技能的配额互通吗？** A：互通。所有文献检索技能共享同一统一钱包配额。\r\n- **Q：邮箱没验证能用吗？** A：能。验证仅在特定操作时需要，不影响正常使用与付费。\r\n- **Q：体验卡能重复买吗？** A：不能，终身仅 1 张，限新用户。\r\n- **Q：下载会额外扣钱吗？** A：不会。下载额度随套餐给定，仅消耗额度；单篇下载 / 下载包为独立购买的超额方案。\r\n- **Q：同一篇文献反复下载会重复扣费吗？** A：不会。同一用户在 72 小时内重复下载同一篇文献，系统直接复用、不扣配额也不重复收费；超过 72 小时后再下载才正常计费。\r\n\r\n---\r\n\r\n*本文件为 SmartLib 统一计费钱包的说明文档（smartlib-account），由各文献技能按需引用，数字以本文为准。*\n\nFile v3.10.1:PIPELINE.md\n\n# SmartLib 全链路检索下载管线优化指南\r\n\r\n本文件记录 SmartLib 文献检索技能中\"检索→详情→下载\"全链路的架构设计、性能优化策略和实战基准数据。面向技能调用者（AI Agent）和开发者，提供最优执行路径参考。\r\n\r\n> This document covers the architecture, optimization strategies, and real-world benchmarks for the SmartLib literature search → detail → download pipeline. Designed for skill invokers (AI Agents) and developers as the authoritative execution reference.\r\n\r\n---\r\n\r\n## 1. 管线架构\r\n\r\n```\r\n用户请求\r\n    │\r\n    ▼\r\n┌─────────────────────────────────────────────────────┐\r\n│  PHASE 1: 并行检索│\r\n│  ├─ CN: API 1 (中文期刊) ─── 独立 Token，并行发起   │\r\n│  └─ EN: API 4 (全球文献) ─── 独立 Token，并行发起   │\r\n│  预计耗时: 1-3s (5 并发检索)                         │\r\n└──────────────────┬──────────────────────────────────┘\r\n                   ▼\r\n┌─────────────────────────────────────────────────────┐\r\n│  PHASE 2: 批量获取详情│\r\n│  ├─ CN: 无需此步（API 3 直接用 Identifier 下载）     │\r\n│  └─ EN: API 5 (文章详情) ─── 8 并发获取 DOI + 元数据 │\r\n│  预计耗时: 0.3-2s (50 篇以内)                        │\r\n│  关键优化: Token 缓存复用，无需每次重新认证           │\r\n└──────────────────┬──────────────────────────────────┘\r\n                   ▼\r\n┌─────────────────────────────────────────────────────┐\r\n│  PHASE 3: 并行下载│\r\n│  ├─ CN: API 3 (GetArticleFile) ─── 10 并发下载       │\r\n│  └─ EN: 多渠决策树 ─── 10 并发，每篇独立路由         │\r\n│       ├─ ArXiv (最快)                                │\r\n│       ├─ Unpaywall OA 探测 (最全面)                   │\r\n│       ├─ SpringerOpen / PLOS / PMC (出版商专用)       │\r\n│       └─ DOI 重定向 (兜底)                            │\r\n│  预计耗时: 5-15s (10 篇) / 20-40s (50 篇)            │\r\n└──────────────────┬──────────────────────────────────┘\r\n                   ▼\r\n              📊 汇总报告\r\n```\r\n\r\n**设计原则**\r\n- **分阶段并行**: 每阶段内部并行，阶段间串行（依赖数据传递）\r\n- **独立无锁**: 每篇论文的下载互不依赖，无共享状态\r\n- **失败隔离**: 单篇失败不影响其他论文\r\n- **Gateway 代理**: 所有 API 调用通过 Gateway /consume → /search 代理，Token 由 Gateway 管理\r\n\r\n---\r\n\r\n## 2. 核心优化技术\r\n\r\n### 2.1 Gateway 统一管理 Token\r\n\r\n**问题**: 每次 API 调用前走 OAuth 两步认证 (code→token)，耗时 ~0.8s。50 篇论文=50 次认证=40s 浪费。\r\n\r\n**优化**: SmartLib OAuth Token 由 Gateway 全权管理，技能无需获取或缓存 Token。\r\n\r\n**架构**\r\n```\r\n技能 (Skill) → Gateway (/consume → /search) → SmartLib API\r\n                    ↑\r\n              Token 缓存 + 自动刷新 + 分布式同步\r\n```\r\n\r\n- Gateway 维护 OAuth 凭证（APPID + APPSECRET）\r\n- 技能通过 config.json 中的 GATEWAY_SECRET 调用 Gateway API\r\n- 技能**无需持有** APPID/APPSECRET\r\n- Gateway 自动处理 Token 刷新与缓存（含跨实例分布式同步）\r\n\r\n### 2.2 提前终止\r\n\r\n**问题**: 传统策略是对所有渠道逐一尝试，但 closed-access 论文注定失败。\r\n\r\n**优化**: Unpaywall 探测后立即判断：\r\n\r\n| OA 状态 | 策略 | 原因 |\r\n|------|------|------|\r\n| `gold` | 全渠道重试 | 几乎必定能下 |\r\n| `hybrid` | 先试 Unpaywall PDF URL | 大概率能下 |\r\n| `green` | 试 ArXiv + Unpaywall + 机构库 | 作者自存档版本 |\r\n| `bronze` | 尝试一次后 curl 兜底 | ⚠️ 大概率被防盗链拦截 |\r\n| `closed` | **立即终止**，不浪费后续尝试 | 100% 付费墙内 |\r\n\r\n**效果**: closed-access 论文从 ~8s (7个渠道轮询) 降至 ~1s (仅一次 Unpaywall 查询)。\r\n\r\n### 2.3 智能渠道路由\r\n\r\n**问题**: 不同出版商的 PDF 获取方式差异大，统一策略效率低。\r\n\r\n**优化**: 根据出版商名称路由到最优渠道：\r\n\r\n```python\r\nPUBLISHER_ROUTES = {\r\n    \"springer\":  [\"springer\", \"unpaywall\", \"arxiv\"],   # SpringerOpen 直链最快\r\n    \"elsevier\":  [\"unpaywall\", \"arxiv\", \"green\"],       # Elsevier 大概率付费墙\r\n    \"mdpi\":      [\"unpaywall\", \"direct\"],                # MDPI 几乎全 OA\r\n    \"frontiers\": [\"unpaywall\", \"direct\"],                # Frontiers 全 OA\r\n    \"plos\":      [\"plos\", \"unpaywall\"],                  # PLOS 专用 API\r\n    \"biomed\":    [\"springer\", \"unpaywall\", \"pmc\"],       # BMC = Springer 子品牌\r\n}\r\n```\r\n\r\n**效果**: SpringerOpen/BMC 论文直接从 `link.springer.com/content/pdf/` 拿 PDF，跳过 Unpaywall，节省 1-2s/篇。\r\n\r\n### 2.4 HTTP 连接复用\r\n\r\n**问题**: 每次 `urllib.request.urlopen()` 创建新 TCP 连接 + TLS 握手，开销 ~200ms。\r\n\r\n**优化**: \r\n- 使用 `build_opener()` + `Connection: keep-alive` header\r\n- 同 host 的连续请求复用底层 TCP 连接\r\n\r\n**效果**: 50 篇同 host 下载可节省 ~5s。\r\n\r\n### 2.5 curl 兜底\r\n\r\n**问题**: Python `urllib` 对某些服务器（OUP Bronze OA）返回 `IncompleteRead` 或截断 PDF。\r\n\r\n**优化**: 下载失败时自动切换为 `curl` subprocess 重试。\r\n\r\n```python\r\n# curl 对 HTTP chunked encoding 和 unstable connections 处理更鲁棒\r\nresult = subprocess.run([\"curl\", \"-sL\", \"--max-time\", \"25\", \"-o\", \"-\", url], ...)\r\n```\r\n\r\n**效果**: 将 Bronze OA 论文成功率从 ~20% 提升至 ~60%。\r\n\r\n---\r\n\r\n## 3. 下载渠道路由决策树\r\n\r\n```\r\n论文有 Identifier + 来源 = API 1 (中文期刊)?\r\n  ├─ YES → API 3 (GetArticleFile) → 获取 PDF URL → 下载\r\n  │        成功率: >95%  |  耗时: ~1s/篇\r\n  │\r\n  └─ NO (全球文献)\r\n       ├─ 标题含 arXiv ID? → https://arxiv.org/pdf/{id}\r\n       │   成功率: >99%  |  耗时: ~2s/篇\r\n       │\r\n       ├─ 获取 DOI (API 5) → Unpaywall 探测\r\n       │   ├─ is_oa = false\r\n       │   │   → ⛔ 立即终止，标记 \"paywall_closed\"\r\n       │   │\r\n       │   ├─ oa_status = \"gold\" → 全渠道并发尝试\r\n       │   │   1. Unpaywall best_oa_location.url_for_pdf\r\n       │   │   2. DOI redirect (Accept: application/pdf)\r\n       │   │   3. 出版商专用路由 (SpringerOpen/PLOS/MDPI)\r\n       │   │   成功率: >90%\r\n       │   │\r\n       │   ├─ oa_status = \"hybrid\" → Unpaywall PDF URL 优先\r\n       │   │   成功率: ~80%\r\n       │   │\r\n       │   ├─ oa_status = \"green\" → ArXiv + Unpaywall + DOI redirect\r\n       │   │   成功率: >85%\r\n       │   │\r\n       │   └─ oa_status = \"bronze\" → ⚠️ 高风险\r\n       │       1. Unpaywall PDF URL (常规)\r\n       │       2. curl 兜底 (绕过 urllib 限制)\r\n       │       3. 出版商专用路由\r\n       │       成功率: ~40-60% (出版商防盗链)\r\n       │\r\n       └─ 无 DOI → 标记 \"no_doi\"，仅展示元数据\r\n```\r\n\r\n---\r\n\r\n## 4. 性能基准\r\n\r\n### 4.1 实测数据\r\n\r\n测试环境: Windows 10, Python 3.14, 中国网络环境 (GFW)\r\n\r\n#### 完整 5 领域多渠测试 (multi_channel_test.py)\r\n\r\n| 领域| 检索| 下载成功| 成功率| 主要渠道|\r\n|------|:--:|:--:|:--:|------|\r\n| 化学催化**10** | 100% | Unpaywall Gold OA (MDPI/Frontiers) |\r\n| AI/深度学习**10** | 100% | ArXiv + Unpaywall Gold |\r\n| 生物技术 CRISPR\r\n| 环境/气候\r\n| 制药/mRNA**0** | 0% | 全部付费墙 (Elsevier/Nature/Wiley) |\r\n\r\n**总计**\r\n\r\n#### 优化管线 Demo 测试\r\n\r\n| 指标| 值|\r\n|------|------|\r\n| 检索\r\n| 详情| 5 EN in 0.3s (Token 缓存) |\r\n| CN 下载| 5 in 4.4s (0.88s/篇) |\r\n| EN 下载| 5 in 5.7s (1.14s/篇) |\r\n| **总计** | **10 in 11.7s (1.17s/篇)** |\r\n| 成功率\r\n\r\n### 4.2 速度对比\r\n\r\n| 阶段| 优化前| 优化后| 提升|\r\n|------|:--:|:--:|:--:|\r\n| Token 获取 (50篇) | ~40s (每次重新认证) | ~2s (缓存复用) | **20x** |\r\n| EN 详情获取 (50篇) | ~40s (串行) | ~2s (8并发+Token复用) | **20x** |\r\n| CN 下载 (10篇) | ~30s (串行) | ~8s (10并发) | **3.75x** |\r\n| EN 下载 (10篇) | ~60s (全渠道串行轮询) | ~12s (路由+提前终止) | **5x** |\r\n| closed 论文判定 | ~8s (7渠道失败) | ~1s (立刻终止) | **8x** |\r\n\r\n### 4.3 渠道贡献分析\r\n\r\n基于 50 篇 5 领域实测 + 10 篇优化管线测试 = 60 篇总样本:\r\n\r\n| 渠道| 成功数| 占比| 平均耗时|\r\n|------|:--:|:--:|:--:|\r\n| API 3 (中文期刊) | 5 | 14% | ~0.9s |\r\n| ArXiv | 5 | 14% | ~2s |\r\n| Unpaywall Gold OA | 22 | 60% | ~3s |\r\n| Unpaywall Hybrid OA | 1 | 3% | ~4s |\r\n| Unpaywall Green OA | 2 | 5% | ~5s |\r\n| SpringerOpen Direct | 1 | 3% | ~2s |\r\n\r\n---\r\n\r\n## 5. 使用指南\r\n\r\n### 5.1 快速启动\r\n\r\n```bash\r\n# Demo 模式: 1 个 CN + 1 个 EN 检索，各 5 篇\r\npython optimized_pipeline.py --preset demo --pagesize 5\r\n\r\n# 完整测试: 5 个领域 EN 检索，各 10 篇\r\npython optimized_pipeline.py --preset test --pagesize 10\r\n\r\n# 自定义检索\r\npython optimized_pipeline.py \\\r\n  --cn \"深度学习::K=深度学习 AND TY=3\" \\\r\n  --en \"CRISPR::(K=CRISPR OR K=gene editing) AND TY=3\" \\\r\n  --pagesize 10 \\\r\n  --out ./my_downloads\r\n```\r\n\r\n### 5.2 编程调用\r\n\r\n```python\r\nfrom optimized_pipeline import PipelineOrchestrator\r\n\r\norch = PipelineOrchestrator(out_dir=\"./papers\")\r\n\r\nresult = orch.run(\r\n    cn_queries=[{\"name\": \"AI_CN\", \"rule\": \"K=人工智能 AND TY=3\"}],\r\n    en_queries=[{\"name\": \"LLM_EN\", \"rule\": \"(K=transformer) AND (K=large language model)\"}],\r\n    page_size=10\r\n)\r\n\r\nprint(f\"Downloaded: {result['totals']['downloaded']}\")\r\nprint(f\"Time: {result['timing']['total']}s\")\r\nprint(f\"Channels: {result['stats']}\")\r\n```\r\n\r\n### 5.3 AI Agent 调用建议\r\n\r\n当 AI 助手调用本技能进行文献下载时，建议遵循以下执行路径：\r\n\r\n1. **检索阶段**: 中文用 API 1，英文用 API 4，并行发起（同一批 Token）\r\n2. **详情阶段**: 仅对 EN 文献调 API 5 获取 DOI（CN 可直接下载）\r\n3. **下载阶段**: CN 和 EN 并行下载；EN 内部 10 并发\r\n4. **失败处理**: closed-access 标记后直接跳过，bronze OA 用 curl 兜底\r\n\r\n**关键**: 绝对不要逐篇串行下载 N 篇论文！必须并行。\r\n\r\n---\r\n\r\n## 6. 排障指南\r\n\r\n| 现象| 原因| 解决|\r\n|------|------|------|\r\n| 所有 EN 论文下载失败 | Token 未正确缓存 | 检查 `TokenManager._expires_at` 是否正确设置 |\r\n| Unpaywall 返回空 | 邮箱未提供或格式错误 | 确认 `email=` 参数正确 |\r\n| 下载的 PDF 无法打开 (几 KB) | 服务器返回 HTML 错误页而非 PDF | 开启 curl 兜底；检查 `%PDF` magic bytes 验证 |\r\n| Bronze OA 全部 403 | 出版商防盗链 (OUP/IEEE) | 启用 curl 兜底；长期方案：部署 Chromium CDP |\r\n| 中文期刊 PDF URL 过期 | URL 有效期 ~10min | 重新调用 API 3 获取新 URL |\r\n| `failed_no_doi` 比例高 | API 5 返回的元数据不含 DOI | 该论文确实无 DOI，建议用户通过标题在 Google Scholar 手动搜索 |\r\n\r\n---\r\n\r\n## 7. 依赖\r\n\r\n- Python 3.8+\r\n- `urllib` (标准库)\r\n- `curl` (系统工具，用于 PDF 兜底下载)\r\n- SmartLib Gateway (腾讯云 SCF，管理 OAuth 凭证与 Token 缓存)\r\n- Unpaywall API (免费，需提供邮箱)\r\n\r\n---\r\n\r\n## 8. 版本\r\n\r\n| 版本 | 日期 | 变更 |\r\n|------|------|------|\r\n| 1.0 | 2026-05-27 | 初始发布。基于 5 领域 50 篇多渠测试 + 优化管线 Demo 10 篇实战数据。 |\n\nFile v3.10.1:skill-card.md\n\n## Description:\n\nglobal-biblio-base lets agents search Chinese and global academic literature, show metadata and source links, and retrieve authorized Chinese journal PDFs or open-access foreign full text through SmartLib.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[j-levee](https://clawhub.ai/user/j-levee)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agents use this skill to find papers, patents, standards, theses, and supporting citations, then inspect details or request downloads when quota and access rules allow.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill may send and persist a user's email for SmartLib account and quota management.\n\nMitigation: Use it only where local email storage and transmission to SmartLib are acceptable, and request an explicit user-provided email before account actions.\n\nRisk: The skill can consume search or download quota and create Alipay payment orders after a package is selected.\n\nMitigation: Review quota status before paid operations, require user package selection, and avoid exposing gateway secrets or tokens in responses or generated payment pages.\n\nRisk: The skill forwards gateway-provided notification links and can guide PDF downloads.\n\nMitigation: Review remote notices before following links, and use download features only for authorized Chinese journal content or legitimate open-access foreign papers.\n\nRisk: Automated full-text retrieval could be misused to bypass publisher restrictions.\n\nMitigation: Do not use the skill to obtain closed-access content; stop at metadata when access rights are not clear.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/j-levee/skills/global-biblio-base)\n- [Skill specification](artifact/SKILL.md)\n- [Pipeline guide](artifact/PIPELINE.md)\n- [SmartLib account and billing reference](artifact/references/account.md)\n- [Alipay payment page template](artifact/references/pay_page_template.html)\n- [SmartLib website](https://www.vipslib.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, files, configuration, guidance]\n\n**Output Format:** [Markdown responses with literature result lists, source links, quota or payment guidance, and PDF or HTML file links when generated.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May consume SmartLib search or download quota, may create Alipay payment orders after user package selection, and may store the user email locally for account and quota management.]\n\n## Skill Version(s):\n\n3.10.1 (source: frontmatter and server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v3.10.1:config.example.json\n\n{\n  \"SMARTLIB_GATEWAY_URL\": \"https://<your-gateway-id>.ap-shanghai.tencentscf.com\",\n  \"SMARTLIB_GATEWAY_SECRET\": \"<your-gateway-secret>\"\n}\n\nFile v3.10.1:config.json\n\n{\n  \"SMARTLIB_GATEWAY_URL\": \"https://1318491188-jvmi3wist0.ap-shanghai.tencentscf.com\",\n  \"SMARTLIB_GATEWAY_SECRET\": \"sk-O9vHwWzMg0Jf7khvhKQ0xxpdGIOROcw5RyQnROrNuZj9x6hOeHmi2\",\n  \"SMARTLIB_EMAIL\": null\n}\n\nArchive v3.10.0: 8 files, 39191 bytes\n\nFiles: config.example.json (220b), config.json (204b), PIPELINE.md (13394b), README.md (5026b), references/account.md (5573b), skill-card.md (3008b), SKILL.md (65375b), _meta.json (138b)\n\nFile v3.10.0:SKILL.md\n\n---\r\nslug: global-biblio-base\r\nname: global-biblio-base\r\ndisplayName: 全球12亿文献知识库（8千万中文期刊可下载）\r\nversion: 3.10.0\r\ndescription: |\r\n  全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。\r\n\r\n  能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。\r\n\r\n  配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。\r\n\r\n  触发：用户表达\"查论文\"\"找文献\"\"检索学术\"\"搜期刊\"\"查专利\"\"找标准\"\"下论文\"\"写文献综述\"\"找参考文献\"\"查 SCI/EI\"等意图时启用；也适用\"帮我找关于 XX 的论文\"\"写文献综述\"\"找几篇引用支撑论点\"。英文：\"find papers\" \"search literature\" \"write literature review\" \"find supporting citations\"。\r\n\r\n  调用前必须先用 /consume 获取 consume_token，再凭 token 调 /search（每次计费接口调用都需一次 /consume）。\r\nagent_created: true\r\n---\r\n\r\n## 🤖 AI 执行摘要 / AI Execution Summary（先读这段）\r\n\r\n- **何时触发**：用户要查 / 找 / 下载中外文学术文献（论文、期刊、专利、标准、学位论文），或要写文献综述、找引用支撑、做课题查新。\r\n- **不触发（转其他技能）**：引用核查 / \"这篇是真的吗\" → `smartlib-citation-checker`；论文写作辅助、非文献类查询。\r\n- **两个前置硬规则**：① 动手前必须先向用户索取邮箱（禁止用 config 预填邮箱、禁止臆造邮箱）；② 每次计费接口调用前先 `/consume` 取 `consume_token`，再带 token 调 `/search`（token 单次使用、约 60s 有效，过期/已用需重新 `/consume`）。\r\n- **输入**：用户自然语言检索意图 + 邮箱。\r\n- **产出**：检索结果列表（含核心收录标注、原始数据库来源链接）、文献详情、PDF 下载链接（中文期刊直下 / 外文 OA 多渠道探测）。\r\n- **配额模型**：免费 100 次检索 + 10 次下载 / 月；耗尽时 Gateway 返回 429，技能自动弹出套餐卡片（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），用户也可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。\r\n- **红线**：不改功能；不臆造邮箱；不在对话中泄露 `SMARTLIB_GATEWAY_SECRET`；付费墙内外文文献无法获取全文。\r\n- **凭证来源**：`config.json` → `SMARTLIB_GATEWAY_URL` / `SMARTLIB_GATEWAY_SECRET`（SMARTLIB_EMAIL 运行后由注册写入，勿预填）。\r\n\r\n# 全球12亿文献知识库（8千万中文期刊可下载）\r\n\r\n> 中文 / Chinese | [English below each section]\r\n\r\n通过 SmartLib 开放平台 API 提供中外文学术文献检索能力。\r\n\r\n> Powered by SmartLib Open Platform API. Search across 80M Chinese journal articles and 1B global literature records.\r\n\r\n---\r\n\r\n## ⚡ 启动前必须执行 / Pre-flight Checklist\r\n\r\n### Step A：凭证自动检测 & 注册 / Auto Credential Check & Registration\r\n\r\n> ## ⚠️ 强制规则 — 必须先询问邮箱\r\n> 1. **执行任何操作前，必须先询问用户邮箱地址**\r\n> 2. 禁止使用 config.json 中预填的邮箱（即使存在且非 null）\r\n> 3. 禁止自动生成邮箱（如 `user@example.com`、`auto@xxx.com` 等）\r\n> 4. 用户未提供邮箱 → 停止执行，回复：\r\n>    \"请提供您的邮箱地址以注册 SmartLib 文献检索服务（新用户免费 100 次/月）\"\r\n> 5. 只有用户明确输入邮箱后，才能调用 /register 或 /quota\r\n>\r\n> ## 邮箱识别自动化\r\n> 当用户消息中出现以下模式时，自动提取邮箱 → 无需再次询问：\r\n> - 明确的邮箱地址（包含 @ 符号的完整地址，如 `xxx@xxx.xxx`）\r\n> - \"我的邮箱是 xxx\" / \"email: xxx\" / \"用 xxx 注册\" / \"邮箱 xxx\"\r\n\r\n每次执行本技能时，按以下流程处理凭证（从 config.json 读取）：\r\n\r\n```\r\n读取技能目录下的 config.json\r\n检查 SMARTLIB_EMAIL 是否已配置\r\n  ├── 已配置 → 进入 Step B (配额检查)\r\n  │\r\n  └── 未配置 → 自动注册流程:\r\n        ├── ① 展示检索计划 + 询问邮箱（一句话）:\r\n        │      \"📋 我将用中英文关键词检索... 首次使用需绑定邮箱（免费 100 次/月，仅用于配额管理），请输入邮箱即可开始:\"\r\n        │      用户输入 → 写入 config.json\r\n        │\r\n        ├── ② 调智能网关注册（无需验证码，极速注册）:\r\n        │     POST {SMARTLIB_GATEWAY_URL}/register\r\n        │     Headers: {\"Authorization\": \"Bearer {SMARTLIB_GATEWAY_SECRET}\"}\r\n        │     Body: {\"email\": \"{用户邮箱}\"}\r\n        │\r\n        ├── 成功 (201/200) → Gateway 返回配额信息\r\n        │     提示: \"✅ 注册成功！本月免费 100 次，可立即使用。确认邮件已发送（邮箱验证仅充值时需要，现在不验证也能用）。\"\r\n        │     追加引导: \"请告诉我您想检索什么主题，现在就可以开始——\"\r\n        │     → 继续 Step B 配额检查 → 检索\r\n        │\r\n        └── 失败 → 提示原因 (服务暂不可用 / 网络错误等) → 终止\r\n```\r\n\r\n> **注意**：注册无需验证码，极速完成。**注册后即可立即使用全部功能**，确认邮件为可选项（仅充值时需验证邮箱）。\r\n> \r\n\r\n### Step B：配额检查 / Quota Check\r\n\r\n```\r\n凭证就绪后, 调网关查询配额:\r\n  GET <SMARTLIB_GATEWAY_URL>/quota?email=<SMARTLIB_EMAIL>\r\n  Headers: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\n\r\n  返回字段: total_remain, email_verified, plan, download_quota_free, download_reset_at, download_paid_remain, download_remain\r\n  （完整返回: user_id, email, plan, trial_total, trial_used, trial_remain, paid_total, paid_used, paid_remain, paid_expires_at, total_remain, email_verified, download_quota_free, download_reset_at, download_paid_remain, download_remain）\r\n  \r\n  如果返回 404 \"not_registered\" → 用户可能已被重置/删除\r\n    → 提示: \"检测到您的账户需要重新绑定，正在自动重新注册...\"\r\n    → 跳回 Step A ②（调 /register 重新注册，使用同一邮箱）\r\n    → 注册成功后继续配额检查\r\n  \r\n  total_remain > 20 → 静默进入检索\r\n  total_remain 5-20 → 尾部轻提示: \"📊 本月剩余 {n} 次\"\r\n  total_remain 1-5  → 警告: \"⚠️ 接近用尽（剩余 {n} 次），已为你列出可用套餐（见下方💰章节），需要更高额度随时说「升级」\"\r\n  total_remain 0    → 配额耗尽处理（见配额耗尽章节）\r\n\r\n  额外检查:\r\n```\r\n\r\n### Step C：按接口调用次数消耗配额 / Per-API-Call Quota Consumption\r\n\r\n本技能的配额按**实际 API 接口调用次数**计费，不是按对话会话计费。\r\n\r\n共涉及 **5 个接口**（分3类），每次调用其中任意一个接口计 **1 次**配额。\r\n\r\n> Quota is consumed **per API call**, not per conversation session. **5 interfaces** in 3 categories, each call = 1 quota.\r\n\r\n**计费接口清单（5个）/ Billable Interfaces (5 total):**\r\n\r\n| 类别 | 接口 | API 端点 | 计费 |\r\n|------|------|---------|------|\r\n| **检索** | 中文期刊检索 | API 1 `Articlesearch` | 每次调用 **1 次** |\r\n| **检索** | 全球文献检索 | API 4 `Articlesearch` | 每次调用 **1 次** |\r\n| **详情** | 中文期刊详情 | API 1/5 `Articledetail` | 每次调用 **1 次** |\r\n| **详情** | 全球文献详情 | API 4/5 `Articledetail` | 每次调用 **1 次** |\r\n| **下载** | 中文期刊全文下载 | API 3 `GetArticleFile` | 每次调用 **1 次** |\r\n\r\n> 注：全球文献（API 4）无全文下载接口，仅返回元数据。\r\n\r\n**计次示例 / Counting Examples:**\r\n\r\n```\r\n示例1：用户请求\"查10篇工业母机论文，下载5篇中文PDF\"\r\n  → 检索接口：中文1次 + 英文1次         = 2 次\r\n  → 详情接口：查5篇详情                   = 5 次\r\n  → 下载接口：下载5篇PDF                  = 5 次\r\n  → 合计消耗: 12 次配额\r\n```\r\n\r\n```\r\n示例2：用户请求\"帮我看看这篇论文的详情\"（1篇）\r\n  → 详情接口：1次                         = 1 次\r\n  → 合计消耗: 1 次配额\r\n```\r\n\r\n```\r\n示例3：用户仅请求\"检索人工智能论文\"（不查看详情、不下载）\r\n  → 检索接口：1次（或2次，若中英文并行） = 1-2 次\r\n  → 合计消耗: 1-2 次配额\r\n```\r\n\r\n**扣减方式 / Deduction Method:**\r\n\r\n**⚠️ 强制执行规则：每次调用计费接口前，必须先调 `/consume` 获取 token，再用 token 调 `/search`。**\r\n\r\n每次调用计费接口的流程：\r\n\r\n```\r\n① POST <SMARTLIB_GATEWAY_URL>/consume\r\n   Headers: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\n   Body: {\"email\": \"<SMARTLIB_EMAIL>\", \"skill_source\": \"global-biblio-base\"}\r\n\r\n   返回 200 → 获取 consume_token，继续\r\n   返回 429 → 配额已用完，终止后续调用，按 §配额耗尽处理 自动弹出套餐选择\r\n\r\n② POST <SMARTLIB_GATEWAY_URL>/search\r\n   Headers: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\n   Body: {\r\n       \"email\": \"<SMARTLIB_EMAIL>\",\r\n       \"consume_token\": \"<上一步返回的token>\",\r\n       \"skill_source\": \"global-biblio-base\",\r\n       \"api_path\": \"/openapi/t/data0012/doccenter/Articlesearch\",\r\n       \"api_body\": {<检索请求体>}\r\n   }\r\n\r\n   返回 200 → 检索成功\r\n   返回 401 → token 无效/过期/已用，需重新 /consume\r\n```\r\n\r\n> **MANDATORY**: Call `/consume` → `/search` for **EACH** billable API call. Token is single-use, expires in 60s. If 401 on /search, re-consume.\r\n\r\n**🛡️ Token 绑定调用链 / Token-Bound Call Chain:**\r\n\r\n> **强制安全机制 — 不可绕过：**\r\n> 每次调用计费接口前，必须通过 `/consume` 获取 `consume_token`，然后将 token 传给 `/search` 代理端点。\r\n> Gateway 验证 token 签名 + 有效期 + 防重放后才转发检索请求。\r\n> Token 由 GATEWAY_SECRET 签名，AI 无法伪造。无有效 token 则 /search 直接 401。\r\n>\r\n> **调用流程 / Call Flow:**\r\n> ```\r\n> 1. POST /consume {\"email\":\"...\", \"skill_source\":\"global-biblio-base\"} → 返回 consume_token\r\n> 2. POST /search {\"email\":\"...\", \"consume_token\":\"...\", \"skill_source\":\"global-biblio-base\", \"endpoint\":\"/search/cn\", \"rule\":\"...\"}\r\n>    → Gateway 验证 token → 代理转发到检索 API → 返回检索结果\r\n> ```\r\n>\r\n> **注意**：每个 consume_token 只能使用一次（防重放），有效期 60 秒。每次检索 API 调用前都需要先 /consume 获取新 token。\r\n\r\n**🆕 v36 行为：仅成功调用消耗配额 / Quota Deducted on Success Only:**\r\n\r\n> `/consume` 仅验证配额可用性 + 签发 token，**不预扣配额**。配额在实际调用 SmartLib API 且返回成功后，由 Gateway 自动扣除。\r\n> **失败的 API 调用不消耗配额**（如参数错误导致 400、网络错误导致 500 等）。\r\n> `/consume` 返回的 `total_remain, email_verified, plan` 反映的是当前已成功调用的次数，非预扣后的值。\r\n\r\n**不计费的操作 / Non-billable Operations:**\r\n\r\n| 操作 / Operation | 说明 / Note |\r\n|------|------|\r\n| /consume 配额消费 | Gateway 验证，不计费 |\r\n| 联网关键词扩展 | Web search，不计费 |\r\n| 结果排序/格式化展示 | 本地处理，不计费 |\r\n| 多级 OA PDF 探测 | 外部免费 API（ArXiv/Unpaywall/CORE/OpenAlex等），**不消耗 SmartLib 配额** |\r\n| 原始来源链接展示 | Source 字段随详情接口返回，不计额外费用 |\r\n\r\n\r\n---\r\n\r\n## 💰 套餐与额度 / Plans & Quota\r\n\r\n- 计费与升级由 SmartLib **统一钱包**管理，所有文献检索技能**统一定价、配额共享**。\r\n- **配额不足时自动弹套餐**：检索或下载配额接近用尽 / 已耗尽时，技能直接在对话中弹出下方套餐选择卡片，无需用户说任何口令；用户也可主动说「升级 / 充值 / 购买 / 我要升级」唤起同一卡片。\r\n- 企业 / 机构定制（API 接入、私有化部署）请联系 vipsmart@vipslib.com。\r\n\r\n### 当前套餐（与云端 v3.9.1 同步）\r\n\r\n| 套餐 | plan key | 价格 | 检索次数 | 下载次数 | 有效期 | 限购 | 适用 |\r\n|------|----------|------|---------|---------|--------|------|------|\r\n| 体验卡 | `trial_card` | ¥9.9 | 1000 | 20 | 7天 | 每用户1次 | 尝鲜/临时 |\r\n| 个人版月 | `personal_month` | ¥39 | 1000 | 50 | 30天 | — | 个人常规 |\r\n| 专业版月 | `pro_month` | ¥99 | 2000 | 200 | 30天 | — | 重度/小团队 |\r\n| 单篇下载 | `single_download` | ¥2.5 | 0 | 1 | 不限 | — | 只差几篇下载 |\r\n| 下载包 | `download_pack` | ¥20 | 0 | 10 | 30天 | — | 批量下载 |\r\n| 企业/机构 | `enterprise` | 暂停 | — | — | — | — | 联系我们 |\r\n\r\n> 下载耗尽时优先推荐「单篇下载 / 下载包」；检索耗尽时优先推荐「体验卡 / 个人版月 / 专业版月」。\r\n\r\n### 支付流程（对话内完成，用户回复数字即可）\r\n\r\n```\r\n检测到配额信号（/quota 返回 quota_low / quota_exhausted，或 /consume 返回 429，或 download_remain==0）\r\n   ↓\r\n① 渲染套餐卡片（数字①②③④⑤标注，如上表），并提示\"回复数字选择，扫码即付\"\r\n   用户回复数字 → 映射 plan key（如 \"3\" → pro_month）\r\n   ↓\r\n② 创建订单（支付宝）:\r\n   POST {SMARTLIB_GATEWAY_URL}/api/pay/alipay/create\r\n   Headers: 无需认证（网关仅校验邮箱已注册，不要求 Authorization；严禁在对话/前端暴露任何密钥）\r\n   Body: {\"plan\": \"<plan_key>\", \"email\": \"<已注册用户邮箱>\", \"amount\": <套餐价格，单位「元」，须与上表「价格」列完全一致>}\r\n   ⚠️ email 必须是当前已注册用户邮箱（来自注册/配额上下文），严禁使用 config 里的 SMARTLIB_EMAIL（其值为 null）。\r\n   ⚠️ amount **必填且必须精确等于上方套餐表的「价格」**（网关会校验，偏差 >0.01 元直接 400 amount_mismatch）。取值：trial_card=9.9 / personal_month=39 / pro_month=99 / single_download=2.5 / download_pack=20。严禁留空、严禁写 0、**严禁用「分」**（如 990 会被判成 ¥990 而失败）。\r\n   返回: {\"qr_code\", \"out_trade_no\", \"amount\", \"plan\", \"quota\", \"channel\":\"alipay\"}\r\n   ↓\r\n③ 生成支付宝付款码 HTML（用 qrcode.js 渲染 qr_code；页面含套餐名/金额/配额/二维码/订单号；禁止显示用户邮箱）\r\n   ↓\r\n④ 轮询支付状态:\r\n   GET {SMARTLIB_GATEWAY_URL}/api/pay/alipay/status?out_trade_no=<out_trade_no>\r\n   （3s 轮询，最多 20 次≈60s；超时提示重新发起）\r\n   支付成功返回 {\"status\":\"paid\",\"out_trade_no\":...} → 对话通知\"✅ 支付成功，已到账 N 次\" + 自动重试上次中断的检索\r\n```\r\n\r\n### ⚠️ 半成功态（支付宝创单失败 / 502）处理\r\n\r\n`/api/pay/alipay/create` 在「订单创建请求已受理、但支付宝侧暂忙/异常」时会返回 **502**，响应体形如 `{\"error\":\"alipay_error\",\"message\":\"支付宝创单失败: ...\"}`——**注意：该失败响应不含 `out_trade_no`**，请勿编造或展示任何订单号。\r\n\r\n正确处理方式（务必遵守）：\r\n\r\n1. **绝不展示任何你自行推断/拼接/记忆的订单号。** 502 失败响应里没有可用单号。\r\n2. 直接告知用户支付码暂未生成，引导稍后重试：\r\n   > 支付宝支付通道暂时繁忙，订单尚未生成。请 1~2 分钟后回复「重试」，我会重新发起并生成新的付款码。此过程未产生任何扣款。\r\n3. 说明：**每次「重试」都会由网关新建一笔订单**，旧 pending 订单自动失效、无害，用户无需做任何清理。\r\n4. **不要说「复用此订单重试」**——网关不支持复用 pending 单重新发起支付，重试一定是新单。\r\n\r\n> 对比：若返回 **200** 且 body 含 `qr_code` + `out_trade_no`，才是真正下单成功，此时才渲染二维码并展示真实订单号（见上方 ③）。\r\n\r\n### 安全机制\r\n- `out_trade_no` UNIQUE 防重复充值；二维码 5 分钟有效\r\n- `/api/pay/alipay/status` 为公开端点（无需 Bearer），可直接轮询\r\n- `SMARTLIB_GATEWAY_SECRET` 仅后端调用，不在对话中输出\r\n- 生成的支付页面**禁止显示用户邮箱**\r\n\r\n---\r\n\r\n## 🔒 配额耗尽处理 / Quota Exhaustion\r\n\r\n配额耗尽后，**暂停新的检索请求**，不再展示任何部分结果，并**自动弹出套餐选择卡片**（见上方💰章节），不再要求用户说「我要升级」。\r\n\r\n| 状态 | 行为 |\r\n|------|------|\r\n| **配额充足** (>0) | 正常执行检索，完整展示所有结果（含详情查看、全文下载、智能排序） |\r\n| **配额偏低** (≤10 且无付费余额) | 尾部轻提示 + 自动弹出套餐卡片（软引导） |\r\n| **配额耗尽** (=0) | Gateway 返回 429，拒绝服务，**自动弹出套餐卡片**（硬引导）；企业 / 机构定制仍联系我们 |\r\n\r\n配额耗尽时的引导格式：\r\n\r\n```\r\n⚠️ 您的 SmartLib 配额已用尽，已为您列出可用套餐：\r\n\r\n① 体验卡 ¥9.9 — 1000 检索 + 20 下载 / 7天\r\n② 个人版月 ¥39 — 1000 检索 + 50 下载 / 30天\r\n③ 专业版月 ¥99 — 2000 检索 + 200 下载 / 30天\r\n④ 单篇下载 ¥2.5 — 1 次下载\r\n⑤ 下载包 ¥20 — 10 次下载 / 30天\r\n\r\n回复数字选择，或说「升级 / 充值」重新唤起。\r\n企业 / 机构批量定制、API 接入或私有化部署请联系：\r\n📧 vipsmart@vipslib.com  ☎️ 023-63016015  🌐 https://www.vipslib.com/\r\n```\r\n\r\n**重要规则**：\r\n- 配额耗尽后，所有检索请求一律拒绝，不展示任何结果\r\n- 不再要求用户说「我要升级」——配额信号会自动唤起套餐卡片\r\n- 企业 / 机构定制仍联系我们\r\n\r\n\r\n## 输出规范 / Output Standards\r\n\r\n**每次检索结果末尾必须展示配额状态：**\r\n\r\n```\r\n📊 本次消耗 3 次 | 剩余 82 次 (共 100 次/月)\r\n```\r\n或接近耗尽时：\r\n```\r\n⚠️ 剩余 3 次 (共 100 次/月)，已为你列出可用套餐（回复数字即可购买，或说「升级」唤起）\r\n```\r\n\r\n```\r\n```\r\n\r\n## 核心能力 / Core Capabilities\r\n\r\n| 能力 / Capability | 说明 / Description |\r\n|------|------|\r\n| **中文期刊检索 / Chinese Journal Search** | 8000万篇授权中文期刊文献，支持全文下载 / 80M authorized Chinese journal articles with full-text download |\r\n| **全球文献检索 / Global Literature Search** | 10亿篇中外文文献元数据（含中英文论文、专利、标准、学位论文等）/ 1B global literature metadata (papers, patents, standards, theses) |\r\n| **文献详情 / Article Detail** | 查看摘要、DOI、基金资助、核心收录等完整信息 / View abstracts, DOI, funding, core journal indexing |\r\n| **全文下载 / Full-text Download** | 授权中文期刊支持 PDF 全文下载 / PDF download for authorized Chinese journals |\r\n| **原始来源链接 / Source Links** | 每篇文献提供多个原始数据库详情链接（覆盖300+数据库，如Scopus/WoS/EI/PubMed等），覆盖率100%，平均4.75个/篇，可直接验证文献真实性 / Multi-database source links for authenticity verification |\r\n| **OA文献免费下载 / OA Free Download** | 十级多渠道自动探测OA文献PDF（ArXiv/Unpaywall/CORE/OpenAlex等），Gold/Hybrid/Bronze/Green OA免费获取，**不消耗SmartLib配额** / OA PDF auto-detection via 10 channels, no quota consumption |\r\n| **智能关键词扩展 / Smart Keyword Expansion** | 联网检索中英文同义词/近义词，自动扩展检索词，提升召回率 / Web search for synonyms to expand search terms |\r\n| **核心期刊优先排序 / Core Journal Priority** | 联网查询核心收录情况（SCI/EI/北大核心/CSSCI等），优先展示高水平文献 / Rank by core journal indexing (SCI/EI/CSSCI etc.) |\r\n| **相关性智能排序 / Relevance Ranking** | 基于题名、关键词、摘要语义分析，对检索结果进行二次相关性排序 / Semantic relevance re-ranking |\r\n| **少结果智能扩展 / Low-result Expansion** | 结果过少时自动推荐上位词、相关机构、学科分类号等多种扩展策略 / Auto-suggest broader terms and alternative strategies |\r\n\r\n## 能力边界 / Capability Boundaries\r\n\r\n### 支持的功能 / Supported\r\n\r\n- 中文期刊论文检索、详情、全文下载（8000 万篇授权文献）\r\n- 全球文献元数据检索（10 亿篇，含论文/专利/标准/学位论文等）\r\n- 关键词智能扩展、核心期刊优先排序、少结果自动扩展\r\n- 自然语言输入，无需学习检索语法\r\n\r\n### 不支持的功能 / Not Supported\r\n\r\n- **付费墙内英文文献全文下载**：通过 SmartLib API 4 查到的全球文献仅返回元数据。本技能已集成十级多渠道下载策略（ArXiv/Unpaywall/CORE/OpenAlex/Semantic Scholar/Crossref/DOI.org/Europe PMC/bioRxiv/medRxiv + CDP浏览器），可免费获取 OA 版本（Gold/Hybrid/Bronze/Green OA），**OA 下载不消耗 SmartLib 配额**。但付费墙内（closed access）文献无法获取全文\r\n- **付费墙内文献**：不提供需单独购买的文献全文\r\n- **批量导出**：不提供 EndNote/BibTeX 等格式的批量导出功能\r\n- **文献查重/查新**：不具备论文查重或科技查新功能\r\n\r\n### 使用限制 / Limitations\r\n\r\n| 限制项 / Limit | 说明 / Description |\r\n|------|------|\r\n| **单次查询条数 / Per-query limit** | PageSize 20-1000，建议 ≤100 以保证速度 / Recommend ≤100 |\r\n| **翻页上限 / Max pages** | 无硬限制，但建议不超过 50 页（共 1000 条）/ No hard limit, but ≤50 pages recommended |\r\n| **请求频率 / Rate limit** | 有频率限制（未公开数值），触发 429 时自动等待重试 / Undisclosed limit; auto-retry on 429 |\r\n| **Token 有效期 / Token TTL** | Access Token 30 秒，Refresh Token 2 小时。系统自动管理刷新 / Access Token 30s, Refresh Token 2h. Auto-managed. |\r\n| **下载链接有效期 / Download URL TTL** | 约 10 分钟，过期需重新调用下载接口 / ~10min, re-call download API |\r\n| **依赖 / Dependencies** | 完全依赖 SmartLib API 和网络连接，离线不可用 / Requires network + SmartLib API |\r\n\r\n### 触发意图区分 / Trigger Intent Differentiation\r\n\r\n| 用户表达 / User Expression | 系统行为 / System Behavior | 区分逻辑 / Rationale |\r\n|------|------|------|\r\n| \"查论文\"、\"找文献\"、\"检索XX\" / \"Search XX papers\" | **触发本 Skill**，精准检索，默认平衡策略 | 明确的检索意图 |\r\n| \"写文献综述\"、\"帮我写综述\" / \"Write a literature review\" | **触发本 Skill**，切换为综述模式：宽检索策略、去重合并、按主题聚类 | 综述需更全的覆盖范围和聚类分析 |\r\n| \"帮我写论文开头/引言\" / \"Write paper intro, need citations\" | **触发本 Skill**，窄检索策略：找 3-5 篇最相关引用，核心期刊优先 | 写作引用需要精准而非全面 |\r\n| \"这段论述有文献支撑吗\"、\"找几篇引用\" / \"Find supporting citations\" | **触发本 Skill**，窄检索 + 核心期刊优先，提供可引用的高质量文献 | 文献支撑场景需要高可信度来源 |\r\n| \"这篇论文是真的吗\"、\"核查引用\" / \"Verify this citation\" | **不触发本 Skill**，应转至 smartlib-citation-checker | 引用核查是独立能力 |\r\n| \"帮我写论文\"、\"写作辅助\" / \"Help me write\" | **不触发本 Skill** | 论文写作不是文献检索功能 |\r\n| \"下载这篇论文的 PDF\" / \"Download this paper's PDF\" | **触发本 Skill**（若有中文期刊 ID） | 下载是检索的延伸功能 |\r\n\r\n## 数据范围 / Data Coverage\r\n\r\n平台累计汇聚各类资源元数据总量达 **12.28 亿条**。\r\n\r\n> The platform aggregates **1.228 billion** metadata records.\r\n\r\n### 核心文献类型存量规模 / Core Literature Type Inventory\r\n\r\n| 文献类型 / Type | 存量规模 / Inventory | 说明 / Notes |\r\n|------|------|------|\r\n| **期刊文献 / Journal Articles** | **7.19 亿条 / 719M** | 平台核心资源 / Largest category |\r\n| **专利资源 / Patents** | **2.15 亿条 / 215M** | 第二大品类 / Second largest |\r\n| **会议论文 / Conference Papers** | **7155 万条 / 71.55M** | — |\r\n| **学位论文 / Theses & Dissertations** | **2473 万条 / 24.73M** | — |\r\n| **标准资源 / Standards** | **268 万条 / 2.68M** | — |\r\n\r\n### 可检索数据集 / Searchable via API\r\n\r\n- **中文期刊数据集 / Chinese Journal Dataset**：8000 万篇授权中文期刊文献，支持全文下载 / 80M authorized Chinese journal articles with full-text download\r\n- **全球文献数据集 / Global Literature Dataset**：覆盖全平台 12.28 亿条元数据 / Covers all 1.228B metadata records\r\n\r\n## 环境配置 / Environment Configuration\r\n\r\n配置存储于技能目录下的 `config.json`：\r\n\r\n> Config persisted at skill-level config.json:\r\n\r\n```json\r\n{\r\n  \"SMARTLIB_GATEWAY_URL\": \"https://<your-gateway>.ap-shanghai.tencentscf.com\",\r\n  \"SMARTLIB_GATEWAY_SECRET\": \"<your-gateway-secret>\",\r\n  \"SMARTLIB_EMAIL\": null\r\n}\r\n```\r\n\r\nGateway 自动管理 SmartLib 凭证, 你不需要 APPID/APPSECRET。用户的 EMAIL 在首次注册后自动写入。运行前先读取 config.json 获取网关地址和密钥。\r\n\r\n## Token 管理 / Token Management\r\n\r\nSmartLib 的 OAuth Token 由 Gateway 全权管理。你无需获取或缓存 Token。\r\n\r\nGateway 支持两种检索调用模式：\r\n\r\n### 推荐：语义化端点（v36+，更简洁）\r\n\r\n```\r\nPOST /search\r\nHeaders: {\"Authorization\": \"Bearer <SECRET>\"}\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<token>\",\r\n  \"skill_source\": \"global-biblio-base\",\r\n  \"endpoint\": \"/search/cn\",     // 或 /search/global, /detail/cn, /detail/global\r\n  \"rule\": \"K=人工智能\",          // 检索表达式\r\n  \"page_index\": 1,\r\n  \"page_size\": 20,\r\n  \"sort\": 1                     // 可选\r\n}\r\n```\r\n\r\n支持的 endpoint：`/search/cn` `/detail/cn` `/download/cn` `/search/global` `/detail/global`\r\n\r\n### 兼容：全代理模式（旧版，仍可用）\r\n\r\n```\r\nPOST /search\r\nBody: {\r\n  \"email\": \"...\",\r\n  \"consume_token\": \"...\",\r\n  \"skill_source\": \"global-biblio-base\",\r\n  \"api_path\": \"/openapi/t/data0012/doccenter/Articlesearch\",\r\n  \"api_body\": {\"Rule\": \"...\", \"PageIndex\": 1, \"PageSize\": 20}\r\n}\r\n```\r\n\r\n## 检索接口选择策略 / Search Interface Selection\r\n\r\n| 用户需求特征 / User Intent | 推荐接口 / Recommended API | 原因 / Reason |\r\n|-------------|---------|------|\r\n| 查中文论文/需要全文 / Chinese papers, need full-text | 接口1（中文期刊检索）/ API 1 | 支持全文下载 / Full-text available |\r\n| 查英文论文/国际期刊 / English papers, intl. journals | 接口4（全球文献检索）/ API 4 | 覆盖范围更广 / Broader coverage |\r\n| 需要专利/标准/学位论文 / Patents, standards, theses | 接口4（全球文献检索）/ API 4 | 支持多种文献类型 / Multi-type support |\r\n| 不确定/跨语言检索 / Uncertain, cross-language | 优先接口4，再补充接口1 / API 4 first, supplement API 1 | 互为补充 / Complementary |\r\n| 明确指定中文来源 / Explicit Chinese source | 接口1（中文期刊检索）/ API 1 | 数据更精准 / More precise |\r\n\r\n## 检索策略分级体系 / Search Strategy Hierarchy\r\n\r\n### 策略选择决策表 / Strategy Selection Matrix\r\n\r\n| 检索场景 / Scenario | 推荐策略 / Strategy | 目标 / Goal |\r\n|------|------|------|\r\n| 开题报告、文献综述、查新 / Thesis proposal, literature review, novelty check | **宽检索 / Broad** | 查全优先 / Recall-first |\r\n| 精准溯源、单篇确认、引用支撑 / Precise trace, citation verification, evidence finding | **窄检索 / Narrow** | 查准优先 / Precision-first |\r\n| 常规文献调研、一般检索 / General literature survey | **平衡策略 / Balanced (default)** | 查全查准兼顾 / Balanced |\r\n\r\n### 策略切换信号 / Strategy Switch Signals\r\n\r\n执行检索后，系统根据结果自动评估是否需要切换策略：\r\n\r\n- 结果 > 500 条且前 10 条相关性差 → 提示切换为**窄检索**\r\n- 结果 < 5 条 → 提示切换为**宽检索**（执行「结果数量自适应策略」）\r\n- 结果方向偏（前 10 条均不相关）→ 提示**更换关键词或字段**\r\n\r\n---\r\n\r\n## 可用接口 / Available Interfaces\r\n\r\n### 1. 中文期刊文献检索 / Chinese Journal Search\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/data0012/doccenter/Articlesearch\",\r\n  \"api_body\": {\r\n    \"Rule\": \"<检索表达式>\",\r\n    \"PageIndex\": 1,\r\n    \"PageSize\": 20,\r\n    \"Sort\": 1,\r\n    \"FilterRule\": \"<可选：过滤表达式>\"\r\n  }\r\n}\r\n```\r\n\r\n**检索表达式规则（Rule，必填）：**\r\n- 字段代码：`T`=题名，`A`=作者，`K`=主题词，`P`=出版物名称，`O`=机构，`U`=全部字段\r\n- 逻辑运算符（必须大写，两边空格）：`AND` `OR` `NOT`\r\n- 示例：`(K=人工智能 OR K=机器学习) AND O=清华大学`、`T=深度学习`\r\n\r\n**过滤表达式规则（FilterRule，可选）：**\r\n- 字段代码：`L`=中图分类号，`C`=学科分类号，`Y`=出版年份，`TY`=文献类型，`LA`=语言\r\n- 文献类型 TY：3=期刊文献，4=学位论文，5=标准，7=专利，等\r\n- 示例：`TY=3 AND Y=2024`\r\n\r\n**排序 Sort：** 1=相关度（默认），2=时效性倒序，3=时效性正序\r\n**PageSize 范围：** 20~1000\r\n\r\n### 2. 中文期刊文献详情 / Chinese Journal Detail\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/data0011/doccenter/Articledetail\",\r\n  \"api_body\": {\r\n    \"Identifier\": \"<文献ID>\"\r\n  }\r\n}\r\n```\r\n\r\n返回完整文献详情，包含摘要、DOI、页码、基金资助、核心收录、原始数据库来源链接等。\r\n\r\n### 3. 中文期刊文献下载 / Chinese Journal Download\r\n\r\n仅限授权中文期刊全文下载。\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/data0013/doccenter/GetArticleFile\",\r\n  \"api_body\": {\r\n    \"Identifier\": \"<文献ID>\"\r\n  }\r\n}\r\n```\r\n\r\n返回 / Response：`{\"Data\": {\"Url\": \"<下载链接>\", \"Identifier\": \"<文献ID>\"}}`\r\n\r\n---\r\n\r\n### 3b. 全球文献全文多渠道下载 / Multi-channel Full-text Download\r\n\r\nSmartLib API 3 仅覆盖中文期刊全文。对于 API 4（全球文献检索）查到但有 DOI 的国际论文，本技能提供多级多渠道下载策略，最大化免费获取成功率。\r\n\r\n#### ⚡ 执行触发条件 / Execution Trigger\r\n\r\n**仅在用户主动请求全文下载时才执行外文文献下载流程。** 检索结果展示后，默认只展示元数据；用户说\"下载全文\"/\"获取PDF\"/\"帮我下载\"时才触发。\r\n\r\n> Full-text download is **user-triggered only**. After search results are displayed, only metadata is shown. Execute download only when the user explicitly requests full-text (e.g., \"下载全文\", \"获取PDF\", \"帮我下载\").\r\n\r\n**触发关键词 / Trigger Keywords:**\r\n- 中文：「下载全文」「获取PDF」「帮我下载」「我要看全文」「下载这篇/这些」\r\n- 英文：`download full-text` / `get PDF` / `download this paper`\r\n\r\n**执行规则 / Execution Rules:**\r\n\r\n```\r\n用户请求下载全文:\r\n  ├── 中文期刊文献 → 调 API 3 下载 PDF（直接）\r\n  └── 外文文献（API 4，有 DOI）\r\n       ├── 按渠道优先级 1→10 自动逐级尝试\r\n       ├── 任一渠道成功 → 停止后续渠道，标记结果\r\n       ├── 全部失败 → 按失败分类标记\r\n       └── 每篇文献独立执行，并行处理（最多 10 篇并发）\r\n```\r\n\r\n**结果标记规范 / Result Tagging Standard:**\r\n\r\n每篇外文文献下载完成后，必须在结果列表中标记获取状态。标记使用明确的图标+文字：\r\n\r\n| 标记 / Tag | 含义 / Meaning | 触发条件 |\r\n|------|------|------|\r\n| `[全文:已获取 ✓]` | PDF 已成功下载 | 任一渠道成功获取 PDF 文件 |\r\n| `[全文:在线 📖]` | 可在线阅读但无法自动下载 | Bronze OA / 出版商防盗链 |\r\n| `[全文:付费 💰]` | 付费墙内，需机构订阅或购买 | Closed access / 所有渠道均返回 403 |\r\n| `[全文:手动 🔍]` | 所有渠道均失败，需用户手动获取 | 无 OA 版本 / 网络错误 / 无 DOI |\r\n| `[全文:未尝试 -]` | 无 DOI 或未触发下载流程 | 文献无 DOI 或 API 4 未返回 DOI |\r\n\r\n**结果展示格式 / Display Format:**\r\n\r\n检索结果列表中，每篇外文文献末尾追加标记：\r\n\r\n```\r\n1. [SCI一区] Attention Is All You Need\r\n   Vaswani A, Shazeer N, Parmar N, et al.\r\n   Advances in Neural Information Processing Systems, 2017\r\n   摘要: The dominant sequence transduction models are based on...\r\n   DOI: 10.5555/3295222.3295349\r\n   [全文:已获取 ✓] → papers/attention_is_all_you_need.pdf\r\n```\r\n\r\n**渠道执行报告 / Channel Execution Report:**\r\n\r\n所有文献下载完成后，在结果末尾输出汇总表：\r\n\r\n```\r\n## 📥 外文文献全文获取报告 / Full-text Retrieval Report\r\n\r\n| # | 文献标题 | DOI | 成功渠道 | 状态 | 备注 |\r\n|---|---------|-----|---------|------|------|\r\n| 1 | Attention Is All You Need | 10.5555/xxx | ArXiv (渠道1) | [全文:已获取 ✓] | — |\r\n| 2 | BERT: Pre-training of... | 10.18653/v1/xxx | Unpaywall (渠道2) | [全文:已获取 ✓] | — |\r\n| 3 | Closed-access paper | 10.1000/xxx | — | [全文:付费 💰] | Elsevier 付费墙 |\r\n| 4 | Bronze OA paper | 10.1093/xxx | DOI.org (渠道7) | [全文:在线 📖] | OUP Bronze OA，需手动保存 |\r\n| 5 | No DOI paper | — | — | [全文:手动 🔍] | 无 DOI，建议联系作者 |\r\n\r\n> ✅ 成功 2/5 篇 | 📖 需在线阅读 1 篇 | 💰 付费墙 1 篇 | 🔍 需手动获取 1 篇\r\n```\r\n\r\n#### 渠道优先级 / Channel Priority\r\n\r\n| 优先级 | 渠道 | 适用条件 | 可靠性 | 费用 |\r\n|:--:|------|------|:--:|------|\r\n| **1** | **ArXiv 直链** | 论文有 arxiv ID | ★★★★★ | 免费 |\r\n| **2** | **Unpaywall OA 探测** | 有 DOI + 邮箱 | ★★★★☆ | 免费 |\r\n| **3** | **CORE OA 聚合器** | 有 DOI + API Key | ★★★★☆ | 免费 |\r\n| **4** | **OpenAlex 存档 PDF** | 有 DOI + API Key | ★★★★☆ | 免费 $1/天 |\r\n| **5** | **Semantic Scholar PDF** | 有 API Key | ★★★☆☆ | 免费 |\r\n| **6** | **Crossref 链接提取** | 有 DOI | ★★★☆☆ | 免费 |\r\n| **7** | **DOI.org 重定向** | 有 DOI | ★★☆☆☆ | 免费 |\r\n| **8** | **Europe PMC + PMC** | 生命科学/医学 DOI | ★★★☆☆ | 免费 |\r\n| **9** | **bioRxiv/medRxiv** | 生命科学预印本 | ★★★★☆ | 免费 |\r\n| **10** | **真实浏览器 CDP** | Bronze/Green OA | ★★★★☆ | 需服务器 |\r\n\r\n#### 下载决策树 / Download Decision Tree\r\n\r\n```\r\n用户请求下载某篇论文\r\n  ├─ 文献来自 API 1（中文期刊）→ 调 API 3（中文期刊下载）\r\n  └─ 文献来自 API 4（全球文献）或仅有 DOI\r\n       ├─ 有 ArXiv ID？ → 渠道 1：ArXiv 直链\r\n       ├─ 获取 DOI → 渠道 2：Unpaywall OA状态探测\r\n       ├─ 渠道 3：CORE 全球OA聚合器\r\n       ├─ 渠道 4：OpenAlex 存档PDF\r\n       ├─ 渠道 5：Semantic Scholar PDF\r\n       ├─ 渠道 6：Crossref PDF 链接提取\r\n       ├─ 渠道 7：DOI.org 内容协商重定向\r\n       ├─ 渠道 8：Europe PMC + PMC\r\n       ├─ 生物医学 → 渠道 9：bioRxiv/medRxiv 预印本\r\n       └─ 全部失败 + Bronze/Green OA？ → 渠道 10：真实浏览器 CDP\r\n```\r\n\r\n#### 出版商排障表 / Publisher Troubleshooting\r\n\r\n| 出版商 | 常见错误 | 原因 | 应对方案 |\r\n|------|------|------|------|\r\n| **OUP (Oxford)** | 403 Forbidden | Bronze OA，不开放自动化下载 | 渠道 10 CDP 模拟人工点击 |\r\n| **IEEE** | 403 / 418 | 需机构订阅 IP | CC-BY 论文可直接下；其余需机构权限 |\r\n| **Elsevier** | 403 | 付费墙 | 查 Green OA 版本 |\r\n| **Springer Nature** | 403 / 418 | 付费墙 + 机器人检测 | 查 ArXiv 预印本 |\r\n| **Nature / Science** | 403 | 几乎无免费 PDF | 查作者自存档 |\r\n| **Wiley** | 403 | 付费墙 | 同 Elsevier |\r\n\r\n#### 失败分类与用户引导 / Failure Classification\r\n\r\n| 失败原因 | 用户提示 |\r\n|------|------|\r\n| **Bronze OA（出版商防盗链）** | 该论文为 Bronze OA——出版商允许免费阅读但禁止自动化下载。建议：[点击在线阅读]({url}) 手动保存 |\r\n| **Closed（付费墙）** | 该论文在付费墙内。建议：1) 通过机构图书馆访问 2) 搜索 ArXiv/bioRxiv 预印本 3) 通过科研通求助 |\r\n| **所有渠道均失败** | 所有下载渠道均未获取到全文。建议：[在线阅读]({url}) 或联系通讯作者请求 PDF |\r\n\r\n---\r\n\r\n### 4. 全球文献检索 / Global Literature Search\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/skrs2/doccenter/Articlesearch\",\r\n  \"api_body\": {\r\n    \"Rule\": \"<检索表达式>\",\r\n    \"PageIndex\": 1,\r\n    \"PageSize\": 20,\r\n    \"Sort\": 1,\r\n    \"FilterRule\": \"<可选：过滤表达式>\"\r\n  }\r\n}\r\n```\r\n\r\n检索表达式和过滤规则与中文期刊检索完全相同。网关统一返回结构：`{\"data\": {\"list\": [...], \"total\": N}, \"notifications\": [...]}`，**结果列表字段为 `data.list`（全小写）**；若个别旧接口回传 PascalCase（`Data.List`），请回退查找该键。\r\n\r\n### 5. 全球文献详情 / Global Literature Detail\r\n\r\n通过 Gateway /search 代理访问:\r\n\r\n```\r\nPOST {SMARTLIB_GATEWAY_URL}/search\r\nHeaders: {\"Authorization\": \"Bearer <SMARTLIB_GATEWAY_SECRET>\"}\r\nContent-Type: application/json\r\n\r\nBody: {\r\n  \"email\": \"<SMARTLIB_EMAIL>\",\r\n  \"consume_token\": \"<通过 /consume 获取的 token>\",\r\n  \"api_path\": \"/openapi/t/skrs1/doccenter/Articledetail\",\r\n  \"api_body\": {\r\n    \"Identifier\": \"<文献ID>\"\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## 使用指南 / Usage Guide\r\n\r\n### 完整工作流 / Complete Workflow\r\n\r\n```\r\n                    ┌──────────────────────────────────┐\r\n                    │ 1. 理解需求 / Understand Intent    │\r\n                    └───────────────┬──────────────────┘\r\n                                    ↓\r\n                    ┌──────────────────────────────────┐\r\n                    │ 2. 选定检索策略 / Select Strategy │ ← 宽检索/窄检索/平衡\r\n                    └───────────────┬──────────────────┘\r\n                                    ↓\r\n              ┌─────────────────────────────────────────┐\r\n              │ 3. 关键词智能扩展 / Keyword Expansion     │\r\n              │ 4. 构建检索式 / Build Expression          │\r\n              │ 5. 选择接口 / Select API                  │\r\n              │ 6. 执行检索 / Execute Search              │\r\n              │ 7. 结果智能排序 / Smart Ranking           │\r\n              └─────────────────────┬───────────────────┘\r\n                                    ↓\r\n                    ┌──────────────────────────────────┐\r\n                    │ 8. 结果评估 / Evaluate Results     │\r\n                    └───────────────┬──────────────────┘\r\n                          ┌─────────┴─────────┐\r\n                          ↓                   ↓\r\n              ┌───────────────────┐  ┌───────────────────┐\r\n              │ 结果满意 / Good   │  │ 结果需调整 / Needs │\r\n              │ → 步骤9          │  │ Adjustment         │\r\n              └───────┬───────────┘  └─────────┬─────────┘\r\n                      ↓                        ↓\r\n              ┌───────────────┐    ┌──────────────────────┐\r\n              │ 9. 展示结果   │    │ 9a. 策略调整          │\r\n              │ 10. 深入查看  │    │ 过多→窄化 / 过少→宽化 │\r\n              │ 11. 全文下载  │    │ 方向偏→换关键词       │\r\n              │  (中文直接下) │    └──────────┬───────────┘\r\n              │  (外文自动走) │\r\n              │  (十级渠道)   │\r\n              └───────────────┘\r\n                                              ↓\r\n                                    ┌──────────────────────┐\r\n                                    │ 9b. 二次检索         │\r\n                                    │ 回到步骤3-7          │\r\n                                    └──────────────────────┘\r\n```\r\n\r\n检索→评估→调整→再检索是核心工作流。首次检索后自动评估结果质量，必要时调整策略重新检索。\r\n\r\n**Step 11 全文下载（用户触发）：** 仅当用户主动请求时才执行全文下载：\r\n- **中文期刊**：直接调 API 3 下载 PDF\r\n- **外文文献**：走十级多渠道 OA PDF 探测（见 3b 章节），每篇独立并行执行\r\n- 下载结果以标记形式追加到结果列表中，并在末尾输出「全文获取报告」汇总表\r\n- **未触发下载时**：仅展示元数据，不执行任何下载操作\r\n\r\n### 关键词智能扩展 v2 / Smart Keyword Expansion v2\r\n\r\n> ⚠️ **核心原则**：SmartLib API 后端分词器（类似 IK Analyzer / mmseg4j）对中文复合词的索引已较完善。**召回不足的首要原因不是分词颗粒度问题，而是缩写/别名缺失、跨语言鸿沟和字段策略不当。**\r\n\r\n每次检索前，按以下 4 层策略扩展关键词：\r\n\r\n**第1层：缩写/别名扩展（优先级最高，实测 +122% 召回）**\r\n\r\n内置高频学术术语映射表（无需联网，即时可用）：\r\n\r\n| 用户常用词 | 必须扩展的别名/缩写 | 扩展后召回提升 |\r\n|-----------|-------------------|---------------|\r\n| 大语言模型 | LLM, 大模型, large language model | +122% |\r\n| 人工智能 | AI, artificial intelligence | +18% |\r\n| 自然语言处理 | NLP, natural language processing | — |\r\n| 深度学习 | deep learning, DNN, 深度神经网络 | — |\r\n| 机器学习 | machine learning, ML | +22% |\r\n| 计算机视觉 | CV, computer vision, 机器视觉 | — |\r\n| 知识图谱 | knowledge graph, KG | — |\r\n| 推荐系统 | recommender system, 个性化推荐 | — |\r\n| 强化学习 | reinforcement learning, RL | — |\r\n| 联邦学习 | federated learning, FL | — |\r\n| 区块链 | blockchain, 分布式账本 | — |\r\n| 物联网 | IoT, Internet of Things | — |\r\n| 数字孪生 | digital twin | — |\r\n| 元宇宙 | metaverse | — |\r\n| 碳中和 | carbon neutrality, 碳达峰 | — |\r\n| 文献检索 | 信息检索, information retrieval, 文献搜索 | — |\r\n| 分词 | 中文分词, word segmentation, tokenization, 切词 | — |\r\n| BERT | bidirectional encoder representations | — |\r\n| GPT | generative pre-trained transformer | — |\r\n| CNN | convolutional neural network, 卷积神经网络 | — |\r\n| RNN | recurrent neural network, 循环神经网络 | — |\r\n| GAN | generative adversarial network, 生成对抗网络 | — |\r\n\r\n> **规则**：只要用户关键词命中上表左列，必须自动添加右列的扩展词。**AI 还应自行推理**——遇到表外术语时，联网搜索其标准缩写和英文对应词（如\"Swin Transformer\" → \"Swin Transformer, Swin-T\"）。\r\n\r\n**第2层：中英互译扩展**\r\n\r\n- 中文关键词 → 必须补英文对应词（通过联网搜索确认学术通用译名）\r\n- 英文关键词 → 必须补中文对应词\r\n- 示例：`知识图谱` → 扩展 `knowledge graph`；`segmentation` → 扩展 `分割, 语义分割`\r\n\r\n**第3层：上下位词扩展（按需，联网搜索）**\r\n\r\n- 结果 < 10 条时执行：用上位词扩大范围，或用下位词增加相关结果\r\n- 示例：`深度学习` 结果少 → 上位词 `机器学习`；`自然语言处理` 结果少 → 下位词 `文本分类, 命名实体识别`\r\n\r\n**第4层：同义词/近义词扩展（联网搜索）**\r\n\r\n- 通过联网查询学术语境下的等价表述\r\n- 示例：`文献检索` → 补充 `文献发现, 文献获取, 资源发现`\r\n\r\n**检索表达式构建规则：**\r\n\r\n1. 同义词组内用 `OR` 连接，不同概念组间用 `AND` 连接\r\n2. 每组扩展词控制在 3-8 个，**缩写词优先**（收益最大）\r\n3. **重要**：中文和英文扩展词必须在同一个 OR 组内，而非分开\r\n   - ✅ `(K=大语言模型 OR K=大模型 OR K=LLM OR K=large language model)`\r\n   - ❌ `(K=大语言模型 OR K=大模型) AND (K=LLM OR K=large language model)`\r\n4. 默认字段使用 `K=`（关键词字段，精度和召回最均衡）\r\n5. **中文复合词不拆解**（API 后端分词已处理。实测：拆解为单字/n-gram 对召回增益 <15% 但噪声激增）\r\n   - ✅ `K=自然语言处理`\r\n   - ❌ `K=自然 AND K=语言 AND K=处理`（噪声大，不推荐）\r\n\r\n### 结果智能排序 / Smart Result Ranking\r\n\r\n检索结果需进行二次智能排序，综合考虑以下因素（优先级从高到低）：\r\n\r\n1. **核心收录权重**：SCI/SSCI > EI > CSSCI > 北大核心 > CSCD > 普通期刊\r\n2. **内容相关性权重**：题名匹配 > 题名+关键词 > 摘要相关 > 仅关键词命中\r\n3. **时效性权重**：近 3 年文献给予适当加分\r\n\r\n### 结果数量自适应策略 / Adaptive Result Strategy\r\n\r\n**结果过少（< 5 篇）— 宽化扩展：**\r\n\r\n1. 上位词扩展：联网搜索更泛化的术语\r\n2. 字段放宽：`T=` → `K=` → `U=`\r\n3. 相关机构检索：查找领域代表性机构\r\n4. 学科分类号检索：使用中图分类号或教育部分类号\r\n5. 放宽过滤条件：去掉时间/语言/文献类型限制\r\n6. 关键词拆分/重组\r\n\r\n**结果过多（> 500 条或相关性差）— 窄化收缩：**\r\n\r\n1. 字段收窄：`U=` → `K=` → `T=`\r\n2. 增加 AND 限定\r\n3. 核心词精简\r\n4. 强化过滤条件（限定文献类型/语言/年份）\r\n5. 排序优化\r\n\r\n### 自然语言转检索表达式示例 / NL-to-Query Examples\r\n\r\n> **字段默认使用 `K=`（关键词），而非 `U=`（全字段）。`K=` 精度高、噪声少，是学术检索的标准字段。**\r\n\r\n| 用户需求 | 扩展后的 Rule | FilterRule | 接口 |\r\n|---------|------|-----------|------|\r\n| 找关于深度学习的论文 | `(K=深度学习 OR K=deep learning OR K=DNN OR K=深度神经网络)` | - | 接口1+4 |\r\n| 清华大学发表的人工智能相关论文 | `(K=人工智能 OR K=AI OR K=artificial intelligence) AND O=清华大学` | `TY=3` | 接口1 |\r\n| 2024年中文期刊上关于大模型的文章 | `(K=大语言模型 OR K=大模型 OR K=LLM OR K=large language model)` | `TY=3 AND Y=2024 AND LA=ZH` | 接口1 |\r\n| Nature 期刊上的量子计算论文 | `(K=quantum computing OR K=量子计算) AND P=Nature` | - | 接口4 |\r\n| 查找计算机领域的专利 | `(K=计算机 OR K=computer)` | `TY=7` | 接口4 |\r\n| 2023-2025年的深度学习综述 | `(T=深度学习 OR T=deep learning) AND (T=综述 OR T=review OR T=survey)` | `Y=2023 OR Y=2024 OR Y=2025` | 接口1+4 |\r\n| 找关于知识图谱的论文 | `(K=知识图谱 OR K=knowledge graph OR K=KG)` | - | 接口1+4 |\r\n| NLP领域最新研究 | `(K=NLP OR K=自然语言处理 OR K=natural language processing)` | `Y=2024 OR Y=2025` | 接口1+4 |\r\n\r\n### 高级检索技巧 / Advanced Search Techniques\r\n\r\n#### 引文追溯策略 / Citation Tracing\r\n\r\n| 追溯方向 | 操作方式 | 适用场景 |\r\n|------|------|------|\r\n| **作者追踪** | `A=作者名` | 追踪核心研究者团队全部成果 |\r\n| **期刊溯源** | `P=期刊名 AND K=相关主题词` | 锁定高水平期刊中该领域全部论文 |\r\n| **机构扩展** | `O=机构名` | 了解机构在相关领域的研究布局 |\r\n| **参考文献反向查** | 提取参考文献标题，用 `T=` 逐一检索验证 | 确认引用文献是否在数据库中 |\r\n| **引用链追踪** | `L=分类号 OR C=分类号` | 在相同分类号下发现更多相关文献 |\r\n\r\n#### 分类号体系利用 / Classification-based Search\r\n\r\n利用中图分类号（`L=`）和教育部学科分类号（`C=`）检索可绕过关键词歧义。常用分类号：`TP18`=人工智能，`TP391.1`=自然语言处理，`O413`=量子论，`0812`=计算机科学与技术。\r\n\r\n#### 字段选择策略矩阵 / Field Selection Matrix\r\n\r\n> **默认使用 `K=`（关键词字段）**。这是学术检索的标准做法——知网的\"主题\"检索、维普的人工标引关键词、WoS 的 Topic Search 均以关键词/主题词为核心检索入口。\r\n\r\n| 字段 | 精度 | 覆盖 | 最佳场景 |\r\n|------|------|------|------|\r\n| `K=` 关键词 | 中 | 高 | **常规检索（默认）** — 对标知网\"主题\"检索 |\r\n| `T=` 题名 | 最高 | 低 | 精准匹配、引用确认 — 对标 WoS \"Title\" 检索 |\r\n| `U=` 全部字段 | 低 | 最高 | 查全兜底（仅当 K= 和 T= 结果 < 10 条时使用） |\r\n| `A=` 作者 | 高 | 低 | 追踪特定研究者 |\r\n| `O=` 机构 | 中 | 中 | 了解机构研究布局 |\r\n| `P=` 出版物 | 高 | 中 | 限定高质量期刊 |\r\n\r\n**字段分级检索流程 / Progressive Field Strategy:**\r\n\r\n```\r\n默认（平衡策略）：\r\n  第1轮：K=检索（关键词字段，平衡精度和召回）\r\n    ├─ 结果 ≥ 10 → 完成 ✅\r\n    └─ 结果 < 10 → 第2轮\r\n    \r\n  第2轮：T=检索（放宽到题名，提高召回）\r\n    ├─ 结果 ≥ 5 → 合并去重，展示 ✅\r\n    └─ 结果 < 5 → 第3轮\r\n    \r\n  第3轮：U=检索（全部字段，最大召回）\r\n    → 合并去重（U= 结果可能噪声大，需标注\"全字段检索结果\"）\r\n\r\n宽检索（综述/查全）：\r\n  同时用 K= + U= 两路并行，取并集去重\r\n\r\n窄检索（精准/引用）：\r\n  优先 T= 精确匹配，K= 辅助补充\r\n```\r\n\r\n### 结果展示规范 / Result Display Standards\r\n\r\n**检索结果列表**以编号列表形式展示，每篇文献包含：序号、核心收录标注、标题、作者、来源出版物、出版日期、摘要（截取前200字）、文献ID。\r\n\r\n**文献详情**额外展示：DOI、核心收录、原始数据库链接、SmartLib 详情页、基金资助、页码。\r\n\r\n结果按「结果智能排序」策略排列。展示后主动提示用户：\r\n- \"输入文献编号可查看详情\"\r\n- \"中文期刊文献支持全文下载\"\r\n- \"如需更多结果，可以说'下一页'\"\r\n\r\n### 检索结果质量判断 / Result Quality Assessment\r\n\r\n#### 核心收录标注解读\r\n\r\n| 标注 | 含义 | 权重 |\r\n|------|------|------|\r\n| `[SCI一区]` | 国际顶级期刊（影响因子前 25%） | 最高 |\r\n| `[SCI二区]` | 国际高水平期刊 | 高 |\r\n| `[SSCI]` | 社会科学国际核心期刊 | 最高 |\r\n| `[EI]` | 工程领域国际核心收录 | 高 |\r\n| `[CSSCI]` | 中文社会科学引文索引（南大核心） | 高 |\r\n| `[CSCD]` | 中国科学引文数据库 | 中高 |\r\n| `[北大核心]` | 北京大学核心期刊目录 | 中 |\r\n| `[CCF-A]` | 中国计算机学会 A 类会议/期刊 | 最高 |\r\n\r\n#### 用户自检清单 / User Quality Checklist\r\n\r\n在引用或深入阅读文献前，建议用户快速核对：\r\n- [ ] **来源**：发表在什么期刊/会议上？是否为核心收录？\r\n- [ ] **时效**：出版年份是什么？对当前领域是否足够新？\r\n- [ ] **作者**：作者是否是该领域的活跃研究者？\r\n- [ ] **相关性**：标题和摘要是否与我的研究问题直接相关？\r\n- [ ] **可获取性**：是中文期刊（可下载全文）还是全球文献（仅元数据）？\r\n\r\n---\r\n\r\n### 错误处理 / Error Handling\r\n\r\n错误处理必须给出具体可操作的解决方案。网络波动时自动重试（最多 3 次，指数退避 1s→2s→4s）。\r\n\r\n#### 错误码处理表 / Error Code Handling\r\n\r\n| 状态码 | 含义 | 具体处理步骤 |\r\n|------|------|------|\r\n| **401** | Token 无效或过期 | Gateway 自动管理 Token 刷新, 无需处理。若持续 401，请检查 consume_token 是否有效 |\r\n| **403** | 权限不足 | 提示\"当前凭证无此接口权限，请确认 API 套餐是否已开通此接口\" |\r\n| **429** | 请求频率超限 | 等待 5 秒后自动重试 |\r\n| **499** | 参数错误 | 检查 Rule 语法（运算符大写、有空格）、FilterRule 字段代码、PageSize 范围 |\r\n| **502（alipay_error / 支付宝通道繁忙）** | 支付宝支付通道暂忙（订单未生成） | **不视为服务端故障、不要自动重试 3 次**（重试会加重节流）。按「半成功态」话术告知用户稍后重试；响应**不含** `out_trade_no`，切勿编造 |\r\n| **500/503** | 网关服务端错误 | 自动重试 3 次（指数退避 1s→2s→4s）→ 全部失败后提示\"SmartLib 服务暂时不可用，通常 5 分钟内恢复\" |\r\n| **网络超时** | 请求无响应 | 自动重试 3 次 → 提示\"请检查网络是否可访问 data.smart.vipslib.com\" |\r\n| **无结果** | API 返回空列表 | 按「结果数量自适应策略」自动提供扩展建议 |\r\n| **凭证缺失** | 环境变量未设置 | 自动触发 Pre-flight 注册流程 |\r\n\r\n---\r\n\r\n### 常见问题（FAQ）\r\n\r\n| 问题 | 答案 |\r\n|------|------|\r\n| **检索不到想要的论文怎么办？** | 1. 去掉过滤条件扩大范围 2. 尝试上位词 3. 用英文关键词在接口4再试 4. 用 `U=` 替代 `T=` |\r\n| **全文下载失败怎么办？** | 仅中文期刊支持全文下载。下载 URL 约 10 分钟有效，过期需重新调用。英文文献自动走多渠道下载策略获取 OA 版本。 |\r\n| **Token 多久过期？** | Access Token 30 秒，Refresh Token 2 小时。系统自动管理刷新，用户无感知。 |\r\n| **英文文献能不能下全文？** | 本技能集成十级多渠道下载策略（ArXiv → Unpaywall → CORE → OpenAlex 等），Gold/Green/Hybrid OA 论文成功率 >85%。付费墙内论文无法获取。 |\r\n| **配额耗尽后还能用吗？** | 不能。试用额度耗尽后 Gateway 返回 429 拒绝所有检索请求，并自动弹出套餐选择；如需更高额度，回复套餐数字或说「升级 / 充值」即可（企业 / 机构定制联系 vipsmart@vipslib.com）。 |\r\n| **计费 token（consume_token）是一次性的吗？** | **是的，务必注意。** 每次 `/consume` 返回的 `consume_token` **仅能使用一次**且 **约 60 秒过期**。获取后要立刻调用 `/search` 或 `/download`，不要缓存或复用；过期/已用需重新 `/consume`。这与 SmartLib 云端 Access/Refresh Token（30s/2h，系统自动刷新）是两回事。 |\r\n| **Windows 下用 curl 下载 PDF 失败？** | 返回链接若含中文文件名，Git Bash 的 `curl` 常因 URL 编码失败而下载到空文件/报错。改用 **Python `urllib.request`** 直接拉取（自动处理编码），或直接用浏览器打开链接下载。 |\r\n| **中文关键词搜不到 / 命中少怎么办？** | 下游检索（维普系）对中文复合词与缩写别名的索引有限，纯中文窄词常召回不足。建议：① 补英文关键词（接口1+接口4 双检）② 用上位词/同义词扩检 ③ 用 `U=` 替代 `T=` ④ 去掉过滤条件扩大范围。详见下方「检索召回优化提示」。 |\r\n\r\n---\r\n\r\n### 检索召回优化提示（中文关键词命中低时必读）\r\n\r\n下游检索（维普系）的分词与别名索引对中文复合词、缩写、中英鸿沟支持有限，**召回不足的首要原因通常不是分词颗粒度，而是缩写/别名缺失、跨语言鸿沟和字段策略不当**。实操清单：\r\n\r\n- **中英双检**：同一概念同时用中文（接口1）和英文（接口4）各检一次，覆盖率显著提升。\r\n- **上位词 / 同义词扩检**：如「深度学习」补「神经网络 / 机器学习」；「新冠」补「COVID-19 / SARS-CoV-2」。\r\n- **字段渐进**：默认 `K=`（关键词），召回差时改用 `T=`（题名）精准定位，或 `U=`（任意字段）扩检。\r\n- **去掉过滤条件**：先广后窄，去掉 `TY=`/`LA=` 等过滤扩大范围，再人工筛选。\r\n- **缩写展开**：机构缩写（如「中科院」→「中国科学院」）、期刊缩写（如「JACS」→「Journal of the American Chemical Society」）务必展开。\r\n\r\n---\r\n\r\n### API 调用注意事项 / API Call Notes\r\n\r\n- **检索结果数据路径**：列表字段为 **`data.list`（全小写）**；解析优先级：`data.list` → `Data.List` → `List`。总条数在 `data.total` / `Data.Total`。\r\n- **Source 字段需详情接口获取**：检索列表中 `Source` 为空数组，原始数据库链接需调用详情接口。Source 数组元素结构为 `{\"Source_DbId\": \"scopusjournal\", \"Source_DbTitle\": \"Scopus\", \"Source_Link\": \"https://...\"}`，字段说明：`Source_DbId`=数据库标识符，`Source_DbTitle`=数据库中文名称，`Source_Link`=原始数据库详情页链接。平台覆盖300+数据库，100篇样本实测平均每篇4.75个链接，覆盖率100%。\r\n\r\n---\r\n\r\n## 注意事项 / \n\nArchive v3.9.7: 8 files, 39362 bytes\n\nFiles: config.example.json (139b), config.json (204b), PIPELINE.md (13394b), README.md (5026b), references/account.md (5573b), skill-card.md (3431b), SKILL.md (65558b), _meta.json (137b)\n\nArchive v3.9.6: 8 files, 39141 bytes\n\nFiles: config.example.json (139b), config.json (178b), PIPELINE.md (13394b), README.md (5026b), references/account.md (5573b), skill-card.md (3000b), SKILL.md (65419b), _meta.json (137b)\n\nArchive v3.9.5: 8 files, 39160 bytes\n\nFiles: config.example.json (220b), config.json (274b), PIPELINE.md (13394b), README.md (5026b), references/account.md (5573b), skill-card.md (3045b), SKILL.md (65298b), _meta.json (137b)\n\nArchive v3.9.4: 8 files, 37707 bytes\n\nFiles: config.example.json (168b), config.json (207b), PIPELINE.md (13394b), README.md (5026b), references/account.md (5573b), skill-card.md (2752b), SKILL.md (62560b), _meta.json (137b)\n\nArchive v3.9.3: 8 files, 37892 bytes\n\nFiles: config.example.json (220b), config.json (260b), PIPELINE.md (13394b), README.md (5026b), references/account.md (5573b), skill-card.md (2801b), SKILL.md (62927b), _meta.json (137b)\n\nArchive v3.9.2: 8 files, 36958 bytes\n\nFiles: config.example.json (220b), config.json (260b), PIPELINE.md (13394b), README.md (5026b), references/account.md (5573b), skill-card.md (2895b), SKILL.md (60513b), _meta.json (137b)\n\nArchive v3.9.1: 8 files, 35456 bytes\n\nFiles: config.example.json (220b), config.json (260b), PIPELINE.md (13394b), README.md (5026b), references/account.md (5573b), skill-card.md (2672b), SKILL.md (56933b), _meta.json (137b)","readmeExcerpt":"Skill: global-biblio-base Owner: j-levee Summary: 全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。 能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"帮我找一些关于大语言模型的最新论文\n下载第 3 篇"},{"language":"text","snippet":"帮我找一些关于大语言模型的最新论文\n下载第 3 篇"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nslug: global-biblio-base\r\nname: global-biblio-base\r\ndisplayName: 全球12亿文献知识库（8千万中文期刊可下载）\r\nversion: 3.10.2\r\ndescription: |\r\n  全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。\r\n\r\n  能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。\r\n\r\n  配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。\r\n\r\n  触发：用户表达\"查论文\"\"找文献\"\"检索学术\"\"搜期刊\"\"查专利\"\"找标准\"\"下论文\"\"写文献综述\"\"找参考文献\"\"查 SCI/EI\"等意图时启用；也适用\"帮我找关于 XX 的论文\"\"写文献综述\"\"找几篇引用支撑论点\"。英文：\"find papers\" \"search literature\" \"write literature review\" \"find supporting citations\"。\r\n\r\n  调用前必须先用 /consume 获取 consume_token，再凭 token 调 /search（每次计费接口调用都需一次 /consume）。\r\nagent_created: true\r\n---\r\n\r\n## 🤖 AI 执行摘要（先读这段）\r\n\r\n- **何时触发**：用户要查 / 找 / 下载中外文学术文献（论文、期刊、专利、标准、学位论文），或要写文献综述、找引用支撑、做课题查新。\r\n- **不触发（转其他技能）**：引用核查 / \"这篇是真的吗\" → `smartlib-citation-checker`；论文写作辅助、非文献类查询。\r\n- **两个前置硬规则**：① 动手前必须先向用户索取邮箱（禁止用 config 预填邮箱、禁止臆造邮箱）；② 每次计费接口调用前先 `/consume` 取 `consume_token`，再带 token 调 `/search`（token 单次使用、约 60s 有效，过期/已用需重新 `/consume`）。\r\n- **输入**：用户自然语言检索意图 + 邮箱。\r\n- **产出**：检索结果列表（含核心收录标注、原始数据库来源链接）、文献详情、PDF 下载链接（中文期刊直下 / 外文 OA 多渠道探测）。\r\n- **配额模型**：免费 100 次检索 + 10 次下载 / 月；耗尽时 Gateway 返回 429，技能自动弹出套餐卡片（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），用户也可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。\r\n- **红线**：不改功能；不臆造邮箱；不在对话中泄露 `SMARTLIB_GATEWAY_SECRET`；付费墙内外文文献无法获取全文。\r\n- **凭证来源**：`config.json` → `SMARTLIB_GATEWAY_URL` / `SMARTLIB_GATEWAY_SECRET`（SMARTLIB_EMAIL 运行后由注册写入，勿预填）。\r\n\r\n# 全球12亿文献知识库（8千万中文期刊可下载）\r\n\r\n\r\n通过 SmartLib 开放平台 API 提供中外文学术文献检索能力。\r\n\r\n\r\n---\r\n\r\n## ⚡ 启动前必须执行/ Pre-flight Checklist\r\n\r\n### Step A：凭证自动检测 & 注册/ Auto Credential Check & Registration\r\n\r\n> ## ⚠️ 强制规则 — 必须先询问邮箱\r\n> 1. **执行任何操作前，必须先询问用户邮箱地址**\r\n> 2. 禁止使用 config.json 中预填的邮箱（即使存在且非 null）\r\n> 3. 禁止自动生成邮箱（如 `user@example.com`、`auto@xxx.com` 等）\r\n> 4. 用户未提供邮箱 → 停止执行，回复：\r\n>    \"请提供您的邮箱地址以注册 SmartLib 文献检索服务（新用户免费 100 次/月）\"\r\n> 5. 只有用户明确输入邮箱后，才能调用 /register 或 /quota\r\n>\r\n> ## 邮箱识别自动化\r\n> 当用户消息中出现以下模式时，自动提取邮箱 → 无需再次询问：\r\n> - 明确的邮箱地址（包含 @ 符号的完整地址，如 `xxx@xxx.xxx`）\r\n> - \"我的邮箱是 xxx\" / \"email: xxx\" / \"用 xxx 注册\" / \"邮箱 xxx\"\r\n\r\n每次执行本技能时，按以下流程处理凭证（从 config.json 读取）：\r\n\r\n```\r\n读取技能目录下的 config.json\r\n检查 SMARTLIB_EMAIL 是否已配置\r\n  ├── 已配置 → 进入 Step B (配额检查)\r\n  │\r\n  └── 未配置 → 自动注册流程:\r\n        ├── ① 展示检索计划 + 询问邮箱（一句话）:\r\n        │      \"📋 我将用中英文关键词检索... 首次使用需绑定邮箱（免费 100 次/月，仅用于配额管理），请输入邮箱即可开始:\"\r\n        │      用户输入 → 写入 config.json\r\n        │\r\n        ├── ② 调智能网关注册（无需验证码，极速注册）:\r\n        │     POST {SMARTLIB_GATEWAY_URL}/register\r\n        │     Headers: {\"Authorization\": \"Bearer {SMARTLIB_GATEWAY_SECRET}\"}\r\n        │     Body: {\"email\": \"{用户邮箱}\"}\r\n        │\r\n        ├── 成功 (201/200) → Gateway 返回配额信息\r\n        │     提示: \"✅ 注册成功！本月免费 100 次，可立即使用。确认邮件已发送（邮箱验证仅充值时需要，现在不验证也能用）。\"\r\n        │     追加引导: \"请告诉我您想检索什么主题，现在就可以开始——\"\r\n        │     → 继续 Step B 配额检查 → 检索\r\n        │\r\n        └── 失败 → 提示原因 (服务暂不可用 / 网络错误等) → 终止\r\n```\r\n\r\n> **注意**："},{"path":"README.md","content":"# SmartLib 学术文献检索 Skill v3.10.1\n\n用自然语言查论文、找文献、下载全文 —— 覆盖 8000 万篇中文期刊 + 12.28 亿条全球文献。**全自动**：首次使用自动注册开通（免费 100 次/月），配额自动消耗，用尽引导支付宝扫码支付。\n\n---\n\n## 这是什么\n\n一个让 AI 助手具备学术文献检索能力的 Skill。安装后，用日常语言说出需求，AI 自动帮你检索、筛选、展示文献，还能下载中文期刊全文 + 英文 OA 论文。\n\n### 核心亮点\n\n- **中文期刊全文下载**：8000 万篇授权中文期刊，一键获取 PDF\n- **英文 OA 多渠道下载**：十一级下载策略，Gold/Hybrid/Green OA 成功率 >85%\n- **全球文献覆盖**：12.28 亿条元数据（期刊/专利/会议/学位/标准等）\n- **全自动变现**：零配置启动，配额耗尽后扫码支付即恢复\n- **自然语言交互**：不需要学检索语法\n\n---\n\n## 🔒 免费体验与受限展示\n\n| 状态 | 展示规则 |\n|------|---------|\n| **配额充足** | 完整展示所有检索结果（含详情、下载、智能排序） |\n| **配额耗尽** | Gateway 返回 429，**拒绝服务**，直接提示充值 |\n\n配额耗尽后回复「充值」，展示数字选套餐卡片（①-④），回复数字即可获取带套餐信息的支付宝付款码。\n\n---\n\n## 快速开始\n\n### 1. 安装\n\n在 WorkBuddy 中搜索 \"smartlib\" 安装。\n\n### 2. 零配置启动\n\n**无需手动申请 API 密钥。** 首次使用自动检测凭证，未配置则自动通过智能网关注册开通（免费 100 次/月）。\n\n### 3. 开始使用\n\n```\n帮我找一些关于大语言模型的最新论文\n下载第 3 篇\n```\n\n---\n\n## 使用示例\n\n**查找中文论文并下载：** `帮我找几篇关于知识图谱的中文论文` → AI 自动检索、展示结果、输入编号即可下载 PDF。\n\n**查找英文论文并获取 OA 全文：** `找 transformer architecture 相关的论文` → AI 自动通过 ArXiv / Unpaywall / CORE 等渠道获取 OA 版本。\n\n**配额耗尽 → 对话支付：** 在对话中说「充值」→ 展示 ①-④ 数字套餐卡片 → 回复数字选择 → 直接出带订单信息的支付宝付款码 → 扫码支付 → 即时恢复。\n\n---\n\n## 常见问题\n\n**Q: 免费吗？** 首次使用自动注册，免费 100 次/月。超出后付费，¥9.90 体验卡（1000 次）起。\n\n**Q: 英文文献能下全文吗？** 可以。十一级多渠道下载策略，Gold/Hybrid/Green OA 成功率 >85%。付费墙内（Closed）论文无法获取。\n\n**Q: 配额耗尽后怎么办？** 在对话中说「充值」，展示数字选套餐卡片，回复数字直接获取支付宝付款码，扫码后即时恢复。\n\n---\n\n## 依赖\n\n- SmartLib API（自动通过网关注册）\n- SmartLib Gateway（腾讯云 SCF 上海）\n- Alipay（支付宝当面付扫码支付）\n\n---\n\n## 相关文档\n\n- **SKILL.md** — 完整技能规范（API 接口、检索策略、变现流程）\n- **PIPELINE.md** — 全链路优化指南\n\n---\n\n## 作者\n\n**张亚东** — 重庆维普智图 · GitHub: [J-levee](https://github.com/J-levee)"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn71136czyc1f1bmx5rt1tjtes86jsve\",\n  \"slug\": \"global-biblio-base\",\n  \"version\": \"3.10.2\",\n  \"publishedAt\": 1788060441064\n}"},{"path":"references/account.md","content":"# SmartLib 账户与计费（smartlib-account）\r\n\r\n> 本文档是 SmartLib 所有文献检索类技能的**计费与升级唯一真相源**。\r\n> 所有调用文献检索能力的技能（global-biblio-base / citation-checker / academic-knowledge-base / keji-skill-showcase 等）**统一定价、配额共享**，走同一个「统一钱包」。\r\n> 各技能 SKILL.md 不重复价格表，仅在需要时点此文档或引导用户对话中说「我要升级」。\r\n> 本文件按需加载，不进 SKILL.md，避免多处复制导致漂移。\r\n\r\n---\r\n\r\n## 一、注册（首次使用，极简 1 步）\r\n\r\n- 首次在某文献技能发起检索 → 检测到未关联 SmartLib 账户 → **仅需提供邮箱**即可注册（无需验证码）。\r\n- 注册成功**立即可用**：免费 **100 次检索 + 10 次全文下载 / 月**，全程对话驱动。\r\n- 邮箱验证：注册后确认邮件为可选项；**未验证也能正常付费与使用**（降低摩擦，已确认）。\r\n\r\n---\r\n\r\n## 二、套餐与价格\r\n\r\n> 阶段 0 仅开放「单付」；连续包月（¥29 / ¥79）为**后续版本**，当前前端不展示连包入口与连包价。\r\n> 「下载价格」为包内含下载的**单篇均价**（透明参考，非额外计费）；下载额度随套餐一并给定，不单独叠加收费。\r\n\r\n| 档位 | 周期 | 检索与详情 | 下载 | 价格 | 下载价格 | 定位 |\r\n|------|------|-----------|------|------|---------|------|\r\n| 免费体验 | 月 | 100 | 10 | ¥0 | — | 获客入口 |\r\n| 体验卡 | 一次性·7天 | 1000 | 20 | ¥9.9 | ¥0.5 | 首付费转化·仅新用户 1 张 |\r\n| 个人版月 ★ | 月 | 1000 | 50 | ¥39（连包 ¥29 后续） | ¥0.6 / ¥0.8 | 性价比最高·推荐 |\r\n| 专业版月 | 月 | 2000 | 200 | ¥99（连包 ¥79 后续） | ¥0.4 / ¥0.5 | 高价锚点 |\r\n| 单篇下载 | 即时 | — | 1 | ¥2.5 | ¥2.5 | 按需·对齐维普零售价 |\r\n| 下载包 | 月 | — | 10 | ¥20 | ¥2 | 超额低成本（当前唯一下载包） |\r\n| 企业/机构 | 议价 | 自定义 | 自定义 | 按量 / API | 自定义 | >2000 次 或团队出口 |\r\n\r\n**规则要点：**\r\n- 下载配额每个档位**显式给定**（不再用「总额度 10%」隐式规则）。\r\n- 体验卡：**仅新用户 + 终身限 1 张**；用过 / 过期 / 退款均不可重买。\r\n- 免费档与付费档**可并行使用**：付费期内免费额度**不冻结**，客户可持续享用每月免费检索 / 下载额度（先用免费、后动付费），降低早期使用门槛。\r\n- 企业 / 机构档保持「联系我们」，不开放自助购买。\r\n\r\n---\r\n\r\n## 三、价格表展示与推荐逻辑\r\n\r\n- **未购体验卡用户**：优先高亮推荐 **体验卡 ¥9.9**。\r\n- **体验卡已购 / 已用 / 已过期**：体验卡从价格表**消失**，此时优先推荐 **个人版月 ¥39**。\r\n- 升级入口：对话中说「我要升级」，或在任一文献技能查看本文件。\r\n\r\n---\r\n\r\n## 四、下载权益、72 小时重下窗与配额提醒（每次全文下载强制）\r\n\r\n**下载权益（统一钱包）：**\r\n- 免费档每月含 **10 次全文下载**，随日历月重置（`/quota` 返回的 `download_reset_at` 字段标明重置日）。\r\n- 付费档在对应周期内额外给定下载次数（见第二节价格表）；**付费期内免费额度不冻结**，可同时享用免费 + 付费下载额度。\r\n- **单篇下载 ¥2.5 / 下载包 ¥20（10 次）** 为独立购买的超额方案，购买后写入「下载授权」（含有效期，见下）。\r\n- 下载授权消耗优先级：**先消耗即将过期的付费授权 → 再消耗免费月度额度**，避免浪费。\r\n\r\n**72 小时同篇重下窗（不重复计费）：**\r\n- 同一用户、同一篇文献，在 **72 小时内** 重复下载，**不扣减下载配额、也不重复收费**（含单篇付费用户）。\r\n- 系统按 `email + 文献ID` 记录下载历史；命中 72h 窗口内已有记录时直接复用，不再扣减。\r\n- 超出 72 小时后再次下载，按正常配额 / 付费流程计费。\r\n\r\n**每次下载的对话 UX（强制）：**\r\n1. **下载前提醒**：「您当前剩余下载配额 **N 次**，本次将消耗 **1 次**」。\r\n2. **确认文献**：向用户确认要下载的具体文献（标题 / ID）后再执行，**不静默扣减**。\r\n3. **耗尽转向**：下载额度耗尽后，引导转向 **单篇下载 ¥2.5** 与 **下载包 ¥20（10 次）**。\r\n\r\n---\r\n\r\n## 五、企业 / 机构合作\r\n\r\n机构 / 企业批量定制、API 接入、私有化部署：\r\n- 📧 vipsmart@vipslib.com  ☎️ 023-63016015  🌐 https://www.vipslib.com/\r\n\r\n---\r\n\r\n## 六、常见问题 FAQ\r\n\r\n- **Q：配额多久重置？** A：免费档每月重置；付费档按购买周期（月 / 7 天）计算。\r\n- **Q：不同技能的配额互通吗？** A：互通。所有文献检索技能共享同一统一钱包配额。\r\n- **Q：邮箱没验证能用吗？** A：能。验证仅在特定操作时需要，不影响正常使用与付费。\r\n- **Q：体验卡能重复买吗？** A：不能，终身仅 1 张，限新用户。\r\n- **Q：下载会额外扣钱吗？** A：不会。下载额度随套餐给定，仅消耗额度；单篇下载 / 下载包为独立购买的超额方案。\r\n- **Q：同一篇文献反复下载会重复扣费吗？** A：不会。同一用户在 72 小时内重复下载同一篇文献，系统直接复用、不扣配额也不重复收费；超过 72 小时后再下载才正常计费。\r\n\r\n---\r\n\r\n*本文件为 SmartLib 统一计费钱包的说明文档（smartlib-account），由各文献技能按需引用，数字以本文为准。*"},{"path":"PIPELINE.md","content":"# SmartLib 全链路检索下载管线优化指南\r\n\r\n本文件记录 SmartLib 文献检索技能中\"检索→详情→下载\"全链路的架构设计、性能优化策略和实战基准数据。面向技能调用者（AI Agent）和开发者，提供最优执行路径参考。\r\n\r\n> This document covers the architecture, optimization strategies, and real-world benchmarks for the SmartLib literature search → detail → download pipeline. Designed for skill invokers (AI Agents) and developers as the authoritative execution reference.\r\n\r\n---\r\n\r\n## 1. 管线架构\r\n\r\n```\r\n用户请求\r\n    │\r\n    ▼\r\n┌─────────────────────────────────────────────────────┐\r\n│  PHASE 1: 并行检索│\r\n│  ├─ CN: API 1 (中文期刊) ─── 独立 Token，并行发起   │\r\n│  └─ EN: API 4 (全球文献) ─── 独立 Token，并行发起   │\r\n│  预计耗时: 1-3s (5 并发检索)                         │\r\n└──────────────────┬──────────────────────────────────┘\r\n                   ▼\r\n┌─────────────────────────────────────────────────────┐\r\n│  PHASE 2: 批量获取详情│\r\n│  ├─ CN: 无需此步（API 3 直接用 Identifier 下载）     │\r\n│  └─ EN: API 5 (文章详情) ─── 8 并发获取 DOI + 元数据 │\r\n│  预计耗时: 0.3-2s (50 篇以内)                        │\r\n│  关键优化: Token 缓存复用，无需每次重新认证           │\r\n└──────────────────┬──────────────────────────────────┘\r\n                   ▼\r\n┌─────────────────────────────────────────────────────┐\r\n│  PHASE 3: 并行下载│\r\n│  ├─ CN: API 3 (GetArticleFile) ─── 10 并发下载       │\r\n│  └─ EN: 多渠决策树 ─── 10 并发，每篇独立路由         │\r\n│       ├─ ArXiv (最快)                                │\r\n│       ├─ Unpaywall OA 探测 (最全面)                   │\r\n│       ├─ SpringerOpen / PLOS / PMC (出版商专用)       │\r\n│       └─ DOI 重定向 (兜底)                            │\r\n│  预计耗时: 5-15s (10 篇) / 20-40s (50 篇)            │\r\n└──────────────────┬──────────────────────────────────┘\r\n                   ▼\r\n              📊 汇总报告\r\n```\r\n\r\n**设计原则**\r\n- **分阶段并行**: 每阶段内部并行，阶段间串行（依赖数据传递）\r\n- **独立无锁**: 每篇论文的下载互不依赖，无共享状态\r\n- **失败隔离**: 单篇失败不影响其他论文\r\n- **Gateway 代理**: 所有 API 调用通过 Gateway /consume → /search 代理，Token 由 Gateway 管理\r\n\r\n---\r\n\r\n## 2. 核心优化技术\r\n\r\n### 2.1 Gateway 统一管理 Token\r\n\r\n**问题**: 每次 API 调用前走 OAuth 两步认证 (code→token)，耗时 ~0.8s。50 篇论文=50 次认证=40s 浪费。\r\n\r\n**优化**: SmartLib OAuth Token 由 Gateway 全权管理，技能无需获取或缓存 Token。\r\n\r\n**架构**\r\n```\r\n技能 (Skill) → Gateway (/consume → /search) → SmartLib API\r\n                    ↑\r\n              Token 缓存 + 自动刷新 + 分布式同步\r\n```\r\n\r\n- Gateway 维护 OAuth 凭证（APPID + APPSECRET）\r\n- 技能通过 config.json 中的 GATEWAY_SECRET 调用 Gateway API\r\n- 技能**无需持有** APPID/APPSECRET\r\n- Gateway 自动处理 Token 刷新与缓存（含跨实例分布式同步）\r\n\r\n### 2.2 提前终止\r\n\r\n**问题**: 传统策略是对所有渠道逐一尝试，但 closed-access 论文注定失败。\r\n\r\n**优化**: Unpaywall 探测后立即判断：\r\n\r\n| OA 状态 | 策略 | 原因 |\r\n|------|------|------|\r\n| `gold` | 全渠道重试 | 几乎必定能下 |\r\n| `hybrid` | 先试 Unpaywall PDF URL | 大概率能下 |\r\n| `green` | 试 ArXiv + Unpaywall + 机构库 | 作者自存档版本 |\r\n| `bronze` | 尝试一次后 curl 兜底 | ⚠️ 大概率被防盗链拦截 |\r\n| `closed` | **立即终止**，不浪费后续尝试 | 100% 付费墙内 |\r\n\r\n**效果**: closed-access 论文从 ~8s (7个渠道轮询) 降至 ~1s (仅一次 Unpaywall 查询)。\r\n\r\n### 2.3 智能渠道路由\r\n\r\n**问题**: 不同出版商的 PDF 获取方式差异大，统一策略效率低。\r\n\r\n**优化**: 根据出版商名称路由到最优渠道：\r\n\r\n```python\r\nPUBLISHER_ROUTES = {\r\n    \"springer\":  [\"springer\", \"unpaywall\", \"arxiv\"],   # SpringerOpen 直链最快\r\n    \"elsevier\":  [\"unpaywall\", \"arxiv\", \"green\"],       # Elsevier 大概率付费墙\r\n   "}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。 能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.com。 触发：用户表达\"查论文\"\"找文献\"\"检索学术\"\"搜期刊\"\"查专利\"\"找标准\"\"下论文\"\"写文献综述\"\"找参考文献\"\"查 SCI/EI\"等意图时启用；也适用\"帮我找关于 XX 的论文\"\"写文献综述\"\"找几篇引用支撑论点\"。英文：\"find papers\" \"search literature\" \"write literature review\" \"find supporting citations\"。 调用前必须先用 /consume 获取 consume_token，再凭 token 调 /search（每次计费接口调用都需一次 /consume）。 Skill: global-biblio-base Owner: j-levee Summary: 全球12亿文献知识库（8千万中文期刊可下载）——通过 SmartLib 开放平台 API 提供中外文学术文献检索与下载能力，覆盖 8000 万篇授权中文期刊全文 + 12.28 亿条全球文献元数据（期刊 7.19 亿 / 专利 2.15 亿 / 会议 7155 万 / 学位论文 2473 万 / 标准 268 万）。 能力：中英文关键词检索、文献详情、中文期刊 PDF 全文下载、外文 OA 文献十级渠道免费下载（不消耗配额）、智能关键词扩展、核心期刊优先排序、相关性重排、引文追溯、分类号检索。 配额：首次使用自动注册，免费 100 次检索 + 10 次下载 / 月；耗尽自动弹出套餐（体验卡 / 个人版月 / 专业版月 / 单篇下载 / 下载包），可说「升级 / 充值」唤起；企业 / 机构定制联系 vipsmart@vipslib.","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":784,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T23:30:13.017Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T23:30:13.017Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T03:00:58.033Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}