XMOS 使用文档

从安装与本地 Runtime 准备开始,了解如何发起任务、进入工作现场、确认关键操作,并保留可检查的工作成果。

快速开始

XMOS 桌面端把产品外壳、本地运行环境和任务工作现场放在同一处。第一次使用建议从一个范围清晰、结果可检查的小任务开始,例如整理工作区文件、生成摘要或核对一组记录。

  1. 下载安装包

    前往下载中心,选择与你的设备架构和部署方式匹配的版本。正式环境请使用组织管理员提供的安装来源。

  2. 完成本地安装

    按安装向导完成部署并启动 XMOS。首次进入时,先确认系统能够访问已授权的工作目录。

  3. 准备 Runtime

    进入 Runtime 管理页导入组织提供的离线包,等待校验、启动和健康检查完成。

  4. 发起第一项任务

    在对话中写清目标、输入范围、限制条件和期望交付物;涉及外部提交或覆盖操作时,保留人工确认。

  5. 检查并归档成果

    打开生成的文件或结果摘要,确认任务状态、关键操作记录和异常信息,再决定是否继续下一步。

运行环境

Runtime 提供会话、工具、审批和任务执行的运行基础。桌面端负责启动、停止、版本检查与本地状态呈现;组织策略决定可使用的 Runtime 包、模型服务和工作目录范围。

导入与启动

  • 只导入来自组织管理员或正式发布渠道的 Runtime 包。
  • 导入后等待完整性校验结束,不要直接修改运行目录中的文件。
  • 状态显示为“运行正常”后再发起任务;“正在启动”或“健康检查中”表示尚未就绪。

更新与恢复

升级前保存正在编辑的内容并结束关键任务。更新通常经过检查、下载、重启三个阶段;若失败,请保留当前版本、错误提示和诊断信息,不要直接删除本地安装目录。

  • 未安装:尚未导入可用 Runtime,需要先完成部署。
  • 正在启动:运行环境已加载,但健康检查尚未完成。
  • 运行正常:服务已就绪,可以创建会话并调用已授权工具。
  • 异常或降级:部分能力不可用,应先查看诊断信息并按组织流程处理。

工作台与对话

对话是任务入口,工作台用于查看正在执行的任务、状态变化和结果。数字员工会根据岗位包中的流程与工具推进工作,但目标、数据范围和关键决策仍需要由使用者明确。

怎样写清一项任务

一条可执行的任务描述至少包含四部分:要完成什么、允许处理哪些输入、有哪些限制、最终需要交付什么。避免只写“处理一下”或“帮我看看”这类无法判断完成标准的指令。

目标:整理本周安全设备巡检记录 输入:工作区 /inspection/week-35/ 限制:不修改原始记录,不向外部系统提交 交付:异常清单、处理建议和引用来源

任务进行中

  • 查看当前阶段、已完成步骤和下一项动作。
  • 当界面要求确认时,核对目标、范围、影响和可恢复性后再继续。
  • 任务长时间没有变化时,先区分 Runtime 状态异常与单次任务失败。
  • 需要调整目标时,应补充明确的新约束,不要让旧任务在不确定范围内继续。

工作现场与文件

工作现场把任务需要的文件预览、网页操作和过程信息放在对话旁边。它只应接触完成任务所必需、且已经授权的工作范围。

文件工作现场

  • 从已授权工作目录选择输入文件,先确认名称、版本和内容范围。
  • 生成文件应写入任务约定的输出目录,避免覆盖原始材料。
  • Office 或其他预览用于快速核对;正式交付前仍应打开原文件检查格式与内容。

网页工作现场

网页工作现场用于需要浏览器或 RPA 的业务步骤。登录、提交、删除、覆盖和外部发送等动作应保留人工确认,并以界面展示的目标系统、对象和影响范围为准。

不要在任务描述、对话或工作文件中粘贴密码、验证码、密钥等敏感凭据。需要认证时,请使用组织批准的凭据管理方式。

数字员工与岗位包

数字员工不是一段临时提示词,而是一套可安装、可更新的岗位能力。岗位包通常包含身份说明、工作流程、工具、参考文档、输出目录约定和版本信息。

  • 身份与职责:定义员工负责的岗位、可接受的任务和不应越过的边界。
  • Skills:描述标准流程、判断规则和关键人工确认点。
  • Tools:提供确定性脚本、浏览器操作或企业系统连接能力。
  • Workspace:保存任务输入、过程文件、成果和可复核证据。

导入和更新

导入岗位包前核对来源、版本与适用范围。更新后先用低风险任务验证关键流程;如新版与组织策略或 Runtime 不兼容,应按管理员给出的回退路径恢复,而不是混用不同版本文件。

权限、确认与安全边界

权限应以完成当前岗位任务所需的最小范围授予。XMOS 会展示关键操作的目标与影响,使用者需要在确认前判断这一步是否符合任务目标和组织策略。

需要重点检查的操作

  • 向外部系统提交、发送或发布内容。
  • 删除、覆盖、移动原始文件或修改业务记录。
  • 执行高风险命令,或扩大文件、网络和系统访问范围。
  • 使用包含个人信息、凭据或敏感业务数据的材料。

桌面端通过受限接口与本地主进程和 Runtime 交互;网页工作现场不会自动获得任意桌面权限。若界面展示的目标、范围或后果不清楚,应停止并补充信息,而不是默认继续。

成果、记录与诊断

任务结束后,先检查成果本身,再阅读过程记录。一个可交付结果应包含清晰的结果说明、可打开的文件或链接(如有)以及必要的来源和限制。

成果检查

  • 确认文件能够打开,名称、位置和版本符合约定。
  • 核对摘要、引用来源和关键数字,避免把未验证内容直接用于业务决策。
  • 检查任务是否仍有失败、待确认或未完成步骤。
  • 涉及外部提交时,由业务人员完成最终内容复核。

出现问题时

  1. 记录客户端版本、Runtime 状态、复现步骤和错误提示。

  2. 使用界面提供的重试、返回或查看日志操作,不要先修改本地运行目录。

  3. 向技术支持提供脱敏后的诊断信息,并说明是否涉及文件预览、网页工作现场或审批步骤。

常见问题

为什么启动后不能立即进入对话?

通常是 Runtime 尚未导入、正在启动,或健康检查没有通过。请进入 Runtime 管理页确认状态并查看诊断信息。

为什么某些功能显示暂不可用?

客户端会根据当前 Runtime、企业策略与版本范围显示可用能力。灰态入口不代表任务会在后台继续执行,请以页面说明和版本更新日志为准。

任务能访问电脑上的所有文件吗?

不应如此。请只为任务提供必要且已授权的工作目录;涉及敏感数据时,应先缩小范围并在关键操作前确认。

如何确认一项任务真的完成了?

检查最终文件或结果摘要、过程记录,以及是否仍存在失败或待确认状态。需要用于业务决策或外部提交的成果还应由业务人员复核。