Coding Agent
操作手册
从第一个 APP 到数据大屏、业务流程图、3D 数字孪生与技能。
跟随界面标注，找到入口、完成配置，再预览与交付。
先选择正确的构建类型
首页的入口决定后续向导和工作台。先按交付目标选择，再填写需求。
先选择“轻应用”或“工业 APP”等类别，再选择具体类型，点击“立即构建”。图中展示有效 VIP 公司空间的入口。
业务管理与完整应用
适合设备台账、点检、工单等业务页面。通过四步向导配置资源、风格和需求。
指标、图表与监控大屏
先选数据和主题，再确认需求与布局线稿，进入正式构建。
2D 组态与工艺画面
使用参考工艺图、SVG 或 2D 组件，构建设备、管网及数据联动。
三维场景与设备可视化
提供现场照片、GLB 或组件，确认场景需求和数据后进行构建。
需要 Python / Node-RED 后端时，选择“工业 APP → 专家模式”；创建可复用的工作方法时，选择首页“技能”。
开始前准备
- 可登录的账号，以及当前使用的个人／公司空间。
- 明确要完成的任务、使用者、输入数据和验收结果。
- 需要接真实数据时，准备有权限使用的环境与数据资源。
- 选择当前可用的模型，并确认可用积分；模型清单可能随配置变化。
登录并找到你的工作入口
登录后可创建和管理自己的构建。资源、项目与市场各有独立入口。
① 点击左下角“未登录”，按页面提示登录或注册。② “使用帮助”直接打开图文操作手册。登录成功后左下角显示当前用户及空间。
-
进入平台并登录
打开 agent.supos.com，点击“登录”，或点击“立即构建”进入登录流程。嵌入使用时可能出现“登录蓝卓云”弹窗。
登录成功后回到平台；嵌入登录成功后页面会刷新。
-
确认当前空间
打开用户菜单，查看当前为“个人空间”还是某个公司空间。需要切换时，选择对应空间。
后续列表和积分操作以当前空间及权限为准。
-
进入“我的”管理资产
在左侧导航点击“我的”，使用应用／构建列表、我的项目、资源管理、我的模板、我的技能及我的组件等入口。返回首页可点击“构建”。
打开已有应用的“构建”操作可回到对应工作台。
只查看构建中的应用
进入「我的 → 我的构建」，或从「我的项目」进入关联应用列表，点击搜索框旁的「构建中」。按钮高亮时只显示正在构建的应用，再次点击恢复全部状态。个人和公司空间均可使用，可与名称、类型及公司空间的创建人条件一起筛选。
筛选后的总数和分页只统计匹配应用，切换条件会返回第一页。此条件按应用是否正在生成或修改判断；仅打开预览运行的应用不一定正在构建。切换空间会清空「构建中」条件。
在公司空间按创建人查找资产
公司超管和普通成员均可使用创建人筛选，无需成员积分管理权限。先切换到公司空间，再进入“我的”。在“我的构建、我的项目、我的模板、我的技能、我的组件”中，名称搜索旁是创建人下拉框。输入姓名、昵称或用户 ID 搜索并选择成员；下拉选项及选中后显示“昵称（名称）”，没有名称时只显示昵称，没有昵称时只显示名称，两者均缺失时显示用户 ID。列表按选中成员筛选，可与名称、类型及「构建中」条件同时使用。
卡片用人员图标和名称显示创建人，悬停可查看完整创建人信息；切换到列表模式可查看“创建人”列。昵称缺失时显示用户 ID；长名称可悬停查看。打开下拉框先显示成员列表，滚动到底部会继续加载下一页；输入文字会按成员姓名、昵称或用户 ID 搜索。选择或清空后列表从第一页显示。成员选项涵盖当前、已退出和已移除成员。切换空间会清空创建人条件；个人空间不显示创建人筛选和信息。
名称搜索右侧从可搜索下拉列表选择创建人，选中后显示“昵称（名称）”，没有名称时只显示昵称；再点击「构建中」可组合筛选。滚动下拉列表可加载下一页。按钮高亮表示条件已启用；卡片底部用人员图标和名称显示创建人，右上角可切换卡片与列表。
创建工业 APP
推荐首次使用从“工业 APP → 普通模式”开始。以下步骤适用于当前普通模式创建向导。
-
选择“工业 APP → 普通模式 → 立即构建”
可先在首页写下业务需求并选择模型，再进入创建向导。
打开四步“创建应用”向导。
图 03先填写名称，再确认集成配置界面示例 · 示例数据 ① 填写应用名称。② 按需要开启或关闭 supOS 集成，开启时选择对应版本。③ 点击“下一步”。
-
填写基础信息
填写应用名称，确认描述、行业、应用类型和模型。名称不能为空，最多 200 字符；描述最多 500 字符。需要对接平台时，确认“集成 supOS”及 X／V6／V4 版本；该开关默认开启。
点击“下一步”后检查应用名称是否重复。
图 04选择应用可以使用的资源和 Skill界面示例 · 示例数据 ① 关联业务资源。② 按需关联 Skill。③ 点击“下一步”。资源列表为空时，可先到“我的 → 资源管理”创建。
-
配置能力
按需选择“关联资源”“我的 Figma 连接”和“关联 Skill”。开启 supOS 集成时，环境需与应用版本一致；未指定环境时使用平台按版本配置的默认环境。
所选资源与技能参与本次构建。
图 05选择一种 UI 风格来源界面示例 · 示例数据 在预设风格、DESIGN.md 或 Sketch 设计稿中选择一条路线，完成后点击“下一步”。
-
选择 UI 风格
在“预设风格”“DESIGN.md”“Sketch 设计稿”中选择一条路线，再选择组件库并补充风格描述。组件库默认 shadcn/ui，也可选 Ant Design、Carbon Design、MUI。
上传路线需要先选择对应文件才能继续。
图 06把业务目标写成具体操作界面示例 · 示例数据 ① 描述用户、页面、数据和操作。② 检查需求与附件后，点击“开始构建”。
-
填写需求并开始构建
提供非空“需求描述”、需求附件或 Sketch 设计稿，点击“开始构建”。仅提供 DESIGN.md 不满足启动条件。
创建完成并进入工作台，上传成功的需求材料随本次请求提供给 Agent。
请创建一个设备点检管理应用。 用户：设备管理员和点检人员。 页面：设备台账、点检任务、异常记录。 操作：新增设备、按区域筛选、提交点检结果、查看异常。 字段：设备编号、名称、区域、点检时间、结果、处理状态。 验收：创建任务后能在列表查到；提交异常后能按设备追溯。 第一版未接入真实系统，请先与我确认数据来源。
| 材料 | 当前限制／用法 |
|---|---|
| 需求附件 | 最多 10 个，每个 ≤10 MiB；支持 .md/.txt/.pdf/.docx/.xlsx/.csv/.json/.yaml/.yml/.png/.jpg/.jpeg。 |
| DESIGN.md | 仅 1 个，文件名必须为 DESIGN.md；用于视觉规范，不能单独替代业务需求。 |
| Sketch 设计稿 | 仅 1 个 .sketch 文件，≤50 MiB。 |
| 业务标签 | 最多 10 个，每个最多 30 字符。 |
专家模式：使用另一套创建流程
-
选择“工业 APP → 专家模式 → 立即构建”
在弹窗填写应用名称、描述和模型。名称最多 30 字符，描述最多 500 字符。
显示独立创建表单，不经过上述四步向导。
-
配置后端并创建
选择 Python 或 Node-RED 后端，按需填写系统提示词，点击“创建并打开”。
打开对应构建会话。
在工作台预览与持续修改
工作台以对话和工具区协同工作。不同构建类型显示的工具不同，不必寻找所有页签。
需要停止生成时，点击停止并等待取消完成，再发送“继续”或新的修改要求。取消前的记录保留在原轮次；后续对话单独展示，不应混入已取消任务的迟到输出。取消不会自动撤销已经完成的文件修改，继续前可先检查预览或版本记录。
普通模式构建页暂不显示“工程图纸”标签。需要使用工程图纸时，可在创建应用时上传并在需求中说明用途；已有图纸和解析数据继续保留。继续修改时，在对话中说明需要调整的业务功能，再切换“预览”核对结果。只有二维资料时，三维展示为依据图纸证据建立的参考模型，缺少尺寸的项目仍需人工确认。
图纸解析没有文字或尺寸候选时，原图仍可能包含可读信息；在对话中明确要求结合原图核对，并查看待确认事项。参考模型不能替代精确 CAD。生成报价应用后，示例价格、未确认的 BOM 或单件质量只能用于草稿；正式出具前需维护真实价格并完成确认，币种和计价单位必须一致。
生成应用中的 PDF 图纸应在应用内预览，支持分页、缩放、适合宽度和失败重试。若历史应用显示“此页面已被 Chrome 屏蔽”，可在对话中要求改用应用内 PDF 渲染组件后重新生成预览；不需要关闭浏览器安全设置。已有应用和已安装版本不会因平台升级自动改写。
需求包含 AI 建议或分析时，生成应用应同时提供业务按钮和模型配置入口。首次使用可从业务页进入 AI 设置，保存应用自己的服务地址、模型和凭据后再验证调用；未配置、连接失败与候选结果校验失败应明确提示，并保留人工操作。绑定技能表示可用，不代表模型已经配置，也不代表每个绑定技能都会安装。
左侧输入需求或修改意见；右侧点击「＋」打开新标签页，再选择预览、代码、文档或其他工具。普通模式暂不显示「工程图纸」；构建对话完成后，文档列表会自动刷新。
-
先看对话中的待确认事项
查看 Agent 的问题、需求文档或当前进度。出现确认卡片时按提示操作；“等待确认”不等于卡死。
当前回合获得所需输入后继续。
-
打开需要的工具
从工具启动入口选择“预览”“代码”“文档”“资源”“设计稿”“数据模型”等；API／Flow 等入口取决于当前模式与后端。已打开工具不会重复创建。
在同一工作区切换所需信息。
-
在预览中检查任务结果
检查页面、按钮、数据和状态变化。涉及 supOS 时核对预览环境；“集成 supOS 预览”是运行验证入口。源码本地预览由平台为所选 supOS 环境和已授权的数据库绑定建立访问通道，无需放开容器网络隔离；数据库账号及连接配置仍须有效。源码应用的 supOS X 集成预览使用平台已有 LakeRDS；修改资源绑定或数据库连接源码后，需重新生成安装包再预览。
源码应用预览失败时，点击“查看错误详情”，查看退出码、内存终止标志、资源上限和应用关键日志。线程创建失败时，应结合应用线程池配置和运行配额排查；应用仍在运行但入口不可用时，按转发异常处理。日志不可用时会说明原因，修复后再重试预览。
看到的页面行为与需求相符；未接入数据时不将演示值当作真实数据。
-
描述具体修改并复验
指出具体页面、对象、当前表现和期望结果；通过对话补充附件或文档上下文。重要修改前先创建快照。
完成修改后重新执行受影响的操作，不仅查看生成完成提示。
| 工具 | 用户可以做什么 |
|---|---|
| 预览 | 查看运行效果，核对当前环境及数据状态。 |
| 代码／文档 | 浏览生成源码和需求资料，辅助定位需要调整的页面。 |
| 资源／数据模型 | 查看关联资源；轻应用通过“维护选数”选择可用对象和字段。 |
| API／Flow | 依当前后端查看接口或流程能力；不保证所有模式同时提供。 |
| 数据库 | 在提供该工具的应用中配置并测试数据库连接。 |
请修改设备列表页： 1. 筛选区增加“设备状态”，保留现有区域筛选。 2. 点击“查看”打开设备详情，不进入编辑状态。 3. 其他页面和既有数据字段保持不变。 完成后请检查：组合筛选、空结果提示，以及返回列表后的筛选状态。
构建大屏看板
大屏先确定数据与需求，再确认布局。线稿确认前，正式大屏尚未完成。
-
进入“轻应用 → 大屏看板 → 立即构建”
填写应用名称（最多 50 字符）、模型和集成配置。
进入大屏专用四步向导。
图 08创建大屏应用界面示例 · 示例数据 ① 填写名称。② 确认是否集成 supOS。③ 点击“下一步”。
-
选择数据来源
在“资源配置”选择“在线环境”或“我的 UNS”，勾选需要的对象和字段。关闭 supOS 集成后只能使用“我的 UNS”。也可以暂不选数，进入工作台后维护。
勾选的内容成为应用可查询的数据范围。
图 09先确定数据从哪里来界面示例 · 示例数据 ① 在线环境用于连接 supOS 数据。② “我的 UNS”用于选择已上传的 UNS。③ 完成后进入下一步；也可稍后维护选数。
-
选择主题并填写需求
可选预设主题或 Sketch 设计稿。主题中可使用“让 AI 帮我配色”，确认后点“使用这组配色”。补充指标、图表、布局、显示比例及需求文档。
点击“开始构建”进入工作台；有选数和需求材料时自动发起构建。
图 10选择主题与显示比例界面示例 · 示例数据 先选择预设主题或 Sketch，再确认显示比例。点击“下一步”进入需求填写。
图 11说明指标、图表与布局界面示例 · 示例数据 ① 写明业务目标及布局，按需上传需求文档和参考附件。② 点击“开始构建”。
-
核对整理后的需求
看到“已整理需求文档，确认后继续”，点击“查看需求文档”。认可后点“按此继续”；要调整点“改几处”并“提交”；需要沿用原始需求则点“保留原文”。
按确认结果继续准备数据和布局。
图 12读过需求，再决定是否继续操作区域示例 · 示例数据 ① 打开“查看需求文档”。② 需要调整时点“改几处”。③ 认可需求后点“按此继续”。
图 13有修改意见时，具体说明要改哪里操作区域示例 · 示例数据 ① 输入要改的区域、指标或图表。② 点击“提交”，再检查更新后的需求。
-
确认布局线稿
点击线稿进入全屏，调整区域位置和大小、模块顺序及宽窄。文字修改用“AI 改线稿”；需要还原拖拽时用“撤销布局调整”。满意后点击“确认布局，开始构建”。
布局被确认后进入正式构建。
-
检查预览和数据
没有真实数据源时，可用预览中的“演示数据”检查图表效果。接入真实环境后核对数值和刷新行为，再导出。
演示数据仅用于预览，不进入导出或安装。
大屏交付前检查
- 指标名称、单位、时间范围与数据来源一致。
- 确认目标屏幕比例与布局，检查文字截断和图表空态。
- 关闭演示数据后核对真实数据；无来源时保留无数据状态。
- 更换选数后如提示重新生成线稿，先确认已有布局可能受到影响。
构建业务流程图与 2D 组态
首页入口名为“业务流程图”。适合工艺管网、设备状态与二维监控画面。
开始前：切换到具备有效 VIP 权益的公司空间。
-
完成“基本信息 → 资源配置 → 需求与材料”
首页选择“轻应用 → 业务流程图 → 立即构建”。名称最多 50 字符，描述最多 500 字符；选好模型、supOS 配置和所需数据资源。
进入 2D 专用创建流程。
-
提交业务需求与参考材料
描述设备范围、连接关系、需要显示的数据及状态。需求描述最多 20,000 字符；需求描述或需求文档至少提供一项。可上传参考截图／工艺图、SVG／PNG 或选择 2D 组件，最后点“开始构建”。
创建应用，Agent 整理需求供确认。
图 14提交 2D 需求与参考材料界面示例 · 示例数据 ① 填写需求描述。② 可补充需求文档。再按需上传参考图。
图 15向下滚动，准备 2D 材料界面示例 · 示例数据 ① 上传 SVG／PNG 或 ZIP 组件包。② 也可以点击“选择组件”。③ 检查需求后“开始构建”。
-
确认需求并完成选数
先查看需求文档，点“按此继续”。已有有效选数时继续生成；尚未选数时打开“数据模型 → 维护选数”。开启 supOS 集成后可选“在线环境”或“我的 UNS”；关闭后只能用“我的 UNS”。首次提交按钮为“保存并生成业务流程图”。
保存选数后继续生成，无需重复发送启动请求。
-
缺少数据时使用 AI 示例
点击“AI 生成”，完成后打开“预览”，在“示例 UNS 预览”中确认对象和字段，点击“保存并使用”。
示例成为已确认的选数；仅生成示例尚不算完成。
-
检查画面并维护资源
在预览中检查设备、连线、详情和状态动画。在资源区可“导入 2D 组件”、上传材料、对资源执行“AI 修改”或导出。
逐设备核对显示与交互，不以画面有动画代替数据正确性。
| 2D 创建材料 | 精确限额 |
|---|---|
| 参考截图／工艺图 | PNG／JPEG／WebP；最多 4 张，每张 ≤5 MiB。 |
| 本地材料 | SVG／PNG 单文件 ≤10 MiB；含 Manifest 的 ZIP 组件包 ≤32 MiB。 |
| 材料总数 | 本地材料与所选组件合计最多 8 项，仅指该创建入口。 |
| 需求文档 | 最多 1 份、≤10 MiB；支持普通需求附件格式，并额外支持 .html/.htm。 |
构建 3D 数字孪生
以下面向首页当前“3D 数字孪生”入口。明确场景、设备、交互和数据，再准备照片或模型。
开始前：切换到具备有效 VIP 权益的公司空间。
-
完成“基本信息 → 资源配置 → 现场与材料”
首页选择“轻应用 → 3D 数字孪生 → 立即构建”。填写名称、模型和集成配置，按需关联 Skill。开启 supOS 集成后可选“在线环境”或“我的 UNS”；关闭后只能用“我的 UNS”。
进入三维创建流程，按表单补齐需求与素材。
-
描述现场并准备素材
说明需要还原的设备与布局、观看角度、点击交互和数据联动。需求最多 20,000 字符；需求描述或需求文档至少提供一项。上传现场照片、GLB 或从组件中选择素材。
点击“开始构建”，进入工作台。
图 16提交 3D 需求与需求文档界面示例 · 示例数据 ① 说明场景、设备、布局和交互。② 可补充需求文档。
图 17向下滚动，补充现场照片与 GLB界面示例 · 示例数据 ① 上传已有 GLB 模型。② 也可以点击“选择组件”。③ 检查需求后“开始构建”。模型可以稍后在工作台添加。
-
确认需求与数据
查看整理后的需求文档，选择“按此继续”或“改几处”。未完成选数时使用“数据模型 → 维护选数”；首次提交使用“保存并生成场景”。没有真实数据时，可按 2D 章节的 AI 示例流程生成、预览并“保存并使用”。
选数保存成功后继续场景构建。
-
逐项检查三维场景
在预览中检查主体形状、设备位置、模型显示、设备选择与数据联动。需要修改时明确指出对象和目标，例如“只调整泵组颜色，保留布局与数据绑定”。
实际预览符合需求后，再保存版本和导出。
| 3D 创建材料 | 精确限额 |
|---|---|
| 现场照片 | PNG／JPEG／WebP；最多 4 张，每张 ≤2 MiB。与 2D 的 5 MiB 不同。 |
| 本地模型 | GLB 单文件 ≤100 MiB；本地模型与所选组件合计最多 8 项。 |
| 需求文档 | 最多 1 份、≤10 MiB；仅照片或模型不能替代需求描述／需求文档。 |
| 工作台资产 ZIP | 压缩包 ≤100 MiB、最多 100 个文件；单个 GLB 与解压后 GLB 总量均 ≤100 MiB。非 GLB 或无效路径会跳过。 |
连接环境、UNS 与业务资源
入口：“我的 → 资源管理”。先创建可用资源，再在应用创建或工作台中关联。
① 点击“资源管理”。② 添加 supOS 环境。③ 有 UNS 文件时选择“接入 UNS”。
| 资源类型 | 创建入口与要求 |
|---|---|
| supOS 环境 | 点击“添加 supOS 环境”，填写名称和服务地址，测试连接后按检测结果补全配置。 |
| UNS | 点击“接入 UNS”，上传 1 个 .json 文件。UNS 定义描述数据对象；文件本身不等于实时数据连接。 |
| 第三方接口 | 点击“添加第三方接口”，必填服务商；可附最多 5 个 .json/.yaml/.yml/.md/.txt/.pdf 文件。 |
| Figma 连接 | 点击“添加 Figma 连接”，按表单配置；创建 APP 时从“我的 Figma 连接”关联。 |
添加 supOS 环境
-
测试服务地址
填写资源名称和服务地址，点击“测试连接”。地址需要能被平台服务器访问，不能只在你的本机浏览器中可达。
检测可达性和版本；修改地址后需要重新测试。
图 19填写平台能够访问的环境地址界面示例 · 示例数据 填写名称与服务地址，再使用“测试连接”。按检测结果补齐该版本要求的连接信息，最后创建资源。
-
补齐对应版本的配置
检测为 V4／V6 时，填写页面要求的服务器 IP、端口、账号、密码、秘钥 ID 和秘钥 Key；可使用“测试 SSH 连接”。
V4／V6 配置齐全后才可保存；SSH 测试是独立操作。
-
创建并关联
点击“创建”；编辑已有资源则点击“保存”。在 APP 的资源选择器中选择与应用版本匹配的环境。
应用关联到选中的环境。
配置应用数据库
数据库配置位于提供该工具的应用工作台中：打开“数据库 → 配置数据库”，填写主机、端口、Schema、数据库、用户名和密码，选择 SSL 模式，使用“测试连接”和“保存配置”。端口范围为 1–65535；修改配置时需重新输入密码。测试与保存为独立操作。
填写便于识别的名称，上传一份 JSON 文件并创建。之后在应用的选数页面选择“我的 UNS”。
用项目组织多个 APP
项目用于组织应用，并配置共用资源与共用 Skill。关联条件取决于应用的集成与后端设置。
-
创建项目
进入“我的 → 我的项目 → 新建项目”，填写项目名称和行业，点击“下一步”。选择资源和技能，点击“创建”。
项目出现于列表，名称会检查是否重复。
图 21先定义项目，再配置共用能力界面示例 · 示例数据 ① 输入项目名称，并填写行业等信息。② 点击“下一步”。
图 22为项目选择资源与 Skill界面示例 · 示例数据 勾选后续应用需要共用的资源与 Skill，完成后创建项目。也可以创建后再维护。
-
在项目中创建或打开应用
点击项目卡片查看关联应用；点击“构建”进入项目工作台。空项目先点击“新建应用”。项目内创建会带上当前项目。
可在项目上下文中进入相关应用。
-
维护共用配置
在项目工作台打开“共用资源”或“共用 Skill”，调整勾选。
勾选变化立即保存，没有独立保存按钮；Figma 个人连接不属于共用资源。
按创建人查找公司项目
在公司空间打开“我的项目”，在名称搜索旁的创建人下拉框中搜索并选择成员，可与名称搜索同时使用。滚动下拉框到底部会加载下一页。卡片中的人员图标显示创建人；悬停可查看完整名称，列表模式提供独立的“创建人”列。清空选择可恢复全部项目。
在名称搜索右侧的创建人下拉框中选择成员，滚动到底部可加载下一页。卡片底部人员图标对应创建人，点击项目查看关联应用。
使用模板、技能与组件市场
模板用于创建新应用；Skill 提供可复用工作方法；组件提供 2D/3D 资产。三者的使用入口不同。
模板市场：预览并创建应用
-
在模板市场查看与预览
进入“模板市场”，按需搜索和筛选。卡片“使用”、菜单“使用此模板”、详情“使用模板”均可进入创建流程。
先预览模板是否满足业务场景。
-
创建模板应用
在“使用此模板创建应用”中修改名称，符合条件时选择关联项目，点击“创建应用”。名称最多 200 字符，不能为空。
创建新应用并导入模板历史聊天记录；不再经过普通 APP 四步向导。
-
继续修改并保存为模板
进入新应用工作台后按业务需要迭代。提供“保存为模板”的工作台可将当前成果保存，之后在“我的模板”管理。
如果浏览器拦截新窗口，可从“我的”应用列表再次进入。
① 确认进入“模板市场”。② 输入关键字，结合行业、场景与类型筛选。先点击“预览”，再点击目标模板的“使用”。
技能市场：查看并复用 Skill
从左侧“技能市场”进入，按分类或名称筛选，点击技能卡片查看详情。需要本地使用时下载；需要用于应用构建时，在创建向导或工作台配置中关联该 Skill。
① 进入技能市场。② 搜索技能名称或描述；点击卡片查看详细内容，使用卡片右下角的下载入口获取技能包。
组件市场：查找 2D／3D 素材
进入“组件市场”，选择 2D 或 3D，再按行业、名称筛选。先在“详情”确认素材用途，再下载对应 ZIP 或 GLB；创建场景时通过“选择组件”导入。
① 确认进入组件市场。② 搜索组件，结合行业和类型筛选。目标卡片提供“详情”和“下载”，图中为 2D 组件示例。
模型市场：登录后浏览模型
从左侧“模型市场”进入。未登录时点击“登录后查看”，完成登录后返回；按模型市场页面的指引浏览模型、查看定价并开通。开通和调用条件以该页面显示为准。
① 页面标题用于确认已进入模型市场。② 未登录时点击“登录后查看”。登录后的模型内容在该页面中加载。
我的模板：维护与提交上架
在“我的 → 我的模板”中查找当前空间的模板，查看详情、预览或再次创建应用。需要公开复用时使用“上架模板库”提交审核，随后查看审核记录；按当前发布和审核状态处理删除等操作。
公司空间可在名称搜索旁按创建人昵称或用户 ID 筛选，并在卡片或列表中查看创建人。条件可与其他筛选叠加，清空后恢复全部结果；个人空间不显示创建人筛选和信息。
选择“我的模板”，按名称、创建人和模板类型查找。公司空间的创建人从下拉列表选择，输入姓名、昵称或用户 ID 搜索，滚动到底部加载下一页。卡片底部显示创建人，并提供预览、使用及更多操作。
我的技能：上传与管理版本
在“我的 → 我的技能”点击“上传技能”，按表单上传技能文件并填写资料。后续从目标技能的操作入口上传新版本、查看版本历史或提交审核；审核中的版本按页面状态处理。
公司空间可在名称搜索旁按创建人昵称或用户 ID 筛选，并在卡片或列表中查看创建人。条件可与其他筛选叠加，清空后恢复全部结果；个人空间不显示创建人筛选和信息。
选择“我的技能”，按名称、创建人、技能类型和分类筛选；公司空间创建人从可搜索下拉列表选择，滚动到底部加载下一页。点击“上传技能”添加文件，卡片提供版本与审核操作。
我的组件：上传并跟踪审核
在“我的 → 我的组件”点击“上传组件”，选择组件文件，填写名称与行业后上传并提交审核。2D ZIP 不超过 32 MiB，3D GLB 不超过 100 MiB。通过列表筛选查看审核及发布状态，按状态进行撤回、新版本或删除操作。
公司空间可在名称搜索旁按创建人昵称或用户 ID 筛选，并在卡片或列表中查看创建人。条件可与其他筛选叠加，清空后恢复全部结果；个人空间不显示创建人筛选和信息。
选择“我的组件”，按名称、创建人、类型和审核状态查找；公司空间创建人从可搜索下拉列表选择，滚动到底部加载下一页。卡片显示创建人，点击“管理”维护组件。
| 入口 | 常用操作 | 需要留意 |
|---|---|---|
| 技能市场／我的技能 | 查看详情、下载；在创建或构建配置中关联 Skill；我的技能支持上传、上传新版本、版本历史及提交审核。 | 审核中或待上架的新版本会限制继续上传；已发布或审核中不能删除。 |
| 组件市场／我的组件 | 按 2D／3D、行业筛选；下载组件包或 GLB。我的组件支持“上传组件 → 选择组件文件 → 上传并提交审核”。 | 2D ZIP ≤32 MiB；3D GLB ≤100 MiB；名称、行业必填。场景创建时使用“选择组件”导入。 |
| 我的模板 | 预览、使用、详情、上架模板库、审核记录及删除。 | 上架模板库是提交审核；已发布或审核中不能再次提交或删除。 |
| 模型市场 | 登录后打开模型市场页面。 | 由外部页面嵌入承载；订阅、开通等具体流程按该页面当前说明操作。 |
创建并试用自己的 Skill
首页“技能”入口用于生成或改进 Skill，并在独立预览中尝试它的实际表现。
开始前：切换到具备有效 VIP 权益的公司空间。
-
从首页“技能”开始
输入想让 Skill 完成的任务，选择可用模型，点击“立即构建”。按弹窗填写名称和需求，可提供需求材料或已有 Skill。
进入技能构建工作台；已有 Skill 会作为本次修改对象。
图 30说明 Skill 的目标、输入与输出界面示例 · 示例数据 ① 填写名称。② 说明要解决的问题和预期输出，选择模型后开始构建。
图 31已有 Skill 时，可上传后继续改进界面示例 · 示例数据 ① 在表单下方上传 .zip、.skill 或 SKILL.md。② 点击“开始构建”，后续通过对话改进并预览。
-
在对话中完善方法
说明触发场景、输入、输出要求和不应处理的内容。生成后查看右侧“预览”，像最终用户一样试用。
需要引用具体文件时，在“代码”中打开文件并点击“发送路径”，或右键文件、目录选择“发送路径到对话”。输入框中会显示路径引用；输入修改要求后发送。引用可在发送前移除，发送失败时会保留，发送成功后清除。
获得可供试用的 Skill 草稿。
-
更新预览并检查行为
修改草稿后点击“更新技能”加载最新版本；这会清空预览对话并重新初始化。需要独立上下文时，使用“清空对话历史”并确认。
预览使用最新技能和新的对话上下文。
-
保存或导出
完成验证后点击“保存到我的 Skill”；后续有新变更时显示“保存新版本”。也可以使用“导出”或“历史版本”。
保存到个人技能管理后可继续版本和审核流程；保存不等于公开上架。
保存快照与恢复历史版本
对重要修改先留存版本，再继续迭代。源码包、快照和安装包的用途不同。
-
创建快照
在工作台点击“历史版本 → 创建快照”，填写描述后点击“创建”。
当前变化保存为版本；没有变更时会提示无需创建。
图 32在历史版本中创建快照界面示例 · 示例数据 点击“创建快照”，写下本次完成的内容。列表中的名称和版本为示例。
-
查看版本记录
在历史列表中检查版本与描述，确定要恢复的目标。
有多个版本时可使用版本项上的恢复操作。
图 33用描述记录这个版本能做什么界面示例 · 示例数据 ① 写清楚完成内容，例如“设备台账和点检任务已验证”。② 点击“创建”。
-
恢复目标版本
悬停目标版本，点击“恢复”，在“确认恢复”弹窗再次点击“恢复”。
恢复操作完成后，重新检查预览与受影响的业务操作。
导出源码与安装包
完成预览和业务验证后，从工作台“导出”选择包类型。兼容目标要与应用及实际 supOS 环境核对。
| 你要做什么 | 对应选项 | 说明 |
|---|---|---|
| 交接或继续开发代码 | 源码包 | 下载经过筛选的源码 ZIP；不是完整会话备份。 |
| 交付 Windows 环境 | Windows 安装包（supOS-Free） | 开启 supOS 集成且应用选择 V4／V6 时，此项禁用。 |
| 交付 Linux／supOS 环境 | Linux 安装包 | 普通 APP 和当前 2D/3D 工作台仅在开启 supOS 集成且应用选择 V4／V6 时显示对应版本；其他情况显示 supOS X 1.5+。V4/V6 是目标环境版本尚未查询成功时的回退标签，不表示同时兼容两个版本的保证。 |
-
确认目标环境与应用版本
核对应用是否开启 supOS 集成、选择了哪个版本，以及实际部署环境版本。
明确本次需要源码包还是对应平台的安装包。
-
选择导出并等待完成
点击“导出”，选择目标包。等待打包、构建和下载进度；失败时保留报错信息，处理后重试。
以实际文件下载完成为导出完成标志。
图 34按交付目标选择导出类型操作区域示例 · 示例数据 ① 源码包用于继续开发。② Windows 安装包面向对应 Windows 环境。③ Linux 安装包需核对目标 supOS 版本。此图展示 supOS X 应用的菜单。
-
在目标环境安装并验收
交付安装包后，按该包与目标平台的安装说明操作。检查启动、登录、页面、真实数据与权限。
下载成功不等于已经安装到 supOS。
交付验收清单
- 下载文件存在且可正常打开，目标平台与包类型匹配。
- 真实环境的数据、权限和外部依赖已验证。
- 关闭演示数据后检查页面，不将演示效果当作真实连接。
- 重要版本已保存；交付说明记录应用版本、配置前提和已知限制。
积分、空间与账户设置
从确认空间开始，完成充值或兑换，再核对账单与消耗。公司管理员还可以分配和回收成员额度。
1. 确认当前空间，读懂可用积分
先确认积分属于哪个空间，再进行充值、兑换或查询。个人空间和公司空间的积分账户不同。
-
打开左下角用户菜单
点击头像或用户名。菜单顶部显示当前空间，下方可查看“我的可用积分”，并进入“积分管理”。
确认当前使用的是个人账户还是公司账户。
-
选择本次要使用的空间
使用个人积分时点击“个人空间”；使用公司积分时，将鼠标移到“公司空间”，再点击右侧列表中的公司名称。
切换后，检查左下角空间名称和积分页右上角“当前积分账户”是否一致。
-
切换后重新确认页面
等待应用列表和积分信息更新；其他已打开的页面若提示空间已变更，点击“确认并刷新”后再继续。
后续操作使用切换后的空间，不沿用旧页面上的余额。
① 个人空间。② 公司空间。③ 积分管理入口。图中是公司管理员视角。
将鼠标移到“公司空间”，再点击右侧具体公司名称；勾选状态表示当前空间。
| 你正在使用的身份 | 应该看哪个数字 | 额度不足时怎么办 |
|---|---|---|
| 个人空间用户 | 当前积分余额 | 在个人空间充值或兑换，再检查到账情况。 |
| 公司空间普通成员 | 我的可用积分／成员剩余额度 | 联系公司管理员分配；给公司充值并不会自动增加自己的额度。 |
| 公司管理员 | 自己的可用积分，以及公司的可用余额和可分配积分 | 先确认公司资金，再为自己或其他成员分配额度。 |
普通成员页面会提示“当前可用额度为 0，请联系公司管理员分配”，不会显示管理员的成员管理入口。
2. 选择套餐并完成充值
-
进入“积分充值”
在用户菜单点击“积分管理”，再选择“积分充值”页签。核对右上角“当前积分账户”，查看自己的余额或可用积分。
明确本次充值将进入哪个空间。
-
选择套餐或自定义金额
点击可购买的套餐卡片；需要自定义时选择“自定义充值”并输入金额。向下查看“充值积分”“赠送积分”（如有）和“应付金额”。
选中的套餐有高亮状态，汇总金额随选择更新。
-
选择支付方式并阅读协议
选择支付宝或微信支付，打开并阅读《应用生成 Agent 充值消费协议》，同意后勾选协议，再点击“立即支付”。
打开支付窗口，显示本次订单和二维码。按钮不可用时检查套餐、协议及加载状态。
-
完成扫码并确认入账
使用对应支付工具扫码。支付后等待页面显示结果；若提示“积分入账中”，可稍后回到积分页刷新，并在“账单与发票”核对该订单。
以实际到账和订单状态为准；二维码显示出来不代表已支付成功。
① 积分充值页签。② 选中的套餐。③ 积分兑换入口。套餐与金额为演示数据。
① 选择支付方式。② 阅读并同意协议。③ 点击“立即支付”。图示金额不是对当前售价的承诺。
3. 将兑换码兑入正确的空间
-
打开“积分兑换”
在积分管理页右上角点击“积分兑换”。先看弹窗中的“入账至”；需要调整时点击“切换”，选择个人空间或指定公司。
入账空间显示为本次要使用的账户。
-
输入有效兑换码
粘贴兑换码并检查空格，点击“立即兑换”。公司专属兑换码应在指定公司空间使用。
成功提示显示获得的积分和实际入账空间。
-
回查余额或成员额度
回到积分管理查看余额，必要时到“积分明细 → 获取记录”核对。公司兑换到账后，联系管理员确认成员额度。
确认积分已进入预期空间，并能在该空间下使用。
① 核对入账空间，必要时“切换”。② 输入有效兑换码。③ 点击“立即兑换”。图中代码仅供演示。
4. 查找充值订单和入账记录
-
进入“账单与发票”
选择时间范围、支付状态和发票状态，点击“查询”。需要取消条件时点击“重置”。
列表显示符合条件的充值订单。
-
打开“账单详情”
在目标订单行点击“账单详情”，核对订单号、实际支付金额、实发积分以及支付和入账时间。
能确认查到的是本次付款，以及是否已完成入账。
① 账单与发票。② 查看目标订单详情。③ 支付成功且符合条件的订单可申请开票。
重点查看实际支付金额、实发积分、支付时间及入账时间；图中订单为示例。
| 订单显示的状态 | 下一步 |
|---|---|
| 待支付 | 确认订单是否仍需支付；不要把待支付订单当作已充值。 |
| 支付成功 | 打开详情核对入账时间和实发积分，再核对当前空间余额。 |
| 已关闭／已退款 | 查看详情；这些状态不是仍可支付的有效订单。 |
5. 申请、跟踪和下载发票
-
找到可申请的订单
在“账单与发票”中找到支付成功的订单。未申请的订单提供“申请开票”；开票失败的订单提供“重新申请”。
打开“填写开票信息”弹窗，先核对“本单可开金额”。
-
填写抬头和接收邮箱
按实际情况选择个人或企业抬头。填写发票抬头、有效电子邮箱；企业抬头还需填写企业税号，并选择企业类型。
所有必填项完整，邮箱用于接收电子发票。
-
选择发票类型并提交
选择页面提供的发票类型。“企业 → 一般纳税人”时可选择专用发票；选择后还需填写开户银行、银行账号、注册地址／经营地址和注册电话。核对后点击“提交申请”。
申请进入开票审核，订单发票状态随处理进度更新。
-
查看结果并下载
回到订单列表查看发票状态。“已开具”时点击“下载发票”；“开票失败”时在详情查看失败原因，修正后“重新申请”。
获得实际发票文件，或根据失败原因完成重新申请。
① 选择抬头类型，填写相应资料。② 填写接收电子发票的邮箱。核对后点击“提交申请”。
6. 查询积分花在了哪里
-
进入“积分明细”并选择范围
普通成员查看自己的记录。公司管理员可在右上角切换“我的积分”与“公司积分”；后者用于查看公司范围内的明细。
记录范围与当前选择一致。
-
选择获取或消耗记录
点击“全部”“获取记录”或“消耗记录”。选择“消耗记录”后，可按调用类型、APP 和时间范围筛选；公司视角还可按人员筛选。
列表及消耗汇总随筛选条件更新。
-
核对具体消耗
按发生时间、应用、操作人和积分数量定位记录。如积分数量可点击，可打开计算详情查看本次用量与计费信息。需要重新查询时使用“重置筛选”。
能将消耗对应到具体应用或操作。
① 管理员可选择公司积分视角。② 切换消耗记录。③ 筛选对应 APP；公司视角还支持人员筛选。
7. 公司管理员分配与回收额度
适用身份：公司管理员。普通成员看不到成员“积分管理”页签和“公司积分”明细视角。
-
打开成员积分管理
在公司空间的积分管理页，点击“去分配”，或打开同名“积分管理”页签。查看“公司可用余额”和“公司可分配积分”。
进入“成员积分”列表，看到成员的累计分配、消耗和剩余积分。
-
找到成员并点击“分配”
按名称、昵称或用户 ID 搜索；也可按当前成员、已退出或已移除状态筛选。找到目标行后点击“分配”。
弹窗显示该成员以及当前可分配／可回收数量。
-
选择“划入”或“划出”
“划入”给成员增加额度，“划出”回收剩余额度。输入正整数积分数量和调整原因，再点击“确认分配”。数量不能超过弹窗显示的上限。
划入占用公司可分配积分；划出恢复可分配积分，成员余额同步变化。
-
检查调整结果
回查该成员的剩余积分，并打开“调整记录”。可按成员筛选，核对操作人、积分数量、方向、原因和时间。
确认额度变更对应到正确成员。
① 打开成员积分管理。② 搜索成员。③ 在目标成员行点击“分配”。
① 选择划入／划出。② 输入积分数量并填写调整原因。③ 点击“确认分配”。额度数字为示例。
① 查看调整记录。② 按成员筛选；核对操作人、数量、方向、时间和原因。
8. 账户设置与退出登录
-
打开账户设置
点击左下角头像或用户名，选择“账户设置”。
在新页面打开蓝卓云账户中心，按该页面提供的入口维护账户信息。
-
退出当前账号
回到用户菜单，点击“退出登录”。确认后点击“确认退出”；暂不退出则点击“取消”。
完成退出后返回登录流程；共享设备上使用结束后应确认已退出。
① 账户设置打开蓝卓云账户中心。② 退出登录会先弹出确认框。
点击“确认退出”完成退出；不想退出则点击“取消”。
遇到积分问题时，先核对这些信息
- 当前空间名称，以及你是普通成员还是公司管理员。
- 问题属于未支付、未入账、未分配额度，还是某笔消耗需要核对。
- 发生时间、订单号或对应 APP，以及页面显示的具体状态。
- 仍无法解决时，在用户菜单进入“工单支持”；提交截图时遮盖兑换码、支付信息和个人资料。
遇到问题时，从这里检查
先识别当前所在模式、等待步骤和环境，再决定下一步。
看到“当前可用额度为 0，请联系公司管理员分配”时，先确认当前公司空间，再联系管理员核对自己的剩余额度。公司充值后仍需为成员分配。
为什么“立即构建”不能点击？
检查是否登录、当前构建类型是否可用、是否有可用模型。工业 APP、大屏、2D 和 3D 的创建条件不同；按当前表单提示补齐必填项。
只上传参考图，为什么仍然要求填写需求？
2D/3D 创建要求需求描述或需求文档至少一项。参考图片和 GLB 等材料用于辅助表达，不能代替业务需求。
Agent 已整理需求，为什么没有继续？
先打开“查看需求文档”，选择“按此继续”“改几处”或“保留原文”。当前 2D/3D 若尚未选数，还需进入“数据模型 → 维护选数”；AI 示例要点“保存并使用”才完成确认。
源码已经构建成功，为什么预览仍然失败？
编译成功后，应用启动仍可能因线程、内存或依赖配置退出。展开“查看错误详情”，查看退出码、资源上限和关键日志。应用线程池参数属于源码配置，容器资源配额由平台管理；应结合具体错误调整应用或联系管理员。若提示应用仍运行但转发入口不可用，可先重试预览并反馈错误详情。源码本地预览保留网络隔离，平台会自动连接所选 supOS 环境和已绑定、授权的数据库 TCP 资源。只有数据库申请声明并不表示本地已分配数据库；请核对资源绑定和连接配置。源码应用集成 supOS X 时复用平台已有 LakeRDS，目标环境须提供该资源及应用连接权限。修复数据库配置后，请重新生成安装包再安装，旧包不会自动更新。
为什么大屏没有正式预览？
检查是否仍在等待布局确认。线稿阶段先调整并点击“确认布局，开始构建”；正式产物准备完成后再查看预览。
为什么预览有动画或数值，关闭演示数据后没有了？
演示数据用于展示效果，不证明真实数据已接通。核对资源授权、环境、对象和字段；没有真实来源时，未知或空数据是需要处理的接入状态。
为什么资源管理里没有“第三方数据库”？
当前用户资源类型提供 supOS 环境、UNS、第三方接口和 Figma 连接。数据库连接在提供该能力的应用工作台“数据库”工具中配置。
为什么关联项目选项没有出现？
当前关联项目要求开启 supOS 集成且后端为 TypeScript。创建时可选择；编辑应用时不提供项目选择器。
导出成功是不是已经发布到 supOS？
不是。导出完成表示打包与下载完成；目标平台安装、实际环境配置和业务验收仍需完成。“集成 supOS 预览”也不等于正式发布。
公司已充值，为什么我的积分仍然为 0？
公司入账和成员额度分开管理。先确认当前空间，再联系公司管理员核对成员额度分配。
为什么首页没有业务流程图、3D、技能或专家模式？
先核对左下角的当前空间。上述创建入口仅在具备有效 VIP 权益的公司空间显示；个人空间或未开通／已到期的公司空间只显示大屏看板和工业 APP 普通模式。联系公司管理员确认权益，切换到对应公司空间后重试。