用途:sf-docs 用于在线检索 Salesforce 官方文档,让回答有据可依。它不维护本地语料、不做索引、不依赖 PDF 回退,核心是提供一套可靠的官方文档在线检索流程,重点应对难以抓取的页面,如 help.salesforce.com、JS 较重的 developer.salesforce.com、lightningdesignsystem.com 上的 Lightning Design System 文档,以及 architect.salesforce.com、admin.salesforce.com 等官方页面。
主要能力:仅优先使用 Salesforce 官方来源(developer.salesforce.com、help.salesforce.com、architect.salesforce.com、admin.salesforce.com、lightningdesignsystem.com 等),避免第三方博客、视频或摘要文章,也不回退到 PDF。检索流程为:先判断文档家族(开发者文档、帮助文档、架构/管理员文档、设计系统文档、旧版 atlas 文档),再提取精确概念(如 API/类/方法名、功能名、产品短语、设置概念),然后定向检索官方页面,确认目标概念确实出现,必要时跟进 1–3 个官方子链接,拿到可支撑的证据即停止。
使用方式:可选包装脚本位于 skills/sf-docs/scripts/extract_salesforce_doc.py,会自动将 help.salesforce.com 链接路由到专用 Help 提取器,并通过通用浏览器渲染路径支持 *.salesforce.com 与 lightningdesignsystem.com 等官方页面;对机器人敏感的页面,在安装 playwright-stealth 后可用 --stealth 做尽力而为的可选隐身模式。专用 Help 提取器也可直接使用:skills/sf-docs/scripts/extract_help_salesforce.py。
适用场景:用户需要官方 Salesforce 文档,涉及 Apex、API、LWC、元数据、Agentforce、设置或帮助文章,或页面看起来 JS 较重、难以用普通抓取读取时。
限制:不维护本地语料、不依赖本地索引、不使用 PDF 回退、不运行基准工作流。若证据薄弱,应明确说明,而不是强行作答;遇到 Loading、Sorry to interrupt、CSS Error 或仅有导航/页脚文本的壳页面,以及软 404 页面,应视为提取失败而非证据。若定向重试后仍失败,应返回找到的最佳官方 Help URL,并明确说明正文提取未成功。