在 Windows 上安装
Windows 平台提供一键安装器：一个自包含的单文件 EXE，内置 Axiomate 本体及 Git、Python 离线包，按向导操作即可完成安装。
系统需求
- 操作系统：Windows 10（build 10240 及以上）或 Windows 11
- 处理器架构：x64（不支持 arm64 与 32 位）
- 必需依赖：Git 2.40+（缺失时安装器会自动安装内置的 Git 2.54）
- Windows 10 额外依赖：Windows Terminal（缺失时安装器会通过 winget 联网安装
Microsoft.WindowsTerminal） - 可选依赖：Python 3.12+（部分技能为 Python 脚本，按需安装；安装器提供可选项）
安装器需要管理员权限运行，并会无条件应用两项系统设置：将 PowerShell 执行策略设为
RemoteSigned、启用 Windows 开发人员模式，同时把安装目录写入系统 PATH。受管控的企业终端请提前知悉。
安装步骤
从下载页获取安装器（文件名形如 axiomate-installer-<版本>-windows-x64.exe），双击运行。系统会弹出权限确认窗口（需要管理员权限写入安装目录与系统设置），点击「是」后进入安装向导。
安装器当前未做代码签名，首次运行时 Windows SmartScreen 可能弹出提醒，选择「更多信息 → 仍要运行」即可。
向导共有以下几个步骤：
1. 欢迎页
显示安装器版本与内置的 Axiomate 版本，并列出安装器将执行的操作。语言切换（中文 / English）只在此页提供，后续页面无法更改。
若检测到系统中已安装过 Axiomate，点击「下一步」时会弹窗提示，确认后安装器会先卸载旧版本再继续：清理系统 PATH、删除桌面与开始菜单快捷方式、移除注册表项并删除旧的安装目录（卸载期间会显示进度，请稍候）。此过程不会删除 ~/.axiomate.json 与 ~/.axiomate/，你的个人配置与数据会保留。
2. 环境检查
自动检测操作系统、架构、Windows Terminal、Git 与 Python：
- 系统与架构：必须为 Windows 10+、x64。不满足时无法继续。
- Windows Terminal：仅 Windows 10 会检查。若缺失，安装器会要求并自动通过 winget 联网安装
Microsoft.WindowsTerminal，用于运行 Axiomate 的终端快捷方式；Windows 11 通常已内置，因此会跳过该检查。 - Git：已安装 2.40+ 则显示通过并跳过；缺失则强制安装内置 Git 2.54（必装，不可取消）。
- Python：已安装 3.12+ 则跳过；缺失时默认勾选安装内置 Python 3.12，但允许取消。若你的用法不需要 Python 技能，可取消以节省时间。
- pip 镜像：仅当「安装内置 Python」处于勾选状态时才出现。默认开启、默认使用清华 TUNA 源，可切换为阿里云或关闭。国内网络建议保持默认；海外网络可关闭。
3. 安装位置
默认 %USERPROFILE%\axiomate。请注意：
- 安装前会清空目标目录。若所选目录非空，向导会二次确认后整体删除其中内容，切勿指向含有项目代码或文档的目录。
- 系统目录（Windows、Program Files、ProgramData 等）、用户特殊文件夹（桌面、文档、下载等）以及
~/.axiomate配置目录均被禁止选择。 - 建议使用默认路径或另建一个专用空目录。
4. 安装选项
安装选项均可按需调整；即使全部关闭，axiomate 命令也会正常安装并可使用：
- 快速模型配置：勾选后下一步可填入模型与 API Key。安装时会覆盖
~/.axiomate.json；已有模型配置的用户请先备份，或不勾此项——安装后按首次启动引导添加模型即可。 - 清空 Axiomate 配置目录：勾选后安装时会删除整个
~/.axiomate/目录（含已有会话、设置、skills 等，且不备份）。默认不勾选。Axiomate 仍处于测试阶段，升级时若遇到旧数据不兼容的异常，可勾选此项清空旧数据；勾选前如目录中有重要内容，请先备份。注意该选项不会删除~/.axiomate.json配置文件——若该文件也不兼容，可勾选「快速模型配置」覆盖它，或安装后手动删除。 - 默认开启 bypass permissions 模式：勾选后写入
~/.axiomate/settings.json，使 AI 无需逐次确认即可自动执行命令、修改文件。这会显著降低安全防护，建议仅在受信任的个人或隔离环境中开启；企业、生产或共享机器请保持关闭。 - 创建默认工作区与快捷方式：在桌面与开始菜单创建快捷方式，双击即以工作区目录启动 Axiomate TUI，适合初次使用者。勾选后可自定义工作区目录（默认
%USERPROFILE%\axiomate-workspace）。
注册系统 PATH 是默认行为，无法关闭。
5. 模型配置（仅在勾选「快速模型配置」时出现）
当前快速配置支持选择以下模型站点与主要模型：
| 站点 | 端点 | 可选模型（首项为默认） |
|---|---|---|
| DeepSeek 官方 | api.deepseek.com | deepseek-v4-pro（高质量, 强推理）deepseek-v4-flash（轻量, 高速度） |
| 智谱 BigModel | open.bigmodel.cn | glm-5.2（Coding Plan, 更便宜）glm-4.7（Coding Plan, 更便宜）glm-5.2（通用端点）glm-4.7（通用端点） |
| 智谱 Z.ai（国际） | api.z.ai | 与智谱 BigModel 相同的四个 GLM 模型，走 z.ai 国际网关。 |
| 月之暗面 Kimi | api.moonshot.cn | kimi-k2.7-code-highspeed（高配, 256K 上下文, 强推理）kimi-k2.5（低配, 256K 上下文, 性价比） |
| Moonshot Kimi（国际） | api.moonshot.ai | 与月之暗面 Kimi 相同的两个 Kimi 模型，走国际端点。 |
| 阿里云百炼（国内） | dashscope.aliyuncs.com（通用）coding.dashscope.aliyuncs.com（Coding Plan）token-plan.cn-beijing.maas.aliyuncs.com（Token Plan） | qwen3.7-max + qwen3.7-plus（高配, 1M 上下文, 强推理）qwen3.6-plus + qwen3.6-flash（低配, 1M 上下文, 性价比） |
| 阿里云百炼（国际） | dashscope-us.aliyuncs.com | 与国内相同的四个 Qwen 模型，走国际端点。 |
| 小米 MiMo | api.xiaomimimo.com | mimo-v2.5-pro（高配, 纯文本, 1M 上下文）mimo-v2.5（低配, 多模态, 1M 上下文） |
| 小米 MiMo（国际） | token-plan-sgp.xiaomimimo.com | 与国内相同的两个 MiMo 模型，走国际端点。 |
| MiniMax | api.minimaxi.com（Anthropic 协议） | MiniMax-M3（高配, 多模态, 1M 上下文）MiniMax-M2.5（低配, 192K 上下文, 性价比） |
| MiniMax（国际） | api.minimax.io（Anthropic 协议） | 与国内相同的两个 MiniMax 模型，走国际端点。 |
| 火山引擎 Ark（豆包） | ark.cn-beijing.volces.com | doubao-seed-2.1-pro + doubao-seed-2.1-turbo（高配, 256K 上下文, 推理）doubao-seed-2.1-turbo + doubao-seed-2.0-lite（低配, 256K 上下文, 性价比） |
| 火山引擎 Ark 豆包（国际） | ark.ap-southeast.bytepluses.com | 与国内相同的三个豆包模型，走国际端点。 |
选择模型后填入对应平台的 API Key（必填，不能包含 * 字符）即可。需要使用其他厂商或自定义模型时，安装后手动编辑 ~/.axiomate.json。
6. 安装进度与完成
进度页按顺序执行各步骤并实时显示日志；若失败会标红并提示日志位置。完成后：
- 勾选了创建工作区的用户，可直接点「启动 Axiomate」，或使用桌面 / 开始菜单快捷方式。
- 未创建工作区的用户，需重新打开一个终端让 PATH 生效，再运行
axiomate。
验证
打开一个新的终端（已开启的窗口需重新打开以加载 PATH），执行：
axiomate --help
git --version
两条命令均正常输出，即表示安装成功。若已安装 Python，可另行运行 python --version 确认。
卸载
安装器已注册标准卸载项，通过系统自带入口卸载即可：
- 「设置 → 应用 → 已安装的应用」，找到 Axiomate，点击「卸载」；或
- 「控制面板 → 程序 → 卸载程序」中选择 Axiomate。
这会调用安装器自带的卸载程序，移除安装目录、清理系统 PATH，并删除快捷方式与注册表项。
卸载会保留你的个人数据：~/.axiomate.json、~/.axiomate/ 以及工作区目录不会被删除，如需彻底清理可手动删除它们。