Skip to content

安装

环境要求

  • Python: >= 3.10（推荐 3.12+）
  • git: 推荐 >= 2.30（store 使用 git worktree）
  • 操作系统: macOS（已验证）/ Linux（预期可用）/ Windows（降级路径，未验证）
  • 一个能读取项目级技能的 AI Agent —— Claude Code 为已验证目标

快速安装

通过 pipx 安装（推荐）

# macOS
brew install pipx
pipx ensurepath
pipx install ipman-cli

# Linux / Windows
pip install pipx
pipx install ipman-cli

VPN / 企业网络用户：如果遇到 SSL 证书验证失败，使用以下命令： 

pipx install ipman-cli --pip-args="--trusted-host pypi.org --trusted-host files.pythonhosted.org"
详见 FAQ - SSL 报错。

通过 pip 安装

pip install ipman-cli

注意：Python 3.12+ 的 Homebrew 环境会因 PEP 668 阻止全局安装。建议使用 pipx 或虚拟环境。

通过 uv 安装

uv pip install ipman-cli

通过 curl 安装（Linux / macOS）

curl -sSL https://raw.githubusercontent.com/twisker/ipman/main/install.sh | bash

预编译二进制（已暂停）

早期版本在 GitHub Releases 提供 PyInstaller 二进制。二进制构建目前已暂停——现有下载会落后于最新版本，请改用 pip/pipx/uv 安装。

免安装一次性运行

uvx ipman-cli sync    # 零安装复原一个仓库的技能环境

macOS 详细步骤

如果你的 macOS 自带 Python 版本低于 3.10（如 3.9），需要先安装新版 Python。

1. 安装 Python 3.12

brew install python@3.12

2. 将 Python 3.12 设为默认版本

echo 'export PATH="$(brew --prefix python@3.12)/libexec/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

验证：

python3 --version   # 应显示 3.12.x
which python3       # 应指向 Homebrew 路径

注意：不要删除或覆盖 /usr/bin/python3，macOS 系统工具可能依赖它。上述方法通过 PATH 优先级"遮盖"系统版本，安全且可逆。

3. 安装 pipx 并安装 IpMan

brew install pipx
pipx ensurepath
pipx install ipman-cli

验证安装

ipman --version
ipman info

Shell 自动补全

IpMan 基于 Click，支持 Shell 自动补全：

# Bash
eval "$(_IPMAN_COMPLETE=bash_source ipman)"

# Zsh
eval "$(_IPMAN_COMPLETE=zsh_source ipman)"

# Fish
_IPMAN_COMPLETE=fish_source ipman | source

从源码安装（开发者）

git clone https://github.com/twisker/ipman.git
cd ipman
uv venv
uv pip install -e ".[dev]"