/docs/zh-CN/getting-started/01-installation.md

安装指南

Skill Seekers v3.6.0

在 5 分钟内完成 Skill Seekers 的安装并运行。

---

系统要求

要求	最低配置	推荐配置
Python	3.10	3.11 或 3.12
内存	4 GB	8 GB+
磁盘	500 MB	2 GB+
操作系统	Linux, macOS, Windows (WSL)	Linux, macOS

---

快速安装

选项 1：pip（推荐）

# 基础安装
pip install skill-seekers

# 支持所有平台
pip install skill-seekers[all-llms]

# 验证安装
skill-seekers --version

选项 2：pipx（隔离环境）

# 如果尚未安装 pipx
pip install pipx
pipx ensurepath

# 安装 skill-seekers
pipx install skill-seekers[all-llms]

选项 3：开发模式（从源码安装）

# 克隆仓库
git clone https://github.com/yusufkaraaslan/Skill_Seekers.git
cd Skill_Seekers

# 以可编辑模式安装
pip install -e ".[all-llms,dev]"

# 验证
skill-seekers --version

---

安装选项

最小安装

仅包含核心功能：

pip install skill-seekers

包含：

• 文档抓取
• 基础打包
• 本地增强（Claude Code）

完整安装

包含所有功能和平台：

pip install skill-seekers[all-llms]

包含：

• Claude AI 支持
• Google Gemini 支持
• OpenAI ChatGPT 支持
• 所有向量数据库
• MCP server
• 云存储（S3, GCS, Azure）

自定义安装

仅安装您需要的部分：

# 仅安装特定平台
pip install skill-seekers[gemini]      # Google Gemini
pip install skill-seekers[openai]      # OpenAI
pip install skill-seekers[minimax]     # MiniMax AI
pip install skill-seekers[chroma]      # ChromaDB

# 安装多个扩展
pip install skill-seekers[gemini,openai,chroma]

# 开发工具
pip install skill-seekers[dev]

---

可用的扩展包

扩展包	描述	安装命令
gemini	Google Gemini 支持	pip install skill-seekers[gemini]
openai	OpenAI ChatGPT 支持	pip install skill-seekers[openai]
mcp	MCP server	pip install skill-seekers[mcp]
video	YouTube/Vimeo 字幕与元数据	pip install skill-seekers[video]
video-full	+ Whisper 转录与视觉帧	pip install skill-seekers[video-full]
jupyter	Jupyter Notebook 提取	pip install skill-seekers[jupyter]
ocr	OCR 支持（扫描版 PDF、视觉帧）	pip install skill-seekers[ocr]
confluence	Confluence wiki 支持	pip install skill-seekers[confluence]
notion	Notion 页面支持	pip install skill-seekers[notion]
chroma	ChromaDB 导出	pip install skill-seekers[chroma]
weaviate	Weaviate 导出	pip install skill-seekers[weaviate]
qdrant	Qdrant 导出	pip install skill-seekers[qdrant]
faiss	FAISS 导出	pip install skill-seekers[faiss]
s3	AWS S3 存储	pip install skill-seekers[s3]
gcs	Google Cloud Storage	pip install skill-seekers[gcs]
azure	Azure Blob Storage	pip install skill-seekers[azure]
embedding	Embedding server	pip install skill-seekers[embedding]
all-llms	所有 LLM 平台	pip install skill-seekers[all-llms]
all	全部功能	pip install skill-seekers[all]
dev	开发工具	pip install skill-seekers[dev]

---

安装后设置

1. 配置 API 密钥（可选）

用于 AI 增强和上传：

# 交互式配置向导
skill-seekers config

# 或设置环境变量
export ANTHROPIC_API_KEY=sk-ant-...
export GITHUB_TOKEN=ghp_...

2. 验证安装

# 检查版本
skill-seekers --version

# 查看所有命令
skill-seekers --help

# 测试配置
skill-seekers config --test

3. 快速测试

# 列出可用预设
skill-seekers estimate --all

# 试运行
skill-seekers create https://docs.python.org/3/ --dry-run

---

平台特定说明

macOS

# 使用 Homebrew Python
brew install python@3.12
pip3.12 install skill-seekers[all-llms]

# 或使用 pyenv
pyenv install 3.12
pyenv global 3.12
pip install skill-seekers[all-llms]

Linux (Ubuntu/Debian)

# 安装 Python 和 pip
sudo apt update
sudo apt install python3-pip python3-venv

# 安装 skill-seekers
pip3 install skill-seekers[all-llms]

# 全局可用
sudo ln -s ~/.local/bin/skill-seekers /usr/local/bin/

Windows

推荐： 使用 WSL2

# 或直接使用 Windows（PowerShell）
python -m pip install skill-seekers[all-llms]

# 如需添加到 PATH
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:APPDATA\Python\Python312\Scripts", "User")

Docker

# 拉取镜像
docker pull skillseekers/skill-seekers:latest

# 运行
docker run -it --rm \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  -v $(pwd)/output:/output \
  skillseekers/skill-seekers \
  skill-seekers create https://docs.react.dev/

---

故障排除

"command not found: skill-seekers"

# 将 pip bin 添加到 PATH
export PATH="$HOME/.local/bin:$PATH"

# 或使用 --user 重新安装
pip install --user --force-reinstall skill-seekers

权限被拒绝

# 不要对 pip 使用 sudo
# 替代方案：
pip install --user skill-seekers

# 或使用虚拟环境
python3 -m venv venv
source venv/bin/activate
pip install skill-seekers[all-llms]

导入错误

# 对于开发安装，确保使用可编辑模式
pip install -e .

# 检查安装
python -c "import skill_seekers; print(skill_seekers.__version__)"

版本冲突

# 使用虚拟环境
python3 -m venv skill-seekers-env
source skill-seekers-env/bin/activate
pip install skill-seekers[all-llms]

---

升级

# 升级到最新版本
pip install --upgrade skill-seekers

# 升级所有扩展
pip install --upgrade skill-seekers[all-llms]

# 检查当前版本
skill-seekers --version

# 查看更新内容
pip show skill-seekers

---

卸载

pip uninstall skill-seekers

# 清理配置（可选）
rm -rf ~/.config/skill-seekers/
rm -rf ~/.cache/skill-seekers/

---

下一步

• 快速入门指南 - 3 条命令创建第一个 skill
• 你的第一个 Skill - 完整演练

---

获取帮助

# 命令帮助
skill-seekers --help
skill-seekers create --help

# 文档
# https://github.com/yusufkaraaslan/Skill_Seekers/tree/main/docs

# Issues
# https://github.com/yusufkaraaslan/Skill_Seekers/issues