用户与权限
适用角色：管理员
前置条件：已了解分组驱动资源可见性
本篇覆盖三块：用户管理（开号、分配节点）、分组管理（权限单元）、用户智能体管理（容器生命周期与资源档位）。
一、用户管理
| 页签 | 内容 |
|---|---|
| 用户管理 | 全部用户 |
| 分组管理 | 分组列表 |
1.1 用户列表
| 列 | 说明 |
|---|---|
| 用户名 | 登录名，创建后不可改 |
| 显示名称 | 界面上展示的名字 |
| 邮箱 | 联系邮箱 |
| 分组 | 该用户所属分组，决定其可见资源 |
| 节点 | 分配到的节点，未分配显示「未分配」 |
| 操作 | 编辑、重置密码、注销、重新分配、删除 |
1.2 新增用户
| 字段 | 必填 | 规则 |
|---|---|---|
| 用户名 | ✅ | 3–30 字符，必须以字母开头，只能含字母／数字／下划线／中划线／点，不支持中文 |
| 显示名称 | — | 界面上显示的名字 |
| 密码 | ✅ | 新建时必填 |
| 邮箱 | ❌ | — |
| 所属分组 | ❌ | 可多选。超级管理员的分组不可修改 |
| 节点 | ❌ | 留空既未分配；选了则按选择分配 |
| 智能体密码 | ❌ | 容器 HTTP Basic Auth 密码，16–64 字符。留空用镜像默认值 |
注意 · 用户名不支持中文是系统级限制，不是表单校验问题。中文请写在「显示名称」。
1.3 编辑用户
| 字段 | 编辑时 |
|---|---|
| 密码 | 留空表示不修改 |
| 节点 | 不支持直接修改。如需变更，请先「注销」再「重新分配」 |
1.4 重置密码
重置后会展示新密码，只能查看一次，关闭后无法再次查看。请通过安全渠道交付给用户。
注意 · 重置密码会使该用户所有已登录设备的会话立即失效。
1.5 注销用户
| 项 | 说明 |
|---|---|
| 效果 | 用户暂时没有节点，AI 对话不可用 |
| 数据 | 工作空间数据保留在原节点上，不会被删除 |
| 后续 | 重新分配到其他节点时，老节点上的工作空间内容会被清除 |
提示 · 「注销」是安全的第一步操作，不丢数据。「删除」才不可逆。
1.6 重新分配
两步确认，需输入用户名二次确认。
| 步骤 | 内容 |
|---|---|
| 1 | 选择目标节点，展示将从哪个节点切到哪个节点，并列出将被清除的数据 |
| 2 | 输入用户名确认后执行 |
⚠️ 将被清除的数据（不可恢复）：
| 数据 | 说明 |
|---|---|
| 工作空间内容 | 所有文件 |
| OpenCode 会话历史 | 所有对话 |
| OpenCode 偏好配置 | 个人偏好 |
| SSH 密钥缓存 | 缓存的密钥 |
1.7 删除用户
删除后用户记录与其容器一并移除。
二、分组管理
| 列 | 说明 |
|---|---|
| 名称 | 分组名称 |
| 描述 | 用途说明 |
| 操作 | 编辑、删除 |
2.1 新增分组
| 字段 | 必填 | 说明 |
|---|---|---|
| 分组名称 | ✅ | 如「技术组」 |
| 描述 | ❌ | 用途说明 |
注意 · 内置两个分组不可删除：超级管理员（id=1）与管理员（id=2），两者权限相同。
2.2 编辑分组
2.3 删除分组
注意 · 删除分组前请确认组内成员已被转移，否则这些用户会失去对应资源的访问权。
2.4 分组在哪些地方起作用
| 资源 | 配置位置 |
|---|---|
| Git 仓库 | Git 仓库管理 |
| 技能目录 | 资产 · 权限设置 |
| 重要文档目录 | 资产 · 权限设置 |
| 动态场景 | 动态场景 |
| 扩展应用 | 扩展自身的准入组配置 |
三、节点分配
节点的分配入口在用户的新增／编辑表单中。
| 选项 | 效果 |
|---|---|
| 留空 | 未分配 |
| 选择一个节点 | 用户绑定到该节点，容器与工作空间都在该节点上 |
| 本机 | 当前节点本身（管理员操作时显示） |
| 节点状态 | 说明 |
|---|---|
| 在线 | 正常服务 |
| 离线 | 不可达，需排查 |
注意 · 用户没绑节点 = 完全用不了 AI 对话。用户登录后会看到「未分配智能体容器，AI 对话暂不可用」。
四、用户智能体管理
本模块管理用户智能体容器（不是 AI 角色定义，那是智能体设置）。
| 卡片字段 | 说明 |
|---|---|
| 状态 | 运行中／已停止 |
| 端口 | 容器映射到宿主的端口；显示「自动」表示由系统分配 |
| 需重建 | 端口与当前配置不一致，需重建容器 |
| opencode 鉴权 | 已启用／未启用 |
| 在线时长 | 容器已运行的时长 |
| OpenCode 版本 | 容器内运行时版本 |
| 最后心跳 | 容器最近一次存活上报 |
4.1 启停容器
| 操作 | 效果 |
|---|---|
| 启动 | 拉起容器。首次启动需 30–90 秒冷启动 |
| 停止 | 停止容器，工作空间文件保留 |
| 重启 | 重启容器，会话保留 |
4.2 终端
直接进入容器内的 shell，用于排查 OpenCode 运行时问题。
注意 · 终端是最高权限入口，操作前确认目标容器。
4.3 编辑用户配置
其中最常调整的是用户智能体等级（资源档位）。
| 等级 | 行为 | 资源成本 |
|---|---|---|
| 标准 | 用时启动，空闲后自动关闭 | 低 |
| 常驻 | 用时启动，并始终保持在线，随时可用 | 中 |
| 预热常驻 | 始终在线，首次响应更快 | 高 |
注意 · 设为「预热常驻」时界面会给出资源成本警告。每个常驻容器都会持续占用内存与 CPU，请按需分配。
提示 · 等级调整可在用户智能体等级分布中总览各档位人数。
五、常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 用户看不到某个仓库／技能／场景 | 未加入对应分组 | 编辑用户调整分组 |
| 用户提示「未分配智能体容器」 | 未绑定节点 | 分配节点 |
| 用户登录后被顶下线 | 平台启用单点登录 | 调整登录策略 |
| 重新分配后老数据没了 | 老节点数据被清除 | 不可恢复，分配前务必确认 |
| 端口显示「需重建」 | 端口配置与实际不一致 | 重建容器 |
| 用户名不能用中文 | 系统级限制 | 中文写在「显示名称」 |
六、相关页面
| 页面 | 内容 |
|---|---|
| 节点与升级 | 节点的健康、镜像策略与升级 |
| 资产 | 资源授权的具体设置 |