深浅色
首次配置向导
这一页是干什么的：第一次安装完成后，按 8 个步骤把系统配置过一遍。走完它，系统就进入日常使用状态。
菜单位置：左边导航栏 → 设置 → 首次配置向导
谁能看到这一页
| 角色 | 能看到什么 |
|---|---|
| 管理员 | 可以打开、填写、完成配置 |
| 主管 | 看不到"设置"菜单，打不开这一页 |
| 普通员工 | 看不到"设置"菜单，打不开这一页 |
用之前必须知道的前提
- 这一页只有管理员能打开。
- 走之前先准备好两样东西：企业ID 和 应用ID，都在企业微信后台能看到。
- 页面上方有一行提醒：企业微信这一步显示"待外部验收"时，只说明本机参数填好了，不代表已经和企业微信那边真正联通。
- 这不是唯一入口。以后日常改参数用系统配置；检查系统状态用系统就绪检查。
敏感密钥不在这一页填
Secret、Token、EncodingAESKey、会话存档 Secret 和私钥，不在页面上填。
它们由部署人员在服务器上配置。网页不接收、不回显、不显示。页面上有黄色提示说明这一点。
界面上有什么
页面分左右两块：左边是步骤列表，右边是当前步骤的详细内容。
右上角两个按钮：
| 按钮 | 干什么用 |
|---|---|
| 重新检查 | 把每一步的状态重新查一遍 |
| 完成配置 | 全部必需步骤通过后才能点，点完向导就结束了 |
左边的 8 个步骤：
| 步骤 | 干什么 |
|---|---|
| 1 系统检查 | 检查必需的本地配置 |
| 2 品牌与域名 | 检查公开地址和路径前缀（部署时填的） |
| 3 管理员 | 检查管理员账号 |
| 4 企业微信 | 填企业 ID、应用 ID（可选，可以以后配） |
| 5 登录方式 | 检查登录相关配置 |
| 6 AI 能力 | AI 相关配置（可选，可以以后配） |
| 7 文件存储 | 检查文件存放配置 |
| 8 能力验证与完成 | 汇总全部结果，完成配置 |
每个步骤旁边的状态词：
| 状态 | 什么意思 |
|---|---|
| 已完成 | 这一项通过了 |
| 待确认完成 | 都检查完了，等你点"完成配置" |
| 需要处理 | 这一项有问题，要先处理 |
| 待外部验收 | 本机参数已填好，还没和企业微信那边真正联通确认 |
| 可选 | 可选步骤，可以以后配 |
| 未启用 | 这一项没有启用 |
| 待检查 | 还没检查过 |
面板底部有 上一步 / 下一步 按钮，走到最后一步变成完成配置。
企业微信这一步的表单：
| 字段 | 怎么填 |
|---|---|
| 企业 ID | 你们公司企业微信的编号，一般以 ww 开头，在企微后台能看到 |
| 应用 ID | 企业微信应用的编号 |
| 会话存档 SDK 路径 | 服务器上的位置，由部署人员填；不懂就留空 |
填完点保存非敏感配置。
最后一步的检查结果：
会显示"本机必需配置已通过"或"还有必需配置未通过"，下面有重新验证本机配置按钮。
保存了不等于连上了
点"保存非敏感配置"只是把参数记下来。保存不等于连接成功。
点"完成配置"也只是记录向导进度，不会给客户发消息，也不会调用 AI。
怎么用：一步一步
场景一：第一次把向导走一遍
- 用管理员账号登录，点开 设置 → 首次配置向导
- 从第 1 步"系统检查"开始，看每一步的状态
- 显示已完成或可选的，直接点下一步
- 显示需要处理的，按说明处理完，点检查当前配置复查
- 走到第 4 步"企业微信"，填企业 ID 和应用 ID，点保存非敏感配置
- 走到第 8 步，确认显示"本机必需配置已通过"
- 点完成配置，看到"首次配置已完成"
场景二：企业微信那一步不想现在配
- 在第 4 步直接点下一步跳过去
- 以后想配了，随时回到这一页补上
- 注意：不配企业微信，客户、群发这些功能就用不了
场景三：填错了想改
- 左边点回"企业微信"那一步
- 改完再点保存非敏感配置
- 提示"非敏感配置已保存"，说明改好了
出错了怎么办
| 屏幕上显示 | 什么意思 | 怎么办 |
|---|---|---|
| 企业 ID 和应用 ID 需要同时填写 | 两个只填了一个 | 两个都填上，或两个都留空 |
| 保存失败，请检查输入和后端服务 | 保存没成功 | 检查输入后重试；反复失败找部署人员 |
| 还有必需配置未通过，暂时不能完成 | 前面还有"需要处理"的步骤 | 回左边的步骤列表，把"需要处理"的处理掉 |
| 步骤切换已显示，但进度暂时没有保存 | 页面切换正常，进度没存上 | 不影响使用，点一下重新检查 |
| 步骤进度暂时没有保存，请稍后重试 | 进度没存上 | 稍后重试；反复失败找部署人员 |
| 验证失败，请查看系统就绪检查 | 检查没跑成功 | 去系统就绪检查看具体问题 |
| 向导暂时无法加载 | 页面没读出来 | 点再试一次；还不行找部署人员 |
常见问题
Q："完成配置"按钮是灰的，点不动？
说明还有必需步骤没通过。回左边列表，看哪个显示需要处理，先处理它。
Q：企业微信和 AI 这两步可以先跳过吗？
可以。它们是可选步骤，以后随时回来配。不配的话，对应的功能用不了。
Q：向导走完了，是不是所有功能就能用了？
不一定。向导只把本机配置过一遍。功能能不能用，还要看企业微信那边对应能力开没开——去能力状态看。
Q：走完向导还要做什么？
建议去系统就绪检查点一次验证配置，再实际试一遍：让员工加个测试客户，看客户列表有没有数据。
Q：向导和"系统配置"有什么区别？
向导是第一次安装后按步骤过一遍；系统配置是以后日常改参数的地方。两边改的是同一套参数。
相关页面
- 系统配置 — 日常改参数
- 系统就绪检查 — 随时给系统做体检
- 能力状态 — 看哪些能力真的开通了
- 企业微信要开通哪些能力 — 企微那边要开什么、去哪儿开
- 第一次配置（企微接入） — 第一次配置的完整说明
- 企业微信接入 — 部署人员怎么把参数和密钥配好