安装与首次配置完整指南
YQWORK 目前提供 Windows 客户端。下载安装程序后按向导装好，再配置一家模型服务，就能开始让数字员工替你干活。YQWORK 不绑定单一模型厂商，也没有强制的新手向导——配置都在软件里随时可调。
请只从官网或本帮助中心的“下载客户端”入口获取安装程序，避免使用来源不明的第三方安装包。
一、系统要求
| 操作系统 | Windows 10 或 Windows 11，64 位 |
|---|---|
| 磁盘空间 | 建议预留约 1.5 GB。客户端内置 Python 运行时，安装后约 640 MB，另加工作区文件所需空间 |
| 网络 | 配置模型和调用在线模型时需要联网；软件本体在本地运行 |
| 权限 | 安装时可能需要 Windows 允许应用更改设备 |
二、下载并安装
下载安装程序
点击页面顶部的“下载客户端”，保存 YQWorkSetup.exe。网络较差时可改用官网的离线完整安装包。
运行安装程序
双击安装文件。Windows 询问是否允许应用更改设备时，选择“是”。
完成安装
按向导装好，安装程序会创建开始菜单和桌面入口。
启动 YQWORK
打开客户端进入落地页，接着按下面第四节完成首次配置。
在线引导器体积小、安装时联网拉取主体文件；离线完整安装包体积大，但安装过程中不再下载，适合网络差或多机离线安装。两者装出来是同一个客户端。
三、Windows 提示“未知发布者 / SmartScreen”怎么办？
在代码签名证书信誉积累完成前，或安装包刚更新时，Windows SmartScreen 可能显示保护提示。
继续前先确认安装文件来自官网并核对文件名。不要对通过聊天群、网盘或陌生网站获得的安装包直接放行。
确认来源无误后，点击“更多信息”，再点击“仍要运行”。如果杀毒软件已将文件隔离，请先查看隔离原因，不要直接关闭安全软件。
四、首次配置（四步）
第一次打开是一个落地页，没有强制向导。建议依次完成以下四步，之后都可以在设置里随时改：
- 添加模型服务：打开设置 → 模型服务，YQWORK 预置了 DeepSeek、通义千问、Kimi、智谱、豆包 5 家国内厂商（均兼容 OpenAI 接口）。选一家，填入你在该厂商控制台申请的 API 密钥并保存。
- 选择工作区：选一个允许 YQWORK 读写的文件夹，任务成果物会保存到这里。不选的话会自动使用默认工作区
文档\YQWork并提示你。 - 选择权限模式：共四档——每次询问（默认，逐条确认）、接受编辑（写文件不再确认、命令仍确认）、规划模式（只读）、自动模式（中低风险免确认、高风险仍问）。新用户建议先用“每次询问”。
- 选择数字员工：在输入框选择要用的员工，如财务助手；更多员工可在员工角色库添加。
配置完成后，在新任务里直接用大白话下达即可，例如：
帮我读取工作区里的月度报表，核对勾稽关系，并生成一份 Word 报告。
五、API 密钥与隐私
API 密钥用于你的电脑直接调用所选模型服务。密钥在本机加密保存（%APPDATA%\yqwork），不会上传到 YQWORK 的服务器，界面上只显示 sk-**** 占位、不持续显示明文，也不会作为普通任务内容写入工作区文件。
更换电脑或重装系统后，需要在新机器上重新配置密钥。请不要把密钥粘贴到任务对话、截图或公开反馈中。
六、安装失败时如何排查？
- 确认系统是 64 位 Windows 10 / 11，并重新下载安装包。
- 右键安装程序，选择“以管理员身份运行”。
- 检查系统盘空间是否充足（预留约 1.5 GB）。
- 检查代理、防火墙或企业网络是否拦截了下载地址。
- 仍无法安装时，记录客户端版本号、Windows 版本和错误截图，作为反馈材料。