Appearance
第 2 章：安装、登录与更新
本章目标
掌握一条不依赖旧截图和失效链接的安装路径：确认系统环境，从当前产品官方入口获取安装包，完成登录和首次启动检查，并在更新前保留必要的工作资料和配置记录。
适用场景
- 新电脑首次安装 WorkBuddy；
- 更换设备或系统后重新登录；
- 应用提示有新版本，需要判断是否现在更新；
- 安装包打不开、登录回跳失败或文件权限异常。
前置条件
- 确认当前设备的操作系统、芯片架构、剩余空间和网络环境；
- 只从当前产品官方入口获取安装包，不使用网盘、不明镜像或来历不明的修改包；
- 如为公司设备，先确认 IT 管理和软件安装权限；
- 记录现有工作区、配置和自定义 Skill 的位置，重要资料先备份。
核心概念
| 概念 | 说明 | 注意事项 |
|---|---|---|
| 安装包 | 与当前系统和架构匹配的客户端文件 | 名称、格式和入口以当前产品版本为准 |
| 登录 | 建立当前用户的工作身份和授权上下文 | 不借用他人账号，不绕过组织认证 |
| 工作区 | 任务读写文件的范围 | 安装成功不等于自动获得所有目录权限 |
| 更新 | 替换客户端程序或补充能力 | 更新前确认工作资料和配置可恢复 |
分步操作
- 确认环境。 查看系统类型、芯片架构、网络限制和安装权限；不要用“差不多”的安装包替代匹配版本。
- 获取安装包。 通过当前产品官方入口进入下载流程。入口、平台选项和文件格式如果发生变化，以当前页面为准，本说明书不固定下载地址。
- 核对来源。 安装前检查下载来源、文件名和系统安全提示；如果产品提供校验值或签名，按当前说明核对。
- 完成安装。 按系统安装向导操作。遇到发布者未知、安全策略拦截或权限申请时先暂停核实，不要为了安装而关闭系统保护。
- 完成登录。 使用有权使用的账号，通过当前产品提供的认证流程完成登录；浏览器回跳失败时检查默认浏览器、网络代理和系统时间。
- 进行首次检查。 打开一个独立练习工作区，确认可以创建任务、读取授权样本并生成简单草稿。
- 安排更新。 需要更新时记录当前版本、工作区和自定义配置，选择低风险时间执行；更新后重新跑一次练习任务。
示例
安装完成后的最小检查清单：
text
[ ] 系统和安装包架构匹配
[ ] 安装来源可以追溯
[ ] 登录账号和组织权限正确
[ ] 可以打开 WorkBuddy 并创建练习任务
[ ] 练习任务只读取脱敏样本
[ ] 工作区、配置和自定义 Skill 的位置已记录
[ ] 更新前后均能完成同一项最小验收验收方法
- 客户端可以正常启动，当前用户和组织身份显示正确；
- 能在独立工作区创建任务并完成一次只读或草稿任务；
- 系统安全设置没有被不必要地关闭；
- 更新后练习目录、配置记录和任务入口仍可访问；
- 任何无法确认的版本、下载入口或平台支持均被标记为“以当前产品版本为准”。
常见问题
安装包打不开或提示损坏怎么办？
停止安装，确认系统和芯片架构，从当前官方入口重新获取。保留报错和系统信息，不要随意关闭安全功能，也不要使用来历不明的替代包。
登录后没有回到客户端？
检查默认浏览器是否拦截回跳、代理是否影响认证、系统时间是否准确。仍失败时记录时间、系统、错误提示和账号组织，不要反复输入凭证。
更新前需要备份什么？
至少记录工作区位置、重要输入和产物、自定义配置及已安装 Skill 的清单。具体备份方式以当前产品能力和组织策略为准。
风险和权限边界
- 不从第三方镜像、网盘或修改版获取客户端；
- 不绕过公司终端安全、软件白名单或账号认证策略；
- 登录和授权只使用本人或组织明确批准的账号；
- 不把安装问题和业务资料问题混在一起排查，先用脱敏样本验证；
- 版本、下载入口、登录方式和更新选项均可能变化，以当前产品版本为准。
相关解决方案
来源引用
- SRC-UPSTREAM-CH02：安装、登录、更新和常见故障的原始资料，经清理不稳定入口后重组。
内容版本与核对日期
- 内容版本：
0.1.0 - 最后核对日期：
2026-08-05 - 适用版本状态：安装入口、平台选项和登录界面以当前产品版本为准。
- 来源提交版本：
6b5e2403f0f2ad5d3f7ab7a67e9c4d4113583ff3