星海智算开发文档
应用开发

在工作台提交和管理应用

个人应用开发者在开发者中心完成接入配置、镜像归档、版本提交、联网调试和上架申请。

超级管理员为个人账号授予“应用开发者”权限后,应用中心会显示“应用开发者工作台”。开发者只管理归属于自己的应用,不会看到或修改其他开发者的应用。进入应用开发者工作台后直接打开默认应用工作台;页面头部始终提供“新建应用”,不需要先经过“我的应用”中转页。

从已有项目到版本上架的开发者主流程

接入流程

  1. 进入应用开发者工作台,点击“新建应用”,填写应用名称和稳定简称。
  2. 在“接入与配置”中按顺序阅读“SDK 总览 → jusp app → Python/HTTP SDK”,使用 jusp app init 在已有项目内创建 .jusp/app.yaml,再由开发者确认入口、组件、资源和角色;本地模拟不会调用平台或扣积分。
  3. 在“版本管理”选择 Docker/OCI 镜像归档。上传会话按分片传输;上传失败时按页面提示继续原会话,会话过期后重新选择同一归档。平台检查通过后才会产生可引用的镜像资产。镜像只属于当前版本,开发者不需要接触平台的存放方式。
  4. 在已有项目目录用 jusp app package 生成版本包(.jusp/dist/submission.json),在页面选择生成的 JSON 文件并预览入口、路由、资源和镜像绑定后提交。页面不要求手写平台 JSON,重复点击会复用幂等键,不会创建重复版本。
  5. “版本管理”使用一张版本表,不把历史版本藏在“处理中”步骤里。点击版本行即可打开详情,不再额外显示“查看与操作”。草稿版本可直接替换版本包和镜像;已上架版本通过“修改本版本”建立同版本修改稿,修改后再提交审核。
  6. 版本状态由平台返回:草稿、处理中、可提交审核、审核中、已退回、已批准、上架中、已上架或已暂停。页面会显示阻断原因和下一步,不再使用没有动作含义的“准备→检查→开发测试→预发布”步骤条。
  7. 点击“CLI 配对”生成一次性配对码。联网调试会调用真实模型并从当前账户扣积分;配对页必须展示应用名称、有效期、权限范围和扣费提示,配对凭据只在 CLI 子进程中使用,不写入 .env、日志或版本包。
  8. 状态为“可提交审核”时申请上架。管理员审核或退回后,页面展示审核结果;新版本失败不会替换当前线上版本。

应用详情的四个分区

  • 接入与配置:查看接入合同、本地模拟和 CLI 配对。
  • 版本管理:上传与版本一一对应的镜像归档,选择 jusp app package 生成的版本包;版本详情同时展示可展开查看的源文件,以及平台翻译后的入口、组件、资源需求、角色和镜像信息。
  • 应用角色:定义角色名称与用途;成员绑定由组织管理员完成。
  • 基本信息:查看应用名称、稳定简称和线上版本。低频技术标识收在“技术信息”中。

版本包和权限边界

版本包由 jusp app package 根据项目接入文件生成,只声明入口、路由、资源、角色和镜像资产引用,不包含秘密凭据、平台生成名称或镜像字节。平台会保存源文件的文件名、摘要、大小和上传时间,并把解析后的可读信息与版本绑定;这两层信息都可在详情中对照查看。应用角色只表达业务含义,组织成员的绑定由组织管理员负责;开发者不能模拟其他用户,也不能批准或激活版本。

本地模拟永远不扣积分。联网调试使用公网 Runtime 门面和当前账户的正常价格、余额、限流与用量归因;开始前页面会明确提示真实扣费。凭据到期后不能创建新调用,已经创建的异步任务仍可在受控窗口恢复。

提交新版本审核不会影响当前线上版本。只有新版本通过审核、预上架检查和平台激活后,才会成为新的线上版本。

版本状态和可执行动作

状态开发者可以做什么管理员可以做什么
草稿编辑、替换源文件、上传/更换镜像、删除草稿、运行检查只读查看
检查失败查看字段级阻断,修复后重新检查查看失败证据
可提交审核发起上架申请尚不能直接上线
审核中查看申请和审计;不能原地覆盖源文件批准或退回
已退回按意见修改后重新提交查看新申请
已批准等待平台上线;可在允许条件下申请撤回运行预上架检查并上线
上架中只读查看部署进度查看运行证据
已上架修改本版本并提交变更审核,或显式新建下一版本审核修改稿,批准后执行更新线上版本
已暂停/已撤销查看原因,创建修复版本按策略恢复或保持下线

修改已上架版本时,先点击“修改本版本”,平台为同一个版本建立独立修改稿。开发者先更新版本包或镜像并核对前后差异,再按需补充原因并提交审核;修改稿不会形成新的可见版本号。管理员批准后仍需单独执行“更新线上版本”,平台部署成功后才把同一版本切换为修改内容;部署失败时线上旧内容保持不变。只有显式点击“新建版本”才产生新版本。非线上版本的删除申请获批后,该版本会标记为已删除并退出可用版本列表;线上版本必须先下架,删除版本不会卸载另一个运行版本,也不删除应用业务数据。

如何确认没有影响线上版本

版本详情同时展示三组事实:

  1. 你上传的源文件:文件名、大小、SHA-256、上传时间和可展开查看的 JSON;
  2. 平台识别结果:应用入口、组件、资源需求、依赖、角色和镜像摘要;
  3. 平台执行事实:检查、审核、上线、部署状态与操作记录。

三组信息不一致时页面必须明确标红,并禁止申请上线。新版本或同版本修改稿完整通过并成功部署前,旧线上内容继续运行。

开发文档入口

  • “应用中心 SDK 总览”:先理解模式、地址和安全边界;
  • “应用 SDK 开发、维护与发布指南”:应用需要被其他应用调用时,设计和发布自己的业务 SDK;这是可选分支,平台不代维护应用业务文档;
  • “jusp app 使用指南”:已有项目、接入 YAML、镜像 tar 和版本包;
  • “Python SDK 入门教程”:安装、本地模拟、真实调试、正式运行、异步任务和应用间调用;
  • “应用中心 HTTP 接入指南”:其他语言的完整接入步骤;
  • “应用中心 HTTP API 参考”:原始接口、字段、响应和错误码。

第三方开发者只使用 RuntimeSession 和正式 SDK,不需要理解平台部署实现。

常见问题

  • 需要处理:草稿版本可直接修改;已提交或已上架版本必须先建立同版本修改稿,修改版本包或镜像后再提交审核,不能绕过修改稿直接覆盖线上内容。
  • 版本申请记录:提交、变更、删除和上架申请都会留下申请号、状态、说明和时间;管理员的批准、退回、撤销、上线也会在同一版本审计中出现。
  • 镜像上传中断:回到“镜像与版本”,使用原上传会话的“继续上传”;会话过期后重新选择归档。
  • 无法申请上架:版本必须处于“可提交审核”,平台检查阻断项为空。
  • CLI 配对失败:重新生成一次性配对码;不要复制或保存运行时凭据。
  • 看不到别人的应用:这是正常的所有权隔离,每个个人开发者只能管理自己的应用。

本页目录