# CLOAK AI 操作指南

> 版本：v0.1.37  
> 用法：将这个文件拖入支持文件上传的 AI 聊天窗口，然后告诉 AI 你想完成什么。

## 给 AI 的执行要求

1. 先询问用户的目标，以及系统、Mac 芯片类型、个人/团队使用方式等必要信息。
2. 用户正在边看边操作时，每次只给一步，等用户确认后继续。
3. 不得索要用户在聊天中粘贴 API Key；应让用户直接在 CLOAK 设置中填写。
4. 不得虚构组织邀请码、账号、权限、模型配置或不存在的功能。
5. 涉及组织权限、资源限额和工作区分配时，引导用户联系组织管理员或 CLOAK 团队。

## 1. 选择正确安装包

| 设备 | 下载地址 |
|---|---|
| Windows 10 及以上·x64 | https://qn.oss.43consult.com/cloak/release/v0.1.37/Cloak_0.1.37_x64-setup.exe |
| macOS·Apple 芯片 M1/M2/M3/M4 | https://qn.oss.43consult.com/cloak/release/v0.1.37/Cloak_0.1.37_aarch64.dmg |
| macOS·Intel 芯片 | https://qn.oss.43consult.com/cloak/release/v0.1.37/Cloak_0.1.37_x64.dmg |
| Linux·amd64 AppImage | https://qn.oss.43consult.com/cloak/release/v0.1.37/Cloak_0.1.37_amd64.AppImage |

不知道 Mac 芯片时：点击苹果菜单 → 关于本机，查看“芯片”一栏。

## 2. 安装

- **Windows：**打开安装程序并按提示完成。如提示缺少基础组件，按应用指引安装；也可安装 Git for Windows 并保持默认选项。
- **macOS：**打开 DMG，把 CLOAK 拖到“应用程序”。无法访问文件时，在“系统设置 → 隐私与安全性 → 完全磁盘访问权限”中为 CLOAK 授权，然后重启。
- **Linux：**在 AppImage 文件属性中允许作为程序执行，然后打开。

## 3. 选择使用路径

### 个人用户

1. 打开“设置 → 模型与环境”。
2. 选择服务商，在 CLOAK 中直接填写 API Key；也可使用自定义兼容端点。
3. 使用 Claude 时，在配置详情中选择订阅账号登录或 Console/API 登录。
4. 选择本地项目文件夹，新建任务并开始对话。

### 组织成员

1. 确认组织已开通 CLOAK 团队版，并且账号已加入正确工作区。
2. 使用组织支持的账号、手机验证码或组织提供的邀请码登录。
3. 使用组织已开放的模型、资料和工作区；普通成员通常不需要自行维护 API Key。

## 4. 常用操作

- **处理文件/图片：**直接拖入对话窗口，说明希望 AI 完成的结果。
- **微信接入：**打开“设置 → 接入微信”，扫码连接并保持 CLOAK 桌面客户端运行。
- **Zen 语音：**打开“设置 → 高级扩展 → Zen 模式”，在 CLOAK 中填写语音服务 API Key 后保存。
- **产物/交付：**收到新产物提示后，进入产物或交付中心查看。
- **反馈问题：**在“设置 → 反馈”中说清点了哪里、想做什么、出现了什么提示，并附上截图。

## 5. 常见问题

- **看不到团队工作区：**检查登录状态、团队版开通状态、组织成员身份和工作区分配。
- **看得到文件但无法打开/下载/带入对话：**优先让组织管理员检查文件权限。
- **模型不可用或请求失败：**检查模型选择、服务商状态、个人账户余额/组织资源限额和网络；然后重试或切换已授权的备用模型。
- **公司网、校园网或代理异常：**切换其他网络测试，或请网管放行模型服务、GitHub、下载地址和登录服务。

## 可以直接对 AI 说

- “请根据这份指南，一步一步帮我在 M 系列 Mac 上安装 CLOAK。”
- “我是个人用户，请帮我配置模型环境，每次只告诉我一步。”
- “我看不到团队工作区，请按这份指南帮我排查。”
- “请帮我把当前工作区接入微信。”

如果问题涉及组织开通、账号权限、工作区分配或资源限额，请通过 CLOAK 官网的二维码联系 CLOAK 团队。