快速上手
适用角色：全员
前置条件：已获得平台访问地址与账号，参见安装部署
预计耗时：5 分钟
一、登录
浏览器打开管理员提供的平台地址（默认 http://<服务器IP>:9620），输入账号密码登录。
| 元素 | 说明 |
|---|---|
| 机构 Logo | 由管理员在机构设置上传，留空则展示默认图片 |
| 机构简称 | 显示在 Logo 下方，留空则不显示 |
| 账号 | 3–30 字符，字母开头，可含字母、数字、下划线、中划线、点，不支持中文 |
| 密码 | 首次登录使用管理员下发的初始密码 |
| 登 录 | 提交后自动跳转到「工作台」 |
注意 · 账号与节点是绑定的。登录后系统会自动把你路由到你的节点，无需手动选择。
二、界面导览
| 编号 | 分区 | 说明 |
|---|---|---|
| ① | 垂直导航条 | 左侧图标栏，切换工作台／资产／管理／设置／扩展／账户／智能体在线／查看版本说明；底部是查看版本说明 |
| ② | 工作空间面板 | 左侧上半，你的文件目录树 |
| ③ | 任务列表 | 左侧下半，你的全部会话，按今天／昨天／历史分组 |
| ④ | 对话区 | 中间，与 AI 的多轮对话，含思考链、工具调用、产物 |
| ⑤ | 输入区 | 对话区底部，智能体、模型、技能、场景、MCP、附件都在这里 |
三、5 分钟完成第一个任务
步骤 1 · 确认智能体与模型
输入区左下角第一个下拉是智能体，第二个是模型。
| 下拉 | 默认值 | 说明 |
|---|---|---|
| 智能体 | 主智能体 | 决定 AI 的角色、提示词与可调用工具，由管理员配置 |
| 模型 | 系统默认模型 | 决定用哪个大模型。语言模型必选，生图模型仅在需要出图时选 |
注意 · 若输入框无法发送，界面会提示「系统尚未配置语言模型」或「未分配智能体容器」，说明管理员尚未完成配置，请联系管理员。
步骤 2 · 描述你的需求
在输入框直接说你要做什么，例如：
读取工作空间里的 Q3 复盘材料，整理成一份 5 页的汇报提纲| 快捷键 | 作用 |
|---|---|
Enter | 发送消息 |
Shift + Enter | 换行 |
步骤 3 · 看 AI 的工作过程
对话区会实时显示 AI 的执行过程：
| 元素 | 含义 |
|---|---|
| 思考 | 展开可查看 AI 的推理过程 |
| 工具：xxx completed | AI 调用了一个工具（读文件、执行命令、跑技能等） |
| 回答 | AI 的最终输出 |
提示 · 过程较长时可折叠「思考」段落，只看结论。
步骤 4 · 取走产物
AI 生成的文件会出现在右侧面板 → 会话相关文件，可直接打开、下载。
四、账户菜单
点击左下角头像打开。
退出登录
退出后需重新登录才能继续使用。
重启智能体
| 场景 | 是否需要重启 |
|---|---|
| AI 响应异常、上下文错乱 | ✅ 重启 |
| 刚切换了默认工作空间 | ✅ 重启才能生效 |
| 智能体服务已崩溃（界面有横幅提示） | ✅ 重启 |
| 管理员改了智能体配置后不生效 | ✅ 重启 |
注意 · 重启会中断当前会话，但不会删除历史任务。
切换到 opencode 终端模式
面向熟悉命令行的研发人员，可直接操作终端。与图形界面共用同一个容器和同一份工作空间，可随时切回。
五、版本与更新
| 版本项 | 含义 |
|---|---|
| 前端版本 | 界面与浏览器端代码的版本 |
| 后端版本 | 服务端程序的版本 |
| 只显示一个版本号 | 前端版本与后端版本一致 |
注意 · 平台升级由管理员在节点与升级操作，普通用户无需干预。
六、常见卡点
| 你看到的现象 | 原因 | 处理 |
|---|---|---|
| 输入框是灰的，提示「系统尚未配置语言模型」 | 管理员未配置默认语言模型 | 联系管理员 |
| 顶部横幅「未分配智能体容器，AI 对话暂不可用」 | 你的账号未绑定节点 | 联系管理员 |
| 顶部横幅「您绑定的节点 X 当前离线」 | 节点不可达，平台已降级 | 等待管理员恢复节点；期间仍可管理其他内容 |
| 提示「OpenCode 服务冷启动中（首次约 30-90 秒）」 | 智能体容器按需启动 | 等待即可 |
| 提示「智能体服务已崩溃，请尝试重启容器」 | 容器进程异常退出 | 重启智能体 |
| 下拉里找不到某个场景／技能 | 该资源未对你所在分组授权 | 联系管理员 |
| 找不到「资产」「管理」「设置」 | 你是普通用户，这三项仅管理员可见 | 属正常现象 |
| 对话一直转圈不返回 | AI 任务较复杂 | 等待；或用 Esc 中断本次请求 |
七、下一步
| 我是 | 去看 |
|---|---|
| 普通用户 | 工作台 · 账户 |
| 管理员 | 管理运维总览 —— 从那里开始配置 |