安装¶

前置要求¶

uv 包管理器；uv 会自动安装和管理所需的 Python >= 3.12。

方法一：从 PyPI 安装为系统 CLI 工具（推荐）¶

无需克隆仓库或预装 Python，安装后任意目录直接使用 synapse 命令。

uv tool install synapse-cli-agent

从本地源码开发时，使用可编辑安装：

powershell -ExecutionPolicy Bypass -File scripts/install.ps1 -Force
# 或：uv tool install --editable --force .

安装后即可使用：

synapse tui -w .
synapse run "查看当前仓库结构并总结" -w .

仓库根目录的 synapse.cmd 是一个薄启动器，优先级：PATH 上的入口 > .venv\Scripts > uv run。

方法二：本地 venv 开发¶

# 同步依赖
uv sync

# 使用 venv 入口（Windows）
.\.venv\Scripts\synapse.exe tui -w .

# 或模块入口
uv run python -m synapse tui -w .

# 兼容写法
uv run synapse chat -w .

卸载¶

uv tool uninstall synapse-cli-agent
# 或
powershell -ExecutionPolicy Bypass -File scripts/install.ps1 -Uninstall

升级¶

# 如果通过 PyPI 安装
uv tool upgrade synapse-cli-agent

# 如果通过 venv 使用
git pull && uv sync