# 安装与登录

根据工作地点选择桌面、网页或 Android，并检查登录后的工作范围。

更新于: 2026-11-04
Desktop Source regression checks; final package acceptance is recorded separately in RELEASE.json · Web Production SMS receipt confirmed; phone-only recovery validated with isolated accounts
Canonical: https://ai.z-group.cn/docs/zh/installation/

## 临时服务域名

MATLOOK 在线服务临时使用 [ai.z-group.cn](https://ai.z-group.cn/)，账号和线上额度沿用原服务。请安装支持新入口的客户端后登录同一账号；新版会保留原有本地资料空间，无需重新导入或删除资料。旧客户端仍可能访问原域名；无法连接时请从新入口获取对应平台安装包。原域名恢复后将另行安排兼容切回。浏览器在新域名需要重新登录。

## 手机号登录与找回密码

已注册手机号可以通过短信验证码登录。历史账号的号码验证状态会在正确验证后更新；待审核账号仍需组织审核。忘记密码时，输入注册手机号，获取短信验证码，验证后设置新密码，无需邮箱。邮箱注册用户继续使用邮件重置链接。密码重置会使旧登录会话失效。验证码请求受理不等于手机已经收到；未收到时稍后重试或联系支持。


## Windows 内置 Git Bash（RC45 起）
Windows 安装包包含 Git 和 Git Bash，正常安装后无需单独安装 Git，也无需修改系统 PATH。安装末尾会初始化并检查内置组件。已有用户的有效自定义 Git Bash 路径会保留。
如果出现“修复 Git Bash 组件”，重新安装完整的 MATLOOK 安装包，或选择电脑上已有的 Git Bash。该提示与安装器“不能打开要写入的文件”不同；后者应检查目标目录权限、磁盘空间和文件占用，不要忽略错误继续安装。Windows 实机安装结果以该版本交付记录为准。

## 开始前准备
准备你的 MATLOOK Agent 账号。桌面目标为 macOS 和 Windows 10/11 x64；安装包的芯片架构应与电脑匹配。下载入口及可用版本以当前[MATLOOK Agent 下载页](/download)为准，下载页可能要求登录。
## 安装桌面版
1. 登录 MATLOOK Agent 网站，打开下载页，选择对应系统和架构。
2. 在 macOS 打开下载包并将应用放入“应用程序”；Windows 按安装程序提示完成安装。
3. 打开 MATLOOK Agent，按界面完成账号登录。账号尚未激活时，联系组织管理员处理。
4. 确认顶部执行端为本机，再选择工作区。
5. 在“设置 → AI”检查模型连接。模型未配置不等于本地知识搜索不能使用。
> 部分预发布包尚未完成签名或公证。遇到系统提示，先核对来源、版本与组织的安装要求，不要关闭系统整体安全保护。
## 使用网页版
打开[MATLOOK Agent 应用](/welcome)并登录。在入口选择“继续线上体验”或“连接我的电脑”。前者使用云端资源，后者需要目标电脑登录同一账号并开启同步；网页版不能直接读取任意一台电脑上的文件夹。
## 使用 Android
从 MATLOOK Agent 提供的 Android 下载入口安装对应版本，登录同一账号。先在桌面开启工作区同步，再在手机选择执行电脑。详见[Android 使用](../android/)。
## 检查是否准备完成
应能识别当前账号、执行端、工作区和软件版本。桌面与云端版本可能不同，教程已核对 RC42 的相关变化，旧演示截图来自 RC35／RC36；具体入口以安装版本为准。

## 卸载与重装

先从应用菜单正常退出，再使用 Windows 的卸载入口或在 Mac 上将应用移到废纸篓。默认保留用户目录中的资料；重新安装后可继续打开原工作区和会话。需要备份时，应在退出应用后复制用户资料目录。不要把删除账号或清理资料当作卸载步骤。

rc.74 Windows 版补充清理旧版遗留的当前用户快捷方式和 `matlook://` 协议，清理前核对目标程序路径，避免影响其他安装。覆盖升级不会执行这项卸载清理；本次 Windows 10 真机安装、卸载和重装已验证；Mac 继续提供 rc.73，Windows 11 真机验收暂缓。

## Windows 旧安装资料自动保护与迁移（rc.78）

正常退出 MATLOOK 后运行新安装包。发现旧版将资料放在安装目录内时，安装器先独立备份并逐文件核验，再把原资料归档到安装目录同级的 `MATLOOK-Recovered-Data`；核验成功后继续升级。原资料的文件权限保留，备份权限也会核对。不会用旧会话覆盖现用会话。归档和备份均保留，重试不会删除此前副本。该流程离线运行，无需远程桌面连接或上传资料。

rc.78 的独立卸载也先完成相同保护。若旧版卸载器因旧资料而暂停，可运行新安装包仅修复资料，然后重试原卸载入口：在命令提示符使用安装包的完整路径，例如 `"C:\Downloads\MATLOOK-0.5.0-rc.78-x64.exe" /repair-legacy-data`；选择对应安装目录并继续。此模式完成核验归档后退出，不安装或卸载应用。

若提示退出应用、空间不足、权限或链接目录问题，请按提示处理后重试；不要删除旧资料来解除拦截。迁移失败时安装或卸载会停止，已有副本保留。实际可用范围和真机验收状态以当前下载版本的交付记录为准。