#安装与更新

#系统要求

• 操作系统：Windows 10 / 11（当前正式分发为 Windows NSIS 安装包）
• 网络：配置大模型、下载社区 MCP Server、联网搜索等功能需要可访问外网（或你的私有推理端点）

#获取安装包

1. 打开发布页：Gitee Releases
2. 下载最新的 .exe 安装包（体积较小，不含 Python / 向量库）
3. 按中文安装向导完成安装

首次启动时，若本机还没有运行时组件，轻量启动器会提示下载 5xAI-runtime.zip（Python 嵌入环境 + zvec_c_api.dll）：

• 优先从当前版本 Releases 查找该附件
• 当前版本没有时，自动回退到更早版本里同名附件
• 就绪后再拉起主程序（aihelper-core.exe）

说明：主程序链接了 zvec，无法在缺 DLL 时直接启动，因此安装包内带独立启动器完成下载。

安装完成后，桌面或开始菜单可找到 开发小助手 AI（窗口标题默认显示为「AI集成平台」）。

#检查更新

在应用内：

1. 打开侧栏底部 设置
2. 进入 关于软件
3. 点击 检查更新
4. 若有新版本，点 立即下载 → 应用会下载安装包并以更新模式打开安装向导

更新会保留：已下载的运行环境（Python / zvec）、用户数据与登录状态，无需重新下载运行时或重新登录。

手动安装升级包时，建议选择「请勿卸载」直接覆盖；若选择「安装前卸载」，卸载确认页中「删除应用数据与运行环境」默认不勾选，勾选后才会清理。

下载失败时可选择打开 Gitee Releases 手动下载。

当前版本号可在「关于软件」页查看（例如 0.0.12-alpha）。

#卸载

从「应用和功能」卸载时：

• 默认保留应用数据与运行环境（便于日后重装）
• 若要一并清理，在卸载确认页勾选「同时删除应用数据与运行环境」

#首次建议配置

安装后建议按此顺序完成初始化：

1. 模型配置（设置 → 模型配置）：添加至少一个大模型，并「一键检测」
2. 用户目录（设置 → 系统设置）：确认或自定义数据根目录（任务、工作流、技能、配置等存放于此）
3. Agent 权限（设置 → 系统设置）：推荐「逐步确认」；需要无人值守再改为「自主执行」
4. （可选）MCP 连接：按 集成对接 添加 MCP；桌面工具走 软件连接（如 Git Desk）
5. （可选）IDE 设置：配置 Cursor / Trae 等，便于从灵感、任务一键打开工程

#开发者本地运行

若你从源码调试（非终端用户）：

# 在 py_tauri_works 目录
uv venv -p 3.12 .venv
.venv\Scripts\activate
uv pip install -e src-tauri\src-python
pnpm install
pnpm tauri dev

更完整的环境说明见仓库内 py_tauri_works/开发环境说明.md。