USER GUIDE

使用说明

普通用户只需要选择场景、情境、Runtime 和模型，再描述问题。仓库、文档、日志和数据库等资源由管理员提前接入，任务执行时由 Agent 按场景授权选择所需能力。

场景决定做什么定义输入、可用能力、处理边界和结果形式。
情境决定在哪处理保存项目、环境和能力任务参数等当前上下文。
Runtime 决定如何执行在授权范围内驱动模型规划步骤并调用 Skill/MCP。
01

登录并进入首页

管理员完成首次初始化后，成员使用分配的账号登录。首页是任务入口，不需要在本机安装 Agent 客户端或准备代码仓库。

登录与进入平台
登录后直接进入任务首页。
任务首页
输入区下方展示当前情境、场景、Runtime 和模型。
02

选择上下文并发起任务

STEP 1选择与问题匹配的场景，例如业务问答、故障分析或文档分析。
STEP 2选择情境，确定本次任务的项目、环境和资源范围。
STEP 3选择 Runtime 和模型；保持管理员推荐项即可开始。
STEP 4描述目标、现象和已知线索，按需上传附件后提交。
情境与场景
同一个场景可以在不同环境、项目范围和开放权限下复用。
Runtime 与模型
两套 Runtime 使用同一套场景和能力定义。
描述问题时：优先写清对象、环境、时间范围、异常现象和希望得到的结果。不要填写仓库内部路径、数据库密码或其他本应由能力配置管理的凭据。
03

查看执行过程

任务开始后，页面持续展示模型判断、工具调用、证据读取和阶段性结论。Agent 会根据每次返回结果更新已确认信息与证据缺口，不同问题不要求走固定工具顺序。

真实代码分析过程
从项目资料取得仓库配置，准备隔离 worktree，再继续读取代码证据。
  • 需要时可以展开工具步骤，核对命令结果和证据来源。
  • 运行中的任务可以取消；支持恢复的任务可从历史记录继续。
  • 执行过程中出现结构化选择或表单时，完成交互后任务会继续运行。
  • 网络、权限或资源配置失败会影响结论范围，不等同于“没有数据”或“没有问题”。
04

阅读结果并继续追问

不同场景可以定义不同交付形式。业务问答强调业务口径和证据边界；文档分析强调原文、版本与相关资料；故障分析则会组织定位状态、时间线和处理方向。

业务问答
结论、适用范围、数据内容和业务链路分区展示。
文档分析
回答之外保留本次参考资料，便于返回原文继续核对。

结果生成后可以在同一会话继续追问。追问会继承本次任务上下文；切换到完全不同的问题时，建议新建任务，避免旧上下文干扰。根据权限还可以分享或导出结果。

05

管理员：维护场景、情境与能力

场景管理安装或更新场景，设置启停、用户可见性、排序，并选择场景能够使用的 Skill 和 command。
分析情境为指定场景保存项目、环境和能力任务参数；情境不保存仓库、数据库等外部业务数据本身。
能力管理安装或更新标准 Agent Skill，维护服务接入配置和 MCP。能力保持通用，不绑定某个场景。
场景管理
场景声明任务入口，并组合当前任务允许使用的能力。
Skill 与 MCP
外部系统通过独立能力接入，可以被多个场景复用。
06

管理员：配置 Runtime 与模型

部署完成后，管理员需要先提供至少一个可用模型。Codex Runtime 适合连续工具调用和代码分析；Lingxi Runtime 不依赖本地 CLI，适合先验证平台和场景流程。

  1. 在“管理端 → 模型管理”添加供应商，填写服务地址和 API Key，点击“检测连接并获取模型”后保存。
  2. 选中供应商并点击“添加模型”，填写模型标识、协议和上下文窗口，启用后保存。
  3. 使用 Codex Runtime 时，进入“管理端 → 系统设置 → Codex CLI 维护”，点击“安装 Codex CLI”并等待状态变为“已安装”；Lingxi Runtime 可跳过这一步。
  4. 返回任务首页，在“选择运行方式”中为当前任务选择 Runtime 和兼容模型。
连通性：供应商检测和实际模型请求都由 Lingxi 服务发起，不能用浏览器是否能访问服务地址代替检测。
任务侧选择
普通用户从管理员开放的 Runtime 和模型中选择。
平台模型管理
集中维护供应商、API 协议、模型上下文和价格。
07

管理员：分析执行质量与用量

每次执行都保留单独报告，可以把模型耗时、工具耗时、Token 与异常放回同一条时间线分析。仪表盘用于观察整体趋势，不替代具体任务证据。

模型调用
查看输入 Token 组成、首个响应、生成耗时和异常。
执行时间线
模型调用与工具执行按开始时间排列，便于定位慢点。
用量仪表盘
汇总请求量、成功率、Token、缓存命中与费用趋势。
系统设置
维护并发、全局边界、Token 配额和 Codex CLI。
08

常见问题

首页没有场景Lingxi 默认不导入演示场景。启动 Demo 后从“接入 Lingxi”选择并安装，或在场景管理上传自己的场景包。
任务无法开始先确认模型供应商连接、模型状态和 Runtime 是否可用，再查看任务失败提示。
仓库无法连接连接发生在 Lingxi Runtime 所在服务器。私有仓库 SSH 配置见体验部署。
Demo 页面能访问但任务读不到检查 DEMO_PUBLIC_BASE_URL 是否能从浏览器和 Lingxi Runtime 两端访问。
情境中没有某项能力参数确认当前场景已经挂载对应 Skill；情境只显示场景参数和已挂载能力的任务参数。
执行结果缺少某类证据展开执行过程确认是无需调用、资源未配置、权限不足还是连接失败，不要把失败当作零结果。
截图