127 lines
11 KiB
Markdown
127 lines
11 KiB
Markdown
# 通用版、高级版与一句话助手设计
|
||
|
||
日期：2026-11-11。状态：两版界面及首批真实业务流程已按[实施记录](cloud-editions-20261111.md)落地；本文其余方案对象、模型与脚本内容仍为后续设计。用户已明确本轮不接模型，先完成通用/高级界面的区别。
|
||
|
||
## 产品定位
|
||
|
||
通用版面向不熟悉虚拟化的日常管理员，以“开通员工、分配桌面、查看设备、处理问题”组织流程。高级版面向 IT 运维，提供节点、模板、存储、规格、GPU、策略、监控和任务等详细管理。
|
||
|
||
建议使用同一套 Go 后台、数据库、任务与审计，两套导航和操作流程。现有控制台作为高级界面的基础，新增通用工作台。界面模式与角色权限分别管理：只读账号切换到高级界面仍只有只读权限；通用版管理员发放桌面仍需要后端授权。
|
||
|
||
第一期以“通用模式 / 高级模式”落地，设置默认入口并记住个人选择；需要商业版本销售时，再配置组织可用的功能包及服务端许可校验，避免维护两个代码分支。没有高级版授权的安装不能通过切换模式或直接调用接口开启受限功能。
|
||
|
||
## 两版功能划分
|
||
|
||
| 业务 | 通用版 | 高级版 |
|
||
| --- | --- | --- |
|
||
| 首页 | 健康摘要、常用操作、需要处理的事、助手 | 资源水位、节点、任务、详细告警及助手 |
|
||
| 员工与桌面 | 添加员工、分配/撤销桌面、关联盒子 | 用户批量导入、批量授权、分组筛选及详情 |
|
||
| 桌面管理 | 业务名称、使用人、是否运行、能否连接；开机/正常关机/重启 | VMID、节点、模板、池、规格、批量预检及维护详情 |
|
||
| 新增桌面 | 选择人数与用途，优先分配已有桌面；已就绪模板可进入发放向导 | 节点、存储、模板版本、规格及池成员配置 |
|
||
| 终端管理 | 设备在线状态、名称、使用人、激活向导 | 分组、策略版本、部署回执、系统指标、诊断日志 |
|
||
| 故障处理 | “桌面打不开 / 设备离线”等引导，说明原因和下一步 | 原始指标、关联事件、任务、诊断及专业核对入口 |
|
||
| 监控 | 简明健康状态、待处理事件 | 趋势、阈值规则、确认、历史和缺失采样详情 |
|
||
| GPU/存储/快照 | 常规业务页通过可用性和限制提示体现 | 提供专业页面；具体操作按已实现及已验收能力开放 |
|
||
| 记录 | 操作结果、谁操作、何时完成 | 全历史检索、CSV、任务关联与审计 |
|
||
| 账号安全 | 本人改密、双重验证；管理账号按角色开放 | 同样保留安全能力，并展示详细账号及会话管理 |
|
||
|
||
通用版减少术语与必填参数，仍明确区分“桌面正在开机”“连接服务未就绪”“设备离线”和“数据已过期”。“断开连接”“重启桌面”“还原数据”分别命名，不使用容易混淆的“一键修复”。
|
||
|
||
现有未完成或暂缓的能力继续保留边界：真实克隆与快照还原验收、公共池自动领取/还原、通用 GPU 绑定、OTA、外部通知等不会因为新增助手变成可用。当前已有指定 GPU 的桌面准备与切换能力，也不能推广为任意显卡都可自动分配。
|
||
|
||
## 通用版页面交给 UI 的内容
|
||
|
||
建议只保留五个一级入口：工作台、员工与桌面、终端设备、问题处理、操作记录。账号菜单保留安全设置，接入配置由有权限的管理员通过设置进入。
|
||
|
||
工作台结构：
|
||
|
||
```text
|
||
工作台 [账号] [设置]
|
||
|
||
今天的平台情况
|
||
[可用桌面] [在线设备] [正在使用] [需要处理的问题]
|
||
|
||
你想完成什么？
|
||
[例如：给张三分配一台办公桌面 ] [生成方案]
|
||
[开通新员工] [分配已有桌面] [批量开机] [桌面打不开]
|
||
|
||
常用操作 需要处理的事
|
||
添加员工 / 激活盒子 设备离线、授权缺失、失败任务
|
||
|
||
最近操作
|
||
对象、操作、当前进度、结果、查看详情
|
||
```
|
||
|
||
生成方案后以卡片显示：目标、推荐做法、影响对象、需要的资源、尚缺条件、执行步骤。主要按钮为“执行方案”“修改需求”，旁边提供“查看详情”。有未满足的条件时显示具体下一步，执行按钮不可用。
|
||
|
||
高级版助手可使用同样的卡片，额外展开对象标识、节点/存储、参数、检查结果和底层任务。通用版默认展示用户能理解的业务名称，详情仍可追溯。
|
||
|
||
## 一句话助手如何工作
|
||
|
||
```text
|
||
用户描述 → 识别意图和缺失信息 → 读取真实资源与权限
|
||
→ 生成方案 → 预检与展示 → 用户执行 → 逐步任务与结果
|
||
```
|
||
|
||
脚本或工作流负责检查和执行。理解自由描述、解释结果需要接入语言模型；固定场景也可通过同一套表单向导操作。两者共用执行能力，模型不可用时仍可使用明确的业务向导。
|
||
|
||
默认先生成方案。查状态、解释已有告警等读取请求直接返回结果；修改配置、授权或电源的请求先展示具体对象与影响，再由用户点击执行。涉及重启、断开或数据恢复时，明确展示会中断什么、会改变什么。
|
||
|
||
### 示例：给张三分配一台办公桌面
|
||
|
||
1. 匹配真实用户；同名时提供候选选择。用户不存在时，补充登录名等必要信息，生成“创建用户并分配”的方案。
|
||
2. 查看当前授权与已有可分配桌面。已有合适桌面时优先复用，避免每次都新建 VM。
|
||
3. 需要新建时检查已登记模板、存储、克隆权限及当前支持范围；条件不足就展示缺少什么。普通 Windows 业务镜像尚未完成模板验收时，不能直接承诺自动发放。
|
||
4. 方案卡片说明分配给谁、使用哪台桌面、是否新建、是否关联终端、是否需要开机。
|
||
5. 执行后分别展示“用户已创建 / 授权已保存 / 终端已关联 / 桌面可连接”等实际结果。
|
||
|
||
上述为交互示例，不代表当前已有名为张三的用户或空闲资源。人数、规格和模板名称均须由真实环境或管理员预设产生。
|
||
|
||
### 首批适合接入的六种请求
|
||
|
||
| 用户说的话 | 方案或返回结果 | 当前接口基础与实施范围 |
|
||
| --- | --- | --- |
|
||
| 给张三分配一台办公桌面 | 匹配人员、选桌面、授权；可选关联盒子 | 用户/桌面查询、现有绑定接口；新增跨步骤方案编排 |
|
||
| 把研发组的桌面都开起来 | 固定目标清单、逐台预检、可执行/跳过原因 | 已有批量电源预检与提交；“研发组桌面”的映射不明确时需选择目标 |
|
||
| 这个盒子为什么没有桌面 | 注册/启用、绑定用户、授权、心跳等只读检查 | 现有终端/用户/授权信息；新增诊断规则 |
|
||
| 看看今天有哪些异常 | 汇总真实告警、失败任务、离线设备 | 已有告警与任务历史接口；说明查询时区和时间范围 |
|
||
| 给这个员工换一台桌面 | 展示旧/新授权及当前使用情况，确认后改授权 | 现有绑定/批量授权；不将撤销授权误写成旧 VM 已删除或串流已断开 |
|
||
| 我想再增加几个人使用 | 现有资源与模板前提检查、复用/新增建议、实施步骤 | 可做规划；容量结论需明确估算依据，真实克隆仍按现场验收限制开放 |
|
||
|
||
预设“标准办公”“开发”等用途时，规格、允许模板、是否允许新建和资源预留由管理员配置。预设未配置时只询问影响方案的关键信息，不凭模型常识替客户决定资源或软件授权。
|
||
|
||
## 接口与脚本的实现方式
|
||
|
||
增加业务动作目录，由代码定义每种动作的参数、权限、预检和执行器。语言模型只能从目录中选择动作和填写参数，执行器再次验证。
|
||
|
||
优先复用当前平台接口：用户和桌面查询、用户绑定、CSV 预检、批量电源预检/任务、模板验证和克隆预检等。脚本适合已有接口未覆盖的受控运维步骤，以版本化模板登记；每个模板定义输入、执行位置、超时、返回结构及允许的任务类型。
|
||
|
||
脚本通过平台执行器获得限定的参数和凭据，凭据保留在服务端。模型生成的自由文本不能直接作为 Shell、PowerShell、SSH 命令执行；界面无需让普通用户复制命令。
|
||
|
||
建议新增的后台对象及接口（设计，当前尚未存在）：
|
||
|
||
| 对象/接口 | 内容 |
|
||
| --- | --- |
|
||
| 业务动作目录 | 查询范围、参数定义、权限、执行器、版本、预检要求 |
|
||
| `POST /assistant/plans` | 输入需求，生成方案草稿；缺参数时返回简短问题或候选对象 |
|
||
| `POST /assistant/plans/{id}/check` | 对已确定的对象和动作预检，保存检查时间与资源版本 |
|
||
| `POST /assistant/plans/{id}/execute` | 对同一版本的方案进行幂等提交，重新核对权限和资源 |
|
||
| `GET /assistant/plans/{id}` | 方案步骤、执行状态、关联任务和结果 |
|
||
| 方案及步骤存储 | 意图、对象标识、参数、预检快照、执行人、每步结果及任务关联 |
|
||
|
||
执行权限取当前真实登录身份，同时检查版本可用功能；模型和脚本不能越过服务端 RBAC。只读账号可查和生成允许范围内的方案，执行写操作仍会被后端拒绝。日志、设备名称、用户描述和模型输出都按数据处理，不能改变动作权限。
|
||
|
||
方案必须保存确定的对象标识和版本。“所有设备”也先展开成可核对的清单，不在执行时重新解释为另一批对象。资源、授权或方案发生变化时重新预检。脚本版本在方案内固定，执行前变更不能悄悄套用。
|
||
|
||
每步拥有稳定操作标识并关联现有 task/command；HTTP 提交成功只代表已提交。对于尚无原生幂等支持的接口，编排层需保存调用状态并提供结果核对。结果未知的步骤先核对，不重发；部分成功时保留成功结果、停止依赖步骤并给出具体处理建议。跨系统工作流不承诺全局事务回滚，补偿动作单独展示和执行。
|
||
|
||
## 按项实施与验收
|
||
|
||
1. 通用工作台与导航：接真实数据、业务名称、常用操作，保留高级界面；测试权限、空态、失败、深浅主题和窄屏。
|
||
2. 业务向导与方案对象：先完成“已有桌面授权”“批量开机预检”“终端无桌面诊断”。测试预检无业务副作用、对象唯一性、重复点击和逐步结果。
|
||
3. 接语言模型：使用真实模型服务，验证输出动作参数，展示可执行方案；测试缺信息、同名对象、服务失败、越权请求及日志中的恶意指令。模型供应方式、外发数据范围、密钥和费用上限由部署配置决定。
|
||
4. 扩展脚本模板与流程：选择一个现场可验证的流程接入，测试模板版本、超时、离线、部分成功和结果核对，再开放下一项。
|
||
5. 商业版本授权：功能分包、服务端校验、到期与升级流程，单独验收。账号安全与审计保留为两版基础能力。
|
||
|
||
按用户要求，每项完成并通过对应测试后再进入下一项。原先暂缓的专用 VM、Windows 副本、存储准备和真实还原验收继续暂缓，不因本设计自动恢复。
|