安装

前提条件

• Python 3.12+
• macOS / Linux / Windows（PowerShell、CMD 或 Windows Terminal 均可）

安装方式

uv（推荐）

1. 安装 uv（如已安装可跳过）：

   Linux / macOS

   curl -LsSf https://astral.sh/uv/install.sh | sh

   Windows

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. 安装 Mutsumi：

   uv tool install git+https://github.com/ywh555hhh/Mutsumi.git

3. 验证安装：

   mutsumi --version
   # 预期输出: mutsumi, version 0.4.0b1

提示

uv 会自动管理隔离的 Python 环境，你不需要预先安装 Python。

pip

最简单的方式，只要你有 Python 3.12+ 环境即可：

pip install git+https://github.com/ywh555hhh/Mutsumi

验证：

mutsumi --version

pipx

1. 安装 pipx（如已安装可跳过）：

   python3 -m pip install --user pipx
   pipx ensurepath

2. 安装 Mutsumi：

   pipx install git+https://github.com/ywh555hhh/Mutsumi.git

3. 验证安装：

   mutsumi --version

Git Clone（开发者）

1. 克隆仓库：

   git clone https://github.com/ywh555hhh/Mutsumi.git
   cd Mutsumi

2. 安装并运行：

   pip install .
   mutsumi --version

   或使用 uv：

   uv sync && uv run mutsumi --version

常见问题

mutsumi 命令未找到

Linux / macOS

确保 ~/.local/bin 在你的 PATH 中：

export PATH="$HOME/.local/bin:$PATH"

将上面这行添加到 ~/.bashrc、~/.zshrc 或 ~/.config/fish/config.fish 中以持久化。

Windows

如果使用 pip install --user，需要将 Python Scripts 目录加入 PATH：

# PowerShell — 查看 Scripts 路径:
python -m site --user-site
# 然后将对应的 Scripts\ 目录添加到 PATH

使用 uv tool install 或 pipx 安装时会自动配置 PATH。

升级

# uv
uv tool install --force git+https://github.com/ywh555hhh/Mutsumi.git
# pip
pip install --upgrade git+https://github.com/ywh555hhh/Mutsumi

卸载

pip

pip uninstall mutsumi

uv

uv tool uninstall mutsumi

配置与日志文件可手动删除：

Linux / macOS

rm -rf ~/.config/mutsumi/           # 配置
rm -rf ~/.local/share/mutsumi/      # 日志

Windows

Remove-Item -Recurse "$env:APPDATA\mutsumi"       # 配置
Remove-Item -Recurse "$env:LOCALAPPDATA\mutsumi"   # 日志

tasks.json 是你的数据 —— 请手动决定是否保留。

下一步

安装完成后，前往 快速上手 开始创建你的第一个任务。