人工智能AI 应用AI 技能RAGMCP 服务网页爬虫【免费下载链接】Skill_SeekersConvert documentation websites, GitHub repositories, and PDFs into Claude AI skills with automatic conflict detection项目地址https://gitcode.com/gh_mirrors/sk/Skill_Seekers点击查看免费下载版本3.7.0本文基于当前仓库docs/zh-CN/reference/ENVIRONMENT_VARIABLES.md与源码实现整理导读环境变量是 Skill Seekers 的核心配置入口之一它承载 API 身份验证Claude、Gemini、OpenAI、Moonshot、GitHub、配置路径、输出目录、抓取行为、增强行为、调试开关以及 MCP 服务器设置。本文以官方环境变量参考文档为骨架逐项说明每个变量的用途、默认值、格式与使用场景并结合仓库源码如 agent_client.py 中的API_PROVIDERS注册表与超时映射逻辑解释其底层工作原理最后给出开发、生产、CI/CD 与多平台四种典型配置示例。读完本文你将能够熟练地为 Skill Seekers 配置认证、调整抓取与增强行为、接入任意 OpenAI 兼容提供商并避开常见的优先级与路径陷阱。概述Skill Seekers 使用环境变量来实现API 身份验证Claude、Gemini、OpenAI、GitHub配置路径输出目录行为自定义调试设置这些变量在运行时被读取并覆盖默认设置命令行标志仍拥有最高优先级见文末「优先级顺序」一节。仓库源码中大量使用os.environ.get(...)在运行时读取这些变量例如 agent_client.py 中的get_provider_api_keys()与detect_api_target()就是直接从环境变量推导可用提供商与 API 密钥的。API 密钥ANTHROPIC_API_KEY用途Claude AI API 访问用于增强和上传。格式sk-ant-api03-...使用者skill-seekers enhanceAPI 模式skill-seekers uploadClaude 目标AI 增强功能视频场景处理见 video_scraper.py示例export ANTHROPIC_API_KEYsk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx替代方式在每个命令中使用--api-key标志。注意从源码看enhance_skill.py 在读取ANTHROPIC_API_KEY时还会回退到ANTHROPIC_AUTH_TOKEN即 Anthropic 的两种凭据形式都被支持。GOOGLE_API_KEY用途Google Gemini API 访问用于上传以及增强/视觉处理。格式AIza...使用者skill-seekers uploadGemini 目标支持图片输入的提供商之一supports_images: True见 agent_client.py示例export GOOGLE_API_KEYAIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxOPENAI_API_KEY用途OpenAI以及 OpenAI 兼容API 访问用于增强、上传和 embeddings。格式sk-...使用者skill-seekers create/scan/enhanceAI 增强API 模式skill-seekers uploadOpenAI 目标向量数据库的 embedding 生成参见 adaptors/base.py示例export OPENAI_API_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx与OPENAI_BASE_URLOPENAI_MODEL配合使用可将增强请求路由到任意 OpenAI 兼容提供商OpenRouter、Groq、Cerebras、Mistral、NVIDIA NIM。参见下文「LLM 提供商选择」。MOONSHOT_API_KEY用途Moonshot AIKimiAPI 访问用于增强API 模式。格式sk-...使用者skill-seekers create/scan/enhance增强Kimi/Moonshot示例export MOONSHOT_API_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx易混淆点Moonshot 密钥同样以sk-开头若同时设置了OPENAI_API_KEY可能被误判。此时应使用SKILL_SEEKER_PROVIDERmoonshot强制指定详见「增强设置」一节。另外从 agent_client.py 可以看到Moonshot 走的是anthropic线协议protocol: anthropic且不支持图片输入。GITHUB_TOKEN用途GitHub API 身份验证用于获得更高的速率限制以及提交社区注册表配置。格式ghp_...个人访问令牌或github_pat_...细粒度令牌使用者skill-seekers createGitHub 仓库skill-seekers create --config统一多源skill-seekers scan本地代码库skill-seekers scan—— 向社区注册表提交 AI 生成的配置时必需扫描本身无需该令牌即可运行只是发布提示会被跳过并给出提示信息好处每小时 5000 次请求未认证为 60 次访问私有仓库更高的 GraphQL API 限额允许从scan打开社区配置 GitHub issue示例export GITHUB_TOKENghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx从源码看scan_command.py、github_fetcher.py 与 github_scraper.py 都会读取GITHUB_TOKENconfig_manager.py 也用它来拉取社区配置。创建令牌请前往 GitHub 设置页面的 Personal Access Tokens 区域。平台配置ANTHROPIC_BASE_URL用途自定义 Claude API 端点。默认值https://api.anthropic.com使用场景代理服务器、企业部署、区域端点。示例export ANTHROPIC_BASE_URLhttps://custom-api.example.com源码中的AgentClient在构造时即会读取该变量agent_client.py因此它对所有经由AgentClient的 Claude 调用全局生效。OPENAI_BASE_URL用途用于增强的自定义 OpenAI 兼容 API 端点。默认值https://api.openai.com/v1使用场景任意 OpenAI 兼容提供商 —— OpenRouter、Groq、Cerebras、Mistral、NVIDIA NIM、本地服务器Ollama、vLLM、LM Studio、代理。示例export OPENAI_BASE_URLhttps://openrouter.ai/api/v1由 OpenAI SDK 自动读取。请与OPENAI_API_KEY和OPENAI_MODEL配对使用否则默认模型gpt-4o在其他提供商上通常不存在。LLM 提供商选择AI增强步骤create、scan、enhance通过一个抽象层AgentClient—— 每次 API 增强调用都经由它路由支持多个提供商。提供商的自动检测与优先级提供商由找到的第一个API 密钥决定顺序按照cli/agent_client.py中API_PROVIDERS注册表的定义ANTHROPIC_API_KEY→ANTHROPIC_AUTH_TOKEN→GOOGLE_API_KEY→OPENAI_API_KEY→MOONSHOT_API_KEY从源码看agent_client.py 中的API_PROVIDERS是一个有序元组注册表每个条目声明了provider提供商名、targetCLI/适配器使用的平台名、env_vars对应的环境变量、protocol线上协议与supports_images是否支持图片输入detect_api_target()agent_client.py按注册表顺序返回第一个设置了密钥的目标。注册表目前还包含minimax通过MINIMAX_API_KEY启用支持区域与协议覆盖enhance_command的模式选择与enhance_skill_local的目标检测均消费该注册表——这也是文档中单一事实来源的设计。如果所有密钥均未设置则回退到LOCAL 代理模式--agent无需 API 密钥 —— 使用你的 Claude Pro / ChatGPT Plus 订阅。当密钥前缀有歧义时Moonshot 密钥同样以sk-开头可能被误判为 OpenAI可通过将SKILL_SEEKER_PROVIDER设置为anthropic、google、openai、moonshot别名kimi来强制指定提供商export SKILL_SEEKER_PROVIDERmoonshot对应源码实现位于 agent_client.py它会把强制指定的提供商名规范化kimi→moonshot并据此完成客户端初始化。任意 OpenAI 兼容提供商OpenRouter、Groq、Cerebras、Mistral、NVIDIA NIMexport OPENAI_API_KEYprovider key export OPENAI_BASE_URLhttps://api.groq.com/openai/v1 # provider endpoint export OPENAI_MODELllama-3.3-70b-versatile # a model that provider offers skill-seekers create source提供商OPENAI_BASE_URLOpenRouterhttps://openrouter.ai/api/v1Groqhttps://api.groq.com/openai/v1Cerebrashttps://api.cerebras.ai/v1Mistralhttps://api.mistral.ai/v1NVIDIA NIMhttps://integrate.api.nvidia.com/v1请务必设置OPENAI_MODEL—— OpenAI 的默认模型gpt-4o在其他提供商上不存在。 确保没有设置更高优先级的密钥如ANTHROPIC_API_KEY否则它会胜出。使用订阅而非 API 额度LOCAL 模式skill-seekers create source --agent codex # ChatGPT Plus via Codex CLI skill-seekers create source --agent claude # Claude Pro/Max via Claude CodeLOCAL 模式下增强实际由本地编码代理 CLI 完成可通过SKILL_SEEKER_AGENT指定默认代理、SKILL_SEEKER_AGENT_CMD自定义命令模板详见「增强设置」。路径与目录SKILL_SEEKERS_HOME用途Skill Seekers 数据的基础目录。默认值Linux/macOS~/.config/skill-seekers/Windows%APPDATA%\skill-seekers\用于配置文件工作流预设缓存数据检查点示例export SKILL_SEEKERS_HOME/opt/skill-seekers对应源码可参考 config_manager.pyWindows 下使用APPDATA环境变量推导基础目录进度文件则存放在LOCALAPPDATA下的progress目录。SKILL_SEEKERS_OUTPUT用途技能的默认输出目录。默认值./output/使用者所有抓取命令打包输出技能生成示例export SKILL_SEEKERS_OUTPUT/var/skills/outputSKILL_SEEKERS_CONFIG_DIR用途包含预设配置的目录。默认值configs/相对于工作目录示例export SKILL_SEEKERS_CONFIG_DIR/etc/skill-seekers/configs仓库根目录下的 configs/ 目录即此类预设配置的典型示例其中包含astrovalley_unified.json、blender-unified.json、claude-code-unified.json、godot_unified.json、react.json、unity-addressables.json等按技术栈组织的统一配置。抓取行为SKILL_SEEKERS_RATE_LIMIT用途HTTP 请求的默认速率限制。默认值0.5秒单位请求之间的间隔秒数示例# More aggressive (faster) export SKILL_SEEKERS_RATE_LIMIT0.2 # More conservative (slower) export SKILL_SEEKERS_RATE_LIMIT1.0覆盖方式在每个命令中使用--rate-limit标志。SKILL_SEEKERS_MAX_PAGES用途默认的最大抓取页数。默认值500示例export SKILL_SEEKERS_MAX_PAGES1000覆盖方式使用--max-pages标志或配置文件。SKILL_SEEKERS_WORKERS用途默认并行工作者数量。默认值1最大值10示例export SKILL_SEEKERS_WORKERS4覆盖方式使用--workers标志。SKILL_SEEKERS_TIMEOUT用途HTTP 请求超时。默认值30秒示例# For slow servers export SKILL_SEEKERS_TIMEOUT60SKILL_SEEKERS_USER_AGENT用途自定义 User-Agent 请求头。默认值Skill-Seekers/3.7.0示例export SKILL_SEEKERS_USER_AGENTMyBot/1.0 (contactexample.com)提示部分站点会拦截默认 UA设置一个带联系方式的自定义 UA 有助于提升抓取成功率与合规性。增强设置SKILL_SEEKER_AGENT用途用于增强以及 scan 检测/生成的默认本地编码代理。默认值claude可选值claude、codex、copilot、opencode、kimi、custom以及 IDE 模式别名cursor、windsurf、cline、continue使用者skill-seekers enhanceskill-seekers scan可在单次调用中通过--agent覆盖示例export SKILL_SEEKER_AGENTcursor源码中该变量的读取点非常多enhance_command.pyL272/L300、enhance_skill_local.pyL173、execution_context.pyL328、unified_scraper.pyL2175以及多个 argument 定义文件如 create.py的 help 文本。解析优先级为「命令行参数 → 环境变量 → 默认值claude」。SKILL_SEEKER_AGENT_CMD用途--agent customLOCAL 模式的自定义 CLI 命令模板。使用者当SKILL_SEEKER_AGENTcustom时的skill-seekers create/scan/enhance。示例export SKILL_SEEKER_AGENTcustom export SKILL_SEEKER_AGENT_CMDmy-llm-cli --prompt-file {prompt_file}若选择了custom但未设置该变量源码会输出警告agent_client.py 与 enhance_skill_local.py提示Custom agent requires --agent-cmd or SKILL_SEEKER_AGENT_CMD to be set.。模板中的{prompt_file}占位符会被替换为实际的提示文件路径。SKILL_SEEKER_PROVIDER用途当密钥前缀检测有歧义时强制指定 API 提供商Moonshot 密钥同样以sk-开头否则会被识别为 OpenAI。可选值anthropic、google、openai、moonshot别名kimi示例export SKILL_SEEKER_PROVIDERmoonshotSKILL_SEEKER_MODEL用途API 模式增强的全局模型覆盖优先于下方所有按提供商的模型变量。示例export SKILL_SEEKER_MODELllama-3.3-70b-versatile源码实现位于 agent_client.py先读取SKILL_SEEKER_MODEL未设置时才回退到各提供商专属的模型环境变量。按提供商的模型覆盖仅在未设置SKILL_SEEKER_MODEL时使用。每个变量都会回退到对应提供商的默认值。变量提供商默认值未设置时ANTHROPIC_MODELAnthropicclaude-sonnet-4-20250514OPENAI_MODELOpenAI/兼容gpt-4oGOOGLE_MODELGeminigemini-2.0-flashMOONSHOT_MODELMoonshot/Kimimoonshot-v1-autoexport OPENAI_MODELllama-3.3-70b-versatile上述默认模型列表与 agent_client.py 中的DEFAULT_MODELS映射一致。SKILL_SEEKER_ENHANCE_TIMEOUT用途AI 增强操作的超时时间秒。默认值270045 分钟特殊值unlimited、none或0会映射为 24 小时上限。示例# For large skills export SKILL_SEEKER_ENHANCE_TIMEOUT3600 # No practical limit export SKILL_SEEKER_ENHANCE_TIMEOUTunlimited源码中get_default_timeout()agent_client.py实现了这套映射unlimited/none/0及非正数值统一返回UNLIMITED_TIMEOUT 8640024 小时无法解析的非法值回退到DEFAULT_ENHANCE_TIMEOUT 2700。之所以有 24 小时上限是因为底层 subprocess 需要一个有限数值。SKILL_SEEKER_ENHANCE_ACTIVE用途LOCAL 代理增强的递归保护。Skill Seekers 会在它生成的每个本地代理的环境中将此变量设置为1所有生成路径都如此当该变量已被设置时LOCAL 增强会拒绝再生成嵌套代理。通常你不需要自己设置它 —— 仅当你将 Skill Seekers 包装在另一个代理内、且希望抑制增强时才需要。示例export SKILL_SEEKER_ENHANCE_ACTIVE1 # suppress nested local-agent spawns源码在 agent_client.py 与 enhance_skill_local.py 两处检查该变量是否为1从而阻止嵌套的本地代理生成避免代理递归失控。GitHub 配置GITHUB_API_URL用途自定义 GitHub API 端点。默认值https://api.github.com使用场景GitHub Enterprise Server。示例export GITHUB_API_URLhttps://github.company.com/api/v3GITHUB_ENTERPRISE_TOKEN用途GitHub Enterprise 的独立令牌。使用场景为 github.com 和企业实例使用不同的令牌。示例export GITHUB_TOKENghp_... # github.com export GITHUB_ENTERPRISE_TOKEN... # enterprise这一组变量让同一套配置可以同时对接 GitHub 公共实例与企业私有实例是混合办公/内网部署的常见做法。向量数据库设置以下变量服务于技能上传到向量数据库的场景skill-seekers upload --target db以及对应的 MCP 导出工具。CHROMA_URL用途ChromaDB 服务器 URL。默认值http://localhost:8000使用者skill-seekers upload --target chromaexport_to_chromaMCP 工具示例export CHROMA_URLhttp://chroma.example.com:8000CHROMA_PERSIST_DIRECTORY用途ChromaDB 持久化的本地目录。默认值./chroma_db/示例export CHROMA_PERSIST_DIRECTORY/var/lib/chromaWEAVIATE_URL用途Weaviate 服务器 URL。默认值http://localhost:8080使用者skill-seekers upload --target weaviateexport_to_weaviateMCP 工具示例export WEAVIATE_URLhttps://weaviate.example.comWEAVIATE_API_KEY用途用于身份验证的 Weaviate API 密钥。使用者Weaviate Cloud启用认证的 Weaviate 实例示例export WEAVIATE_API_KEYxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxQDRANT_URL用途Qdrant 服务器 URL。默认值http://localhost:6333示例export QDRANT_URLhttp://qdrant.example.com:6333QDRANT_API_KEY用途用于身份验证的 Qdrant API 密钥。示例export QDRANT_API_KEYxxxxxxxxxxxxxxxx仓库同时提供了这些向量数据库的端到端示例脚本例如 examples/qdrant-example/、examples/weaviate-example/ 与 examples/chroma-example/可配合上述变量直接运行参考。调试与开发SKILL_SEEKERS_DEBUG用途启用调试日志。可选值1、true、yes等效于--verbose标志示例export SKILL_SEEKERS_DEBUG1SKILL_SEEKERS_LOG_LEVEL用途设置日志级别。默认值INFO可选值DEBUG、INFO、WARNING、ERROR、CRITICAL示例export SKILL_SEEKERS_LOG_LEVELDEBUGSKILL_SEEKERS_LOG_FILE用途将日志写入文件而非 stdout。示例export SKILL_SEEKERS_LOG_FILE/var/log/skill-seekers.logSKILL_SEEKERS_CACHE_DIR用途自定义缓存目录。默认值~/.cache/skill-seekers/示例export SKILL_SEEKERS_CACHE_DIR/tmp/skill-seekers-cache源码中的 services/git_repo.py 会读取SKILL_SEEKERS_CACHE_DIR作为 Git 仓库缓存的基础目录未设置时回退到平台默认缓存位置。SKILL_SEEKERS_NO_CACHE用途禁用缓存。可选值1、true、yes示例export SKILL_SEEKERS_NO_CACHE1这一开关在 CI/CD 中尤为有用可确保每次构建都是全新抓取避免缓存导致的过期数据。MCP 服务器设置以下变量控制 Skill Seekers MCP 服务器的传输模式与监听地址对应 src/skill_seekers/mcp/ 目录下的服务实现。MCP_TRANSPORT用途默认的 MCP 传输模式。默认值stdio可选值stdio、http示例export MCP_TRANSPORThttp覆盖方式使用--transport标志。MCP_PORT用途默认的 MCP HTTP 端口。默认值8765示例export MCP_PORT8080覆盖方式使用--port标志。MCP_HOST用途默认的 MCP HTTP 主机。默认值127.0.0.1示例export MCP_HOST0.0.0.0覆盖方式使用--host标志。安全提示0.0.0.0会让 MCP 服务监听所有网络接口仅在受信网络或配合鉴权时使用。更多 MCP 使用细节可参阅 docs/zh-CN/advanced/mcp-server.md。示例开发环境# Debug mode export SKILL_SEEKERS_DEBUG1 export SKILL_SEEKERS_LOG_LEVELDEBUG # Custom paths export SKILL_SEEKERS_HOME./.skill-seekers export SKILL_SEEKERS_OUTPUT./output # Faster scraping for testing export SKILL_SEEKERS_RATE_LIMIT0.1 export SKILL_SEEKERS_MAX_PAGES50生产环境# API keys export ANTHROPIC_API_KEYsk-ant-... export GITHUB_TOKENghp_... # Custom output directory export SKILL_SEEKERS_OUTPUT/var/www/skills # Conservative scraping export SKILL_SEEKERS_RATE_LIMIT1.0 export SKILL_SEEKERS_WORKERS2 # Logging export SKILL_SEEKERS_LOG_FILE/var/log/skill-seekers.log export SKILL_SEEKERS_LOG_LEVELWARNINGCI/CD 环境# Non-interactive export SKILL_SEEKERS_LOG_LEVELERROR # API keys from secrets export ANTHROPIC_API_KEY${ANTHROPIC_API_KEY_SECRET} export GITHUB_TOKEN${GITHUB_TOKEN_SECRET} # Fresh runs (no cache) export SKILL_SEEKERS_NO_CACHE1多平台设置# All API keys export ANTHROPIC_API_KEYsk-ant-... export GOOGLE_API_KEYAIza... export OPENAI_API_KEYsk-... export GITHUB_TOKENghp_... # Vector databases export CHROMA_URLhttp://localhost:8000 export WEAVIATE_URLhttp://localhost:8080 export WEAVIATE_API_KEYxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx配置文件环境变量也可以在.env文件中设置# .env file ANTHROPIC_API_KEYsk-ant-... GITHUB_TOKENghp_... SKILL_SEEKERS_OUTPUT./output SKILL_SEEKERS_RATE_LIMIT0.5加载方式# Automatically loaded if python-dotenv is installed # Or manually: export $(cat .env | xargs)若使用export $(cat .env | xargs)手动加载注意.env中不要出现带空格或特殊字符的值或改用引号包裹否则会被 shell 拆分。优先级顺序设置按以下顺序应用后者覆盖前者默认值环境变量配置文件命令行标志示例# Default: rate_limit 0.5 export SKILL_SEEKERS_RATE_LIMIT1.0 # Env var overrides default # Config file: rate_limit 0.2 # Config overrides env skill-seekers create --rate-limit 2.0 # Flag overrides all这一优先级模型与 docs/zh-CN/reference/CONFIG_FORMAT.md 中描述的 JSON 配置格式互补环境变量适合部署级覆盖配置文件适合项目级默认值命令行标志则用于单次执行的一次性覆盖。安全最佳实践切勿提交 API 密钥# Add to .gitignore echo .env .gitignore echo *.key .gitignore使用密钥管理# macOS Keychain export ANTHROPIC_API_KEY$(security find-generic-password -s anthropic-api -w) # Linux Secret Service (with secret-tool) export ANTHROPIC_API_KEY$(secret-tool lookup service anthropic) # 1Password CLI export ANTHROPIC_API_KEY$(op read op://vault/anthropic/credential)文件权限# Restrict .env file chmod 600 .env在 CI/CD 中优先使用平台的 Secret 管理能力注入环境变量如示例中的${ANTHROPIC_API_KEY_SECRET}避免将密钥写入仓库或构建日志。故障排除变量未被识别# Check if set echo $ANTHROPIC_API_KEY # Check in Python python -c import os; print(os.getenv(ANTHROPIC_API_KEY))优先级问题# See effective configuration skill-seekers config --showconfig --show会展示当前生效的配置合并结果是排查环境变量为何没生效的第一手段。路径展开# Use full path or expand tilde export SKILL_SEEKERS_HOME$HOME/.skill-seekers # NOT: ~/.skill-seekers (may not expand in all shells)在部分 shell尤其是非交互式脚本环境中~不会被展开务必使用$HOME或绝对路径。另请参阅CLI 参考 - 命令参考配置格式 - JSON 配置安装指南 - 平台相关的设置MCP 服务器 - MCP 传输与部署细节环境变量参考英文原版 - 英文版参考文档本文中的默认值与优先级行为以仓库源码尤其是 src/skill_seekers/cli/agent_client.py与官方文档为准适用于 Skill Seekers 3.7.0。赞分享人工智能AI 应用AI 技能RAGMCP 服务网页爬虫【免费下载链接】Skill_SeekersConvert documentation websites, GitHub repositories, and PDFs into Claude AI skills with automatic conflict detection项目地址https://gitcode.com/gh_mirrors/sk/Skill_Seekers点击查看免费下载相关推荐Ollama配置文件详解环境变量与参数优先级Ollama配置文件详解环境变量与参数优先级 想要 快速配置 Ollama来 本地运行大型语言模型 了解配置文件的优先级和环境变量设置是关键。Ollama作人工智能大模型模型推理服务本地部署Local Deep Research 配置完全指南LDR_ 环境变量、优先级机制与全量配置项参考Local Deep Research 配置完全指南LDR_ 环境变量、优先级机制与全量配置项参考 Local Deep ResearchLDR的所有配置AI应用人工智能大模型RAGAI Agent深度研究本地部署后端前端Trippy 配置完全指南配置文件、命令行参数与环境变量的优先级与实战详解Trippy 配置完全指南配置文件、命令行参数与环境变量的优先级与实战详解 Trippy 是一款基于 Traceroute 的网络诊断工具支持交互式 TUI网络CLI运维创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
